GetTranscribation

Метод GetTranscribation

Примените этот метод для получения текстовой расшифровки звонка. Для этого выполните POST-запрос с входными параметрами к точке подключения, указанными ниже.

Точка подключения:

POST: https://api.exolve.ru/statistics/call-record/v1/GetTranscribation

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

ИмяТипОписание
AuthorizationstringAPI-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

ПараметрТипОписание
uiduint64идентификатор звонка

Выходные параметры

ПараметрТипОписание
urlstringURL-адрес для отправки события о готовности текстовой расшифровки звонка
uiduint64идентификатор вызова
application_uuidstringидентификатор приложения, с номера которого был совершён звонок
date_timestringдата звонка в формате RFC-3339 / ISO-8601
number_astringномер звонящего абонента
number_bstringномер принимающего вызов абонента
redirect_numberstringномер для переадресации
durationuint32длительность разговора
chunksChunksтекстовая расшифровка, разбитая на реплики участников звонка

Chunks

ПараметрТипОписание
channel_taguint64канал связи (1 — звонящий абонент, 2 — отвечающий абонент)
textstringтекст реплики
start_timeuint64время начала фразы в секундах
end_timeuint64время конца фразы в секундах

Возможные ошибки

КодСтатусПример сообщенияОписание
400Bad Requestinvalid value [value]в поле uid невалидный формат
401Bad Requesterror while trying to get token from headerнет заголовка авторизации
401Bad Requestfailed to parse tokenневалидный API-ключ
404Bad Requestnot found transcribation with uidнет текстовой расшифровки по этому идентификатору звонка
404Not Foundinvalid uid or application uuidневерный идентификатор звонка

Примеры

Входные параметры:

{
    "uid": 7143406780209569792
}

Выходные параметры:

{
    "transcribation": [
{
    "url": "",
    "uid": "7143406780209569792",
    "application_uuid": "178ec145-6898-4b06-a92a-75f63cb57046",
    "date_time": "2023-12-21T01:09:10Z",
    "number_b": "74991112233",
    "calling_number": "79994445566",
    "number_a": "79997778899",
    "duration": 39,
    "call_start": "2023-12-13T14:26:44Z",
    "call_end": "2023-12-13T14:30:44Z",
    "chunks": {
        "channel_tag": "1",
            "text": "привет",
            "start_time": {
                "seconds":0
                },
            "end_time": {
                "seconds":0
                }
            }
        }
    ]
}