Follow-up for a single call

curl "https://vibecode.bitrix24.com/v1/calls/followups/12345?mentionFormat=none" \
  -H "X-Api-Key: YOUR_API_KEY"

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

const params = new URLSearchParams({ mentionFormat: 'none' })

const res = await fetch(`https://vibecode.bitrix24.com/v1/calls/followups/12345?${params}`, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const body = await res.json()

if (!body.success) {
  // Handle the error explicitly: otherwise on 403 or 422 the code breaks when reading data
  throw new Error(`${body.error.code}: ${body.error.message}`)
}

const { data } = body
const call = data.item

// Ready AI blocks are listed in outcomes — the ones that are not ready arrive as null
console.log(call.outcomes, `${call.durationSeconds} sec`)
console.log(call.overview?.topic ?? 'overview is not built yet')

for (const item of call.overview?.actionItems ?? []) {
  console.log('action item:', item.actionItem, '— quote:', item.quote)
}

// speakerAnalysis is absent if speaker analysis is unavailable on the Bitrix24 account
for (const speaker of call.insights?.speakerAnalysis ?? []) {
  console.log(`speaker ${speaker.userId}: ${speaker.talkPercentage}% of the time, score ${speaker.efficiencyValue}`)
}

// Criteria are a map — the keys depend on the meeting type, so iterate over the keys
for (const [code, criterion] of Object.entries(call.evaluation?.criteria ?? {})) {
  console.log(code, criterion.value ? 'met' : 'not met', '—', criterion.thoughts)
}

const params = new URLSearchParams({ mentionFormat: 'none' })

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

const body = await res.json()

if (!body.success) {
  // Handle the error explicitly: otherwise on 403 or 422 the code breaks when reading data
  throw new Error(`${body.error.code}: ${body.error.message}`)
}

const { data } = body
console.log(data.item)

{
  "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": "en",
      "version": 3,
      "participants": [
        { "userId": 7, "name": "John Smith", "workPosition": "Project manager", "talkedSeconds": 600 }
      ],
      "outcomes": ["transcription", "overview", "summary", "insights", "evaluation"],
      "createdAt": "2026-01-15T11:05:00+00:00",
      "tracks": [
        { "trackId": 100, "type": "mixed_audio", "duration": 2520, "fileName": "call_12345.wav", "mimeType": "audio/wav", "url": "https://example.bitrix24.com/disk/call_12345.wav", "dateCreate": "2026-01-15T11:00:00+00:00" }
      ],
      "transcription": {
        "language": "en",
        "segments": [
          { "userId": 7, "userName": "John Smith", "start": 12, "end": 25, "text": "Let's lock in the sprint scope. What are we taking on?" },
          { "userId": 42, "userName": "Mary Jones", "start": 26, "end": 48, "text": "I suggest we keep only the catalog import, we won't have time for the rest." },
          { "userId": 7, "userName": "John Smith", "start": 49, "end": 70, "text": "Agreed. Then we show the prototype on Friday." }
        ]
      },
      "overview": {
        "topic": "Sprint planning",
        "detailedTakeaways": "The team reduced the sprint scope to the catalog import and agreed to show the prototype on Friday.",
        "meetingType": {
          "typeTag": "planning",
          "title": "Planning",
          "explanation": "The participants assigned tasks and set deadlines for the next iteration."
        },
        "agenda": {
          "explanation": "Define the sprint scope and the demo deadline.",
          "quote": "Let's lock in the sprint scope."
        },
        "agreements": [
          { "agreement": "Only the catalog import goes into the sprint", "quote": "I suggest we keep only the catalog import, we won't have time for the rest." }
        ],
        "actionItems": [
          { "actionItem": "Prepare the prototype by Friday", "quote": "Then we show the prototype on Friday." }
        ],
        "meetings": [
          { "meeting": "Prototype demo on Friday", "quote": "Then we show the prototype on Friday." }
        ]
      },
      "summary": {
        "segments": [
          { "start": 0, "end": 600, "title": "Sprint scope", "summary": "Discussed what the team can deliver and reduced the task set to the catalog import." },
          { "start": 601, "end": 2520, "title": "Deadlines and demo", "summary": "Agreed to show the prototype on Friday and to return to the other tasks in the next sprint." }
        ]
      },
      "insights": {
        "speakerEvaluationAvailable": true,
        "speakerAnalysis": [
          {
            "userId": 42,
            "detailedInsight": "The participant proposed reducing the scope and backed it with a deadline estimate.",
            "efficiencyValue": 82,
            "evaluationCriteria": "Constructiveness of proposals",
            "talkPercentage": 66,
            "duration": 1200,
            "durationFormat": "20:00"
          },
          {
            "userId": 7,
            "detailedInsight": "The participant ran the meeting and recorded the agreements.",
            "efficiencyValue": 74,
            "evaluationCriteria": "Discussion management",
            "talkPercentage": 34,
            "duration": 600,
            "durationFormat": "10:00"
          }
        ],
        "meetingStrengths": [
          { "strengthTitle": "Clear outcome", "strengthExplanation": "The meeting ended with a recorded decision and a deadline." }
        ],
        "meetingWeaknesses": [
          { "weaknessTitle": "Unequal participation", "weaknessExplanation": "One participant spoke for two thirds of the time." }
        ],
        "speechStyleInfluence": "The calm pace of speech helped reach a decision quickly.",
        "engagementLevel": "High engagement of both participants.",
        "areasOfResponsibility": "The catalog import is assigned to Mary Jones.",
        "finalRecommendations": "Send the agenda in advance to shorten the scope discussion."
      },
      "evaluation": {
        "efficiencyValue": 75,
        "calendar": { "overhead": false },
        "criteria": {
          "agenda_defined": {
            "value": true,
            "criteria": "The agenda is stated at the start of the meeting",
            "title": "Agenda",
            "thoughts": "The host stated the goal in the first utterance."
          },
          "decisions_made": {
            "value": true,
            "criteria": "Decisions are made on the issues discussed",
            "title": "Decisions",
            "thoughts": "The sprint scope and the demo deadline are recorded."
          },
          "all_participants_involved": {
            "value": false,
            "criteria": "All participants are involved in the discussion",
            "title": "Engagement",
            "thoughts": "The split of utterances is 66 to 34 percent."
          }
        }
      }
    }
  }
}

{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "No access to the Follow-up data"
  }
}