API
ДокументацияСообщения и шаблоны

Рассылки: от списка контактов до ответов

Загрузите получателей, выберите шаблон, настройте расписание и действия после ответа.

WAIX API · Обновлено 22 сентября 2026

Что нужно до запуска

Рассылки доступны с действующей подпиской WAIX API. Нужны подключённый номер, одобренный Meta шаблон и список клиентов, согласившихся получать ваши сообщения. Плата за сообщения списывается в Meta отдельно от подписки WAIX.

Создать, запустить и остановить рассылку могут владелец, администратор и оператор компании. Если у вас нет кнопки создания, проверьте свою роль в разделе «Команда».

Подготовить список

  1. Откройте «Рассылки» → «Списки получателей». Загрузите CSV, XLSX, TSV или TXT либо вставьте номера построчно.
  2. Нажмите «Проверить список». WAIX определит столбец с телефоном, приведёт номера к международному формату и покажет дубли и ошибки. При необходимости выберите столбец вручную и повторите проверку.
  3. Сохраните список. Дубли и строки с ошибками в него не попадут.

На один файл — до 10 МБ, 100 000 строк и 50 столбцов. Например, 87073670497 и +7 707 367 04 97 распознаются как один номер. Проверка формата не подтверждает наличие WhatsApp или согласие клиента.

Дополнительные столбцы сохраняются. Для name, order и city можно использовать подстановки {name}, {order}, {city}. Названия и значения должны совпадать с файлом. В столбце timezone можно указать часовой пояс, например Asia/Almaty.

Создать рассылку

  1. Нажмите «Создать рассылку», укажите название, номер отправителя и список. Можно отобрать клиентов по полю или результатам предыдущей рассылки.
  2. Выберите шаблон и язык. Заполните переменные постоянным текстом или полями списка. Для шаблона с изображением, видео или документом добавьте файл.
  3. При необходимости добавьте правила после ответа.
  4. Выберите время начала и скорость отправки. Перед запуском проверьте число получателей и пример сообщения.

Если нужного шаблона нет, создайте его в разделе «Шаблоны» и дождитесь одобрения Meta. Шаблоны авторизации предназначены для OTP и не используются в рассылках.

Правила после ответа

УсловиеЧто можно сделать
Клиент ответилОтветить текстом, отправить шаблон, вызвать вебхук или остановить сценарий.
Ответ содержит словаНапример, на «да» отправить инструкцию. Регистр букв не важен.
Нажата кнопкаСопоставить текст или код кнопки быстрого ответа с правилом.
Ответа нетПодождать от часа и отправить одобренный шаблон. Если ответ пришёл раньше отправки, напоминание отменится.
Нужен операторОтправить campaign.handoff в вашу систему и остановить дальнейшие действия сценария для этого получателя.

Каждое правило выполняется для получателя не более одного раза. У обычного текстового ответа должно оставаться открытым окно 24 часов после сообщения клиента; это проверяется ещё раз перед отправкой. Если окно закрыто, используйте шаблон.

Для действий через вебхуки настройте HTTPS-адрес и нужные события в разделе «Вебхуки». Передача оператору здесь означает событие в вашу CRM или чат поддержки. Встроенный чат операторов появится отдельно.

Расписание, скорость и оценка

Без даты отправка начинается после подтверждения запуска. Дата в форме показана по часовому поясу вашего устройства. Дополнительно можно задать время у получателя: WAIX использует timezone из списка, а при его отсутствии — пояс по умолчанию. Если выбранное время уже прошло, отправка переносится на следующий день.

Скорость задаётся от 1 до 300 сообщений в минуту. Фактическая доставка зависит от Meta, подключения и очереди. Большой список отправляется постепенно.

Для примерной стоимости можно указать цену одного сообщения Meta в тенге. Оценка относится только к первой отправке и не включает сообщения сценария. Это расчёт по введённой вами ставке, а не счёт Meta. Тест на свой номер — также настоящее сообщение, оно может оплачиваться по тарифу Meta.

Сравнить два варианта

Для списка от 10 получателей можно добавить шаблон B. Выбранная доля списка получает A, такая же доля — B. Оставшиеся ждут выбора победителя. Распределение случайное и сохраняется при повторных запросах.

Выберите победителя вручную после отправки тестовых вариантов либо включите автовыбор. Через час после завершения тестовых отправок WAIX сравнит долю ответивших. При равенстве выберет A. Это сравнение ответов; переходы по обычным ссылкам Meta не сообщает.

После запуска

В карточке видны отправленные, доставленные, прочитанные сообщения, ответы и ошибки. Во время отправки статистика обновляется автоматически; её можно обновить кнопкой. Доставка и прочтение появляются по уведомлениям Meta, иногда с задержкой. Полный список результатов выгружается в CSV.

«Пауза» останавливает новую отправку и действия после завершения уже начатого запроса. «Продолжить» возобновляет ещё не отправленные сообщения. «Остановить рассылку и сценарии» отменяет оставшиеся действия. Сообщения, уже переданные Meta, отозвать нельзя.

Статус «Отправка завершена» относится к первой отправке. Запланированные правила и ответы могут обрабатываться в течение 30 дней. Чтобы прекратить и их, остановите рассылку. При истечении подписки работа ставится на паузу; после оплаты продолжите её вручную.

Отписки и повторная рассылка

Ответ «СТОП», STOP, «отписаться», «отписка», unsubscribe или «тоқта» исключает номер из всех будущих рассылок компании. Добавить исключение можно и вручную. Возвращайте номер только после нового согласия клиента.

Для повторной рассылки создайте новый черновик и выберите сегмент предыдущей: доставлено, прочитано, ответил, нажал кнопку, не прочитал или не ответил. Исключения применяются и к этому списку. «Не ответил» считается только для тех, кому сообщение было отправлено.

Остался вопрос по этой инструкции?Написать в поддержку →