• Главная
  • Тарифы
  • Подключение (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)

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

    РАЗНОЕ

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

    Для отправки голосового сообщения необходимо вызвать методом GET или POST адрес: http://billing.smstraf.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=<message>&call=1
    При формировании сообщения можно указывать как текст, так и добавлять медиа-файлы форматов wav и mp3.

    Если планируется передача файлов, то их необходимо передавать методом POST в теле http-запроса к серверу. Позиции в тексте, в которые планируется вставлять файлы, необходимо обозначать специальным образом в виде "<file n>", где n - номер файла в формируемом списке начиная с единицы. Если не указывать позиции, то соответствующие файлы будут добавляться в конец сообщения.

    При создании сообщения можно вставлять в текст http-ссылки ранее загруженных файлов, узнать которые можно в личном кабинете на странице отправки, нажав последовательно ссылки "прикрепить файл" – "Загруженные файлы". Также можно указывать локальные ссылки на загруженные файлы на нашем сервере в виде "<file /upload/files/sms/каталог_загрузки/название_файла>".

    Так как телефонные линии не могут идеально проигрывать сложные медиа-файлы, то при формировании отправляемого сообщения передаваемые файлы преобразуются к простому формату.

    Максимальное количество вложений, передаваемых в запросе, равно четырем, и размер каждого вложения не должен превышать 3 Мб. При превышении указанных лимитов обрабатываемые вложения будут исключаться.

    Для передачи своего номера телефона в качестве имени отправителя необходимо указать его в параметре sender. Указанный номер прежде должен быть добавлен и активирован в личном кабинете на данной странице.

    При формировании запроса можно передавать специальный параметр param, в котором задаются некоторые характеристики звонка (более подробно можно ознакомиться в описании). Также дополнительно в запросе можно передать параметр voice, который определяет голос, используемый для озвучивания текста. Данный параметр может принимать следующие значения:
    • voice = m – мужской голос.
    • voice = m2 – мужской альтернативный голос.
    • voice = w – женский голос.
    • voice = w2 – женский альтернативный голос 1.
    • voice = w3 – женский альтернативный голос 2.
    • voice = w4 – женский альтернативный голос 3.

    Отправка кода в телефонном номере

    При необходимости отправки цифрового кода для подтверждения определенных операций с помощью телефонного номера (например, при регистрации нового пользователя, оформлении заказа, получении доступа к различным сервисам и т.п.) вместо отправки SMS-сообщения можно воспользоваться более дешевым способом передачи кода в номере телефона входящего звонка.

    Чтобы передать код в телефонном номере необходимо отправить абоненту специальное голосовое сообщение (звонок) со словом code. При получении звонка абонент может его сбросить или поднять трубку. При поднятии трубки система сама сбросит звонок. Последние 6 цифр номера, с которого пришел звонок, будут являться секретным кодом, его необходимо использовать абоненту для подтверждения операции. Также возможно использование более короткого кода из номера, указав количество цифр в инструкции для пользователей на своем сайте.

    Для отправки указанного кода через API необходимо выполнить запрос на отправку голосового сообщения, получить сгенерированный код из ответа системы и сохранить его на своей стороне. Именно этот код придет абоненту в телефонном номере при звонке и потребуется для подтверждения операции.

    Формат запроса и ответ Сервера: http://billing.smstraf.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=code&call=1
    В случае успешной обработки запроса возвращается строка следующего вида (в стандартный ответ Сервера добавляется параметр code):
    • при fmt = 0: OK - <n> SMS, ID - <id>, CODE - <code>

    • при fmt = 1: <id>,<n>,<code>

    • при fmt = 2 (xml):
      <result>
      <id>id</id>
      <cnt>n</cnt>
      <code>code</code>
      </result>

    • при fmt = 3 (json):
      {
      "id": <id>,
      "cnt": <n>,
      "code": <code>
      }

      При использовании данной функции нельзя передавать параметр voice, так как при его явной передаче в запросе произойдет обычное озвучивание текста сообщения.

      Примеры отправки голосовых сообщений

      Примеры:

      Отправка голосового сообщения с текстом "Hello":

      http://billing.smstraf.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1
      Отправка голосового сообщения с текстом "Hello" от номера телефона "79991234567":

      http://billing.smstraf.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1&sender=79991234567
      Отправка голосового сообщения с текстом "Hello world", озвученным мужским голосом, с временем ожидания снятия трубки 20 секунд, интервалом повтора 10 секунд и количеством попыток дозвона равным 3:

      http://billing.smstraf.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello%20world&call=1& voice=m&param=20%2C10%2C3
      Отправка голосового сообщения с текстом "Hello world", озвученным женским альтернативным голосом:

      http://billing.smstraf.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello%20world&call=1&voice=w2
      Отправка голосового сообщения с текстом и двумя звуковыми файлами через библиотеку на основе cURL:

      <?php
      include "smsc_api.php";
      send_sms("79999999999", "first file <file 1> and second file <file 2>", 0, 0, 0, 9, false, "", array("/home/alex/1.mp3", "/home/alex/2.wav"));
      ?>