Сервис получения статусов доставки

На этой странице

Сервис получения статусов доставки#

Передачу статусов сообщений Сервис-провайдер осуществляет по нотификационной схеме.
При изменении статуса сообщения отправляется POST-запрос на URL, указанный при отправке сообщения в параметре callbackUrl.
В ответ на запрос ожидается HTTP-код: 200.
В случае, если на запрос возвращен HTTP-код 500 (Internal Error), предпринимаются попытки доставить статус до пяти раз с интервалом в минуту.

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

{
"messageId": "3597944866766620289",
"ts": 1613404835977,
"status": "DELIVERED"
}

{
    "messageId": "3597944866766620289",
    "ts": 1613404835977,
    "status": "REJECTED",
    "errorCode": 0
    "id": "super_id_1"
}

Описание параметров#

Параметр	Обязат.	Тип	Описание
messageId	да	string	Уникальный идентификатор сообщения на платформе Сервис-провайдера.
ts	да	long	Время события в миллисекундах.
status	да	string	Текущий статус сообщения (см. Статусы сообщений).
errorCode	нет	integer	Для статусов `REJECTED` и `UNDELIVERABLE` передается `errorCode = 0`. Для других статусов параметр `errorCode` не передается.
id	нет	string	Идентификатор сообщения на стороне Партнёра. Подробнее Если параметр передан в запросе, то он возвращается вместе со статусом сообщения.

Статусы сообщений#

Статус	Описание
SENT	Сообщение было отправлено в сеть оператора.
DELIVERED	Сообщение доставлено абоненту.
EXPIRED	Сообщение было просрочено по сроку жизни.
REJECTED	Сообщение было отклонено оператором или Сервис-провайдером.
UNDELIVERABLE	Сообщение невозможно доставить.
ACCEPTED	Сообщение было принято.
UNKNOWN	Произошла неизвестная ошибка.

Предупреждение

Для SMS-сообщений, отправленных абонентам оператора Мегафон, с 01.03.2023 прекращена передача статусов «Доставлено» и «Не доставлено».