> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# VoiceAgent-Anruf aus Salesforce auslösen

> Lösen Sie CloudTalk-VoiceAgent-Anrufe direkt aus Salesforce aus – mit Flow Builder und einem Apex-HTTP-Callout

<Note>
  Sie können einen CloudTalk-VoiceAgent-Anruf automatisch aus Salesforce auslösen – mit Flow Builder und einem HTTP Callout, das auf einer Apex-Klasse basiert. Diese Anleitung zeigt Ihnen, wie Sie die Verbindung einrichten, die Anrufaktion hinzufügen und bestätigen, dass der Anruf gestartet wurde.
</Note>

**Benutzerebene:** Admin

***

<h2 id="h_c534ee90a9">
  Bevor Sie beginnen
</h2>

Sie benötigen:

* Einen bereits erstellten CloudTalk-VoiceAgent (notieren Sie sich die VoiceAgent-ID)

* [CloudTalk-API-Zugangsdaten](/de/articles/15272380-how-to-access-and-generate-your-cloudtalk-api-keys) (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`)

<h2 id="h_d679197c7b">
  Integration einrichten
</h2>

<h3 id="h_1a1932ad04">
  Named Credential erstellen
</h3>

Erstellen Sie zunächst eine External Credential, um Ihren CloudTalk-API-Schlüssel sicher zu speichern:

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

   <Frame>
     <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/f42afbda40a0-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=9aa5faa95041ed98f83abc78b33f4f9c" alt="" width="909" height="284" data-path="images/help-center/articles/16064425/f42afbda40a0-image.png" />
   </Frame>

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**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/80d0479bd0d9-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=2bc7d38895a1ff4a48d88726ddb32479" alt="" width="899" height="864" data-path="images/help-center/articles/16064425/80d0479bd0d9-image.png" />
</Frame>

Erstellen Sie als Nächstes die Named Credential, die auf CloudTalk verweist:

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**.

Gewähren Sie sich zum Schluss Zugriff auf die Credential:

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**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/3714caae4af3-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3a0b3aa65e24b50345d6613885bb28fc" alt="" width="909" height="284" data-path="images/help-center/articles/16064425/3714caae4af3-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/f22a61ebe097-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=e91164bb89d61a0ec4f33a675a6b2775" alt="" width="899" height="864" data-path="images/help-center/articles/16064425/f22a61ebe097-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/c3209907f03c-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=c24c2ae14f775dec4986bc5ef012b629" alt="" width="899" height="460" data-path="images/help-center/articles/16064425/c3209907f03c-image.png" />
</Frame>

<h3 id="h_0c78cde929">
  Apex-Klasse erstellen
</h3>

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;
    }
}
```

<h3 id="h_8eb7a6f11f">
  Flow erstellen
</h3>

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**.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16064425/be2af2a8b68a-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3cb9bb48204255b2c370e1710c2691b2" alt="" width="971" height="767" data-path="images/help-center/articles/16064425/be2af2a8b68a-image.png" />
</Frame>

<Warning>
  `call_number` und `voice_agent_id` sind die einzigen Pflichtfelder. Optional können Sie `call_properties` hinzufügen, etwa System-Prompt-Variablen (Daten, die der VoiceAgent während des Anrufs verwendet) und Ausgabevariablen (Daten, die nach dem Anruf an Ihren Endpunkt zurückgegeben werden) – je nach Konfiguration Ihres VoiceAgent. [Erfahren Sie, was Sie einbeziehen sollten](/de/articles/11401649-voiceagents-for-outbound-calls).
</Warning>

<h3 id="h_d2c4d04fd1">
  Testen und überprüfen
</h3>

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.

**Fertig!** 🚀 Ihr Salesforce-Flow löst nun automatisch einen CloudTalk-VoiceAgent-Anruf aus, sobald ein Datensatz Ihre gewählten Bedingungen erfüllt.

<h2 id="h_aa42546889">
  Fehlerbehebung
</h2>

* **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.

***

Brauchen Sie Hilfe oder haben Sie eine Frage? Wenden Sie sich an unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884). Wir sind für Sie da.


## Related topics

- [VoiceAgent-Anruf aus Kustomer auslösen](/de/articles/16063131-triggering-a-voiceagent-call-from-kustomer.md)
- [VoiceAgent-Anruf aus Freshdesk auslösen](/de/articles/15457387-triggering-a-voiceagent-call-from-freshdesk.md)
- [VoiceAgent-Anruf aus Freshservice auslösen](/de/articles/15502021-triggering-a-voiceagent-call-from-freshservice.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.