Start employee call
Вызов на сотрудника
| Метод | start.employee_call |
|---|---|
| Версия API | v4.0 |
| Описание | Метод создает прямой звонок абонента с сотрудником без использования сценария. |
| Вернуться к списку методов | |
Параметры запроса
| Название | Тип | Обязательный | Допустимые значения | Описание | |
|---|---|---|---|---|---|
| access_token | string | да | Ключ сессии аутентификации | ||
| first_call | string | да | contact, employee |
Определяет номер, на который нужно дозвониться в первую очередь:
|
|
| switch_at_once | boolean | нет | true, false |
Значение по умолчанию Если параметр
Если параметр
Если в параметре |
|
| early_switching | boolean | нет | true, false |
Значение по умолчанию Если параметр имеет значение К примеру, оператор ждет дозвона до абонента, а абонент недоступен и у него сработала голосовая почта, то при активации параметра Параметр может иметь значение |
|
| media_file_id | number | нет |
Значение по умолчанию - системная мелодия "Музыка переадресации" ( Задает идентификатор звукового файла для музыки переадресации. Файл может быть как системным, так и пользовательским. Получить список системных или пользовательских файлов можно с помощью DATA API - Получение списка пользовательских файлов, Получение списка системных файлов. Проигрывается всегда тому плечу, для которого не задан один из параметров |
||
| virtual_phone_number | string | да |
Виртуальный номер, арендуемый клиентом. Формат номера должен соответствовать международному
стандарту E.164 (например, |
||
| virtual_phone_usage_rule | string | нет |
Правило использования виртуального номера. Позволяет динамически менять виртуальный номер при звонке. Если подходящий номер,
удовлетворяющий выбранному правилу, не найден, то будет использован номер, указанный в параметре
По умолчанию используется правило |
||
| show_virtual_phone_number | boolean | нет | true, false |
Значение по умолчанию Показывать ли виртуальный номер, заданный параметром |
|
| contact | string | да |
Номер абонента на который совершается вызов. Формат номера должен соответствовать
международному стандарту E.164 (например, Внутренние номера сотрудников не поддерживаются. |
||
| external_id | string | нет | Уникальный идентификатор, который может быть использован для связи события звонка с внешней системой. | ||
| dtmf_string | string | нет | 0-9, *, # | Задает DTMF, который будет отправлен абоненту, заданному в параметре contact. С
помощью символа . = '1 секунда' можно задать таймаут по истечению которого символ DTMF будет отправлен. Пример: .12.1..4, т.е через 1 секунду
будет отправлена цифра 12, далее через 1 секунду будет отправлена цифра 1 и через 2 секунды цифра 4.
|
|
| direction | string | нет | in, out | Значение по умолчанию in. Определяет направление звонка in - Входящий звонок, out - Исходящий звонок.
|
|
Сотрудник с которым будет соединен абонент из параметра contact
|
|||||
| employee | object | да | Сотрудник с которым будет соединен абонент, указанный в параметре contact. |
||
| id | number | да |
Уникальный идентификатор сотрудника. Данный идентификатор можно получить с помощью DATA API - Получение информации о сотруднике
Если не указан параметр
|
||
| phone_number | string | нет |
Задает номер сотрудника с которым будет соединен абонент указанный в параметре |
||
Сообщение для проигрывания абоненту, который задан в параметре contact
|
|||||
| contact_message | object | нет |
Определяет параметры сообщения, которое необходимо проиграть абоненту заданному в параметре После окончания проигрывания сообщения, будет проигрываться покругу сообщение из параметра
|
||
| type | string | да | media, tts |
Определяет тип сообщения. |
|
| value | string | да |
Если поле Если поле Длина TTS сообщения регулируется тарифным планом и установленным лимитом. |
||
Сообщение для проигрывания абоненту, который задан в параметре employee
|
|||||
| employee_message | object | нет |
Определяет параметры сообщения, которое необходимо проиграть абоненту заданному в параметре После окончания проигрывания сообщения, будет проигрываться покругу сообщение из параметра
|
||
| type | string | да | media, tts |
Определяет тип сообщения. |
|
| value | string | да |
Если поле Если поле Длина TTS сообщения регулируется тарифным планом и установленным лимитом. |
||
Параметры ответа
| Название | Тип | Обязательный | Описание |
|---|---|---|---|
| call_session_id | number | да | Уникальный идентификатор сессии звонка |
Пример запроса
{
"jsonrpc": "2.0",
"method": "start.employee_call",
"id": "req1",
"params": {
"access_token": "2fRN4g217ca0b4224a67988aff3e584f91964a692045415f36fa66146f5a3c1ae1f6093d",
"first_call": "employee",
"switch_at_once": true,
"media_file_id": 2701,
"show_virtual_phone_number": false,
"virtual_phone_number": "74993720692",
"external_id": "334otr01",
"dtmf_string": ".1.2.3",
"direction": "in",
"contact": "79260000000",
"employee": {
"id": 25,
"phone_number": "79260000001"
},
"contact_message": {
"type": "tts",
"value": "Привет"
},
"employee_message": {
"type": "media",
"value": "2561"
}
}
}
Пример ответа
{
"jsonrpc": "2.0",
"id": "req1",
"result": {
"data": {
"call_session_id": 237859081
}
}
}
Список возвращаемых ошибок
| Текст ошибки | Код ошибки | Мнемоника | Описание |
|---|---|---|---|
The maximum length of Text-to-Speech message is {tts_message_max_length}. The length of your message is {sent_tts_message_length} |
-32602 | tts_text_exceeded |
Длина сообщения превысила допустимое ограничение, установленное тарифным планом |
The media file with id {media_file_id} not found |
-32602 | media_file_not_found |
|
Virtual phone number {virtual_phone_number} not found. It is not your virtual phone number. |
-32007 | virtual_phone_number_not_found |
Если используется виртуальный номер не принадлежащий клиенту |
Employee with id {employee_id} not found. It is not your employee. |
-32602 | employee_not_found |
|
| The phone number does not exist or inactive | -32602 | no_active_phone_number |
У сотрудника нет активных номеров в настройках сотрудника |
Parameter contact can not contain own virtual phone number |
-32602 | own_virtual_phone_number_not_allowed |
Звонок на собственный виртуальный номер запрещен |
The contact {contact} has been found in the blacklist |
-32002 | contact_in_blacklist |
|
| The character encoding must be UTF-8 | -32602 | character_encoding_not_allowed |
См. также раздел "Список ошибок общих для всех методов"