Данный функционал позволяет отправлять SMS коды голосовым роботом. Поступает звонок, цифры кода робот диктует голосом.
Вы формируете проверочный код на своей стороне, например, 5566, также как это делается при отправке обычных сообщений вида "Ваш код авторизации: 5566",
Отправляете указанный текст, также как при отправке обычной SMS метод push_msg, далее, на стороне платформы вырезаются цифры 5566 и абоненту поступает входящий вызов со случайного номера и голосом диктуется код авторизации.
Важно! Перед отправкой кода голосом необходимо предупредить абонента, что вместо обычной SMS он получит входящий звонок, абоненту необходимо ответить и прослушать код авторизации.
Чтобы отправить SMS-код с помощью голосового робота, необходимо использовать метод метод push_msg, который используется для отправки обычной SMS, при этом в запрос добавляете дополнительный параметр route=vc, где vc - (сокращенно от Voice Code) значение, отвечающее за отправку SMS-кода голосовым роботом.
Более подробное описание всех параметров смотрите в документации.
<?php
//**************************
//ПРИМЕР ОТПРАВКИ авторизационного кода голосовым роботом на PHP
//**************************
include_once ("ssms_su.php");
// Пример 1
// в этом примере для аутентификации на сервере используется API KEY (рекомендуется, т.к. надежнее, Вы не передаете логин и пароль в открытом виде)
// API KEY можно запросить в личном кабинете в разделе "НАСТРОЙКИ" -> "API и Интеграция"
// (доступно после активации SMS-шлюза)
$key = 'XXXXyyXYXYXyXyXyXyXY'; // API KEY будет выдан при подключении
$phone = '7905XXXXXXX'; // Телефон абонента в любом формате, 11 цифр
$text = 'Ваш код - '.rand(1000,9999);
$dop_arr["sender_name"] = 'MyBrand'; // Обязательный параметр, Ваше имя необходимо добавить в ЛК в раздел Отправители.
$dop_arr["route"] = 'vc'; // Этот параметр используется для отправки SMS кода голосовым роботом. Если его закомментировать - будет отправлено обычное SMS сообщение.
$result = smsapi_push_msg_nologin_key($key, $phone, $text, $dop_arr);
var_dump($result);
// В результате выполнения запроса Вы получите массив $result, который будет содержать следующие параметры:
array(4) {
[0]=>
int(0) // Код ошибки (0 - выполнено успешно, СМС отправлена)
[1]=>
int(1) // Количество частей СМС
[2]=>
string(4) "1.29" // Стоимость
[3]=>
int(8213301) // ID SMS на стороне SMS-шлюза
}
?>