telephony.externalcall.finish

Scope: telephony Права на выполнение: для всех

Метод завершает звонок, фиксирует его в статистике, скрывает у пользователя карточку звонка.

Возвращаемое значение

Метод возвращает массив, аналогичный методу voximplant.statistic.get.

Параметры функции

Параметр	Описание	Тип значения
CALL_ID	Идентификатор звонка из метода telephony.externalcall.register. Обязательный.	string
USER_ID	Идентификатор пользователя. Обязательный. Ответственный в лиде будет изменен на переданный USER_ID. Ответственный будет меняться только для лида, созданного автоматически при вызове метода telephony.externalcall.register. Для существующего лида ответственный не меняется.	int
DURATION	Длительность в сек. Обязательный.	int
COST	Стоимость звонка.	double
COST_CURRENCY	Валюта, в которой указана стоимость звонка. Список валют можно получить методом crm.currency.list.	string
STATUS_CODE	Код вызова (см. таблицу кодов вызова).	string
FAILED_REASON	Причина несостоявшегося звонка.	string
RECORD_URL	URL файла (желательно mp3, возможен flac) с записью звонка. Портал осуществит две попытки скачать запись по указанному адресу. В случае неудачи, запись приложена не будет и никакого уведомления об ошибке отправлено не будет. Данный параметр является устаревшим и оставлен исключительно для обратной совместимости. Использовать его крайне не рекомендуется. Для загрузки записи звонка используйте метод telephony.externalCall.attachRecord.	string
VOTE	Оценка звонка пользователем (если АТС поддерживает функционал оценки разговора).	int
ADD_TO_CHAT	Добавлять ли сообщение о совершенном звонке сотруднику Б24 в чат (Возможные значения 0 или 1, по умолчанию 0).	int

Вместо USER_ID также может принимать USER_PHONE_INNER.