VoiceAgents voor uitgaande oproepen

In dit artikel leert u hoe u de VoiceAgent-functie van CloudTalk instelt en gebruikt voor uitgaande oproepen. De handleiding behandelt hoe u geautomatiseerde oproepen activeert en gesprekken afhandelt zonder dat er live agents aan te pas komen.

Gebruikersniveau: Admin

VoiceAgent voor uitgaande oproepen stelt teams in staat om uitgaande klantinteracties te automatiseren door oproepen te starten via AI-gestuurde agents. Het is ideaal voor taken zoals opvolging, afspraakbevestigingen, enquêtes of proactieve meldingen - zo houden live agents tijd over voor complexere gesprekken en stijgt de operationele efficiëntie.

💡 Wilt u inkomende oproepen juist geautomatiseerd afhandelen? Bekijk de handleiding VoiceAgent voor inkomende oproepen om te ontdekken hoe u VoiceAgents inzet voor inkomende scenario’s.

Hoe het werkt

Uitgaande oproepen met VoiceAgent worden gestart via het VoiceAgents-endpoint van de CloudTalk API. Wanneer een oproep moet worden uitgevoerd, stuurt een extern hulpmiddel of CRM doorgaans een verzoek naar de API, met daarin de benodigde gegevens van de persoon die gebeld moet worden. Die gegevens bevatten meestal zaken als het telefoonnummer van de ontvanger en eventuele contextuele informatie die de VoiceAgent tijdens het gesprek moet gebruiken. De oproepgegevens die in het API-verzoek worden meegestuurd, raadpleegt de VoiceAgent tijdens de interactie, zodat deze reageert en zich gedraagt volgens wat in de VoiceAgent-configuratie is vastgelegd. Het hele proces is geautomatiseerd en vereist geen tussenkomst van een menselijke agent, waardoor efficiënte en schaalbare uitgaande communicatie mogelijk wordt.

Uitgaande VoiceAgent-oproepen activeren via de API

In dit onderdeel leest u hoe u uitgaande VoiceAgent-oproepen activeert met de API van CloudTalk, inclusief de belangrijkste configuratiestappen die nodig zijn voor een correcte uitvoering en gegevensverwerking.

Vereisten

De VoiceAgents-functionaliteit is ingeschakeld in uw CloudTalk Dashboard.
Er is een uitgaande VoiceAgent geconfigureerd in uw account. Deze kunt u aanmaken door:
- een sjabloon te selecteren met Oproeprichting Uitgaand
- een aangepaste VoiceAgent aan te maken en Oproeprichting Uitgaand te selecteren.

Implementatie

In plaats van oproepen handmatig te starten, worden uitgaande VoiceAgent-oproepen gestart via de CloudTalk API, meestal als onderdeel van een workflow-automatisering met:

HubSpot Workflows
Zapier
Make
Uw interne systemen
Webhook-gebaseerde automatiseringen

Configureer uw API-verzoek volgens deze instructies:

Bepaal in de tool van uw keuze het endpoint van het API-verzoek. Geef eerst het doel-endpoint voor het verzoek op:
POST https://api.cloudtalk.io/v1/voice-agent/calls
Stel in de headers van de configuratie de Authorization-header in.
Authorization: Basic BASE64(api_key_id:api_key)
De Cloudtalk API gebruikt Basic Authentication, waarbij
- api_key_id : uw API-sleutel-ID is uit CloudTalk Dashboard > Instellingen > API-sleutels > API-sleuteldetail > ID
- api_key uw onbewerkte API-sleutel is uit CloudTalk Dashboard > Instellingen > API-sleutels > API-sleuteldetail > Sleutel
Configureer in de body van het verzoek de vereiste velden.
1. call_number - Telefoonnummer dat de voiceagent moet bellen in E.164-formaat
2. voice_agent_id - Het ID van de VoiceAgent. U vindt dit in het CloudTalk Dashboard → VoiceAgents -> Agenten. Open het detail van de gewenste VoiceAgent en kopieer het ID uit de URL van die pagina.
3. call_properties met daarin
  1. system_prompt variabelen - worden doorgegeven aan de systeemprompt van de VoiceAgent en zijn tijdens de oproep zichtbaar voor de AI. Gebruik ze om de oproep te personaliseren (bijv. #{{name}}, #{{order_id}}). Alleen nodig als u variabelen gebruikt in de VoiceAgent-configuratie.
  2. outputvariabelen - worden opgenomen in de payload van de Call Analysis-webhook.

⚠️ Neem het system_prompt object en het output object alleen op in het API-verzoek als u daadwerkelijk variabelen gebruikt in de prompt van de VoiceAgent.

Voorbeeld van een API-verzoek:

curl \--location 'https://api.cloudtalk.io/v1/voice-agent/calls' \--header 'Content-Type: application/json' \--header 'Authorization: Basic dfjag57df********f5gdf4gs4dgd' \--data '{  "call_number": "+421 903 123 123",  "voice_agent_id": "67eaa636148d700a8dmckaf1",  "call_properties": {    "system_prompt": {      "variables": {        "name": "John"      }    },    "output": {      "variables": {        "customer_id": 12345      }    }  }}'

Systeempromptvariabelen versus outputvariabelen

Wanneer u een VoiceAgent-oproep via de API configureert, kunt u twee soorten variabelen meesturen om het gesprek te verrijken en de verwerking na de oproep te ondersteunen:

systeempromptvariabelen
outputvariabelen.

Deze variabelen hebben elk een eigen doel in de VoiceAgent-workflow en moeten dus ook anders worden ingezet.

Systeempromptvariabelen

⚠️ Contactvariabelen werken niet bij agents voor uitgaande oproepen. Variabelen zoals #{{contact.name}} of #{{caller_number}} worden alleen automatisch ingevuld bij agents voor inkomende oproepen. Bij agents voor uitgaande oproepen definieert u uw eigen aangepaste variabelen en geeft u hun waarden mee in het API-verzoek, zoals hieronder beschreven. Zie VoiceAgents voor inkomende oproepen voor personalisatie bij inkomende oproepen.

Systeempromptvariabelen zijn tijdens de oproep zichtbaar voor de AI en helpen het gesprek te personaliseren of geven de VoiceAgent essentiële context. Voeg variabelen aan uw prompt toe met dubbele accolades (#{{ }}). Voorbeeld van een begroeting:

Hello #{{name}}, I'm calling to confirm your order number #{{order_id}} placed on #{{order_date}}.

Zorg er bij het versturen van het API-verzoek voor dat deze variabelen zijn opgenomen in het object system_prompt.variables in de body van het verzoek. Bijvoorbeeld:

"system_prompt": {
  "variables": {
    "name": "Alex",
    "order_id": "123456",
    "order_date": "2025-05-18"
  }
}

Als er in de prompt naar een variabele wordt verwezen die niet in het API-verzoek wordt meegestuurd, kan de VoiceAgent deze niet gebruiken. Dat kan leiden tot fouten of een slechtere gebruikerservaring.

Outputvariabelen

Outputvariabelen zijn tijdens de oproep niet zichtbaar voor de AI. Ze dienen om metadata of context aan het gesprek te koppelen die na afloop van de oproep beschikbaar is in de gespreksanalyse en de geëxtraheerde informatie. Deze variabelen worden met het API-verzoek meegestuurd en opgenomen in de webhook-payload, zodat uw systemen het resultaat van de oproep met volledige context kunnen verwerken, ook al heeft de VoiceAgent deze gegevens niet in het gesprek gebruikt. Voorbeeld Stel dat uw vaardigheid Informatie extraheren als volgt is ingesteld:

In uw API-verzoek neemt u een outputvariabele op om externe context mee te geven (in dit geval customer_id):

"output": {  "variables": {    "customer_id": 12345  }}

Deze waarde is tijdens de oproep niet zichtbaar voor de VoiceAgent, maar wordt wel opgenomen in de webhook-payload die na afloop van de oproep wordt verstuurd. De volledige webhook-payload ziet er zo uit:

{  "data": {    "ct_call_context": {      "uuid": "160f677d-d2f2-419d-822d-b45f33e4fe6c",      "status": "Connected",      "datetime": "2026-06-17T08:38:31Z",      "duration": 23    },    "message_left_by_caller": {      "caller_name": null,      "content": null    },    "customer_id": 12345,    "Summary": "The caller confirmed they want a callback tomorrow morning.",    "Callback_Confirmed": true  }}

💡 Elke webhook-payload bevat nu een ct_call_context-object met de UUID, de status, de starttijd en de duur van de oproep. Met het veld uuid kunt u de oproep opzoeken in CloudTalk of koppelen aan records in uw CRM of datawarehouse. Zie VoiceAgent-vaardigheden – Informatie extraheren voor de volledige payloadreferentie.

Zo verrijkt u de automatisering of rapportage na de oproep met extra context die nooit deel uitmaakte van het gesproken gesprek.

Door beide soorten variabelen te combineren, voert u tijdens de oproep sterk gepersonaliseerde gesprekken en behoudt u achteraf de volledige operationele context - zonder de AI met overbodige gegevens te belasten.

Hulp nodig of hebt u een vraag? Neem gerust contact met ons op via ons supportportaal — we staan voor u klaar.

Aan de slag

Nummers & portering

AI

AI Sales Dialer

CloudTalk Phone & Go

Berichten

Dashboard

Integraties

Facturering & abonnement

Technisch nieuws & updates

Oude Dashboard

VoiceAgents voor uitgaande oproepen