Каскадные сообщения#

Каскадная рассылка сообщений по умолчанию недоступна. Для подключения Партнёру необходимо обратиться к курирующему менеджеру.

Типы сообщений, допустимые в каскадной рассылке:

  • FlashingCall;

  • Push;

  • SMS;

  • Viber;

  • VK;

  • WhatsApp.

Последовательность типов сообщений при отправке может быть произвольной.

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

Также есть возможность передавать опции каскада, используя дополнительные параметры HTTP-запроса.

Параметры запроса#

Возможные параметры HTTP-запроса для отправки сообщений в каскаде.

Наименование параметра

Тип

Описание параметра

order_list

string

Параметр, определяющий последовательность отправки сообщений.

Подробнее

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

Возможные значения (регистр значения не имеет):

  • s – SMS;
  • p – Push;
  • v – VK;
  • i – Viber;
  • w – WhatsApp;
  • f – FlashingCall.

Пример: order_list=v,i,s означает последовательную доотправку сообщений следующих типов: VK → Viber → SMS.

<тип>_resendCond

string

Параметр, определяющий условия срабатывания доотправки.

Подробнее

Здесь <тип> – символ, определяющий тип сообщения (i, s, v, f, p, w), для которого выполняется настройка.

Возможные значения (регистр значения не имеет):

  • N – не производить доотправку;
  • Y – производить доотправку при получении статуса Не доставлено;
  • S – то же, что Y, плюс доотправка произойдет, если не получен статус Просмотрено в течение срока жизни сообщения.

Важно! Значение S не применимо для SMS- и FlashingCall-сообщений, т.к. у них не предусмотрен статус Просмотрено.

При помощи комбинации параметров можно задать различные настройки для разных типов сообщений.

Пример 1. Стандартные значения с произвольным порядком типов сообщений:
order_list = "W,V,S", W_resendCond = Y, V_resendCond = S

В данном случае будет выполнена доотправка в VK, если по типу WhatsApp будет получен статус Не доставлено, и дальше в SMS, если по типу VK не будет получен статус Просмотрено, либо будет получен статус Не доставлено.

Пример 2. В данном случае будет отправлено только первое сообщение каскада (Flashing Call):
order_list = "F,S", F_resendCond = N, S_resendCond = Y

Каскадное SMS не отправится, т.к. срабатывание каскада ПОСЛЕ сообщения типа Flashing Call запрещено (F_resendCond = N).

Параметр S_resendCond = Y при этом не имеет значения, т.к. это настройка срабатывания каскада ПОСЛЕ SMS.

<тип>_resendSn

string

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

Подробнее

Здесь <тип> – символ, определяющий тип сообщения (i, s, v, f, p, w), для которого выполняется настройка.

Пример: v_resendSn=0002&i_resendSn=0001&s_resendSn=0000 означает, что:

  • VK-сообщения отправляются с имени 0002;
  • Viber-сообщения отправляются с имени 0001;
  • SMS-сообщения отправляются с имени 0000.

Используемые сервисные имена должны быть доступны для Партнёра.

Для подключения сервисных имён обратитесь к своему курирующему менеджеру.

<тип>_resendText

string

Параметр, определяющий альтернативный текст сообщения для разных типов сообщений, который будет отправляться в режиме доотправки.

Подробнее

Здесь <тип> – символ, определяющий тип сообщения (i, s, v, f, p, w), для которого выполняется настройка.

Пример: v_resendText=textVK&i_resendText=textViber&s_resendText=textSMS означает, что:

  • VK-сообщения отправляются с текстом textVK;
  • Viber-сообщения отправляются с текстом textViber;
  • SMS-сообщения отправляются с текстом textSMS.

На текст сообщения действуют те же ограничения, как для соответствующих типов отдельных сообщений (см. в соответствующих разделах “Параметры запроса“).

<тип>_resendValid

string

Параметр, определяющий время жизни для разных типов сообщений, отправленных в режиме доотправки.

Подробнее

Здесь <тип> – символ, определяющий тип сообщения (i, s, v, f, p, w), для которого выполняется настройка.

Время жизни означает интервал, в течение которого оператор будет пытаться доставить сообщение до абонента. Если время жизни сообщения истекло, и сообщение не доставлено, то оно уже не будет доставлено абоненту.

Допустимые диапазоны времени жизни для разных типов сообщений:

  • SMS – от 1 до 2880 минут (до 2 суток);
  • FlashingCall – от 1 до 5 минут;
  • VK – от 60 до 86400 секунд (до 1 суток);
  • Viber – от 30 до 86400 секунд (до 1 суток);
  • Push – от 30 до 86400 секунд (до 1 суток);
  • WhatsApp – от 1 до 10080 минут (на стороне оператора значение округляется до суток).

Формат значения параметра: YYMMDDhhmmsstnnp,
где:

  • YY – последние две цифры года;
  • MM – месяц (от 01 до 12);
  • DD – день (от 01 до 31);
  • hh – час (от 00 до 23);
  • mm – минута (от 00 до 59);
  • ss – секунда (от 00 до 59);
  • t – десятая доля секунды (от 0 до 9);
  • nn – количество четвертей часа (по 15 минут), указывающее на разницу во времени между местным временем и временем UTC (от 00 до 48). Например, для 8 часов значение будет 32;
  • p – атрибут для планирования доотправки сообщения и сроков истечения времени жизни (в форматах абсолютного либо относительного времени).

Возможные значения p в формате абсолютного времени:

  • + – смещение на четверти часа местного времени относительно времени UTC в сторону опережения, т.е. 08+ соответствует GMT+2;
  • – – смещение на четверти часа местного времени относительно времени UTC в сторону отставания, т.е. 04– соответствует GMT–1.

Пример 1. В формате абсолютного времени запись 29.04.2025 22:00:00 в таймзоне GMT+3 будет: 250429220000012+.

Важно! В абсолютном формате 250429220000012+ для таймзон GMT+ последний плюс при передаче в HTTP-запросе должен соответствующе энкодиться, т.е. в строке запроса он должен выглядеть так: 250429220000012%2B.

Значение p в формате относительного времени:

R – время жизни сообщения относительно текущего времени.

Значения для десятых долей секунды t и смещения UTC nn игнорируются и должны быть установлены на 0 и 00 соответственно.

Пример 2. Время жизни сообщения 3 минуты относительно текущего времени будет: 000000000300000R.

Формат абсолютного времени

Формат по умолчанию. Запланированное время доотправки и сроки истечения времени жизни указываются в глобальном формате UTC, включая смещение в четвертях часа и символ направления + или –.

Формат относительного времени

Относительное время может быть указано, если установить флаг ориентации UTC на R вместо + или –. В этом формате время интерпретируется как количество лет, месяцев, дней, часов, минут и секунд от текущего времени.
Например, следующий формат времени 020610233429000R будет интерпретирован как относительный период в 2 года, 6 месяцев, 10 дней, 23 часа, 34 минуты и 29 секунд от текущего времени.

shorten_list

string

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

Подробнее

Важно! Данный параметр будет обработан, только если передан параметр order_list.

Значение параметра shorten_list может содержать:

  • перечень типов сообщений (через запятую), для которых требуется сокращать ссылки;
  • пустое значение (shorten_list=), если сокращать ссылки для всех типов сообщений не требуется.

Возможные значения (регистр значения не имеет):

  • s – SMS;
  • p – Push;
  • v – VK;
  • i – Viber;
  • w – WhatsApp.

Пример: shorten_list=S,I означает, что ссылки будут сокращены только в SMS- и Viber-сообщениях каскада.

По умолчанию Сервис сокращения ссылок недоступен. Для его подключения следует обратиться к своему курирующему менеджеру.

Примечание

Пример порядка обработки настроенной каскадной отправки VK → Viber → SMS:

  1. Сообщение будет отправлено в VK.

  2. Если сообщение успешно доставлено, то каскадная отправка заканчивается (переход к п. 6).

  3. Если сообщение не было доставлено из-за ошибки или в течение заданного времени жизни, то производится отправка через Viber.

  4. Если сообщение успешно доставлено, то каскадная отправка заканчивается (переход к п. 6).

  5. Если сообщение не было доставлено из-за ошибки или в течение заданного времени жизни, то производится отправка SMS.

  6. Партнёру сообщается финальный статус отправки сообщения (опционально – все промежуточные статусы).