VoiceAgent-Anruf aus Salesforce auslösen

​

Bevor Sie beginnen

• Einen bereits erstellten CloudTalk-VoiceAgent (notieren Sie sich die VoiceAgent-ID)
• CloudTalk-API-Zugangsdaten (API-Schlüssel und Secret)
• Salesforce Enterprise Edition oder höher (Flow Builder mit HTTP Callout)
• Ein Telefonfeld in Ihren Contact- oder Lead-Datensätzen, im Format E.164 (zum Beispiel +14155550100)

​

Integration einrichten

​

Named Credential erstellen

1. Gehen Sie zu Setup > Security > Named Credentials > External Credentials.
2. Klicken Sie auf New External Credential:
   • Label: CloudTalk API
   • Name: CloudTalk_API
   • Authentication Protocol: Basic
   
3. Klicken Sie auf Save und dann unter Principals auf New:
   • Wählen Sie einen Namen und setzen Sie Identity Type auf Named Principal.
   • Geben Sie Ihre CloudTalk-API-Schlüssel-ID als Benutzernamen und das API-Secret als Passwort ein.
   • Klicken Sie auf Save.

1. Gehen Sie zu Setup > Security > Named Credentials > Named Credentials.
2. Klicken Sie auf New Named Credential:
   • Label: CloudTalk
   • Name: CloudTalk
   • URL: https://api.cloudtalk.io
   • External Credential: CloudTalk API
   • Aktivieren Sie unter Callout Options die Optionen Generate Authorization Header und Allow Formulas in HTTP Body.
3. Klicken Sie auf Save.

1. Gehen Sie zu Setup > Permission Sets, öffnen (oder erstellen) Sie ein Ihnen zugewiesenes Permission Set, gehen Sie dann zu External Credential Principal Access > Edit, fügen Sie Ihren Principal CloudTalk_API hinzu und klicken Sie auf Save.

​

Apex-Klasse erstellen

1. Gehen Sie zu Setup > Apex Classes > New.
2. Fügen Sie den folgenden Code ein, ersetzen Sie YOUR_VOICE_AGENT_ID in Zeile 3 durch Ihre VoiceAgent-ID und klicken Sie auf 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;
    }
}

​

Flow erstellen

1. Gehen Sie zu Setup > Process Automation > Flows > New Flow.
2. Wählen Sie Record-Triggered Flow aus.
3. Konfigurieren Sie den Trigger (Object: Contact oder Lead; When: ein Datensatz wird erstellt oder ein Feld ändert sich).
4. Fügen Sie eine Bedingung hinzu, um Datensätze zu filtern, zum Beispiel nur, wenn das Telefonfeld nicht leer ist.
5. Klicken Sie auf + > Action und suchen Sie nach „Start CloudTalk Voice Agent Call“.
6. Setzen Sie den Eingabewert Call Number auf {!$Record.Phone}.
7. Speichern Sie mit Save und aktivieren Sie den Flow mit Activate.

​

Testen und überprüfen

1. Erstellen oder aktualisieren Sie einen Datensatz, der Ihre Trigger-Bedingungen erfüllt.
2. Prüfen Sie Setup > Debug Logs oder die Details des Flow-Interviews auf die Ausführung.
3. Bestätigen Sie in CloudTalk, dass der VoiceAgent-Anruf gestartet wurde.

​

Fehlerbehebung

• Unauthorized callout: Stellen Sie sicher, dass api.cloudtalk.io in den Remote Site Settings eingetragen ist.
• 401 Unauthorized: Überprüfen Sie die im Principal der External Credential gespeicherten Zugangsdaten.
• 400 Bad Request: Vergewissern Sie sich, dass die Telefonnummer im Format E.164 vorliegt (zum Beispiel +14155550100).
• Flow wird nicht ausgelöst: Vergewissern Sie sich, dass der Datensatz alle Eintrittsbedingungen erfüllt und der Flow aktiv ist.