Каскад сообщений

Каскад сообщений используется для повышения надежности доставки.
Механизм работает через два канала: WhatsApp и SMS.

Основной канал — WhatsApp. Сообщение в первую очередь отправляется через WhatsApp.

Резервный канал — SMS. Если доставка через WhatsApp не удалась (например, у получателя нет аккаунта на данном номере телефона или истёк срок жизни сообщения), система автоматически отправляет сообщение через SMS.

Таким образом, каскадная доставка обеспечивает максимальную вероятность получения сообщения адресатом.

Добавление резервного канала SMS

Для того чтобы добавить резервный канал доставки (SMS) к вашим запросам на отправку WhatsApp-сообщений, необходимо включить дополнительную секцию smsContent в JSON-пакет.

"smsContent": {
    "typeSend": "0",
    "sender": "ZagolovokSMS",
    "msg": "Полный текст SMS-сообщения"
}

typeSend — тип отправки (по умолчанию "0").

sender — имя отправителя, отображаемое в SMS.

msg — полный текст SMS-сообщения, которое будет отправлено в случае, если доставка через WhatsApp не удалась.

Примеры запросов

Пример запроса на отправку авторизационного сообщения

Название шаблона Whatsapp MyAuth.

{
  "requestId": "test-001",
  "to": "77771234567",
  "content": {
      "whatsappContent": {
          "contentType": "AUTHENTICATION",
          "name": "MyAuth",
          "code": "999789"
      },
  	"smsContent": {
          "typeSend": "0",
          "sender": "ZagolovokSMS",
          "msg": "Ваш код: 999789"
      }
  }
}

Пример запроса на отправку маркетингового сообщения

Общая схема работы

Отправка WhatsApp-сообщения

Сообщение отправляется через канал WhatsApp.

Если сообщение доставлено — процесс завершается.

Если сообщение не доставлено — выполняется переход к следующему шагу

Передача статуса WhatsApp

На ваш вебхук отправляется статус не доставки WhatsApp-сообщения согласно документации.

Уведомление о переходе на SMS

На ваш вебхук отправляется статус с информацией о том, что будет произведена отправка SMS согласно документации.

Отправка SMS

Сообщение отправляется через канал SMS.

Передача статуса SMS

После получения статуса доставки от оператора, система передает этот статус на ваш вебхук согласно документации

Параметр typeSend

Параметр отвечает в каких случаях отправлять SMS сообщение

typeSend: 0

SMS сообщение будет выслано только если на номере абонента не зарегистрирован Whatsapp

typeSend: 1

SMS-сообщение будет отправлено во всех случаях недоставки WhatsApp-сообщения, кроме ошибочных сообщений.

Пример:
Вы зарегистрировали авторизационный шаблон со сроком жизни 2 минуты.
Если в течение этого времени WhatsApp-сообщение не было доставлено (например, у абонента отсутствует интернет), система зафиксирует статус «недоставлено» и автоматически выполнит отправку SMS.

⚠️ Важно:
Данный механизм применяется только для авторизационных и сервисных сообщений.
Для маркетинговых сообщений параметр всегда имеет значение 0, и отправка по SMS возможно только если на номере абонента не зарегистрирован Whatsapp.

Важные замечения

Условие срабатывания каскада

Каскадная отправка работает только при получении от WhatsApp статуса «недоставлено» (failed).

Если в запросе на отправку WhatsApp-сообщения была допущена ошибка (например, в шаблоне указано 3 параметра, а в запросе вы передали только 2), система вернёт статус «ошибка» (error).

В таком случае SMS не будет отправлено.

Ограничения передачи статусов WhatsApp

WhatsApp не гарантирует 100% доставку статусов.

Если по каким-либо причинам от WhatsApp не поступил статус «failed», SMS также не будет отправлено.

Маркетинговые сообщения

Для маркетинговых шаблонов SMS может быть отправлено только в случае, если на номере абонента не зарегистрирован аккаунт WhatsApp.

Во всех остальных случаях резервная SMS-отправка для маркетинговых сообщений не применяется.

Формирование текста SMS

Параметр msg в секции smsContent должен содержать полный текст SMS-сообщения.

Использование параметров (как в шаблонах WhatsApp) не поддерживается.

Пример:

"smsContent": {
"typeSend": "0",
"sender": "MyCompany",
"msg": "Ваш код подтверждения: 1234. Никому не сообщайте этот код."
}

Тарификация

WhatsApp
Недоставленные сообщения по каналу WhatsApp не тарифицируются.

SMS
Все SMS-сообщения тарифицируются вне зависимости от их конечного статуса доставки (доставлено, недоставлено, ошибка, доставлено до оператора).

Каскад сообщений