SetSpeechAnalyticsState
Метод SetSpeechAnalyticsState
Примените этот метод для включения и отключения функции речевой аналитики звонков. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.
Услуга подключается бесплатно. Плата списывается с баланса аккаунта за каждую расшифрованную и проанализированную минуту разговора после завершения вызова. Длительность записи разговора при тарификации округляется до следующей минуты. Так, 15-секундная запись округлится до 1 минуты. Посмотреть тарифы
Точка подключения:
POST: https://api.exolve.ru/number/v1/SetSpeechAnalyticsState
Авторизация
Передайте следующие Заголовки HTTP для успешной авторизации.
Имя | Тип | Описание |
---|---|---|
Authorization | string | API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0 , где e***s0 замените на API-ключ вашего приложения |
Входные параметры
Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, обязательны.
Параметр | Тип | Описание |
---|---|---|
number_code | uint64 | купленный номер |
speech_analytics | boolean | True для включения речевой аналитики звонков. False для отключения речевой аналитики звонков |
Примечание
Чтобы включить услугу речевой аналитики звонков на номере, убедитесь, что услуга уже подключена в настройках приложения в Личном кабинете разработчика. Также на номере должна быть подключена услуга хранения записей разговоров. Подключить её можно в Личном кабинете в карточке номера/SIP ID или с помощью методов Call Record API.
Выходные параметры
Пустой JSON с 200 OK статусом.
Возможные ошибки
Код | Статус | Пример сообщения | Описание |
---|---|---|---|
401 | Unauthorized | Unauthorized | отсутствует/невалидный API-ключ |
400 | Bad Request | Error setting speech analytics: number is missing in the application | номер не принадлежит приложению |
400 | Bad Request | invalid value | невалидный формат данных |
Примеры
Входные параметры:
{
"number_code": 79991112233,
"speech_analytics": true
}
Выходные параметры:
{}