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.

Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.