# Follow-up звонков

> **Методы выходят в обновлении `call 26.600.0` и доступны пока не на всех порталах Битрикс24.** Если обновление на ваш портал ещё не пришло, API вернёт `422 METHOD_NOT_YET_AVAILABLE` — это признак того, что метод на портале ещё не выпущен, а не ошибка интеграции.

Чтение AI Follow-up завершённых звонков: транскрипция, обзор встречи, краткое изложение, аналитические выводы и оценка эффективности. Методы только читают данные и ничего не изменяют.

**Скоуп:** `call` | **Базовый URL:** `https://vibecode.bitrix24.tech/v1` | **Авторизация:** `X-Api-Key`

## Операции

- [Список Follow-up](./followup/list.md) — `POST /v1/calls/followups/list`
- [Follow-up по одному звонку](./followup/get.md) — `GET /v1/calls/followups/:callId`

## Доступ

Нужен скоуп `call`. Он не расширяет видимость данных: внутри метода действует проверка прав на конкретный звонок. Сотрудник видит Follow-up тех звонков, в которых участвовал или состоит в связанном чате — в том числе если его добавили в чат уже после разговора. Администратор портала видит все Follow-up портала.

## Аналитические выводы

Разбор участников — `insights.speakerAnalysis`, сильные и слабые стороны встречи, рекомендации — доступен не на каждом портале. Если он недоступен, `insights.speakerEvaluationAvailable` приходит со значением `false`, структура ответа при этом не меняется.

## Типовой сценарий

1. Получить список за период: [`POST /v1/calls/followups/list`](./followup/list.md) с фильтром по дате начала. Из ответа взять `callId` нужного звонка.
2. Запросить полные данные: [`GET /v1/calls/followups/:callId`](./followup/get.md). Если нужны не все блоки, ограничить выдачу параметром `select`.

## Смотрите также

- [Звонки](/docs/calls)
- [Расшифровка звонка клиенту](/docs/entities/activities/transcript)
- [Ошибки](/docs/errors)