> ## 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-gesprek starten vanuit Zoho CRM

> Automatiseer uitgaande VoiceAgent-gesprekken rechtstreeks vanuit Zoho CRM

<Note>
  In deze handleiding leest u hoe u automatisch een CloudTalk VoiceAgent-gesprek start vanuit Zoho CRM met behulp van Workflow Rules.
</Note>

**Gebruikersniveau**: Admin

***

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

U hebt het volgende nodig:

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

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

* Zoho CRM **Professional-abonnement** of hoger

* Een telefoonveld op Contact- of Lead-records

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

CloudTalk gebruikt Basic Authentication voor API-verzoeken.

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

2. Voer uw **CloudTalk API-sleutel** in als gebruikersnaam en uw **API-secret** als wachtwoord

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

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

<h3 id="h_create_webhook">
  De webhook aanmaken
</h3>

1\. Klik in Zoho CRM op het **tandwielpictogram** rechtsboven en ga naar **Automation > Actions > Webhooks**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/98feae8fe1a4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c66f0979edeb7832e8f6616f11539e01" alt="" width="2840" height="1160" data-path="images/help-center/articles/15516182/98feae8fe1a4-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/73f55ba967b7-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88bd7e10c27198c0b30f581ff28cba2e" alt="" width="2384" height="544" data-path="images/help-center/articles/15516182/73f55ba967b7-image.png" />
</Frame>

2\. Klik op **Configure Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/c29a495b2b90-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=1fc63b01d658701a43e6dfce477807bf" alt="" width="2384" height="530" data-path="images/help-center/articles/15516182/c29a495b2b90-image.png" />
</Frame>

3\. Vul de webhookgegevens in:

| **Veld** | **Waarde** |
| - | - |
| Name | CloudTalk VoiceAgent |
| URL to Notify | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Method | POST |
| Authorization Type | General |
| Module | Contacts of Leads |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/4a5c1aef7583-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=a28db82730d3f7679e9ffb17a0c66e40" alt="" width="1385" height="949" data-path="images/help-center/articles/15516182/4a5c1aef7583-image.png" />
</Frame>

4\. Voeg onder **Custom Headers** het volgende toe:

* `Authorization` → `Basic XXXXXXXXX` (uw gegenereerde waarde)

* `Content-Type` → `application/json`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5242d55f0b27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=553381a3ed9fd980e2c3a4d21af4a47b" alt="" width="1644" height="514" data-path="images/help-center/articles/15516182/5242d55f0b27-image.png" />
</Frame>

5\. Stel onder **Body** **Type** in op Raw en **Format** op JSON en plak vervolgens:

```json theme={"system"}
{  "call_number": "${Contacts.Phone}",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

<Warning>
  `call_number` en `voice_agent_id` zijn de enige verplichte velden. U kunt ook optionele `call_properties` meesturen, zoals variabelen voor de systeemprompt en outputvariabelen, afhankelijk van uw VoiceAgent-configuratie. [Ontdek wat u kunt meesturen](/nl/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5dae1c82d009-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=eeb1d0596d12ab9a036373e3e3ca726f" alt="" width="2298" height="474" data-path="images/help-center/articles/15516182/5dae1c82d009-image.png" />
</Frame>

6\. Klik op **Save**

<h3 id="h_create_rule">
  De Workflow Rule aanmaken
</h3>

1\. Klik op het **tandwielpictogram** rechtsboven en ga naar **Automation > Workflow Rules**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/801053f501d3-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=bcca196dfb6b5f1365ed0d7a3ded13f5" alt="" width="2856" height="1114" data-path="images/help-center/articles/15516182/801053f501d3-image.png" />
</Frame>

2\. Klik op **Create Rule**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/5ef19e32b2ee-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c3e2c947e6af57bfcdc914cca28bf0de" alt="" width="2850" height="874" data-path="images/help-center/articles/15516182/5ef19e32b2ee-image.png" />
</Frame>

<Warning>
  **Let op:** webhooks zijn beschikbaar vanaf Zoho CRM Professional edition en hoger.
</Warning>

3\. Configureer de regel:

* Selecteer de **module** (bijv. Contacts of Leads) en geef de regel een naam

* Stel de **trigger** in (bijv. een record wordt aangemaakt, een veld wordt gewijzigd)

* Voeg **condities** toe om records te filteren (bijv. telefoonveld is niet leeg)

* Voeg onder **Instant Actions** het volgende toe: **Webhook > CloudTalk VoiceAgent**

4\. Klik op **Save** en daarna op **Activate** om de regel te activeren

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/51a5a32cd713-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=c7d4b1550da7b824c867024705ed11b0" alt="" width="2016" height="1258" data-path="images/help-center/articles/15516182/51a5a32cd713-image.png" />
</Frame>

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

1. Maak een Contact aan of werk een Contact bij dat aan uw triggercondities voldoet

2. Ga naar **tandwielpictogram > Automation > Workflow Rules**, selecteer uw regel en klik op **View Usage** om de uitvoering te controleren

3. Controleer in CloudTalk of het VoiceAgent-gesprek is gestart

**Klaar!** 🚀 Uw Zoho CRM-workflow start nu een CloudTalk VoiceAgent-gesprek zodra een record aan de door u gekozen condities voldoet.

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

  *Zorg ervoor dat uw workflow de gespreksverdeling 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_troubleshooting">
  Problemen oplossen
</h2>

Is het VoiceAgent-gesprek niet tot stand gekomen? Ga dan naar **View Usage** en klik op **Failures**. Zoek uw record op en bekijk de kolom **Reason For Failures**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516182/f6fcd150ee27-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=186290eea2a7b0d1b57b663a9c28e4dd" alt="" width="2828" height="1232" data-path="images/help-center/articles/15516182/f6fcd150ee27-image.png" />
</Frame>

| **Fout** | **Wat u moet controleren** |
| - | - |
| **Autorisatie** | Onjuiste CloudTalk API-gegevens in de webhook — genereer ze opnieuw en voer ze opnieuw in |
| **Telefoonformaat** | Zorg ervoor dat het nummer in E.164-formaat staat (`+1234567890`) |
| **Onjuist VoiceAgent-ID** | Controleer of de `voice_agent_id` in de body van de webhook klopt |
| **Webhook niet geactiveerd** | Controleer of de workflowregel actief is en of aan de condities is voldaan |

***

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


## Related topics

- [Een VoiceAgent-oproep triggeren vanuit Zoho Desk](/nl/articles/15442851-triggering-a-voiceagent-call-from-zoho-desk.md)
- [Een VoiceAgent-oproep starten vanuit Zapier](/nl/articles/11831224-triggering-a-voiceagent-call-from-zapier.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.