Skip to main content
In deze handleiding leert u hoe u automatisch een CloudTalk VoiceAgent-oproep activeert vanuit Freshservice met de Workflow Automator.
Gebruikersniveau: Beheerder
Let op: Gebruik de Web Request Node, niet de Trigger Webhook-node. De Web Request Node wacht op het API-antwoord en ondersteunt het parsen van JSON-antwoorden, zodat u fouten kunt opvangen. De Trigger Webhook-node werkt volgens het fire-and-forget-principe en bevestigt niet of het gelukt is.

​
Voordat u begint

U hebt nodig:
  • Een reeds aangemaakte CloudTalk VoiceAgent (noteer de VoiceAgent-ID)
  • CloudTalk API-gegevens (API-sleutel en Secret) die u vindt in Bedrijfsinstellingen > Integraties > API (Hoe u uw CloudTalk API-sleutels bekijkt en genereert)
  • Een Freshservice Pro-abonnement of hoger
  • Een telefoonnummer dat beschikbaar is op Requester-records

​
Uw CloudTalk-API-gegevens opzoeken

De Web Request Node heeft een ingebouwd Basic Auth-formulier, dus voorafgaande codering is niet nodig.
  1. Ga in CloudTalk naar Bedrijfsinstellingen > Integraties > API
  2. Noteer uw API Key ID — dit wordt de Username
  3. Noteer uw API Secret — dit wordt het Password

​
De integratie instellen

​
De workflow aanmaken

1. Ga in Freshservice naar Admin > Workflow Automator 2. Klik op Create > Workflow 3. Stel de Event trigger in, bijvoorbeeld:
  • Ticket raised
  • Ticket updated (status verandert in Pending)
  • Requester replies
4. Voeg condities toe om te filteren welke tickets de oproep activeren (bijv. telefoonnummer van de requester aanwezig, specifieke categorie)

​
De Web Request Node toevoegen

1. Klik op + om een actieblok toe te voegen 2. Selecteer Web Request Node 3. Configureer de node: 4. Plak onder Request body het volgende:
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. Bekijk wat u kunt meesturen
5. Verbind de node met de trigger en klik op Activate

​
Testen en controleren

  1. Maak een ticket aan of werk een ticket bij dat aan uw triggercondities voldoet
  2. Open Workflow Automator en bekijk de uitvoeringsgeschiedenis
  3. Controleer in CloudTalk of de VoiceAgent-oproep is gestart
Klaar! 🚀 Uw Freshservice-workflow activeert nu een CloudTalk VoiceAgent-oproep zodra een ticket aan uw gekozen condities voldoet.
💡 API-limieten om rekening mee te houdenZorg ervoor dat uw workflow de verdeling van oproepen zorgvuldig afhandelt om fouten of throttling te voorkomen. Gebruik waar nodig vertragingen of planningslogica, want de standaard API-limiet (60 verzoeken per minuut) geldt voor het VoiceAgent-endpoint.

​
Problemen oplossen

Hulp nodig of hebt u een vraag? Neem contact op via ons supportportaal. We staan voor u klaar.