|
8 (800) 080 7672 Бесплатно по Казахстану |
API позволяет рассылать сообщения через ваши проекты и сервисы по протоколам HTTP/HTTPS, SMTP и SMPP. Готовые библиотеки на разных языках программирования подключаются к вашему проекту и помогают отправлять сообщения из любого места с помощью одной команды.
ОТПРАВКА СООБЩЕНИЙ Отправка SMS-сообщения УПРАВЛЕНИЕ РАССЫЛКАМИКомментарии в SMS-сообщениях Отправка на группу номеров Отправка HLR-запроса Отправка MMS-сообщения Отправка e-mail сообщения Отправка голосового сообщения (звонок) Отправка viber-сообщения Отправка telegram-сообщения Использование префиксов при отправке сообщений Управление шаблонами сообщений Управление шаблонами операторов Виртуальная отправка (режим тестирования) Уведомления о событиях СТАТУСЫ СООБЩЕНИЙ Проверка статуса ПРОВЕРКА СОСТОЯНИЯ БАЛАНСАСтатусы сообщений. Ответ сервера и коды ошибок Коды статусов Коды ошибок в статусе Удаление сообщения УПРАВЛЕНИЕ КОНТАКТАМИ Действия с контактами и группами УПРАВЛЕНИЕ КЛИЕНТАМИКонтакты и группы. Ответ сервера и коды ошибок Примеры операций с контактами Работа с субклиентами УПРАВЛЕНИЕ ИМЕНАМИ ОТПРАВИТЕЛЕЙ (SENDER ID)Создание и выгрузка счетов и актов Перечень доступных операций с именами отправителей ПОЛУЧЕНИЕ ДАННЫХОтвет сервера и коды ошибок Примеры действий с именами отправителей Получение истории отправленных сообщений РАЗНОЕПолучение входящих сообщений Получение статистики Запрос тарифов Получение информации об операторе Получение данных о короткой ссылке | Отправка голосового сообщения (звонок)Для отправки голосового сообщения необходимо вызвать методом GET или POST адрес:
https://smsc.kz/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)-адрес файла. В этом случае передача в запросе параметра mes необязательна. Так как телефонные линии не могут идеально проигрывать сложные медиа-файлы, то при формировании отправляемого сообщения передаваемые файлы преобразуются к простому формату. При отправке голосового сообщения первоначальное время и стоимость рассчитываются приблизительно. После отправки и прослушивания сообщения абонентом продолжительность и стоимость звонка корректируются либо в меньшую сторону (например, если абонент не дослушал сообщение до конца), либо, если длительность сообщения превышает рассчитанную, то разница в секундах указывается в комментарии к сообщению в виде дополнительного времени overtime, которое в том числе отображается в детализации в виде отдельной записи. Также overtime может возникать при использовании голосового меню (IVR). Максимальное количество вложений, передаваемых в запросе, равно четырем, и размер каждого вложения не должен превышать 5 Мб. При превышении указанных лимитов обрабатываемые вложения будут исключаться. Для передачи своего номера телефона в качестве имени отправителя необходимо указать его в параметре sender. Указанный номер прежде должен быть добавлен и активирован в личном кабинете на данной странице. При формировании запроса можно передавать специальный параметр param, в котором задаются некоторые характеристики звонка (более подробно можно ознакомиться в описании). Также дополнительно в запросе можно передать параметр voice, который определяет голос, используемый для озвучивания текста. Данный параметр может принимать следующие значения:
Использование голосового меню (IVR)Для использования голосового меню необходимо в начале текста сообщения передать текст или голосовой файл с начальными инструкциями для абонента и далее указать макрос, содержащий служебные команды меню {menu: <...>}, где <...> описание параметров голосового меню.Схематично сообщение с использованием голосового меню, выглядит следующим образом: СТАРТОВЫЙ ТЕКСТ
После поднятия трубки абоненту озвучивается "СТАРТОВЫЙ ТЕКСТ", далее проигрывается "ТЕКСТ МЕНЮ" с описанием пунктов меню и допустимыми действиями. После нажатия клавиши на цифровой клавиатуре телефона, соответствующей необходимому пункту, абоненту может быть озвучен текст "ТЕКСТ" или выполнена одна или несколько следующих друг за другом "КОМАНД". После выхода из меню озвучивается "КОНЕЧНЫЙ ТЕКСТ". Описание параметров, используемых в макросе {menu: <...>}:
В пунктах и подпунктах можно использовать следующие команды:
<?php Примеры отправки голосовых сообщенийПримеры:Отправка голосового сообщения с текстом "Hello": https://smsc.kz/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1 Отправка голосового сообщения с текстом "Hello" от номера телефона "79991234567": https://smsc.kz/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello&call=1&sender=79991234567 Отправка голосового сообщения с текстом "Hello world", озвученным мужским голосом, с временем ожидания снятия трубки 20 секунд, интервалом повтора 10 секунд и количеством попыток дозвона равным 3: https://smsc.kz/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello%20world&call=1&voice=m¶m=20%2C10%2C Отправка голосового сообщения с текстом "Hello world", озвученным женским альтернативным голосом: https://smsc.kz/sys/send.php?login=alex&psw=123&phones=79999999999&mes=Hello%20world&call=1&voice=w2 Отправка голосового сообщения с прикрепленным через параметр fileurl голосовым файлом: https://smsc.kz/sys/send.php?login=alex&psw=123&phones=79999999999&call=1&fileurl=http://mysite.com/voice.wav Отправка голосового сообщения с текстом и двумя звуковыми файлами через библиотеку на основе cURL: <?php |
© 2003–2024 ТОО «СМС-центр» Рег.номер 2207-1910-01-ТОО | support@smsc.kz Контакты | Дизайн — Студия Артемия Лебедева Информация о сайте |