Отправка «каскадных» сообщений

Платформой предусмотрена возможность отправки «каскадных» сообщений. Процедура отправки сообщения выглядит следующим образом:

  • Предпринимается попытка отправить PUSH-уведомление
  • В случае недоставки или в случае, если отправку PUSH-уведомлений отключена отправляется Viber-сообщение
  • В случае недоставки Viber сообщения отправляется СМС

Отправка «каскадных» сообщений осуществляется аналогично отправке SMS, при этом в список передаваемых параметров добавляется параметр cascade со значением 1

Отправка «каскадного» сообщения GET-запросом:

https://auth.terasms.ru/outbox/send?login=login&target=78002223344&sender=terasms.ru&message=terasms rulez&cascade=1&sign=3e6eb14d4b7c06d77aecd92904d964c2

Описание параметров

Формат ответа аналогичен ответу при отправке SMS: либо ID сообщения в виде положительного числа, либо ошибка в виде отрицательного числа.

Запрос в формате JSON:

Пример запроса:

> POST auth.terasms.ru/outbox/send/json

{
	"login": "login",
	"sign": "3e6eb14d4b7c06d77aecd92904d964c2",
	"target": 78002223344,
	"message": "terasms rulez",
	"sender": "terasms.ru",
	"cascade": 1,
}

Пример ответа:

{
  "status": 0,
  "status_description": "OK",
  "message_infos": [
    {
      "msisdn": "78002223344",
      "id": "566668915",
      "status": 0
    }
  ]
}

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

Получение статуса сообщения в формате 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 Говорит о передаче сообщения в SMS-центр и попытках доставить сообщение.
Статус временный и через некоторое время изменится.
Возможные причины:
- Телефон выключен или находится вне зоны действия сети
- Память телефона переполнена
- Не получен новый статус сообщения от SMS-центра
Стандартное время при котором предпринимаются попытки доставить сообщение 24 часа
промежуточный
Отправлено (sent) 1 Сообщение принято и находится в локальной очереди.
Статус сообщения временный и через некоторое время изменится
промежуточный
Доставлено (delivered) 12 Сообщение доставлено на телефон Конечный
Просрочено (expired) 13 Были предприняты попытки доставить сообщение в течение допустимого времени, но срок истек и сообщение не было доставлено
Возможные причины:
- Телефон был выключен или находился вне зоны действия сети в течение возможного времени доставки
- Память телефона переполнена и не была освобождена в течение возможного времени доставки
Конечный
Не доставлено (not_delivered) 15 Сообщение не доставлено на телефон. Повторные попытки доставить сообщение предприниматься не будут.
Возможные причины:
- Номер не существует
- Абонент заблокирован
- Запрет приема сообщений
Конечный
Неизвестный статус (unknown) 17 Не был получен статус доставки сообщения от SMS-центра
Возможные причины:
- SMS-центр не предоставляет информацию о статусе доставки
- Ошибка на стороне оператора
Конечный
Отказ в передаче (rejected) 18 Получен отказ в передаче от SMS-центра, сообщение не доставлено.
Возможные причины:
- Спам фильтр
- Неправильный формат номера абонента
- Неправильный формат имени отправителя
- Неправильный формат сообщения
Конечный
Просмотрено абонентом (read) 20 Сообщение было получено и открыто получателем.
Не применимо для SMS-сообщений.
Конечный
Недействительно (error) 255 Cтатус говорит о том, что сообщение было отбито со стороны шлюза. Конечный
Готовы начать работу?
Если остались вопросы, свяжитесь с нами по телефону: 8 800 555-9412