Настройки расшифровки

Настройки определяют, какие звонки расшифровываются автоматически.

Объект настроек

{
    "id": 17,
    "amocrm_id": 31245678,
    "settings": {
        "model": "whisper",
        "mode": "auto",
        "onIncoming": {
            "active": true,
            "durationFrom": 20,
            "durationTo": 1800,
            "responsibles": [{ "name": "Иван Петров", "responsibleId": 101, "groupId": 0 }]
        },
        "onOutgoing": { "active": false, "durationFrom": 0, "durationTo": 0, "responsibles": [] },
        "onDelay": { "active": false, "duration": 0 },
        "hints": "Пример, тариф «Бизнес», личный кабинет",
        "notifyOnTranscription": false,
        "insights": { "enabled": false },
        "engine": "diarize"
    },
    "created_at": "2026-09-01T08:00:00.000Z",
    "updated_at": "2026-10-19T11:00:00.000Z"
}

Поле `settings`	Тип	Описание
`onIncoming`, `onOutgoing`	object	Правила для входящих и исходящих звонков
`….active`	bool	Расшифровывать звонки этого направления
`….durationFrom`, `….durationTo`	int	Диапазон длительности в секундах, границы включаются. Диапазон не применяется, если `durationFrom` не меньше `durationTo`
`….responsibles`	object[]	Сотрудники, чьи звонки расшифровываются: `responsibleId` — ID пользователя amoCRM, `groupId` — ID его группы, `name` — имя. Пустой список — все сотрудники
`onDelay.active`, `onDelay.duration`	bool, int	Задержка перед расшифровкой, в минутах
`hints`	string	Слова и названия, которые встречаются в разговорах, — помогают распознать их точнее
`notifyOnTranscription`	bool	Отправлять событие `audio-transcribed` по WebSocket. По умолчанию `false`
`insights.enabled`	bool	Анализ тем и итогов разговоров. Управляется методами аналитики
`engine`	string	Как разговор делится на реплики: `diarize` (по умолчанию) — говорящие определяются автоматически; `channels` — для стереозаписей, где каждый говорящий на своём канале. Моно-запись всегда обрабатывается как `diarize`
`managerChannel`	int	`0` или `1` — канал стереозаписи с менеджером. Если указан, реплики подписываются `manager` и `client`
`model`, `mode`	string	Служебные значения, оставьте по умолчанию

Получить настройки

GET /api/v1/settings/transcription/{amocrmId}

Ответ 200 — объект настроек. Если аккаунт ещё ничего не сохранял, возвращаются настройки по умолчанию: автоматическая расшифровка выключена для обоих направлений.

Сохранить настройки

POST /api/v1/settings/transcription/{amocrmId}

Тело — объект settings или его часть. Ключи верхнего уровня, которых нет в теле, сохраняют прежние значения; переданный ключ заменяет прежнее значение целиком, включая вложенные объекты.

curl -X POST "{base_url}/api/v1/settings/transcription/31245678" \
  -H "Content-Type: application/json" \
  -d '{
    "onIncoming": { "active": true, "durationFrom": 20, "durationTo": 1800, "responsibles": [] },
    "notifyOnTranscription": true
  }'

Ответ 200 — сохранённый объект настроек.