9:30 – 20:00
+998 91 008 83 40
Оставить заявку Войти

Техническая справка

API для отправки сообщений

Платформа принимает сообщения по HTTP API, SMPP и SMTP. Ниже — то, что нужно знать до интеграции: в каком виде передавать номер, какие бывают ограничения на имя отправителя и как устроено резервирование.

Получить предложение

Формат номера телефона

Номер абонента всегда передаётся в международном формате: код страны, код оператора, номер — без ведущего «+» и без пробелов.

Код страныКод оператораНомерСтрана, оператор
998901234567Узбекистан, Beeline
998931234567Узбекистан, Ucell
998881234567Узбекистан, Mobiuz
998991234567Узбекистан, Uzmobile
998331234567Узбекистан, Humans
77011234567Казахстан, Kcell

Номер из примера передаётся одной строкой: 998901234567. Коды операторов приведены для примера — принадлежность номера определяется при отправке, переносимость номера учитывается.

Адрес отправителя

В качестве отправителя подставляется число или буквенно-цифровая последовательность. Длина числового отправителя — до 15 цифр, буквенного — до 11 символов. Это ограничение стандарта GSM, а не платформы.

  • Рекомендуемый набор символов: «A-Z», «a-z», «0-9», «-», «_», «.». Остальные символы поддерживают не все SMS-центры и аппараты.
  • Операторы накладывают собственные ограничения: требуют предварительной регистрации имени, запрещают несуществующие номера и имена, не связанные с компанией.
  • Имена, замеченные в спаме и мошенничестве, попадают в чёрные списки операторов. Сообщение с таким именем чаще всего получает отказ в передаче.
  • Регистрацию имени у операторов Узбекистана мы оформляем сами.

Протоколы

Выбор протокола зависит от нагрузки и от того, что умеет ваша система.

ПротоколКогда выбирать
HTTP APIБольшинство задач. Подключается за несколько часов.
SMPP 3.4Высокая нагрузка и минимальная задержка: постоянное соединение, потоки кодов подтверждения.
SMTPОтправка письмом, когда менять код системы нежелательно.

Адреса подключения, логин и пароль выдаются при заключении договора. Один и тот же доступ работает для SMS и для остальных каналов — канал выбирается параметром запроса.

Надёжность и отказоустойчивость

Платформа разнесена на два физически независимых узла. Если соединение с основным недоступно, сообщения направляются на дублирующий — адреса обоих выдаются при подключении.

  • Uptime платформы — 99,99% за счёт резервирования серверных мощностей и каналов до операторов.
  • Пропускная способность — до 10 000 сообщений в секунду.
  • Статус по каждому сообщению возвращается в вашу систему через callback.
  • Входящие сообщения на короткий номер передаются тем же способом.

Частые вопросы

Какой протокол выбрать — HTTP API или SMPP?

HTTP API подключается за несколько часов и подходит большинству задач. SMPP выбирают, когда нужны постоянное соединение, максимальная скорость и минимальная задержка — например, в банковских системах с большим потоком кодов подтверждения.

В каком виде передавать номер телефона?

В международном формате одной строкой, без «+» и пробелов: код страны, код оператора, номер. Для Узбекистана это 998 и далее девять цифр — например, 998901234567.

Нужен ли отдельный доступ для мессенджеров и голосовых каналов?

Нет. Канал указывается параметром в том же запросе, а каскад настраивается на нашей стороне. Интеграция остаётся одна.