Home

Kannel и уведомления о доставке SMS

Tue, 06/05/2008 - 07:39 — misha

Представим себе сервис уведомлений водителей такси о поступивших заказах по SMS. Вы заказали такси для поездки в аэропорт, диспетчер отправил водителю сообщение, а у того телефон разрядился час назад... представили? Чтобы избежать подобных ситуаций, большинство SMSC поддерживает передачу информации о доставке SMS абоненту. Итак, попробуем разобраться с тем, каким образом можно получить уведомление о доставке SMS, используя все тот же Kannel.

Используемые аббревиатуры

  • SMSC - SMS-Center (главная железяка по доставке SMS);
  • ESME - External Short Message Entity (наш сервис, подключенный по протоколу SMPP);
  • DLR - DeLivery Report (уведомление о доставке);

Как это выглядит на уровне SMPP

  1. ESME передает SMSC новое сообщение, используя команду submit_sm с выставленным в 1 параметром registered_delivery.
  2. В ответ SMSC возвращает команду submit_sm_resp с указанием идентификатора сообщения на стороне SMSC в параметре message_id. Соответствие PDU с командами submit_sm и submit_sm_resp определяется передаваемым в обоих пакетах параметром sequence_number.
  3. После того, как SMSC стал известен статус доставки сообщения абоненту, он отправляет на сторону ESME команду deliver_sm. В отличие от "обычного" MO-сообщения, в данном случае в параметре esm_class будет выставлен в 4. Само же сообщение содержит информацию о статусе и времени доставки, а также message_id оригинальной SMS-ки, отправленной абоненту.
  4. В принципе, осталось найти по message_id нужное сообщение и внести информацию о нем, куда надо. Например, в биллинговую систему.

А как это работает в Kannel

Чтобы получить уведомление о доставке, при отправке нового сообщения необходимо указать следующие параметры: dlr-mask (маска уведомлений) и dlr-url (адрес обработчика уведомлений о доставке).

Чтобы не запутаться в отправляемых сообщениях и DLR-ках, в параметре dlr-url можно указать свой собственный идентификатор, который и будет передан Kannel'ом обработчику.

Текст сообщения имеет следующий вид:

id:IIIIIIIIII sub:SSS dlvrd:DDD submit date:YYMMDDhhmm done date:YYMMDDhhmm stat:DDDDDDD err:E Text: . . . . . . . . .

В поле stat содержится очень понятный мнемонический статус - например, EXPIRED, DELIVRD или UNDELIV. Более подробное описание можно найти в приложении B спецификации SMPP 3.4.

Немного о граблях и идентификаторах

Несмотря на кажущуюся простоту, разработчики SMSC успели заложить, как минимум, одни прикольные грабли. Заключаются они в том, что идентификатор сообщения в submit_sm_resp и в последующей DLR могут быть представлены в разном виде, а именно, в виде бинарной строки, десятичного или шестнадцатиричного числа. В связи с этим, в настройке SMPP подключения в Kannel есть один полезный параметр msg-id-type, указывающий, в каких форматах будет встречаться message_id в разных командах.

Например: msg-id-type = 0x02 определяет ситуацию, в которой при отправке мы получаем идентификатор в виде десятичного числа, а при получении уведмоления - шестнадцатиричного.

Ссылки в тему

Уведомления о доставке SMS в Kannel
Спецификация SMPP 3.4