Получение статусов сообщений SMS, Viber, VK, «каскад»

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

Запрос:

> POST https://auth.terasms.ru/outbox/getstatus/json

{
    "login": "login",
    "message_ids": [11222, 11223],
    "sign": "fa129981b8d66bada6dd186711dc23ab"
}

Ответ:

[
    {
        "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 Сообщение было отбито со стороны шлюза. Конечный
Готовы начать работу?
Если остались вопросы, свяжитесь с нами по телефону: 8 800 555-9412