Gespreksmetadata

Deze velden stuur je mee bij elk gesprek, of je nu audio of transcripten aanlevert.

Verplicht

Veld	Type	Toelichting
external_conversation_id	tekst	Jullie eigen ID voor het gesprek. Hetzelfde ID nog een keer sturen maakt geen dubbel gesprek, zie retries
agent_external_id	tekst	Jullie eigen ID voor de agent. Moet altijd hetzelfde blijven voor dezelfde persoon
conversation_date	datum/tijd	Wanneer het gesprek plaatsvond, in ISO 8601 met tijdzone, bijvoorbeeld 2026-08-31T10:14:22+02:00
call_agent_name	tekst	Naam van de agent, zoals die in het dashboard verschijnt
campaign	tekst	Campagne of project. Bepaalt welke beoordelingscriteria gelden
outcome_code	tekst	Jullie uitkomst van het gesprek, bijvoorbeeld sale of callback. Hiermee meet Belbrein conversie

Optioneel

Veld	Type	Toelichting
outcome_category	tekst	Alleen als jullie uitkomsten twee niveaus hebben: de hoofdcategorie
duration_seconds	geheel getal	Duur van het gesprek in seconden. Laat je dit weg, dan halen we het uit de opname, of bij een transcript uit de tijden (end) van de laatste zin. Is er geen van beide, dan wordt het gesprek niet geanalyseerd
team_external_id	tekst	Jullie eigen ID voor het team van de agent
contact_id	tekst	Jullie eigen ID voor de gebelde persoon of lead, om herhaalgesprekken te herkennen
metadata	object	Overige eigen velden, als sleutel/waarde. Bij audio als JSON-tekst: -F 'metadata={"wachtrij":"inbound-2"}'

Een veld dat niet in deze lijst staat, wordt geweigerd met 400. Zo komen er geen gegevens binnen die Belbrein niet hoort te hebben.

Geen persoonsgegevens

Stuur geen naam, telefoonnummer, e-mailadres of adres van de gebelde persoon mee, ook niet in metadata. Belbrein heeft dat niet nodig. Gebruik contact_id om gesprekken met dezelfde persoon te koppelen.