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

> Automatiseer VoiceAgent-oproepen vanuit Zendesk Triggers en Automations

<Note>
  U kunt automatisch een CloudTalk VoiceAgent-oproep starten vanuit Zendesk Triggers of Automations. Zendesk ondersteunt Basic Authentication standaard in de Webhooks-configuratie, dus er is geen middleware nodig. In deze handleiding leest u hoe u de webhook instelt, deze aan een trigger koppelt en controleert of de oproep is gestart.
</Note>

**Gebruikersniveau**: Admin

***

<h2 id="before-you-start">
  Voordat u begint
</h2>

U hebt het volgende nodig:

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

* CloudTalk API-sleutel en Secret (**Bedrijfsinstellingen > Integraties > API**)

* Zendesk Support Professional-abonnement of hoger

* Contact-/aanvragerrecords met een telefoonnummer

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

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

1. Ga in het Zendesk Admin Center naar **Apps and integrations > Webhooks**.

2. Klik op **Create webhook**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/b1a87fcbfc33-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3b3b2435d5b92b81e7ff3e70e6d73eac" alt="" width="3600" height="2064" data-path="images/help-center/articles/15934846/b1a87fcbfc33-image.png" />
   </Frame>

3. Selecteer **Trigger or automation** en klik op **Next**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/d66feedd2495-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=506cf3c3e35dd681833fb33a90c56c46" alt="" width="2970" height="1896" data-path="images/help-center/articles/15934846/d66feedd2495-image.png" />
   </Frame>

4. Configureer de webhook:

   * **Name:** CloudTalk VoiceAgent

   * **Endpoint URL:** `https://api.cloudtalk.io/v1/voice-agent/calls`

   * **Request method:** POST

   * **Request format:** JSON

   * **Authentication:** Basic authentication

     * **Username:** uw CloudTalk API-sleutel

     * **Password:** uw CloudTalk API Secret

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/6295a2943f0e-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=78c8949f05e2337d22167fae3481702c" alt="" width="1586" height="1528" data-path="images/help-center/articles/15934846/6295a2943f0e-image.png" />
   </Frame>

5. Klik op **Create webhook > Finish Setup**.

<Note>
  Zendesk codeert de inloggegevens automatisch in Base64 wanneer Basic authentication is geselecteerd.
</Note>

<h3 id="h_81ccd62750">
  De trigger aanmaken
</h3>

1. Ga in het Admin Center naar **Objects and rules > Business rules > Triggers** (of **Automations**).

2. Klik op **Create trigger**.

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/e30863086760-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=45848cc42f215461c9dbbff9d8c3c689" alt="" width="3628" height="1532" data-path="images/help-center/articles/15934846/e30863086760-image.png" />
   </Frame>

3. Voer een **Trigger name** in (bijv. Ticket Solved).

4. Kies een **Trigger category**: maak een nieuwe categorie aan of kies een bestaande die past.

5. Stel uw **Conditions** in (bijv. Ticket > Status > Is > Solved).

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15934846/036d3ef902d4-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=15d81021252741ab2093e78d05d3fba1" alt="" width="1538" height="1242" data-path="images/help-center/articles/15934846/036d3ef902d4-image.png" />
   </Frame>

6. Klik onder **Actions** op **Add action** en selecteer **Notify active webhook**.

7. Selecteer de webhook die u in stap 1 hebt aangemaakt. Er verschijnt een tekstvak voor de JSON-body.

8. Voer uw JSON-payload in het tekstvak in. Gebruik de Zendesk-placeholder `#{{ticket.requester.phone}}` om het telefoonnummer van de aanvrager toe te wijzen aan `call_number`:

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/15934846/bd395bb986f2-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=abcee019a5e4d70d2fa724ad55563348" alt="" width="1574" height="1770" data-path="images/help-center/articles/15934846/bd395bb986f2-image.png" />
   </Frame>

```json theme={"system"}
{
  "call_number": "#{{ticket.requester.phone}}",
  "voice_agent_id": "YOUR_VOICE_AGENT_ID"
}
```

<Note>
  `call_number` en `voice_agent_id` zijn de enige verplichte velden. Aanvullende `call_properties`, zoals systeemprompt-variabelen en outputvariabelen, zijn optioneel en hangen af van uw VoiceAgent-configuratie. [Lees wat u kunt opnemen](/nl/articles/11401649-voiceagents-for-outbound-calls).
</Note>

9\. Zet de trigger rechtsonder op **Active** en klik op **Create**.

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

1. Werk een testticket bij zodat het aan de triggervoorwaarden voldoet.

2. Ga naar **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** om de aflevering te bevestigen.

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

**Klaar!**

Zendesk start nu automatisch een CloudTalk VoiceAgent-oproep zodra een ticket aan de door u gekozen voorwaarden voldoet.

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

Is de oproep niet gestart, ga dan naar **Apps and integrations > Webhooks > CloudTalk VoiceAgent > Activity** om te zien waarom de aflevering is mislukt.

De meest voorkomende oorzaken zijn:

* **Autorisatie**: onjuiste CloudTalk API-inloggegevens in de webhook

* **Telefoonnotatie**: het nummer staat niet in E.164-notatie (`+1234567890`)

* **Onjuist VoiceAgent-ID**: er is een verkeerd `voice_agent_id` verzonden

* **Webhook niet geactiveerd**: de trigger is niet actief of er is niet aan de voorwaarden voldaan

***

*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 Salesforce](/nl/articles/16064425-triggering-a-voiceagent-call-from-salesforce.md)
- [Een VoiceAgent-oproep starten vanuit Zapier](/nl/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)


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