Webhook

Необходимо сообщить менеджеру адрес вашего сервера, который будет принимать статусы SMS

Метод отправки JSON-документа: POST

К примеру, в php JSON-документ будет доступен через функцию file_get_contents("php://input") или переменную $GLOBALS['HTTP_RAW_POST_DATA']

Система отправляет JSON-документ серверу клиента следующего содержания:

[
    {
        "id_sms": "ID SMS в системе для проверки статуса",
        "time": "2011-01-01 12:57:46",
        "state": "Статус"
        },
    {
        "id_sms": "ID SMS в системе для проверки статуса",
        "time": "2011-01-01 12:57:46",
        "state": "Статус"
    }
]

Расшифровка параметров

Параметр

Тип данных

Описание

id_sms

Int

Номер SMS сообщения, полученный в ответном JSON-документа в процессе отправки SMS сообщения

time

String

Время изменения статуса

state

String

Последний статус сообщения:

«send» - статус сообщения не получен. В этом случае передается пустой time (time="")
«not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем)
«expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем)
«deliver» - сообщение доставлено.
«read» - сообщение прочитано. Конечный статус (не меняется со временем
«partly_deliver» - сообщение было отправлено, но статус так и не был получен

Возвращаемый ответ сервера клиента в JSON-документе

Если сервер клиента не передаст id_sms, то статус будет считаться не полученным клиентом. При этом будет сделано 5 попыток доставить статус.

[
    {
        "id_sms":3234
    },
    {
        "id_sms":3235
    }
]

Last updated 1 year ago