| Отправка голосового сообщения (звонок)Для отправки голосового сообщения необходимо вызвать методом GET или POST адрес:
http://s1.sm-s.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=<message>&call=1
При формировании сообщения можно указывать как текст, так и добавлять медиа-файлы форматов wav и mp3.
Если планируется передача файлов, то их необходимо передавать методом POST в теле http(s)-запроса к серверу. Позиции в тексте, в которые
планируется вставлять файлы, необходимо обозначать специальным образом в виде "<file n>", где n - номер файла в формируемом списке
начиная с единицы. Если не указывать позиции, то соответствующие файлы будут добавляться в конец сообщения.
При создании сообщения можно вставлять в текст http(s)-ссылки ранее загруженных файлов, узнать которые можно в личном кабинете на странице
отправки, нажав последовательно ссылки "прикрепить файл" – "Загруженные файлы". Также можно указывать локальные ссылки на загруженные файлы
на нашем сервере в виде "<file /upload/files/sms/каталог_загрузки/название_файла>". Для загрузки файла из внешнего источника можно в запросе передавать
дополнительный параметр fileurl, содержащий полный http(s)-адрес файла.
Так как телефонные линии не могут идеально проигрывать сложные медиа-файлы, то при формировании отправляемого сообщения передаваемые
файлы преобразуются к простому формату.
Максимальное количество вложений, передаваемых в запросе, равно четырем, и размер каждого вложения не должен превышать 3 Мб. При превышении
указанных лимитов обрабатываемые вложения будут исключаться.
Для передачи своего номера телефона в качестве имени отправителя необходимо указать его в параметре sender. Указанный номер прежде
должен быть добавлен и активирован в личном кабинете на данной странице.
При формировании запроса можно передавать специальный параметр param, в котором задаются некоторые характеристики звонка
(более подробно можно ознакомиться в описании). Также дополнительно в запросе можно передать параметр voice,
который определяет голос, используемый для озвучивания текста. Данный параметр может принимать следующие значения:
- voice = m – мужской голос.
- voice = m2 – мужской альтернативный голос.
- voice = w – женский голос.
- voice = w2 – женский альтернативный голос.
Отправка кода в телефонном номереПри необходимости отправки цифрового кода для подтверждения определенных операций с помощью телефонного номера (например, при регистрации нового пользователя, оформлении заказа, получении доступа к различным сервисам и т.п.) вместо отправки SMS-сообщения можно воспользоваться более дешевым способом передачи кода в номере телефона входящего звонка.
Чтобы передать код в телефонном номере необходимо отправить абоненту специальное голосовое сообщение (звонок) со словом code. При получении звонка абонент может его сбросить или поднять трубку. При поднятии трубки система сама сбросит звонок. Последние 6 цифр номера, с которого пришел звонок, будут являться секретным кодом, его необходимо использовать абоненту для подтверждения операции.
Также возможно использование более короткого кода из номера, указав количество цифр в инструкции для пользователей на своем сайте.
Для отправки указанного кода через API необходимо выполнить запрос на отправку голосового сообщения, получить сгенерированный код из ответа системы и сохранить его на своей стороне. Именно этот код придет абоненту в телефонном номере при звонке и потребуется для подтверждения операции.
Формат запроса и ответ Сервера:
http://s1.sm-s.ru/sys/send.php?login=<login>&psw=<password>&phones=<phones>&mes=code&call=1
В случае успешной обработки запроса возвращается строка следующего вида (в стандартный ответ Сервера добавляется параметр code):
|