Skip to main content
Workflow-Automatisierungen sollen die Arbeit eines Agenten erleichtern, indem sie Prozesse automatisieren – etwa das Senden einer Follow-up-Nachricht, das Transkribieren bestimmter Anrufe oder das automatische Weiterleiten von Transkriptionen an Slack. Der Schritttyp, der diese Aktionen ausführt, heißt Aktion (nicht zu verwechseln mit einer Objektaktion, die innerhalb des Triggers ausgewählt wird).
Benutzerebene: Admin

Eine Aktion einrichten

In der Workflow-Automatisierung ist ein Aktion-Schritt die Stelle, an der eine bestimmte Aufgabe automatisch ausgeführt wird. Sobald die Bedingungen vor diesem Schritt erfüllt sind, wird die Aktion ausgelöst. Hier führt das System Aktionen auf Basis Ihrer Konfiguration aus. Ein Aktion-Schritt einer Workflow-Automatisierung lässt sich an jeder Stelle nach dem Trigger in den Workflow einfügen. Sie müssen lediglich die Option + Aktion hinzufügen wählen, wenn Sie einen neuen Schritt im Workflow einrichten.
CloudTalk bietet derzeit vier Arten von Aktionen:
Jeder Automatisierungs-Workflow benötigt mindestens eine Aktion, um wie erwartet zu funktionieren. Sie können mehrere Aktionen innerhalb desselben Workflows hinzufügen, um Ihre Automatisierung noch effizienter zu machen.

API-Anfrage

Sie möchten lediglich Ihr eigenes System benachrichtigen, wenn in CloudTalk etwas passiert – etwa wenn ein Anruf endet oder sich ein Kontakt ändert? Verwenden Sie stattdessen Webhooks. Webhooks sind auf eine zuverlässige Zustellung von Ereignissen ausgelegt – mit signierten Payloads, automatischen Wiederholungsversuchen sowie erneutem Senden und Wiederherstellung über 30 Tage. Aktionen vom Typ API-Anfrage nutzen einen separaten Zustellweg, der diese Funktionen nicht enthält.
Dieser Aktionstyp eignet sich für technisch versierte Benutzer, die mehr Gestaltungsfreiheit beim Entwerfen von Automatisierungen suchen. Eine API (Application Programming Interface) ermöglicht die Kommunikation zwischen verschiedenen Webanwendungen. Derzeit können Anfragen entweder an die CloudTalk REST API oder an andere, externe Systeme gestellt werden, die Folgendes verwenden:
  • Authentifizierungsverfahren, die statische, unveränderliche Headers erfordern (z. B. Basic- oder Bearer-Authentifizierung)
  • Systeme mit URL-/JSON-Body-Authentifizierung.
Die API von CloudTalk ist ein Beispiel für den zweiten Typ. Jede API-Aktion besteht aus den folgenden Komponenten:
„Name“DefinitionBeispielwert
EndpunktURL des jeweiligen API-Endpunktshttps://my.crmwebsite.com/api/contacts/index
MethodeLegt die Aktion der API-Anfrage festZulässig: PUT, POST, PATCH, GET, DELETE
HeadersMetadaten, die häufig für die Authentifizierung und andere Zwecke erforderlich sindSchlüssel: Autorisierung
Wert: Basic x1x2x3x4x5x6x789
WerteDefinieren den Body der Anfrage in Form eines JSON-ObjektsSchlüssel: contactNameWert: Johnny SnowFormatierung: String
Nutzen Sie den Bereich Werte im Builder für API-Anfragen, um den Body einer Anfrage zu definieren. Jeder Eintrag im Bereich Werte besteht aus Schlüssel, Wert und Formatierung. In diesem Fall ist der Schlüssel der Eigenschaftsname in der API-Anfrage. Zum Beispiel:
Der Wert kann statisch sein. Er könnte etwa so aussehen:
Dieser Wert kann auch eine dynamische Eigenschaft sein, die den Wert auf Basis der Daten aus dem von Ihnen gewählten Trigger einträgt. Für einen dynamischen Wert wählen Sie einen der blauen Ausdrücke in der Seitenleiste Nützliche Daten für Ihren Workflow. Wie unten gezeigt, sollte das Feld Wert daraufhin etwa Folgendes enthalten:
In diesem Beispiel würde der Wert name des Kontakts abgerufen, der mit Ihrem Trigger verknüpft ist. Der Wert Formatierung beschreibt einen Datentyp, damit das Zielsystem (API) die enthaltenen Daten korrekt interpretieren kann. CloudTalk unterstützt die folgenden Formate:
  • Nummer – ganze Zahlen (Integer) oder Dezimalzahlen (Floats mit einem Punkt als Dezimaltrennzeichen)
  • String – Folge alphanumerischer Zeichen
  • Boolean – ergibt True oder False (jede nicht definierte Form gilt standardmäßig als False)
  • Automatisch – der Typ wird automatisch erkannt

SMS

Der Aktionsschritt SMS sorgt dafür, dass im Rahmen der Automatisierung eine SMS an die angegebene Nummer gesendet wird. Im Hintergrund sendet das System eine API-Anfrage mit den konfigurierten Angaben an den CloudTalk API-Endpunkt zum Senden von SMS und löst so den SMS-Versand aus, ohne dass ein Agent eingreifen muss. Um die SMS-Aktion zu konfigurieren, müssen Sie die folgenden Attribute festlegen:
  • Empfänger – Telefonnummer im internationalen Format, an die die SMS gesendet werden soll
  • Absender – SMS-fähige Telefonnummer im internationalen Format, von der die SMS gesendet werden soll
  • Text – Inhalt der Nachricht, die gesendet werden soll
  • API-Schlüssel und API Secret – API-Zugangsdaten, die ein Admin im CloudTalk Dashboard abruft
Da diese Aktion eine Anfrage an die CloudTalk API beinhaltet, gelten die standardmäßigen Rate-Limits. Weitere Details finden Sie in unserer API-Dokumentation.

Häufige Probleme

  • Die Nummern in den Feldern Empfänger und Absender müssen im internationalen Format angegeben werden.
  • Die als Absender verwendete Nummer muss SMS-fähig sein.
  • Die API-Zugangsdaten müssen ohne zusätzliche Leerzeichen eingegeben werden.
  • Achten Sie auf ausreichendes Guthaben auf dem Konto, da für die SMS-Automatisierung zusätzliche Kosten anfallen.

Benachrichtigung an Slack senden

Dieser Aktionstyp wird häufig für interne Benachrichtigungen verwendet, sodass wichtige Informationen an einen Slack-Kanal des Unternehmens weitergeleitet werden können. Um diese Option zu nutzen, stellen Sie sicher, dass eine Verbindung zum entsprechenden Slack-Workspace und -Kanal besteht. Prüfen Sie außerdem, ob die Token-Scopes für Workspace und Kanal die Berechtigung chat:write enthalten. Um die Aktion „Benachrichtigung an Slack senden“ zu konfigurieren, müssen die folgenden Attribute definiert werden:
  • Token: Ein über die Slack-Oberfläche generiertes Authentifizierungstoken.
  • Channel: Der Slack-Kanal, in dem die Nachrichten gepostet werden.
  • Text: Der Inhalt der Nachricht.
  • Icon_emoji: Ein Emoji-Symbol, das die Nachricht darstellt.
  • Icon_url: Eine URL für ein benutzerdefiniertes Symbol, das die Nachricht darstellt.
  • Use_markdown: Bei True wird der Text als formatierter Text angezeigt.
Wie bei API-Anfragen kann der Wert jedes Parameters als statischer Eintrag oder als dynamischer Wert festgelegt werden. Für einen dynamischen Wert klicken Sie in das Feld Wert und wählen dann einen der blauen Ausdrücke in der Seitenleiste Nützliche Daten für Ihren Workflow. Die daraus resultierende Slack-Benachrichtigung könnte etwa so aussehen:

Speech-to-Text-Transkription

Dieser Aktionstyp wird häufig verwendet, um während eines Anrufs aufgezeichnete Gespräche in geschriebenen Text zu transkribieren. Beachten Sie, dass diese Aktion nur verfügbar ist, wenn der Trigger Recording Uploaded ausgewählt ist. Um die Speech-to-Text-Aktion zu konfigurieren, müssen die folgenden Attribute definiert werden:
  • Sprache
  • Erweiterte Transkription
  • Modell
Lesen Sie mehr über die Speech-to-Text-Transkription, um besser zu verstehen, wie diese Funktion arbeitet, was sie bietet und welche Kosten damit verbunden sind.

Ausgaben früherer Aktionsknoten wiederverwenden

Sie können die Antwort eines vorherigen Aktionsschritts vom Typ API-Anfrage in nachfolgenden Schritten Ihres Workflows dynamisch referenzieren.

So funktioniert es

Um auf Daten zuzugreifen, die eine frühere Aktion vom Typ API-Anfrage zurückgegeben hat, müssen Sie das exakte Format verwenden:
  • [actionIdentifier] ist die eindeutige Kennung des Aktionsknotens, die beim Hinzufügen vergeben wird (z. B. eine vom System generierte Kennung wie 28547585 oder ein eigener Name wie SendToCRM)
  • message steht für den Body der Antwort, bei dem es sich um ein JSON-Objekt handeln sollte
  • [fieldName] ist ein beliebiges Feld innerhalb dieses JSON-Objekts
Das Präfix .message. ist beim Referenzieren von Antwortdaten zwingend erforderlich. Wenn Sie es weglassen oder eine andere Struktur verwenden, ist die Referenz fehlerhaft.
Beispiel Angenommen, wir haben einen Aktionsknoten vom Typ API-Anfrage mit der Kennung CreateLead
Die API-Anfrage-Aktion CreateLead liefert diese Antwort:
Um die lead_id in einer anderen Aktion zu referenzieren, verwenden Sie diese Referenz:

Brauchen Sie Hilfe oder haben Sie eine Frage? Melden Sie sich einfach über unser Support-Portal — wir sind für Sie da.