Отправка массовой SMS-рассылки
В этой инструкии вы узнаете, как отправить SMS-рассылку от имени компании множеству получателей по расписанию с/без учёта местного времени абонента по API. Рассылку можно также отправить из Личного кабинета — посмотрите видеоинструкцию.
Перед отправкой рассылки нужно:
- Подписать договор как юрлицо или ИП в Личном кабинете — это нужно, чтобы зарегистрировать имя компании для отправки рассылки
- Зарегистрировать индивидуальное имя отправителя в Личном кабинете — отправить рассылку можно только от имени компании
- Подготовить базу мобильных номеров получателей рассылки
- Подготовить текст SMS-сообщения
Для отправки рассылки по API последовательно примените методы:
- Create — настроить и создать рассылку как ресурс. Укажите имя отправителя, текст SMS, расписание отправки и необходимость отправки по местному времени получателя.
Текст рассылки можно персонализировать: обратиться к клиенту по имени, указать номер заказа или адрес доставки. Для этого в тексте введите переменные в двойных фигурных скобках — например, {{name}}. В названии переменной допустима только латиница и спецсимволы (кроме пробелов). Максимум: 100 переменных.
Вы можете сэкономить на рассылке — для этого отправляйте её по заранее согласованному шаблону. Пример:
- Текст шаблона: Здравствуйте, %w! Заказ %w{1,3} будет доставлен %d по адресу: %w{1,20}
- Текст рассылки: Здравствуйте, {{name}}! Заказ {{order_number}} будет доставлен {{date}} по адресу: {{address}}
Важно, чтобы тексты (кроме переменных) полностью совпадали, иначе сообщения будут тарифицированы как рекламные. Перед отправкой рекомендуем проверить, совпадает ли текст шаблона с текстом рассылки с помощью API-метода CheckTemplate или в разделе Личного кабинета «Каналы» → «SMS» → «Шаблоны».
- DownloadFileTemplate (опционально) — скачать шаблон файла в формате base64 для заполнения номерами получателей. Если вы указали в тексте переменные, добавьте их как заголовки в файле и укажите для каждого номера своё значение переменной. Заголовки должны быть уникальны.
- UploadContactFile — загрузить файл с номерами получателей в формате base64.
- CreateCallListFromFile — привязать этот список получателей к созданной рассылке, указав идентификаторы рассылки и загруженного файла.
- Update — запустить рассылку, поменяв ее статус на
4.
Получить детали отправленных SMS можно с помощью API-методов:
- GetHistory — статистика конкретной рассылки
- GetList — общая статистика SMS, отправленных единично или в рамках рассылки
Детали рассылки (ID, настройки и проч.) можно получить, применив метод GetInfo, список всех рассылок приложения — с помощью GetList.