Skip to main content
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.
Gebruikersniveau: Beheerder

​
Voordat u begint

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)
  • Een Freshdesk Pro-abonnement of hoger
  • Een telefoonnummer dat beschikbaar is in de Contact-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 Username en uw API Secret als Password
  3. Kopieer de gegenereerde waarde. Deze ziet er zo uit: Basic XXXXXXXXX
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.

​
De integratie instellen

​
De Automation Rule aanmaken

1. Ga in Freshdesk naar Admin > Automation > Ticket Creation (of On Ticket Update, afhankelijk van wanneer u oproepen wilt activeren)
2. Klik op Start from scratch 3. Stel uw voorwaarden in, bijvoorbeeld:
  • Ticket is created
  • Contact phone is present
  • Tag contains voiceagent
4. Klik onder Actions op Add action > Trigger Webhook 5. Configureer de webhook:
6. Voeg onder Custom Headers het volgende toe:
  • Authorization > Basic XXXXXXXXX
  • Content-Type > application/json
7. Plak onder Content (Advanced) de volgende body:
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
8. Klik op Preview and save en activeer vervolgens de regel.

​
Testen en controleren

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

​
Problemen oplossen

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