Отправка каскадных сообщений
Каскадные сообщения – это последовательность каналов отправки, каждый из которых срабатывает в зависимости от статуса сообщения, полученном на предыдущем этапе.
В большинстве случаев переотправка сообщения по другому каналу происходит, если на предыдущем был получен «отрицательный» статус, такой как undelivered или timeout. Исключением является канал hlr, который инициирует отправку сообщения по очередному каналу в случае «положительного» статуса delivered.
Для отправки каскадного сообщения используйте стандартный метод отправки сообщения POST /api/message с последовательностью каналов, разделённых запятой , в параметре route.
Вы можете изменять параметры отдельного ка нала, например, текст или время ожидания статуса. Для этого используйте общие параметры с префиксом [route]_, где [route] – название канала.
Примеры использования каскадных сообщений
Типы сообщений
| Route | Канал | Назначение | Рекомендация |
|---|---|---|---|
sms | SMS | Универсальная доставка уведомлений и кодов | Основной/резервный |
tgauth | Telegram | Коды авторизации 4–8 цифр через Telegram | Современный канал авторизации |
wcall | Wait Call | Подтверждение номера звонком пользователя | Современный канал авторизации |
fcall | Flash Call | Код в последних цифрах номера входящего звонка | Резерв лучше оркестрировать на стороне клиента |
pushok | PushOk | Подтверждение действия через SIM-Push | Поддерживается 4 основными операторами |
voice | Голосовой звонок/озвучивание кода | Подтверждение действия через SIM-Push | Резерв SMS рекомендуется на стороне клиента |
hlr | HLR-запрос | Проверка активности/состояния номера | В каскаде продолжает цепочку при delivered |