Гарантия лучшей цены!
Нашли дешевле? Сделаем дешевле и вернем 10% от разницы.
Узнать подробности
Партнерская программа
Довольны нашим сервисом? Рекомендуйте нас и получайте бонусы.
Узнать подробности

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


Для отправки голосового сообщения необходимо вызвать методом GET или POST адрес:
http://cab.sms34.ru/sys/send.php?login=&psw=&phones=&mes=&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://cab.sms34.ru/sys/send.php?login=&psw=&phones=&mes=code&call=1
					  

В случае успешной обработки запроса возвращается строка следующего вида (в стандартный ответ Сервера добавляется параметр code):

- при fmt = 0:
OK - <n> SMS, ID - <id>, CODE - <code>
					  
- при fmt = 1:
<n>,<id>,<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://cab.sms34.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1
                      
Отправка голосового сообщения с текстом "Hello" от номера телефона "79991234567":
http://cab.sms34.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1&sender=79991234567
                      
Отправка голосового сообщения с текстом "Hello world", озвученным мужским голосом, с временем ожидания снятия трубки 20 секунд, интервалом повтора 10 секунд и количеством попыток дозвона равным 3:
http://cab.sms34.ru/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello%20world&call=1& voice=m¶m=20%2C10%2C3
                      
Отправка голосового сообщения с текстом "Hello world", озвученным женским альтернативным голосом:
http://cab.sms34.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  and second file ", 0, 0, 0, 9, false, "", array("/home/alex/1.mp3", "/home/alex/2.wav"));
?>
                      

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

Для отправки голосового сообщения используйте команду SUBMIT_SM с текстом "__CALL__: < message >\nvoice:< voice >" (текст "__CALL__", двоеточие, пробел, текст сообщения, перевод строки, слово "voice", двоеточие, голос, используемый для озвучивания текста).

Возможные значения для используемого голоса:

m (по умолчанию) – мужской голос.
m2 – мужской альтернативный голос.
w – женский голос.
w2 – женский альтернативный голос 1.
w3 – женский альтернативный голос 2.
w4 – женский альтернативный голос 3.

При отправке голосового сообщения в конце текста можно указать специальную комбинацию "\n~~~\n" (перевод строки, 3 символа тильды и снова перевод строки), после которой передать параметр param, определяющий некоторые характеристики звонка.

Спецификация XML шлюза

XML (eXtensible Markup Language) - Расширяемый язык разметки. Спецификация XML описывает XML-документы и частично описывает поведение XML-обработчиков. Язык называется расширяемым, поскольку он не фиксирует разметку, используемую в документах: разработчик волен создать разметку в соответствии с потребностями к конкретной области, будучи ограниченным лишь синтаксическими правилами языка.
Протокол XML подразумевает обмен запросами на языке XML. Обмен информацией происходит через соединение TCP/IP по протоколу HTTP или HTTPS (HTTP over SSL) методом POST.
Cкачать полную спецификацю протокола.