При работе с нашим шлюзом у вас может возникнуть необходимость получать от нас статусы доставки SMS-сообщений (далее DLR) автоматически, вместо постоянной отправки многочисленных запросов на проверку наличия статуса.
Для того, чтобы начать получать от нас DLR, необходимо в разделе "Подключение к шлюзу" заполнить форму "Настройки получения статусов".
В форме необходимо указать URL-адрес вашего обработчика статусов, секретный ключ безопасности и отметить нужные протоколы подключения.
Также в настройках доступна возможность временного отключения отправки DLR, чтобы не удалять ранее заполненные данные.
При успешной обработке DLR от оператора, мы сразу же отправляем на указанный URL методом POST следующие данные:
| Поле | Назначение |
|---|---|
| secret | SHA1 хеш секретного ключа безопасности |
| message_id | UUID идентификатор сообщения, сгенерированный при отправке |
| sql_sms_id | Значение поля id в таблице пользователя SQL подключения (если есть) |
| status | Статус доставки |
| sent_date | Дата и время отправки сообщения в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС по киевскому часовому поясу |
| dlr_date | Дата и время генерации DLR в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС по киевскому часовому поясу |
| error | Код ошибки, полученный от оператора (если есть) |
Описание значений поля status
| Значение | Описание |
|---|---|
| DELIVRD | Сообщение доставлено получателю |
| EXPIRED | Истек срок сообщения |
| DELETED | Удалено оператором |
| UNDELIV | Не доставлено |
| REJECTD | Сообщение отклонено |
| UNKNOWN | Неизвестный статус |
Т.к. у каждого оператора свой набор кодов ошибок, нам приходится дополнительно запрашивать назначение конкретного кода. Если Вас интересует причина отклонения сообщения, пожалуйста, свяжитесь с нашим отделом поддержки, и мы отправим уточняющий запрос оператору.