#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
#Эндпоинты
| Метод | Назначение |
|---|---|
| `POST /v1/calls/followups/list` | Список Follow-up за период с фильтрами, сортировкой и курсорной навигацией |
| `GET /v1/calls/followups/:callId` | Полные данные Follow-up по одному звонку |
#Доступ
Требуется скоуп call. Скоуп не расширяет видимость: внутри метода применяется проверка доступа к конкретному звонку — обычный пользователь видит Follow-up звонков, в которых участвовал или состоит в связанном чате; администратор портала — все.
#Замечания
- Регионы. Блок
insights(анализ спикеров) заполняется только в CIS-регионах; в остальныхspeakerEvaluationAvailable = false, структура ответа не меняется. - Звонки без AI. В
listтакие звонки не возвращаются. Вgetвернётся объект с метаданными иnullв AI-блоках (outcomes: []). - Доступ к чужим Follow-up. Участник, добавленный в чат уже после звонка, видит его Follow-up — доступ определяется участием в звонке или в связанном чате.