Transcripten

Eén verzoek per gesprek. De analyse is klaar voordat je antwoord krijgt.

Wat je nodig hebt

• Een integratiesleutel.
• Een transcript waarin per zin staat of de agent of de klant spreekt. Zonder dat onderscheid kan Belbrein het gesprek niet beoordelen.

Stuur het gesprek

Stuur de gespreksmetadata samen met het transcript.

curl -X POST https://app-callinsightswl-prod.azurewebsites.net/v1/ingestion/conversations \
  -H "Authorization: Bearer <integratiesleutel>" \
  -H "Content-Type: application/json" \
  -d '{
    "external_conversation_id": "CM-2026-08-31-00412",
    "agent_external_id": "agent-1187",
    "call_agent_name": "Sanne de Vries",
    "campaign": "Najaarsactie 2026",
    "outcome_code": "callback",
    "conversation_date": "2026-08-31T10:14:22+02:00",
    "transcript": [
      { "speaker": "agent",    "start": 1.41, "end": 3.51, "text": "Goedemorgen, met Sanne de Vries." },
      { "speaker": "customer", "start": 3.49, "end": 4.63, "text": "Ja, goedemorgen." }
    ]
  }'

Je krijgt 200 OK terug:

{
  "status": "accepted",
  "external_conversation_id": "CM-2026-08-31-00412",
  "conversation_id": "b1e4a7c2-3d9f-4e1b-8a6c-2f5d7e9b1c3a",
  "analysed": true
}

Wordt het gesprek niet geanalyseerd, dan staat er "analysed": false met een reason:

reason	Betekenis
agent_not_linked	De agent is in Belbrein nog aan geen medewerker gekoppeld. Het agent-id is nu bekend; stuur het gesprek na het koppelen opnieuw in als je het alsnog geanalyseerd wilt hebben
too_short	Het gesprek duurt 30 seconden of korter (of de duur is onbekend: geef start/end of duration_seconds mee)
before_analysis_start	Het gesprek is gevoerd voordat de analyse voor jullie organisatie aanging
analysis_disabled	Automatisch analyseren staat uit voor jullie organisatie, dus de opname is niet getranscribeerd. Stuur hem opnieuw in nadat analyse aanstaat
analysis_retry_queued	Opgeslagen; de analyse lukte niet meteen en wordt automatisch opnieuw geprobeerd. Niet opnieuw insturen

Het transcript

Het transcript is een lijst zinnen, in de volgorde van het gesprek.

Veld	Verplicht	Toelichting
speaker	Ja	agent of customer
text	Ja	Wat er gezegd werd
start	Nee, wel aanbevolen	Seconden vanaf het begin van het gesprek, bijvoorbeeld 1.41
end	Nee, wel aanbevolen	Seconden vanaf het begin van het gesprek
confidence	Nee	Hoe zeker jullie spraakherkenning van deze zin is, van 0 tot 1. Alleen meesturen als jullie systeem dit levert

Met start en end kan Belbrein ook spreektijd, onderbrekingen en het verloop van het gesprek analyseren. Zinnen mogen overlappen: door elkaar praten is een normaal onderdeel van een gesprek.