# Фоллоуапы встреч Синка

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

> **Методы в процессе раскатки — выходят в обновлении `syncconnector 26.100.0; rest >= 26.1300.0`.** Если методов ещё нет на вашем портале Битрикс24, API вернёт `422 METHOD_NOT_YET_AVAILABLE` с `error.release`. На порталах с доступными методами вызовы работают в обычном режиме.

Для ключа OAuth-приложения укажите `syncconnector` в `scopes` при создании приложения. Набор прав закрепляется за ключом в момент выпуска, поэтому уже созданному приложению право добавляют перевыпуском ключа авторизации: карточка приложения и его данные сохранятся ([Перевыпуск ключа](/docs/keys-auth)). Какие ключи получают `syncconnector` по умолчанию — [Скоупы](/docs/scopes).

Битрикс24 API: `syncconnector.followup.*`

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

## Операции

- [Список фоллоуапов Синка](./sync-followup/list.md) — `POST /v1/calls/sync-followups/list`
- [Фоллоуап встречи Синка](./sync-followup/get.md) — `GET /v1/calls/sync-followups/:followupId`

## Доступ и идентификаторы

Синк возвращает только встречи владельца личного ключа или пользователя сессии OAuth-приложения. Это ограничение действует и для администратора. Фильтр по другому участнику не принимается и доступ не расширяет.

`followupId` — номер страницы фоллоуапа, который приходит в поле `callId` элемента списка. Это не номер звонка. Он не сопоставляется с ID [Follow-up звонков](/docs/calls/followup).

Приложение на личном ключе показывает **всем пользователям** встречи владельца этого ключа. Многопользовательскому приложению нужен ключ приложения OAuth с сессией текущего пользователя: от неё зависит, чьи встречи читает запрос.

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

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

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

- [Звонки](/docs/calls)
- [Follow-up звонков](/docs/calls/followup)
- [Ошибки](/docs/errors)
