Skip to content

Статус сообщения или каскада ​

Метод возвращает текущий статус транзакционного сообщения или каскада и историю событий по нему. Используйте код, полученный в ответе метода отправки.

POST https://app.rees46.ru/api/v3/communications/transactional/status

API находится на домене личного кабинета: app.rees46.ru для России и app.rees46.kz для Казахстана. В on-premise кластере у API свой домен.

Параметры ​

ПараметрТипОбязателен?Описание
shop_idStringДаAPI-ключ
shop_secretStringДаСекретный API-ключ
codeStringДаКод сообщения или каскада из ответа отправки

Запрос ​

shell
curl 'https://app.rees46.ru/api/v3/communications/transactional/status' \
  -X 'POST' \
  -H 'Content-Type: application/json' \
  --data-raw '{"shop_id":"SHOP_ID", "shop_secret":"SHOP_SECRET", "code":"123-456-em-a1b2c3d4"}'

Ответ для сообщения ​

json
{
  "status": "success",
  "payload": {
    "type": "message",
    "code": "123-456-em-a1b2c3d4",
    "campaign_code": "order_paid",
    "channel": "email",
    "status": "opened",
    "events": [
      { "event": "send", "at": "2026-11-12T10:00:00Z" },
      { "event": "open", "at": "2026-11-12T10:03:12Z" }
    ]
  }
}
СвойствоТипОписание
typeStringmessage
codeStringКод сообщения
campaign_codeStringКод транзакционной рассылки
channelStringКанал отправки
statusStringИтоговый статус сообщения, см. справочник
eventsArrayХронология событий по сообщению
events.eventStringСобытие
events.atStringВремя события

Ответ для каскада ​

json
{
  "status": "success",
  "payload": {
    "type": "cascade",
    "code": "123-456-mu-a1b2c3d4",
    "campaign_code": "otp_login",
    "status": "finished",
    "finish_reason": "delivered",
    "delivered_channel": "email",
    "messages": [
      { "node": "m1", "channel": "mobile_push", "code": "...", "status": "sent", "delivery": "not_delivered" },
      { "node": "m2", "channel": "email", "code": "...", "status": "opened", "delivery": "delivered" }
    ]
  }
}
СвойствоТипОписание
typeStringcascade
codeStringКод каскада
campaign_codeStringКод каскада в личном кабинете
statusStringСтатус каскада, см. справочник
finish_reasonStringПричина завершения, см. справочник
delivered_channelStringКанал, в который сообщение было доставлено
messagesArrayСообщения, которые каскад уже отправил
messages.nodeStringУзел дерева правил, который отправил сообщение
messages.channelStringКанал
messages.codeStringКод сообщения. По нему можно запросить статус отдельного сообщения
messages.statusStringСтатус сообщения, см. справочник
messages.deliveryStringРезультат проверки доставки: pending, delivered, not_delivered

Справочник ​

Статусы сообщения ​

СтатусОписание
queuedСообщение в очереди на отправку
sentСообщение отправлено
deliveredСообщение доставлено
openedСообщение открыто
clickedПо ссылке в сообщении был клик
bouncedОтказ в доставке
failedОтправка завершилась ошибкой

Статусы каскада ​

СтатусОписание
runningКаскад выполняет шаги
waitingКаскад ждет результата проверки доставки или задержки
finishedКаскад завершен
cancelledКаскад отменен
failedКаскад завершился ошибкой

Причины завершения каскада ​

ЗначениеОписание
deliveredСообщение доставлено
exhaustedКаналы закончились, доставка не подтверждена
no_channelsНи одна проверка не пройдена — отправлять было некуда
cancelledКаскад отменен
errorОшибка при выполнении каскада

Ошибки ​

В случае ошибки ответ будет в формате:

json
{
  "status": "fail",
  "message": "..."
}
КодПричина
400Неверные параметры запроса
403Неверный shop_secret или проект неактивен
404Сообщение или каскад с таким кодом не найден