Een VoiceAgent-oproep triggeren vanuit Zoho Desk

U kunt automatisch een CloudTalk VoiceAgent-oproep laten starten, rechtstreeks vanuit de Automation Rules in Zoho Desk. In deze handleiding leest u hoe u een Custom Function aanmaakt, deze koppelt aan een Workflow Rule en controleert of de oproepen correct worden gestart.

Gebruikersniveau: Admin

Voordat u begint

U hebt het volgende nodig:

Een reeds aangemaakte CloudTalk VoiceAgent (noteer het VoiceAgent-ID)
CloudTalk API-gegevens (API-sleutel en Secret) — te vinden in Bedrijfsinstellingen > Integraties > API (Uw CloudTalk API-sleutels bekijken en genereren)
Een Zoho Desk-account met toegang tot Automation
Contactrecords met telefoonnummers

De Authorization-header genereren

CloudTalk gebruikt Basic Authentication voor API-verzoeken. Zo genereert u uw gecodeerde waarde:

Ga naar https://www.debugbear.com/basic-auth-header-generator
Voer uw CloudTalk API-sleutel in als Username en het API Secret als Password
Kopieer de gegenereerde header. Deze ziet er ongeveer zo uit: Basic XXXXXXXXX

U gebruikt deze waarde in het Custom Function-script hieronder.

De integratie instellen

De Custom Function aanmaken

1. Ga naar Setup > Developer Space > Custom Functions 2. Klik op New Function 3. Configureer de functie:

Function Name: CloudTalk VoiceAgent
Module: Selecteer de module die de oproep moet starten (bijv. Contacts, Tickets)

4. Voeg onder Argument Mapping het volgende toe:

Argument Name: phoneNumber > Select Field: Contact Phone (of het relevante telefoonveld voor uw module)

5. Plak het volgende script in de editor Function Script:

phoneVal = phoneNumber;
agentId = "YOUR_VOICE_AGENT_ID";
jsonBody = '{"call_number":"' + phoneVal + '","voice_agent_id":"' + agentId + '"}';

headers = Map();
headers.put("Authorization","Basic XXXXXXXXX");
headers.put("Content-Type","application/json");

response = invokeurl
[
    url: "https://api.cloudtalk.io/v1/voice-agent/calls"
    type: POST
    parameters: jsonBody
    headers: headers
];

info response;

Vervang YOUR_VOICE_AGENT_ID door uw eigen VoiceAgent-ID en XXXXXXXXX door uw Base64-gecodeerde gegevens uit de vorige stap.

call_number en voice_agent_id zijn de enige verplichte velden. Optioneel kunt u extra call_properties meesturen, zoals variabelen voor de system prompt of outputvariabelen, afhankelijk van de configuratie van uw VoiceAgent. Bekijk wat u kunt meesturen.

6. Klik op Save Script en vervolgens op Save.

De Automation Rule aanmaken

Ga naar Setup > Automation > Workflow Rules
Klik op New Rule en selecteer dezelfde module die u in stap 1 hebt gekozen

3. Stel de triggergebeurtenis in, bijvoorbeeld:

Contact aangemaakt
Ticketstatus gewijzigd in Open

4. Optioneel: Voeg condities toe om te beperken welke records een oproep starten (bijv. telefoonveld is niet leeg, specifieke afdeling) 5. Selecteer onder Actions de optie Custom Function > CloudTalk VoiceAgent

6. Sla de regel op en schakel deze in

Testen en controleren

Maak een record aan of werk een record bij dat aan uw triggervoorwaarden voldoet
Ga naar Setup > Automation > Workflow Rules, open uw regel en bekijk de Logs
Controleer in CloudTalk of de VoiceAgent-oproep is gestart

Helemaal klaar! 🚀 Uw configuratie is voltooid en u kunt moeiteloos VoiceAgent-oproepen starten. Laat de automatisering maar beginnen!

💡 API-limieten om rekening mee te houdenZorg ervoor dat uw automatisering in Zoho Desk de verdeling van oproepen 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

Controleer eerst of uw Automation Rule is ingeschakeld en of een testrecord daadwerkelijk aan de triggervoorwaarden voldoet, voordat u specifieke fouten gaat uitzoeken.

Fout	Waarschijnlijke oorzaak	Oplossing
`401 Unauthorized`	Ongeldige of verlopen inloggegevens	Genereer de `Autorisatie`-header opnieuw en werk deze bij in uw Custom Function
`400 Bad Request`	Onjuist opgemaakt telefoonnummer	Zorg dat het telefoonnummer in E.164-formaat staat (bijv. `+1234567890`)
Regel wordt niet uitgevoerd	De regel is uitgeschakeld of de triggervoorwaarden komen niet overeen	Controleer of de regel actief is en of het record aan alle voorwaarden voldoet

Hulp nodig of hebt u een vraag? Neem gerust contact met ons op via ons Support portal — we staan voor u klaar.

Aan de slag

Nummers & portering

AI

AI Sales Dialer

CloudTalk Phone & Go

Berichten

Dashboard

Integraties

Facturering & abonnement

Technisch nieuws & updates

Oude Dashboard

Een VoiceAgent-oproep triggeren vanuit Zoho Desk

Voordat u begint

De Authorization-header genereren