Через BYTEHAND SMPP шлюз возможно отправлять СМС сообщения и получать информацию об их статусах. SMPP шлюз рекомендуется для использования при отправке больших объемов СМС сообщений. Поддерживаемая версия SMPP протокола 3.4.
Скачать спецификацию протокола SMPP, версия 3.4:
- Английская версия - smpp_3.4_en.pdf .
- Русская версия - smpp_3.4_ru.pdf .
Подключение
Значения параметров для подключения по SMPP протоколу можно получить в личном кабинете на странице
Настройки → вкладка СМС → раздел SMPP подключение.Сохраняйте пароль для SMPP подключения в тайне и не передавайте его другим лицам. Используйте кнопку Пересоздать пароль, если пароль был скомпрометирован и вам требуется изменить его значение.
BYTEHAND позволяет установить только одно SMPP подключение для одного пользователя. При повторном подключении предыдущее соединение будет автоматически разорвано.
Отправка сообщений
В качестве режима подключения к SMPP шлюзу необходимо выбирать TRANSCEIVER или TRANSMITTER. Для отправки СМС сообщений используйте команду SUBMIT_SM согласно спецификации протокола SMPP.
Поддерживаемые кодировки:
- SMSC alphabet (GSM 0338) - для латинского текста с поддержкой европейских символов.
- UCS2 alphabet coding (16-bit) - для национальных алфавитов, например, русского.
Команды SUBMIT_MULTI и DATA_SM не поддерживаются.
В качестве телефона отправителя может быть любая подпись или номер телефона, которые вы ранее зарегистрировали в личном кабинете или через API. Динамическая подпись отправителя включается по специальному запросу.
Обратите внимание, после регистрации подпись должна пройти модерацию!
Получение сообщений
В качестве режима подключения к SMPP шлюзу необходимо выбирать TRANSCEIVER или RECEIVER. Для получения СМС сообщений используйте команду DELIVER_SM согласно спецификации протокола SMPP.
Статусы сообщений
Если в личном кабинете на странице
Настройки → вкладка СМС → раздел Извещения о статусе СМС сообщений вы выбрали пункт Передавать через SMPP подключение, то информация об отправленных СМС сообщениях будет передаваться через SMPP подключение.Получать статус доставки отправленного СМС сообщения по SMPP протоколу можно как в автоматическом режиме, получая от сервера ответную команду DELIVER_SM сразу после изменения статуса, так и по запросу отдельной командой QUERY_SM. Для автоматического получения статуса в качестве режима подключения к SMPP шлюзу необходимо выбирать TRANSCEIVER или RECEIVER и при отправке СМС указать флаг запроса статуса registered_delivery.
При автоматическом возврате статуса в команде DELIVER_SM передаются TLV-параметры receipted_message_id, message_state и network_error_code, а также передается текст статуса в следующем формате:
id:id; sub:parts; dlvrd:delivered; submit date:submitedAt; done date:updatedAt; stat:status; err:error
Параметр | Описание |
---|---|
id | Идентификатор СМС сообщения. |
parts | Количество частей в отправленном сообщении. |
delivered | Количество доставленных частей. |
submitedAt | Дата отправки. |
updatedAt | Дата изменения статуса. |
status | Статус сообщения в виде строки, возможные значения: DELIVRD, EXPIRED, DELETED, UNDELIV, ACCEPTD, UNKNOWN, REJECTD. |
error | Код ошибки, если сообщение не может быть доставлено. |
Пример
id:32974923213829439 sub:001 dlvrd:001 submit date:1108204567 done date:1108202568 stat:DELIVRD err:000