API SMS, API SMPP API планировщика MS
Руководство пользователя

API SMS, API SMPP API планировщика MS

Этот документ предназначен только для указанного получателя и может содержать привилегированную, защищенную авторским правом или иную личную информацию. Если вы получили его по ошибке, немедленно сообщите об этом отправителю и удалите оригинал. Любое другое использование вами документа запрещено.

История изменений

Введение

LINK Mobility является дистрибьютором SMS с 2001 года и имеет большой опыт работы как с операторами, так и с агрегаторами подключений. Эта платформа предназначена для обработки больших объемов трафика, поддержания высокой доступности и упрощения маршрутизации трафика через несколько подключений.
В этом документе описывается интерфейс SMPP для платформы SMSC, а также необходимые параметры и команды, а также поддерживаемые параметры.
В этом документе не рассматриваются такие конкретные случаи использования, как объединенные сообщения, WAPpush, Flash SMS и т. д. Более подробную информацию об этих случаях можно получить, обратившись в службу поддержки.

Поддерживаемые команды

Сервер LINK Mobility следует рассматривать как SMPP 3.4. Официальную спецификацию можно найти на https://smpp.org/SMPP_v3_4_Issue1_2.pdf.
Не все методы поддерживаются, и все различия указаны ниже.
4.1 Привязка
Поддерживаются следующие команды привязки.

• Передатчик
• Трансивер
• Приемник

Необходимые параметры:

• system_id – получено от службы поддержки
• пароль – получен от службы поддержки

Необязательные параметры:

• addr_ton – значение по умолчанию, если во время отправки TON установлено значение Unknown.
• addr_npi – значение по умолчанию, если NPI установлен на Unknown во время отправки.

Неподдерживаемые параметры:

• диапазон_адресов

4.2 Отвязать
Поддерживается команда отмены привязки.
4.3 Ссылка «Запросить»
Команда enquire link поддерживается и должна вызываться каждые 60 секунд.
4.4 Отправить
Для доставки сообщений следует использовать метод submit.
Необходимые параметры:

• источник_адрес_тон
• исходный_адрес_npi
• исходный_адрес
• dest_addr_ton
• dest_addr_npi
• dest_addr
• esm_класс
• кодирование_данных
• см_длина
• короткое_сообщение

Неподдерживаемые параметры:

• Тип Обслуживания
• протокол_id
• приоритетный_флаг
• расписание_доставки_время
• replace_if_present_flag
• sm_default_msg_id

Примечание что полезная нагрузка tag не поддерживается, и за один вызов может быть доставлено только одно SMS, и рекомендуется, чтобы период действия tag имеет продолжительность не менее 15 минут.
4.4.1 Рекомендуемые TON и NPI
При отправке сообщений с помощью команды submit следует использовать следующие TON и NPI.
4.4.1.1 Источник
Для адреса источника поддерживаются следующие комбинации TON и NPI. Все остальные комбинации будут считаться недействительными. Если TON установлен на значение Unknown (0), будет использоваться TON по умолчанию из команды bind. Если NPI установлен на значение Unknown (0), будет использоваться NPI по умолчанию из команды bind.

4.4.1.2 Место назначения
Для адреса назначения поддерживаются следующие комбинации TON и NPI. Все остальные комбинации будут считаться недействительными. TON по умолчанию из команды bind будет использоваться, если TON установлен на Unknown (0). NPI по умолчанию из команды bind будет использоваться, если NPI установлен на Unknown (0).

4.4.2 Поддерживаемые кодировки
Поддерживаются следующие кодировки. X может содержать любое значение.

Квота

5.1 Квота превышенаview
Квота определяет максимальное количество SMS-сообщений, которые можно отправить в течение заданного периода времени (например, в день, неделю, месяц или неограниченное количество раз). Каждая квота имеет уникальный идентификатор квоты (UUID) и сбрасывается в соответствии с часовым поясом клиента. Квоты можно назначать на уровне страны, региона или по умолчанию через Quota Pro.fileКвоту также можно назначать динамически с помощью сопоставления квот. Это сопоставляет родительский идентификатор квоты (UUID) и уникальный ключ квоты (например, отправителя или пользователя) с определенным идентификатором квоты.
Квота устанавливается в соответствии с вашей местной службой поддержки, назначенным вам менеджером по работе с клиентами или по умолчанию, если не указано иное.
5.2 Статус 106 – Превышена квота
SMS-сообщение может быть заблокировано с кодом статуса 106 («превышена квота»), если:

• Сообщение превышает заданный лимит для соответствующего ему quotaId в текущем интервале.
• Страна или регион назначения не имеет назначенной квоты (т.е. явно заблокирован с отображением нулевой квоты в профиле)file).
• Соответствующая квота отсутствует, и квота по умолчанию не определена, что приводит к отклонению.
  В этих случаях система блокирует дальнейшую обработку сообщений, чтобы обеспечить соблюдение ограничений, установленных для клиента или получателя, и избежать злоупотреблений.

Отчет о доставке

Поддерживаются только варианты «никакой доставки» или «окончательная доставка» с успешным/неуспешным результатом.
Формат отчета о доставке: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx дата выполнения: ггММддЧЧмм статистика:
Доступные значения в статусе:

• ДОСТАВКА
• ИСТЕКШИЙ
• ОТКЛОНЕНО
• НЕДОСТАВЛЕНО
• УДАЛЕНО

6.1 Расширенный формат отчета о доставке
Более подробную информацию в отчетах о доставке можно запросить, связавшись с вашим торговым представителем.
Формат отчета о доставке: id: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx sub:000 dlvrd:000 дата отправки:
ггММддЧЧмм дата выполнения: ггММддЧЧмм статистика: ошибка: текст:
Доступные значения в статусе:

• ДОСТАВКА
• ИСТЕКШИЙ
• ОТКЛОНЕНО
• НЕДОСТАВЛЕНО
• УДАЛЕНО

Поля «sub» и «dlvrd» всегда будут иметь значение 000, а поле «text» всегда будет пустым.
Значения поля «err» см. в главе Коды ошибок.

Поддерживаемые версии TLS

Для всех подключений TLS по протоколу SMPP требуется TLS 1.2 или TLS 1.3.
Поддержка TLS 1.0 и 1.1 прекращена с 2020. Версии 11 и 15 TLS являются устаревшими протоколами, которые устарели и считаются угрозой безопасности в интернет-сообществе.
LINK настоятельно рекомендует использовать TLS, если сегодня используются незашифрованные соединения SMPP. Незашифрованные соединения SMPP устарели с 2020-09-01 компанией LINK и будут удалены в будущем. Дата удаления незашифрованных соединений пока не определена.
Подключения к серверу SMPP для TLS осуществляются через порт 3601, а не через незашифрованный порт 3600.
Вы по-прежнему можете использовать TLS, даже если ваша реализация SMPP не поддерживает TLS с использованием Stunnel, см. https://www.stunnel.org/

Коды ошибок

В поле err могут быть возвращены следующие коды ошибок, если это поле включено.

Документы/Ресурсы

API SMS для мобильности ссылок, API SMPP API MS Scheduler [pdf] Руководство пользователя SMS API SMPP API MS Scheduler API, SMS API SMPP API, MS Scheduler API, API планировщика, API

Ссылки

• Руководство пользователя