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

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

Сервис-провайдер отправляет Партнёру отчёт о доставке сообщений, передавая его на настроенный 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   "segmentPrice": 5.2,
16   "messagePrice": 10.4
17 }

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

Код

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

Описание

0

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

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

2

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

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

5

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

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

9

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

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

Важно

При отправке абоненту в мессенджер Telegram авторизационных кодов возможно получение только статусов 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

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

10

filtered

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

11

unrouted

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

12

oper-blacklisted

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

13

oper-invsrcaddr

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

14

oper-spamfiltered

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

16

busy

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

18

bad-params

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

20

consumer-phone-not-found

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

28

provider-error

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