Gegevens versturen of ophalen voor of na een gesprek

Met de skill API Aanroepen kan je agent informatie naar een extern systeem sturen of daar ophalen. Hij draait op een van drie momenten in een gesprek: voor het gesprek, tijdens het gesprek of na het gesprek.

Dit artikel gaat over de modi voor het gesprek (Pre Call) en na het gesprek (Post Call), die zich op het moment na bijna hetzelfde gedragen.

Voor API-aanroepen tijdens een lopend gesprek (gestart door de agent op basis van wat de beller zegt), zie API Aanroepen — tijdens het gesprek. Die modus heeft extra mogelijkheden, waaronder het veld Results / Path om geneste gegevens uit het antwoord te halen.

Wanneer je hem gebruikt

Gebruik Pre Call om context op te halen die de agent tijdens het gesprek nodig heeft:

• Klantprofiel, accountstatus, lidmaatschapsniveau
• Recente bestellingen, boekingen of openstaande tickets
• Alles waar de agent tijdens het gesprek naar moet kunnen verwijzen zonder de beller ernaar te vragen

Gebruik Post Call om gespreksgegevens na afloop naar een ander systeem te sturen:

• Leaduitkomsten, geëxtraheerde gegevens of samenvattingen naar je CRM sturen
• Een automatisering starten in Make.com, n8n, Zapier of een eigen endpoint
• Een ticketsysteem bijwerken, naar een database schrijven of een vervolgproces starten

Let op: wil je alleen per e-mail op de hoogte worden gehouden van gespreksresultaten, gebruik dan de ingebouwde meldingen van het platform; daarvoor heb je Post Call niet nodig. Post Call is bedoeld om gegevens naar andere softwaresystemen te sturen.

Zo werkt het

De skill stuurt op het gekozen moment een HTTP-verzoek:

• Pre Call draait één keer, vlak voordat het gesprek begint. De gegevens uit het antwoord zijn tijdens het gesprek beschikbaar voor de agent.
• Post Call draait één keer, nadat het gesprek is afgelopen. Het antwoord wordt niet gebruikt (het gesprek is al voorbij): Post Call is gegevenslevering in één richting.

Je bepaalt:

• Wanneer het verzoek draait (Pre Call of Post Call)
• Het endpoint: URL en HTTP-methode (GET of POST)
• Parameters: extra waarden die met het verzoek worden meegestuurd
• Headers: authenticatietokens of eigen headers, als dat nodig is

Instellen

1. Ga naar Agent → Vaardigheden → API Aanroepen.
2. Voeg een API-endpoint toe.
3. Stel de velden in:
   • Uitvoeringsvolgorde: Pre Call of Post Call
   • API-endpoint: de volledige URL van je endpoint
   • Methode: GET of POST
   • Parameters (optioneel): extra waarden; zie "Parameters" hieronder
   • Headers (optioneel): autorisatietokens of eigen headers. Webhook-endpoints van Make.com, n8n of Zapier hebben meestal geen authenticatie nodig; laat dit veld dan leeg.
4. Schakel de skill in met de schakelaar.
5. Klik op Creëren.

Pre Call: het antwoord in het gesprek gebruiken

Geeft je Pre Call-endpoint gegevens terug, dan kan de agent elk veld direct via de sleutelnaam in het Hoofddoel gebruiken.

Voorbeeldantwoord

{
  "customer_name": "Ferguson",
  "membership_tier": "Gold",
  "membership_expires": "2027-06-23",
  "last_order_id": "ORD-4471",
  "order_status": "shipped"
}

Velden gebruiken in het Hoofddoel

Vertel na het bevestigen van de identiteit van de beller dat zijn {{membership_tier}}-lidmaatschap geldig is tot {{membership_expires}}. Vraagt hij naar zijn laatste bestelling, noem dan {{last_order_id}} en vertel dat de status {{order_status}} is.

De agent vervangt elk {{veldnaam}} direct door de waarde uit het antwoord.

Houd het antwoord plat. Pre Call heeft geen veld Path, dus waarden uit geneste JSON kun je niet uitlezen. Om de gegevens bruikbaar te maken:

• Geef platte JSON terug, zonder geneste objecten.
• Gebruik duidelijke, beschrijvende sleutels: customer_name in plaats van name, membership_tier in plaats van tier.
• Maak geneste brongegevens op je endpoint plat voordat je antwoordt.

Lastiger voor de agent:

{
  "customer": {
    "name": "Ferguson",
    "membership": { "tier": "Gold" }
  }
}

Post Call: wat automatisch wordt verstuurd

Post Call-verzoeken bevatten automatisch uitgebreide gegevens uit het gesprek; daarvoor hoef je geen parameters te definiëren. Velden die het platform doorgaans meestuurt:

• transcript: de volledige transcriptie van het gesprek tussen agent en beller
• call_extract: gestructureerde gegevens uit het gesprek (samenvatting, uitkomst en alle eigen velden die je voor extractie hebt ingesteld)
• prompt_params: parameters die zijn meegegeven bij het starten van het gesprek via de API (uitgaande gesprekken)
• call_id, agent_id: ID's van het gesprek en de agent
• phone_number: het nummer van de beller
• status: de gespreksstatus (bijvoorbeeld reached, no_answer)

Je kunt in de skillconfiguratie extra vaste parameters toevoegen die naast deze automatische gegevens worden meegestuurd, bijvoorbeeld een veld source: voice_agent om in je CRM aan te geven waar de gegevens vandaan komen.

Parameters

Elke parameter heeft een naam en een beschrijving. Bij Pre Call en Post Call zijn parameters meestal vast: de waarde in de beschrijving wordt bij elk gesprek ongewijzigd meegestuurd.

De gegevens naar je endpoint bevatten dan altijd "source": "voice_agent".

Pre Call-parameters worden vooral gebruikt om je endpoint te vertellen wat voor soort verzoek het is of welke agent belt. Het telefoonnummer is de enige veelgebruikte dynamische waarde voor Pre Call; heb je die nodig, voeg hem dan toe als parameter.

Bij Post Call bevatten de automatische gegevens meestal alles wat je nodig hebt; extra parameters zijn optioneel.

Voorbeeld: klant opzoeken voor het gesprek

Scenario: een uitgaande agent belt een klant om een recente aankoop te bevestigen. De agent moet weten wie de klant is en wat zijn laatste bestelling was, maar mag de klant daar niet direct naar vragen.

Configuratie:

• Uitvoeringsvolgorde: Pre Call
• API-endpoint: je webhook om klanten op te zoeken (bijvoorbeeld een Make.com-scenario dat je CRM bevraagt)
• Methode: POST
• Parameter: phone_number (dynamisch, uit de gesprekscontext)

Antwoord van je endpoint:

{
  "customer_name": "Ferguson",
  "membership_tier": "Gold",
  "last_order_id": "ORD-4471",
  "order_status": "shipped"
}

Openingszin (apart ingesteld in de agentinstellingen, niet hier):

Hallo, je spreekt met Anna van Kollie.AI. Spreek ik met de accounthouder?

Hoofddoel:

1. Bevestig dat je met de accounthouder spreekt.
2. Vertel daarna dat zijn laatste bestelling {{last_order_id}} momenteel de status {{order_status}} heeft.
3. Als {{membership_tier}}-lid heeft hij recht op voorrangssupport. Noem dat als het relevant is.
4. Vraag of alles in orde is.
5. Beëindig het gesprek.

De agent kan Pre Call-gegevens pas gebruiken nadat het gesprek is begonnen, nooit in de begroeting. Waarom, lees je hieronder bij "Goed om te weten".

Voorbeeld: CRM bijwerken na het gesprek

Scenario: stuur na elk gesprek de geëxtraheerde leadgegevens naar je CRM, zodat sales kan opvolgen.

Configuratie:

• Uitvoeringsvolgorde: Post Call
• API-endpoint: je CRM-webhook (bijvoorbeeld een Make.com-scenario dat een contact aanmaakt of bijwerkt)
• Methode: POST
• Parameters: optioneel, bijvoorbeeld source: voice_agent om de herkomst aan te geven
• De automatische gegevens (transcript, call_extract, phone_number, status enz.) worden automatisch meegestuurd; je endpoint leest wat het nodig heeft.

Aan het Hoofddoel hoef je niets te veranderen. Post Call draait automatisch als het gesprek eindigt.

Goed om te weten

Pre Call-gegevens zijn niet beschikbaar in de openingszin

De openingszin wordt uitgesproken zodra het gesprek verbonden is, meestal voordat het Pre Call-verzoek is beantwoord. Bevat je openingszin bijvoorbeeld:

Hallo {{customer_name}}, ik bel over je {{membership_tier}}-lidmaatschap.

…dan komt hij waarschijnlijk door met lege placeholders: Hallo , ik bel over je -lidmaatschap.

Oplossing: heb je gegevens nodig in de openingszin, geef ze dan mee als parameter bij het starten van het gesprek via de API (alleen bij uitgaande gesprekken). Parameters die bij het starten worden meegegeven, zijn vanaf de eerste milliseconde beschikbaar. Pre Call is voor gegevens die de agent gebruikt zodra het gesprek loopt, niet voor de allereerste zin.

Geen ingebouwde foutafhandeling

Reageert je endpoint niet, geeft het een fout terug of stuurt het lege velden, dan heeft de skill geen ingebouwd alternatief. De agent heeft dan gewoon geen gegevens, slaat misschien delen van de prompt over, vraagt de beller iets te herhalen of verzint in sommige gevallen iets.

Oplossing: voeg expliciete instructies voor dit geval toe aan je Hoofddoel. Voorbeeld:

Noem de laatste bestelling van de beller met {{last_order_id}}. Heb je die informatie niet, vertel dan dat je het team informeert en dat ze zo snel mogelijk contact opnemen.

Terugvalinstructies moeten concreet zijn. Vage terugvalinstructies leiden tot vage verzinsels.

Post Call-antwoorden worden genegeerd

Wat je Post Call-endpoint terugstuurt, wordt weggegooid. Het gesprek is al afgelopen, dus de agent kan niets met de gegevens.

Authenticatie

Heeft je endpoint authenticatie nodig, voeg de inloggegevens dan toe in het veld Headers (bijvoorbeeld Authorization: Bearer your-token-here). De meeste webhookdiensten hebben geen headers nodig; laat dat veld dan leeg.

De skill API Aanroepen in de modi Pre Call en Post Call is de eenvoudigste manier om je agent voor context en verdere automatisering aan externe systemen te koppelen. Voor API-aanroepen in realtime op basis van wat de beller zegt, zie API Aanroepen — tijdens het gesprek.