> ## 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.

# Een VoiceAgent-oproep starten vanuit Zapier

> Start CloudTalk VoiceAgent-oproepen via Zapier met een Webhook-stap. Automatiseer oproepen, geef gegevens door en pas alles naar wens aan - zonder code.

<Note>
  Deze handleiding laat u zien hoe u een oproep van een **CloudTalk VoiceAgent** start met **Zapier** en de app **Webhooks by Zapier**. Zo start u geautomatiseerde spraakoproepen op basis van realtime gebeurtenissen in uw tools - zonder ook maar één regel code te schrijven.
</Note>

**Gebruikersniveau:**

* Admin

***

<h2 id="h_bc6a9f4970">
  CloudTalk VoiceAgents in Zapier
</h2>

Zapier koppelt uw favoriete tools en automatiseert taken daartussen. By Zapier helpt u uw tools te koppelen en taken daartussen te automatiseren. Wanneer u het verbindt met **CloudTalk VoiceAgent**, kunt u spraakoproepen starten op basis van live gegevens uit tools zoals CRM's, formulieren of helpdesksystemen. Zo bevestigt u afspraken, volgt u leads op of verstuurt u gesproken herinneringen met de gegevens die u toch al verzamelt. Spraakautomatisering komt daarmee rechtstreeks in uw bestaande workflows terecht.

Om een **VoiceAgent-oproep vanuit Zapier te starten**, gebruikt u de [Webhooks-app](https://zapier.com/apps/webhook/integrations) om als een van de stappen in uw Zap een API-verzoek te sturen naar het [CloudTalk VoiceAgent-eindpunt](/developers#tag/VoiceAgent).

<h3 id="h_a9cc30eafb">
  Vereisten
</h3>

Zorg dat u het volgende hebt voordat u de Webhook Custom Request in Zapier instelt:

* *CloudTalk API-inloggegevens*

  * Ga naar **CloudTalk Dashboard → Account → Instellingen → API-sleutels**

  * Kopieer zowel de **API Key ID** als de **API Key Secret**

* *VoiceAgent-ID*

  * De VoiceAgent-ID kunt u ophalen via het CloudTalk **Dashboard > VoiceAgents**

  <Frame>
    <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/66af489dee4a-vaid.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=067b7d34380535b6ce267b80b228d17a" alt="" width="1622" height="477" data-path="images/help-center/articles/11831224/66af489dee4a-vaid.png" />
  </Frame>

<h3 id="h_b36bf33918">
  Instructies voor het instellen
</h3>

Volg deze stappen om het starten van een VoiceAgent-oproep vanuit Zapier in te stellen:

1. Voeg in de Zap van uw keuze een stap **Actie** toe en kies **Webhooks by Zapier.**

2. Kies **Custom Request** als actiegebeurtenis.

3. Selecteer bij **Methode** POST

4. Gebruik voor het API-eindpunt deze **URL**:\
   [`https://api.cloudtalk.io/v1/voice-agent/calls`](https://api.cloudtalk.io/v1/voice-agent/calls)

5. Configureer in Data de body van het verzoek volgens de [API-documentatie](/developers#tag/VoiceAgent)

   * Maak een JSON-payload met de volgende opmaak:

     ```json theme={"system"}
     {
     "call_number": "#{{phone_number}}",
     "voice_agent_id": "#{{voice_agent_id}}",
     "call_properties": {
     "system_prompt": {
     "variables": {
     "contact_name": "#{{name}}"
     }
     },
     "output": {
     "variables": {
     "custom_field": "value"
     }
     }
     }
     }
     ```

   * Vervang de variabelen (`#{{...}}`) door gegevens uit eerdere stappen in uw scenario.

   * Voeg in `call_number` een verwijzing toe naar het telefoonnummer (e.164) dat gebeld moet worden, opgehaald uit eerdere stappen.

   * Voeg in `voice_agent_id` de ID van de VoiceAgent in die u in het CloudTalk Dashboard hebt opgehaald.

   * Configureer indien nodig `call_properties`, waarbij:

     1. De gegevens in `call_properties.system_prompt.variables` verzoekspecifieke informatie bevatten die de VoiceAgent tijdens het gesprek moet gebruiken (bijvoorbeeld de naam van het contact).

     2. De gegevens in `call_properties.output.variables` bepalen welke waarden de VoiceAgent na het gesprek aan het externe eindpunt moet doorgeven, naast de informatie die tijdens het gesprek is verzameld.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/g8s2E4Yk8cWS5656/images/help-center/articles/11831224/bdcbf8b7ba06-image.png?fit=max&auto=format&n=g8s2E4Yk8cWS5656&q=85&s=1ac248ff9179fe93b91e2045d354e3b6" alt="" width="867" height="254" data-path="images/help-center/articles/11831224/bdcbf8b7ba06-image.png" />
   </Frame>

<Warning>
  📘 **Wilt u meer weten?** Lees in [dit speciale artikel](/nl/articles/11401649-voiceagents-for-outbound-calls#h_91064c3683) hoe variabelen van de system prompt en outputvariabelen het gedrag van uw VoiceAgent bepalen!
</Warning>

6\. Voeg in het veld **Headers** de header `"Content-Type": "application/json"` toe

8\. Stel **Basic Authentication** in met uw **API Key ID** als gebruikersnaam en de **API Key Secret** als wachtwoord, beide afkomstig uit het CloudTalk Dashboard.

9\. Klik op **Doorgaan** en gebruik **Test Step** om een testoproep te versturen als u de configuratie wilt controleren.

<Note>
  ⚠️ **Let op:** als u de stap test, start er een echte VoiceAgent-oproep. Zorg ervoor dat het `call_number` dat u tijdens het testen gebruikt een nummer is dat u op dit moment ook daadwerkelijk wilt bellen.
</Note>

**U bent helemaal klaar!** 🚀 Uw configuratie is voltooid en klaar om moeiteloos VoiceAgent-oproepen te starten. Laat de automatisering beginnen!

<Info>
  **💡 API-limieten om rekening mee te houden**

  *Zorg ervoor dat uw Make-scenario de verdeling van oproepen zorgvuldig afhandelt, om fouten of throttling te voorkomen. Gebruik waar nodig vertragingen, wachtrijen of planningslogica, want voor het VoiceAgent-eindpunt geldt de standaard API-rate limit (60 verzoeken per minuut).*
</Info>

***

*Hulp nodig of hebt u een vraag?* Neem gerust contact op via ons [Supportportaal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we staan voor u klaar.


## Related topics

- [Een VoiceAgent-oproep starten vanuit Pipedrive](/nl/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)
- [Een VoiceAgent-oproep starten vanuit Zendesk](/nl/articles/15934846-triggering-a-voiceagent-call-from-zendesk.md)
- [Een VoiceAgent-oproep starten vanuit Salesforce](/nl/articles/16064425-triggering-a-voiceagent-call-from-salesforce.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.