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

Подключение сервиса#

Сервис-провайдер отправляет Партнёру отчёт о доставке сообщений, передавая его на настроенный URL для передачи статусов доставки.

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

Метод передачи данных: POST.

Отчёт о доставке#

 1 {
 2   "id":"8770599",
 3   "mtNum":"107930572",
 4   "status":2,
 5   "type":"SMS",
 6   "doneDate":"2019-05-05T10:20:35+0300",
 7   "submitDate":"2019-05-05T10:19:55+0300",
 8   "sourceAddr":"SOURCE",
 9   "destAddr": "72101234567",
10   "text":"message_text",
11   "partCount":"001",
12   "errorCode":"0",
13   "mccMnc":"25012",
14   "trafficType":0
15 }

Статусы доставки#

Код

Статус доставки

Описание

0

Отправлено (SEND)

Отправлено в сторону Оператора, финальный статус пока не известен.

2

Доставлено (DELIVERED)

Доставлено оператору, после доставки возможно ожидание статуса о прочтении абонентом.

5

Не доставлено (UNDELIVERED, REJECTED)

Отклонено оператором/не доставлено оператору. Информация о причине недоставки указана в поле параметров доставки errorCode. Финальный статус, далее других статусов не ожидается.

9

Прочитано (READ)

Статус о прочтении сообщения абонентом. Для всех сообщений, кроме FlashingCall и SMS. Финальный статус, далее других статусов не ожидается.

Описание кодов ошибок (при status=5)#

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

Код

Наименование ошибки

Описание ошибки

1

unknown

В процессе доставки сообщения произошла неизвестная платформе ошибка, либо оператор не предоставил ошибку в отчете о доставке.

7

timeout

Коммутационное оборудование, на котором зарегистрирован абонент, не отвечает.

8

unknown-subscriber

Некорректный номер абонента, либо телефон абонента был выключен на протяжении очень долгого периода времени.

9

duplicated

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

11

unrouted

Ошибка маршрутизации в конфигурации платформы.

13

oper-invsrcaddr

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

18

bad-params

Указаны неверные параметры запроса или не указаны обязательные параметры.

19

consumer-id-not-found

Не найдена карточка с передаваемым идентификатором абонента.

20

consumer-phone-not-found

Не найдена карточка с передаваемым номером телефона абонента.

21

no-primary-devices

Устройство не является основным. В случае, если была выполнена отправка на основное утройство (primaryOn=true).

22

no-active-installations

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

23

push-disabled

У пользователя мобильного приложения установлен запрет на получение push-уведомлений на уровне приложения.

24

push-os-disabled

У пользователя мобильного приложения установлен запрет на получение push-уведомлений на уровне операционной системы.

25

subscription-failed

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

26

no-application

Не найдена установка мобильного приложения на устройстве пользователя.

27

below-min-version

Версия приложения меньше минимально допустимой версии. В текущей реализации актуально только для IOS.

28

provider-error

Облачный провайдер (APNS, FCM или HMS), через которого выполняется отправка уведомления, вернул ошибку.