начало входящего звонка в АТС
Параметры, которые отправляются на ссылку для уведомлений:
- event – событие (NOTIFY_START)
- call_start – время начала звонка;
- pbx_call_id – id звонка;
- caller_id – номер звонящего;
- called_did – номер, на который позвонили.
Составление проверочной подписи для уведомления о входящих звонках, пример на PHP:
Ответ
Ответ:
$signatureTest = base64_encode(hash_hmac('sha1',
$_POST['caller_id'] . $_POST['called_did'] .
$_POST['call_start'], API_SECRET));
Для запросов NOTIFY_START и NOTIFY_IVR можно «на лету» изменять сценарий работы по текущему звонку, отправив в ответ один из следующих вариантов:
Воспроизвести файл:
Ответ 1
Ответ 1:
{
"ivr_play": "ID"
}
Где:
- ivr_play – значение из колонки ID в списке загруженных/начитанных файлов для нужного файла.
Воспроизвести популярную фразу:
Ответ 2
Ответ 2:
{
"ivr_saypopular": 1,
"language": "en"
}
Где:
- ivr_saypopular – номер фразы из списка;
Воспроизвести цифры:
Ответ 3
Ответ 3:
{
"ivr_saydigits": "12",
"language": "en"
}
Воспроизвести число (в соответствии с правилами сложных числительных):
Ответ 4
Ответ 4:
{
"ivr_saynumber": "123",
"language": "en"
}
Где:
- language может принимать одно из значений: ru, en, es, pl;
Если были указаны ivr_saydigits или ivr_saynumber, в следующем событии NOTIFY_IVR будет добавлен параметр:
"ivr_saydigits": "COMPLETE" или "ivr_saynumber": "COMPLETE"
В каждом из указанных запросов выше может присутствовать запрос ввода цифр от абонента:
Ответ 5
Ответ 5:
{
"wait_dtmf": {
"timeout": TIMEOUT,
"attempts": ATTEMPTS,
"maxdigits": MAXDIGITS,
"name": NAME,
"default": DEFAULT,
}
}
Где:
- timeout - время ожидания ввода цифр в секундах;
- attempts - количество попыток набора цифры от абонента;
- maxdigits - максимальное количество цифр, ввода которых дожидаться;
- name - имя, которое будет возвращено в ответе;
- default - действие, если не было набрано ни одной цифры. Возможные значения:
- id сценария редиректа (в формате 0-1, где 0 - номер голосового меню, 1 - номер сценария);
- меню АТС в формате 0-main, где 0 - это id меню;
- внутренний номер АТС (трехзначный номер);
- hangup - закончить звонок.
В следующем событии NOTIFY_IVR будет дополнительно указан параметр:
Ответ 6
Ответ 6:
{
"wait_dtmf": {
"name": NAME,
"digits": DIGITS,
"default_behaviour": "1"
}
}
Где:
- name - имя, указанное в предыдущем ответе;
- digits - цифры, введенные абонентом;
- default_behaviour - указано, если абонент ничего не нажал и сработало поведение по умолчанию;
Перевести звонок:
Ответ 7
Ответ 7:
{
"redirect": ID,
"return_timeout": TIMEOUT (необязательное)
}
Где:
- redirect - id сценария редиректа (в формате 0-1, где 0 - номер голосового меню, 1 - номер сценария); или в формате 1, где 1 - номер сценария(номер голосового меню в этом случае 0); или меню АТС в формате 0-main, где 0 - это id меню; или внутренний номер АТС (трехзначный номер); или "blacklist" - в этом случае звонок будет отклонен с сигналом занято;
- return_timeout - Значение в секундах. Возможные значения:
- 0, звонок не вернется на меню;
- >= 3 - продолжительность звонка внутреннего номер, прежде чем звонок вернется на меню;
Завершить звонок:
Ответ 8
Ответ 8:
{
"hangup": 1
}
В каждом из ответов можно дополнительно указать:
Задать имя для имя входящего номера:
Ответ 9
Ответ 9:
{
"caller_name": NAME
}
Где:
- caller_name - имя номера.
Списки популярных фраз:
- Здравствуйте
- Добрый день
- Переадресация
- Звонок с сайта
- Добро пожаловать
- Тестовое сообщение
- Оставайтесь на линии
- Вы позвонили в нерабочее время
- Сейчас все менеджеры заняты, вам ответит первый освободившийся оператор.
- Наберите внутренний номер абонента
- Наберите внутренний номер сотрудника
- Наберите добавочный номер
- Пожалуйста ожидайте
- Наберите внутренний номер или дождитесь ответа оператора
- Пожалуйста оставьте сообщение
- Оставьте ваше сообщение после сигнала
- Перезвоните пожалуйста в рабочее время
- Благодарим за обращение в нашу компанию.
- Спасибо за звонок.
- Ожидайте ответа оператора
- Ваш звонок очень важен для нас
- Разговор записывается
- В данный момент нас нет в офисе
- Мы перезвоним вам при первой возможности.
- Сегодня у нас выходной.