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

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

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

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

Метод запроса: POST.

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

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

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

В разделе приведено описание статусов доставки сообщений (параметр status, см. Отчёт о доставке).

Статус

Описание

0

Сообщение отправлено в сторону Оператора.
Промежуточный статус. Ожидание финального статуса.

2

Сообщение доставлено абоненту.
После доставки сообщения возможно ожидание статуса о прочтении (для всех типов сообщений, кроме SMS и FLASHINGCALL).

5

Сообщение не доставлено абоненту.
Финальный статус.
Код ошибки при доставке сообщения указан в поле errorCode параметров отчета о доставке (см. выше). Расшифровка кода приведена в п. Описание кодов ошибок.

9

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

Важно

Для SMS-сообщений, отправленных абонентам оператора МегаФон, с 01.03.2023 прекращена передача статусов 2 (доставлено) и 5 (не доставлено).

Примечание

Получение Партнёром промежуточного и финального статусов является опциональным и настраивается при конфигурации интеграционного клиента.

Описание кодов ошибок#

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

Код

Наименование

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

1

unknown

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

2

absent-subscriber

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

3

call-barred

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

4

failure

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

5

memory-capacity-exceeded

Память телефона абонента переполнена.

6

teleservice-not-provisioned

У абонента не подключена услуга приема сообщений.

7

timeout

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

8

unknown-subscriber

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

9

duplicated

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

Подробнее

Пример. У Партнёра включен функционал блокировки дубликатов сообщений.

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

Первый запрос будет успешно обработан и сообщение будет отправлено абоненту.

В ответ на последующие запросы Сервис-провайдер вернет Партнёру код ошибки и не будет отправлять эти сообщения абоненту.

Повторные запросы с одинаковым значением id блокируются в течение 12 часов.

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

Функционал блокировки дубликатов по умолчанию отключен для Партнёра. Может быть включен по просьбе Партнёра.

10

filtered

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

11

unrouted

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

12

oper-blacklisted

Номер абонента находится в чёрном списке оператора.

13

oper-invsrcaddr

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

14

oper-spamfiltered

На стороне оператора сработал СПАМ-фильтр по тексту сообщения.

16

busy

В момент доставки сообщения телефон был занят приёмом или передачей другого короткого сообщения.

18

bad-params

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

20

consumer-phone-not-found

Телефон абонента не принимает сообщение.

28

provider-error

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