Получение статусов сообщений

SMS, Viber, VK, «каскад»


Получение статуса сообщения в формате JSON

Запрос

> POST https://auth.terasms.ru/outbox/getstatus/jsons { "login": "login", "message_ids": [11222, 11223], "sign": "fa129981b8d66bada6dd186711dc23ab" }

Ответ

{ "statuses": [ { "message_id": 11222, "country": "страна/оператор", "status": 12, "status_desc": "delivered", "type": "sms", "method": "sms", "time_seen": "", "segments": [ { "segment_id": "112221", "status": "12", "status_desc": "delivered" }, { "segment_id": "112222", "status": "12", "status_desc": "delivered" } ] }, { "message_id": 11223, "country": "страна/оператор", "status": 18, "status_desc": "rejected", "type": "viber", "method": "viber", "time_seen": "2100-03-04 22:45:32" } ] }

Получение статуса сообщения в формате XML

Запрос

> POST https://auth.terasms.ru/outbox/getstatus/xml <request> <login>login</login> <message_ids> <message_id>11222</message_id> <message_id>11223</message_id> </message_ids> <sign>fa129981b8d66bada6dd186711dc23ab</sign> </request>

Ответ

<response> <statuses> <status> <message_id>11222</message_id> <country>страна/оператор</country> <status>12</status> <status_desc>delivered</status_desc> <type>sms</type> <method>sms</method> <time_seen/> <segments> <segment> <segment_id>112221</segment_id> <status>12</status> <status_desc>delivered</status_desc> </segment> <segment> <segment_id>112222</segment_id> <status>12</status> <status_desc>delivered</status_desc> </segment> </segments> </status> <status> <message_id>11223</message_id> <country>страна/оператор</country> <status>18</status> <status_desc>rejected</status_desc> <type>viber</type> <method>viber</method> <time_seen>2100-03-04 22:45:32</time_seen> </status> </statuses> </response>

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

Статус Код Описание Тип
В очереди (queued) 0 Сообщение принято и ожидает отправки оператору связи. Промежуточный
Отправлено (sent) 1 Сообщение принято и отправлено оператору связи.
Сообщение может иметь этот статус в случае:
- не получен статус сообщения от оператора связи;
- телефон абонента выключен или находится вне зоны действия сети;
- память телефона переполнена.
Стандартное время при котором предпринимаются попытки доставить сообщение 24 часа.
Промежуточный
Доставлено (delivered) 12 Сообщение доставлено на телефон. Конечный
Просрочено (expired) 13 Были предприняты попытки доставить сообщение в течение допустимого времени, но срок истек и сообщение не было доставлено
Возможные причины:
- телефон абонента был выключен или находился вне зоны действия сети в течение возможного времени доставки;
- память телефона переполнена и не была освобождена в течение возможного времени доставки.
Конечный
Не доставлено (not_delivered) 15 Сообщение не доставлено на телефон. Повторные попытки доставить сообщение предприниматься не будут.
Возможные причины:
- номер не существует;
- абонент заблокирован;
- запрет приема сообщений.
Конечный
Неизвестный статус (unknown) 17 Не был получен статус доставки сообщения от оператора связи.
Возможные причины:
- оператор связи не предоставляет информацию о статусе доставки;
- ошибка на стороне оператора.
Конечный
Отказ в передаче (rejected) 18 Получен отказ в передаче от оператора, сообщение не доставлено.
Возможные причины:
- спам-фильтр;
- неправильный формат номера абонента;
- неправильный формат имени отправителя;
- неправильный формат сообщения.
Конечный
Просмотрено абонентом (read) 20 Сообщение было получено и открыто получателем.
Не применимо для SMS-сообщений.
Конечный
Недействительно (error) 255 Сообщение было отбито со стороны шлюза. Конечный