Метод 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
}
Выходные параметры:
{}