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

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

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

Запрос
> POST https://auth.terasms.ru/outbox/getstatus/json
{
    "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 Сообщение было отбито со стороны шлюза. Конечный