#Follow-up по одному звонку

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

GET /v1/calls/followups/:callId

Возвращает AI Follow-up по одному звонку. Без select возвращается полный объект (отсутствующие данные → null).

#Параметры

Параметр Где Тип Обяз. Описание
callId path integer да Идентификатор звонка
select query string[] нет Какие поля вернуть (повторяемый или через запятую); словарь общий с list
mentionFormat query string нет bb (по умолч.) | html | none

#Семантика `select`

select Что в ответе
не указан Полный объект Follow-up; все поля присутствуют, отсутствующие данные → null (стабильная форма)
[] Только базовые метаданные (callId, callType, initiatorId, startDate, endDate, durationSeconds)
['…', '…'] Только перечисленные поля + всегда callId; запрошенные, но пустые поля остаются как null

#Примеры

#curl — личный ключ

Terminal 
curl "https://vibecode.bitrix24.tech/v1/calls/followups/12345?mentionFormat=html&select=callId&select=overview.topic" \
  -H "X-Api-Key: YOUR_API_KEY"

#curl — OAuth-приложение

Terminal 
curl "https://vibecode.bitrix24.tech/v1/calls/followups/12345?mentionFormat=html" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/calls/followups/12345?mentionFormat=html', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { success, data } = await res.json()
console.log(data.item)

#JavaScript — OAuth-приложение

javascript 
const params = new URLSearchParams({ mentionFormat: 'html' })
params.append('select', 'callId')
params.append('select', 'overview.topic')

const res = await fetch(`https://vibecode.bitrix24.tech/v1/calls/followups/12345?${params}`, {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { success, data } = await res.json()
console.log(data.item)

#Поля ответа

data = { item: { ... } }. Поля item — см. «Поля Follow-up».

jsonc 
{
  "success": true,
  "data": {
    "item": {
      "callId": 12345,
      "callType": 1,
      "initiatorId": 7,
      "startDate": "2026-01-15T10:00:00+00:00",
      "endDate": "2026-01-15T10:42:00+00:00",
      "durationSeconds": 2520,
      "uuid": "bb085e5d-5160-4a63-9ac4-152248046c39",
      "language": "ru",
      "version": 3,
      "participants": [ /* ParticipantDto */ ],
      "outcomes": ["transcription", "overview", "summary", "insights", "evaluation"],
      "createdAt": "2026-01-15T11:05:00+00:00",
      "tracks": [ /* TrackDto */ ],
      "transcription": { "language": "ru", "segments": [ /* … */ ] },
      "overview": { "topic": "Планирование спринта", "actionItems": [ /* … */ ] },
      "summary": { "segments": [ /* … */ ] },
      "insights": { "speakerEvaluationAvailable": true, "speakerAnalysis": [ /* … */ ] },
      "evaluation": { "efficiencyValue": 75, "criteria": { /* … */ } }
    }
  }
}

#Ошибки

HTTP Код Когда
400 INVALID_PARAMS callId не положительное целое
401 MISSING_API_KEY Не передан X-Api-Key
403 SCOPE_DENIED Ключу не хватает скоупа call; либо нет доступа к Follow-up
422 BITRIX_ERROR Bitrix24 вернул ошибку — в т.ч. несуществующий callId (текст в error.message)
502 BITRIX_UNAVAILABLE Bitrix24 недоступен

Полный список общих ошибок — Ошибки.

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