> ## 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 activeren vanuit Freshdesk

> Automatiseer VoiceAgent-oproepen rechtstreeks vanuit Freshdesk

<Note>
  In deze handleiding leert u hoe u automatisch een CloudTalk VoiceAgent-oproep vanuit Freshdesk start met behulp van Automation Rules. Met de actie **Trigger Webhook** hebt u volledige controle over de HTTP-methode, URL, headers en body, zodat oproepen rechtstreeks vanuit ticketgebeurtenissen kunnen worden gestart.
</Note>

**Gebruikersniveau**: Beheerder

***

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

U hebt het volgende nodig:

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

* CloudTalk API-inloggegevens (API-sleutel en Secret) die u vindt in **Bedrijfsinstellingen > Integraties > API** ([Uw CloudTalk API-sleutels openen en genereren](/nl/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys))

* Een Freshdesk **Pro-abonnement** of hoger

* Een telefoonnummer dat beschikbaar is in de Contact-records

<h2 id="h_e32b3b4cc1">
  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 Username en uw **API Secret** als Password

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

<Warning>
  **Let op:** Freshdesk accepteert in de webhookconfiguratie ook een gewone combinatie van gebruikersnaam en wachtwoord, dus de Base64-gecodeerde header is optioneel. Beide methoden werken.
</Warning>

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

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

1\. Ga in Freshdesk naar **Admin > Automation > Ticket Creation** (of **On Ticket Update**, afhankelijk van wanneer u oproepen wilt activeren)

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=5a7cc485d58bd1d956110794946f4af7" alt="" width="2936" height="1322" data-path="images/help-center/articles/15457387/459801bf74ad-screenshot-2026-06-05-at-10-53-54.png" />
</Frame>

2\. Klik op **Start from scratch**

3\. Stel uw **voorwaarden** in, bijvoorbeeld:

* *Ticket is created*

* *Contact phone is present*

* *Tag contains* `voiceagent`

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f883a536c594b5986ed2490dbcdb112" alt="" width="2926" height="1310" data-path="images/help-center/articles/15457387/ebd0b5c7f2ee-screenshot-2026-06-05-at-10-59-53.png" />
</Frame>

4\. Klik onder **Actions** op **Add action > Trigger Webhook**

5\. Configureer de webhook:

| **Veld** | **Waarde** |
| - | - |
| Request type | POST |
| URL | `https://api.cloudtalk.io/v1/voice-agent/calls` |
| Encoding | JSON |

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=88d12880285be17c78721cb9768b7c11" alt="" width="2926" height="1332" data-path="images/help-center/articles/15457387/06136a27c11d-screenshot-2026-06-05-at-11-00-17.png" />
</Frame>

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

* `Authorization` > `Basic XXXXXXXXX`

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

7\. Plak onder **Content (Advanced)** de volgende body:

```json theme={"system"}
{
  "call_number": "#{{ticket.contact.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 systeempromptvariabelen en uitvoervariabelen, afhankelijk van uw VoiceAgent-configuratie. [Ontdek wat u kunt opnemen](/nl/articles/11401649-voiceagents-for-outbound-calls)
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=623092ba130f596b5667a223dc720089" alt="" width="2922" height="1316" data-path="images/help-center/articles/15457387/9cf3505f96ed-screenshot-2026-06-05-at-11-00-39.png" />
</Frame>

8\. Klik op **Preview and save** en activeer vervolgens de regel.

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

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

2. Ga naar **Admin > Automation** en controleer het uitvoeringslogboek van de regel

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

**U bent helemaal klaar!** 🚀 Uw Freshdesk-automatiseringsregel start nu een CloudTalk VoiceAgent-oproep zodra een ticket aan uw gekozen voorwaarden voldoet.

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

  *Zorg ervoor dat uw Freshdesk-automatisering de verdeling van oproepen zorgvuldig afhandelt, zodat u fouten of throttling voorkomt. Gebruik waar nodig vertragingen of planningslogica, want de standaard API-limiet (60 verzoeken per minuut) geldt ook voor het VoiceAgent-endpoint.*
</Info>

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

| Fout | Wat u moet controleren |
| - | - |
| **401 Unauthorized** | Genereer de Authorization-header opnieuw en voer hem opnieuw in |
| **400 Bad Request** | Controleer of het telefoonnummer de E.164-notatie heeft (`+1234567890`) en of `voice_agent_id` juist is |
| **Regel wordt niet geactiveerd** | Controleer of aan alle voorwaarden wordt voldaan en of de regel is ingeschakeld |

***

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). We staan voor u klaar.


## Related topics

- [Een VoiceAgent-oproep activeren vanuit Freshservice](/nl/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)
- [Een VoiceAgent-oproep activeren vanuit Kustomer](/nl/articles/16063131-triggering-a-voiceagent-call-from-kustomer.md)
- [Een VoiceAgent-oproep activeren vanuit Make](/nl/articles/11830974-triggering-a-voiceagent-call-from-make.md)


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