Skip to main content
In deze handleiding leest u hoe u automatisch een CloudTalk VoiceAgent-gesprek start vanuit Zoho CRM met behulp van Workflow Rules.
Gebruikersniveau: Admin

​
Voordat u begint

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)
  • Zoho CRM Professional-abonnement of hoger
  • Een telefoonveld op Contact- of Lead-records

​
De Authorization-header genereren

CloudTalk gebruikt Basic Authentication voor API-verzoeken.
  1. Open 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

​
De integratie instellen

​
De webhook aanmaken

1. Klik in Zoho CRM op het tandwielpictogram rechtsboven en ga naar Automation > Actions > Webhooks
2. Klik op Configure Webhook
3. Vul de webhookgegevens in:
4. Voeg onder Custom Headers het volgende toe:
  • Authorization → Basic XXXXXXXXX (uw gegenereerde waarde)
  • Content-Type → application/json
5. Stel onder Body Type in op Raw en Format op JSON en plak vervolgens:
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
6. Klik op Save

​
De Workflow Rule aanmaken

1. Klik op het tandwielpictogram rechtsboven en ga naar Automation > Workflow Rules
2. Klik op Create Rule
Let op: webhooks zijn beschikbaar vanaf Zoho CRM Professional edition en hoger.
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

​
Testen en controleren

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

​
Problemen oplossen

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