> ## Documentation Index > Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt > Use this file to discover all available pages before exploring further. # VoiceAgents voor uitgaande oproepen > Stel de VoiceAgent-functie van CloudTalk in en gebruik deze om uitgaande oproepen efficiënt af te handelen. 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 ***

VoiceAgents voor uitgaande oproepen

**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](/nl/articles/11399385-voiceagents-for-inbound-calls) om te ontdekken hoe u VoiceAgents inzet voor inkomende scenario's.

Hoe het werkt

Uitgaande oproepen met [VoiceAgent](/nl/articles/11053795-getting-started-with-voiceagents) worden **gestart via het [VoiceAgents-endpoint van de CloudTalk API](/developers#tag/Voice-Agents/operation/createVoiceAgentCall)**[.](/developers#tag/Voice-Agents/operation/createVoiceAgentCall) 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](/developers#tag/Voice-Agents), 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](/developers#tag/Voice-Agents)**[,](/developers#tag/Voice-Agents) meestal als onderdeel van een workflow-automatisering met: * **HubSpot Workflows** * **Zapier** * **Make** * **Uw interne systemen** * **Webhook-gebaseerde automatiseringen** Configureer uw [API-verzoek](/developers#tag/Voice-Agents) volgens deze instructies: 1. Bepaal in de tool van uw keuze **het endpoint van het API-verzoek.** Geef eerst het doel-endpoint voor het verzoek op: ```http theme={"system"} POST https://api.cloudtalk.io/v1/voice-agent/calls ``` 2. 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** 3. 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:** ```bash theme={"system"} 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](/nl/articles/11399385-voiceagents-for-inbound-calls) 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](/nl/articles/14072758-voiceagent-skills#h_d5557cb8f7)** 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: ```json theme={"system"} { "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](/nl/articles/14072758-voiceagent-skills#h_364d85c8dd) 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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar. ## Related topics - [TCPA-naleving voor uitgaande VoiceAgent-oproepen](/nl/articles/17230144-tcpa-compliance-for-voiceagent-outbound-calls.md) - [Aan de slag met VoiceAgents](/nl/articles/11053795-getting-started-with-voiceagents.md) - [VoiceAgents voor inkomende oproepen](/nl/articles/11399385-voiceagents-for-inbound-calls.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.