Webhook

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

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

К примеру, в phpXML-документ будет доступен через переменную $GLOBALS['HTTP_RAW_POST_DATA']

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус">Статус</state>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" sms="Статус" viber="Статус">Статус</state>
     <state id_sms="IDSMS в системе для проверки статуса" time="2011-01-01 12:57:46" viber="Статус">Статус</state>
</response>

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

ПараметрТип данныхОписание

state

String

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

  • «send» - статус сообщения не получен. В этом случае передается пустой time (time="")

  • «not_deliver» - сообщение не было доставлено. Конечный статус (не меняется со временем)

  • «expired» - абонент находился не в сети в те моменты, когда делалась попытка доставки. Конечный статус (не меняется со временем)

  • «deliver» - сообщение доставлено.

  • «read» - сообщение прочитано. Конечный статус (не меняется со временем)

  • «partly_deliver» - сообщение было отправлено, но статус так и не был получен

state.id_sms

Int

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

state.time

String

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

state.sms, state.viber

String

Статус сообщения.

Название поля зависит от типа отправляемого и досылаемого сообщения

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

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

<?xml version="1.0" encoding="utf-8" ?>
<response>
     <id_sms>3234</id_sms>
     <id_sms>3235</id_sms>
</response>

Last updated