> ## 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 triggeren vanuit Zoho Desk

> Automatiseer VoiceAgent-oproepen rechtstreeks vanuit workflows in Zoho Desk

<Note>
  U kunt automatisch een CloudTalk VoiceAgent-oproep laten starten, rechtstreeks vanuit de Automation Rules in Zoho Desk. In deze handleiding leest u hoe u een Custom Function aanmaakt, deze koppelt aan een Workflow Rule en controleert of de oproepen correct worden gestart.
</Note>

**Gebruikersniveau**: Admin

***

<h2 id="h_583de41e15">
  Voordat u begint
</h2>

U hebt het volgende nodig:

* Een reeds aangemaakte CloudTalk VoiceAgent (noteer het VoiceAgent-ID)

* CloudTalk API-gegevens (API-sleutel en Secret) — te vinden in **Bedrijfsinstellingen > Integraties > API** ([Uw CloudTalk API-sleutels bekijken en genereren](/nl/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Een Zoho Desk-account met toegang tot Automation

* Contactrecords met telefoonnummers

<h2 id="h_145e880437">
  De Authorization-header genereren
</h2>

CloudTalk gebruikt Basic Authentication voor API-verzoeken. Zo genereert u uw gecodeerde waarde:

1. Ga naar [https://www.debugbear.com/basic-auth-header-generator](https://www.debugbear.com/basic-auth-header-generator)

2. Voer uw **CloudTalk API-sleutel** in als Username en het **API Secret** als Password

3. Kopieer de gegenereerde header. Deze ziet er ongeveer zo uit: `Basic XXXXXXXXX`

U gebruikt deze waarde in het Custom Function-script hieronder.

<h2 id="h_6d25a42937">
  De integratie instellen
</h2>

<h3 id="h_d35cb3411c">
  De Custom Function aanmaken
</h3>

1\. Ga naar **Setup > Developer Space > Custom Functions**

2\. Klik op **New Function**

3\. Configureer de functie:

* **Function Name:** CloudTalk VoiceAgent

* **Module:** Selecteer de module die de oproep moet starten (bijv. Contacts, Tickets)

4\. Voeg onder **Argument Mapping** het volgende toe:

* **Argument Name:** `phoneNumber` > **Select Field:** Contact Phone (of het relevante telefoonveld voor uw module)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=cfc3d5d04d921cb621be8e03dc85ae6f" alt="" width="2068" height="1234" data-path="images/help-center/articles/15442851/f7b454104051-screenshot-2026-06-08-at-15-17-51.png" />
</Frame>

5\. Plak het volgende script in de editor **Function Script**:

```
phoneVal = phoneNumber;
agentId = "YOUR_VOICE_AGENT_ID";
jsonBody = '{"call_number":"' + phoneVal + '","voice_agent_id":"' + agentId + '"}';

headers = Map();
headers.put("Authorization","Basic XXXXXXXXX");
headers.put("Content-Type","application/json");

response = invokeurl
[
    url: "https://api.cloudtalk.io/v1/voice-agent/calls"
    type: POST
    parameters: jsonBody
    headers: headers
];

info response;
```

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1beb14b5d1aa22ae780946174f885432" alt="" width="2060" height="1230" data-path="images/help-center/articles/15442851/bfcf2a7d44d3-screenshot-2026-06-08-at-15-18-12.png" />
</Frame>

Vervang `YOUR_VOICE_AGENT_ID` door uw eigen VoiceAgent-ID en `XXXXXXXXX` door uw Base64-gecodeerde gegevens uit de vorige stap.

<Tip>
  `call_number` en `voice_agent_id` zijn de enige verplichte velden. Optioneel kunt u extra `call_properties` meesturen, zoals variabelen voor de system prompt of outputvariabelen, afhankelijk van de configuratie van uw VoiceAgent. [Bekijk wat u kunt meesturen](/nl/articles/11401649-voiceagents-for-outbound-calls).
</Tip>

6\. Klik op **Save Script** en vervolgens op **Save.**

<h3 id="h_6a6da01438">
  De Automation Rule aanmaken
</h3>

1. Ga naar **Setup > Automation > Workflow Rules**

2. Klik op **New Rule** en selecteer dezelfde module die u in stap 1 hebt gekozen

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a833428c1a45abed512a500c62a44f1c" alt="" width="2932" height="1438" data-path="images/help-center/articles/15442851/f2490da4deee-screenshot-2026-06-08-at-15-17-27.png" />
   </Frame>

3\. Stel de triggergebeurtenis in, bijvoorbeeld:

* Contact aangemaakt

* Ticketstatus gewijzigd in Open

4**. Optioneel:** Voeg condities toe om te beperken welke records een oproep starten (bijv. telefoonveld is niet leeg, specifieke afdeling)

5\. Selecteer onder **Actions** de optie **Custom Function > CloudTalk VoiceAgent**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1eefb6c3c83bb50c99b88ccc67e177bf" alt="" width="2928" height="1348" data-path="images/help-center/articles/15442851/3474f1a58059-screenshot-2026-06-08-at-15-17-38.png" />
</Frame>

6\. Sla de regel op en schakel deze in

<h3 id="h_69986ae3d2">
  Testen en controleren
</h3>

1. Maak een record aan of werk een record bij dat aan uw triggervoorwaarden voldoet

2. Ga naar **Setup > Automation > Workflow Rules**, open uw regel en bekijk de **Logs**

3. Controleer in CloudTalk of de VoiceAgent-oproep is gestart

**Helemaal klaar!** 🚀 Uw configuratie is voltooid en u kunt moeiteloos VoiceAgent-oproepen starten. Laat de automatisering maar beginnen!

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

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

<h2 id="h_de10b8a2e9">
  Problemen oplossen
</h2>

<Warning>
  Controleer eerst of uw Automation Rule is ingeschakeld en of een testrecord daadwerkelijk aan de triggervoorwaarden voldoet, voordat u specifieke fouten gaat uitzoeken.
</Warning>

| **Fout** | **Waarschijnlijke oorzaak** | **Oplossing** |
| - | - | - |
| `401 Unauthorized` | Ongeldige of verlopen inloggegevens | Genereer de `Autorisatie`-header opnieuw en werk deze bij in uw Custom Function |
| `400 Bad Request` | Onjuist opgemaakt telefoonnummer | Zorg dat het telefoonnummer in E.164-formaat staat (bijv. `+1234567890`) |
| Regel wordt niet uitgevoerd | De regel is uitgeschakeld of de triggervoorwaarden komen niet overeen | Controleer of de regel actief is en of het record aan alle voorwaarden voldoet |

***

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


## Related topics

- [Een VoiceAgent-gesprek starten vanuit Zoho CRM](/nl/articles/15516182-triggering-a-voiceagent-call-from-zoho-crm.md)
- [Een VoiceAgent-oproep activeren vanuit Freshdesk](/nl/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [Een VoiceAgent-oproep starten vanuit Pipedrive](/nl/articles/15516233-triggering-a-voiceagent-call-from-pipedrive.md)


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