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

> Automatiseer uitgaande VoiceAgent-oproepen rechtstreeks vanuit Pipedrive

<Note>
  In deze handleiding leert u hoe u automatisch een CloudTalk VoiceAgent-oproep start vanuit Pipedrive met de functie Automations.
</Note>

**Gebruikersniveau**: Admin

***

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

U heeft het volgende nodig:

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

* [CloudTalk API-inloggegevens](/nl/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (API Key ID en API Key Secret)

* Pipedrive **Advanced-abonnement of hoger** (Automations met webhook-acties vereisen Advanced+)

* Een telefoonnummer dat beschikbaar is op Person- of Deal-records

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

<h3 id="h_step1">
  De Automation-webhook aanmaken
</h3>

<Warning>
  **Let op:** Alleen global admin-gebruikers kunnen webhooks aanmaken. Bestaande reguliere webhooks kunt u niet hergebruiken voor Automations, dus u moet specifiek een Automation-webhook aanmaken.
</Warning>

1\. Klik in Pipedrive op uw **profielpictogram** en selecteer **Tools and Apps**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/f77734ddee37-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=65a9148ee4495fd80f7df964fc8a1ee3" alt="" width="400" data-path="images/help-center/articles/15516233/f77734ddee37-image.png" />
</Frame>

2\. Klik op **+ Webhook** en selecteer **Automation webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/de07daf9d028-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6b00478bb7e454e661af55d75e14c5cd" alt="" width="2769" height="1500" data-path="images/help-center/articles/15516233/de07daf9d028-image.png" />
</Frame>

3\. Configureer de webhook:

* **Name:** `CloudTalk VoiceAgent`

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

* **Authentication, Username:** uw CloudTalk API Key ID

* **Authentication, Password:** uw CloudTalk API Key Secret

<Warning>
  **Waarom eindigt de URL op `?`?** Pipedrive vereist dat URL's van Automation-webhooks eindigen op `/`, `&`, `?` of `=`. Alleen `?` wordt door de CloudTalk API geaccepteerd. Dit teken opent een lege querystring die CloudTalk negeert, waardoor de aanroep alsnog bij het juiste endpoint aankomt. De andere tekens worden gezien als onderdeel van het URL-pad, waardoor het verzoek mislukt.
</Warning>

4\. Klik op **Save**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c4e587c5bf00-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=6f104177314f9b1b6c5306bf545352e2" alt="" width="2270" height="1030" data-path="images/help-center/articles/15516233/c4e587c5bf00-image.png" />
</Frame>

<h3 id="h_step2">
  De automatisering aanmaken
</h3>

1\. Ga naar **Tools and Apps > Automations**

2\. Klik op **+ Automation**

3\. Selecteer een **trigger**, bijvoorbeeld:

* *Deal stage changed*

* *Person created or updated*

* *Activity completed*

4\. Voeg de benodigde **condities** toe (bijv. alleen uitvoeren voor een specifieke pipelinefase)

5\. Klik op **+ Add action** en selecteer **Webhook**

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/c37747817114-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=550eb243ab60d8ef6297f3064d4c0312" alt="" width="1928" height="1290" data-path="images/help-center/articles/15516233/c37747817114-image.png" />
</Frame>

<h3 id="h_step3">
  De Webhook-actie configureren
</h3>

1\. Selecteer in het veld **Webhook** de optie `CloudTalk VoiceAgent` (de webhook die u in stap 1 heeft aangemaakt)

2\. Stel **Method** in op `POST`

3\. Schakel in het gedeelte **Body** over naar **Raw** en voer het volgende in:

```json theme={"system"}
{  "call_number": "",  "voice_agent_id": "YOUR_VOICE_AGENT_ID"}
```

Gebruik voor `call_number` de knop van de veldkiezer om **Person > Phones** te selecteren. Voer uw VoiceAgent-ID in als waarde voor `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 uitvoervariabelen, afhankelijk van de configuratie van uw VoiceAgent. [Ontdek wat u kunt meesturen](/nl/articles/11401649-voiceagents-for-outbound-calls)

  Zorg ervoor dat het telefoonnummer is opgeslagen in **E.164-formaat** (`+1234567890`), anders weigert CloudTalk het verzoek.
</Warning>

<Warning>
  **Contacten met meerdere telefoonnummers:** Het Person Phones-veld van Pipedrive kan meerdere nummers bevatten. Als een contact er meer dan één heeft, geeft het veld ze allemaal door aan CloudTalk in plaats van één nummer, waardoor het verzoek ongeldig wordt en de oproep mislukt. **Tijdelijke oplossing:** maak een apart aangepast telefoonveld met één waarde aan (**Settings > Data fields > Person**), sla daarin alleen het te bellen nummer op in E.164-formaat en koppel dat veld aan `call_number`.
</Warning>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/0c71cf9fcd8d-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=93c6028b4bdd3d9b29eb40fc62e07ef9" alt="" width="400" data-path="images/help-center/articles/15516233/0c71cf9fcd8d-image.png" />
</Frame>

<h3 id="h_step4">
  Activeren en testen
</h3>

1. Sla de automatisering op en **activeer** deze

2. Trigger de conditie handmatig met een testrecord (bijv. verplaats een deal naar de gewenste fase)

3. Ga naar **Automations > History** en controleer of de actie is uitgevoerd met status **SUCCESS**

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

**Klaar!** 🚀 Uw Pipedrive-automatisering start nu een CloudTalk VoiceAgent-oproep zodra een record aan de door u gekozen condities voldoet.

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

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

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

Als de VoiceAgent-oproep niet is gestart:

1. Ga naar **Automations > History**

2. Selecteer het filter **Failed**

3. Open de mislukte uitvoering om te zien welke stap is mislukt

<Frame>
  <img src="https://mintcdn.com/cloudtalk/akDGinDOBsihWn_p/images/help-center/articles/15516233/b8eaaf2d1470-image.png?fit=max&auto=format&n=akDGinDOBsihWn_p&q=85&s=3f4076863ebb895c14f29b28d4953528" alt="" width="2410" height="626" data-path="images/help-center/articles/15516233/b8eaaf2d1470-image.png" />
</Frame>

| **Fout** | **Wat u moet controleren** |
| - | - |
| **Authenticatie** | Verkeerde CloudTalk API Key ID of Secret in de webhook. Genereer ze opnieuw en voer ze opnieuw in. |
| **Telefoonnummer** | Het nummer staat niet in E.164-formaat, of het contact heeft meerdere telefoonnummers (zie de opmerking bij stap 3 hierboven) |
| **Onjuist VoiceAgent-ID** | Controleer of de `voice_agent_id` in de body van de webhook correct is |

***

Hulp nodig of heeft 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 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)
- [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.