Een VoiceAgent-oproep starten vanuit Salesforce

​

Voordat u begint

• Een reeds aangemaakte CloudTalk VoiceAgent (noteer de VoiceAgent-ID)
• CloudTalk API-inloggegevens (API-sleutel en Secret)
• Salesforce Enterprise edition of hoger (Flow Builder met HTTP Callout)
• Een telefoonveld op uw Contact- of Lead-records, in E.164-notatie (bijvoorbeeld +14155550100)

​

De integratie instellen

​

De Named Credential aanmaken

1. Ga naar Setup > Security > Named Credentials > External Credentials.
2. Klik op New External Credential:
   • Label: CloudTalk API
   • Name: CloudTalk_API
   • Authentication Protocol: Basic
   
3. Klik op Save en klik vervolgens onder Principals op New:
   • Kies een naam en stel Identity Type in op Named Principal.
   • Voer uw CloudTalk API Key ID in als gebruikersnaam en API Secret als wachtwoord.
   • Klik op Save.

1. Ga naar Setup > Security > Named Credentials > Named Credentials.
2. Klik op New Named Credential:
   • Label: CloudTalk
   • Name: CloudTalk
   • URL: https://api.cloudtalk.io
   • External Credential: CloudTalk API
   • Schakel onder Callout Options de opties Generate Authorization Header en Allow Formulas in HTTP Body in.
3. Klik op Save.

1. Ga naar Setup > Permission Sets, open (of maak) een permission set die aan u is toegewezen, ga vervolgens naar External Credential Principal Access > Edit, voeg uw CloudTalk_API-principal toe en klik op Save.

​

De Apex-klasse aanmaken

1. Ga naar Setup > Apex Classes > New.
2. Plak de onderstaande code, vervang YOUR_VOICE_AGENT_ID op regel 3 door uw VoiceAgent-ID en klik op Save.

public with sharing class CloudTalkVoiceAgent {

    private static final String VOICE_AGENT_ID = 'YOUR_VOICE_AGENT_ID';

    @InvocableMethod(label='Start CloudTalk Voice Agent Call' description='Triggers a CloudTalk voice agent call')
    public static void invoke(List<Request> requests) {
        for (Request r : requests) {
            startCall(r.callNumber);
        }
    }

    @future(callout=true)
    public static void startCall(String callNumber) {
        HttpRequest req = new HttpRequest();
        req.setEndpoint('callout:CloudTalk/v1/voice-agent/calls');
        req.setMethod('POST');
        req.setHeader('Content-Type', 'application/json');
        req.setBody(JSON.serialize(new Map<String, Object>{
            'call_number'    => callNumber,
            'voice_agent_id' => VOICE_AGENT_ID
        }));
        HttpResponse res = new Http().send(req);
        System.debug('CloudTalk status: ' + res.getStatusCode());
    }

    public class Request {
        @InvocableVariable(label='Call Number' required=true)
        public String callNumber;
    }
}

​

De Flow bouwen

1. Ga naar Setup > Process Automation > Flows > New Flow.
2. Selecteer Record-Triggered Flow.
3. Configureer de trigger (Object: Contact of Lead; When: een record wordt aangemaakt of een veld verandert).
4. Voeg een voorwaarde toe om records te filteren, bijvoorbeeld alleen wanneer het telefoonveld niet leeg is.
5. Klik op + > Action en zoek naar “Start CloudTalk Voice Agent Call”.
6. Stel de invoerwaarde van Call Number in op {!$Record.Phone}.
7. Klik op Save en Activate om de Flow te activeren.

​

Testen en controleren

1. Maak een record aan of werk een record bij dat aan uw triggervoorwaarden voldoet.
2. Controleer Setup > Debug Logs of de details van de Flow-interview op de uitvoering.
3. Controleer in CloudTalk of de VoiceAgent-oproep is gestart.

​

Problemen oplossen

• Unauthorized callout: zorg dat api.cloudtalk.io is toegevoegd in Remote Site Settings.
• 401 Unauthorized: controleer de inloggegevens die in de External Credential-principal zijn opgeslagen.
• 400 Bad Request: controleer of het telefoonnummer in E.164-notatie staat (bijvoorbeeld +14155550100).
• Flow wordt niet getriggerd: controleer of het record aan alle toegangsvoorwaarden voldoet en of de Flow actief is.