• Главная
  • Тарифы
  • Подключение (API)
  • Вопросы (FAQ)
  • Новости
  • Договор
  • Контакты
  • Вход

    • API / HTTP/HTTPS протокол / Передача статусов и сообщений на обработчик Клиента

    API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.


    HTTP/HTTPS SMTP SMPP SOAP SMS-команды Библиотеки и примеры кода

    ОТПРАВКА СООБЩЕНИЙ

    Отправка SMS-сообщения

    Комментарии в SMS-сообщениях

    Отправка на группу номеров

    Отправка HLR-запроса

    Отправка MMS-сообщения

    Отправка e-mail сообщения

    Отправка голосового сообщения (звонок)

    Отправка viber-сообщения

    Использование префиксов при отправке сообщений

    Управление шаблонами сообщений

    Виртуальная отправка (режим тестирования)

    УПРАВЛЕНИЕ РАССЫЛКАМИ

    СТАТУСЫ СООБЩЕНИЙ

    ПРОВЕРКА СОСТОЯНИЯ БАЛАНСА

    УПРАВЛЕНИЕ КОНТАКТАМИ

    УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)

    ПОЛУЧЕНИЕ ДАННЫХ

    РАЗНОЕ

    Передача статусов и сообщений на обработчик Клиента

    В личном кабинете Клиента в "Настройках пользователя" имеется возможность указания http-адреса (URL) скрипта для обработки статусов доставки SMS-сообщений и (или) входящих SMS-сообщений на стороне Клиента. Указанный скрипт будет вызываться Сервером после каждого получения статуса доставки ранее отправленного Клиентом SMS-сообщения и (или) после получения входящего SMS-сообщения от абонента.

    В адресе обработчика можно указать параметр charset для выбора кодировки передаваемых параметров: ?charset=utf-8
    ?charset=koi8-r
    ?charset=windows-1251     По умолчанию используется кодировка windows-1251.

    Для защиты передаваемых данных от подмены в адресе обработчика дополнительно можно указать любой из параметров md5, sha1, crc32, определяющих алгоритм подсчета контрольного параметра с хешем строки:
    "id:phone:status:<секретная строка>" − для статуса доставки
    "phone:mes:to:<секретная строка>" − для входящего сообщения     в виде:
    ?md5=<секретная строка>
    ?sha1=<секретная строка>
    ?crc32=<секретная строка>     В качестве символов секретной строки можно использовать латинские буквы, цифры, минус и подчеркивание. Обработчику будет передан соответствующий параметр, в котором секретная строка будет заменена на значение хеша передаваемых данных.

    Все параметры передаются методом POST.

    Передаваемые параметры для статуса SMS-сообщения:

    ПараметрЗначение
    idИдентификатор сообщения.
    phoneНомер телефона.
    statusСтатус сообщения.
    timeВремя изменения статуса (или доставки SMS-сообщения абоненту).
    Формат: DD.MM.YY hh:mm:ss (по часовому поясу, указанному в настройках).
    tsВремя изменения статуса в виде штампа в секундах.
    errКод ошибки, если сообщение не может быть доставлено (список). Передается, если не равен нулю.
    cntКоличество частей (при отправке SMS-сообщения) либо 5-секундных блоков (при голосовом сообщении (звонке)).
    typeТип сообщения (0 – SMS, 1 – Flash-SMS, 2 – Бинарное SMS, 3 – Wap-push, 4 – HLR-запрос, 5 – Ping-SMS, 6 – MMS, 7 – Звонок, 10 – Viber).
    senderИмя отправителя, отображаемое в телефоне получателя.
    dtmfПоследовательность символов, набираемая абонентом на цифровой клавиатуре во время прослушивания голосового сообщения (звонка).
    md5MD5-хеш строки "id:phone:status:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.
    sha1sha1-хеш строки "id:phone:status:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.
    crc32Контрольная сумма crc32 строки "id:phone:status:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.
    Дополнительные параметры для HLR-запросов
    imsiУникальный код IMSI SIM-карты абонента.
    mscНомер сервис-центра оператора, в сети которого находится абонент.
    mccЧисловой код страны абонента.
    mncЧисловой код оператора абонента.
    cnНазвание страны регистрации абонента.
    netНазвание оператора регистрации абонента.
    rcnНазвание роуминговой страны абонента при нахождении в чужой сети.
    rnetНазвание роумингового оператора абонента при нахождении в чужой сети.

    Передаваемые параметры для входящего SMS-сообщения:

    ПараметрЗначение
    idУникальный идентификатор входящего сообщения, назначаемый Сервером автоматически.
    sms_idИдентификатор сообщения, на которое получен ответ. Данный параметр отсутствует, если сообщение пришло не в качестве ответа (такие сообщения возможны при указании префикса "логин, двоеточие и пробел" либо при использовании выделенного входящего номера).
    phoneНомер телефона абонента.
    mesТекст SMS-сообщения.
    toВходящий номер телефона, на который было отправлено сообщение абонентом.
    sentВремя отправки сообщения абонентом в виде штампа в секундах.
    timeВремя получения сообщения Сервером в виде штампа в секундах.
    md5MD5-хеш строки "phone:mes:to:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.
    sha1sha1-хеш строки "phone:mes:to:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.
    crc32Контрольная сумма crc32 строки "phone:mes:to:<секретная строка>". Передается, если был указан в качестве дополнительного параметра в http-адресе обработчика.

    Помимо описанных выше стандартных параметров Сервер также будет передавать методом POST все параметры, указанные в http-адресе обработчика после знака "?".

    Для различия входящего сообщения и статуса в одном обработчике можно выполнить проверку на наличие параметра mes: if (isset($_POST["mes"])) {
            // message
    }
    else {
            // status
    }

    Пересылка статусов на обработчик Клиента осуществляется только при отправке SMS-сообщений по протоколам HTTP/HTTPS, SMTP или SMPP. При отправке сообщений с личного кабинета передача статусов на обработчик Клиента не происходит.




    =100% cellpadding=0>Изменение условий работы на отправку SMS-сообщений в сеть оператора Т2 (Россия)25.02.2025с 1 марта меняются условия работы на отправку SMS-сообщений в сеть оператора Т2 (Россия). С указанной даты оператор вводит обязательную бесплатную регистрацию имени отправителя. Сообщения, без зарегистрированного имени у клиента, будут блокироваться. Подать имя отправителя на регистрацию можно в личном кабинете, меню Настройки - Имена отправителей.