Skip to main content
In deze handleiding leert u hoe u automatisch een CloudTalk VoiceAgent-oproep start vanuit Pipedrive met de functie Automations.
Gebruikersniveau: Admin

​
Voordat u begint

U heeft het volgende nodig:
  • Een reeds aangemaakte CloudTalk VoiceAgent (noteer het VoiceAgent-ID)
  • CloudTalk API-inloggegevens (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

​
De integratie instellen

​
De Automation-webhook aanmaken

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.
1. Klik in Pipedrive op uw profielpictogram en selecteer Tools and Apps
2. Klik op + Webhook en selecteer Automation webhook
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
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.
4. Klik op Save

​
De automatisering aanmaken

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

​
De Webhook-actie configureren

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:
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.
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 meesturenZorg ervoor dat het telefoonnummer is opgeslagen in E.164-formaat (+1234567890), anders weigert CloudTalk het verzoek.
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.

​
Activeren en testen

  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.
💡 API-limieten om rekening mee te houdenZorg 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.

​
Problemen oplossen

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
Hulp nodig of heeft u een vraag? Neem contact met ons op via ons supportportaal. Wij staan voor u klaar.