WhatsApp Nachrichten Flows – Schritt „APIs verbinden"

Mit ActiveCampaign können Sie in WhatsApp Nachrichten-Flows den Schritt „APIs verbinden“ verwenden, um jede Anwendung zu verbinden, die API-Anfragen unterstützt. Mit dieser Funktion können Sie Ihre Flows erweitern, indem Sie externe Systeme verknüpfen, Prozesse automatisieren und Daten abrufen oder senden.

In diesem Artikel wird der Schritt „API“ erläutert und es werden einige Beispiele gegeben, um sein Potenzial zu veranschaulichen.

Hinweis

Diese Option ist für fortgeschrittene Benutzer. Sie müssen sich mit Code auskennen. Unser Customer Experience Team kann Sie nicht bei der Implementierung oder Fehlerbehebung von Code unterstützen.

Über den Schritt „APIs verbinden“

Im Schritt „APIs verbinden“ können Sie HTTP-Anfragen an externe APIs stellen. Sie können diesen Schritt so konfigurieren, dass Daten an andere Systeme gesendet oder von diesen abgerufen werden, sodass eine nahtlose Verknüpfung zwischen ActiveCampaign und Ihren bestehenden Tools ermöglicht wird. 

Der API-Schritt unterstützt verschiedene HTTP-Methoden, darunter GET, POST, PATCH, PUT und DELETE, und ermöglicht Ihnen die Anpassung von Kopfzeilen, Query-Parametern und Anfragetexten.

Konfigurieren Sie den Schritt „APIs verbinden“

1. Klicken Sie im linken Menü auf WhatsApp > Messaging Flows.
2. Bearbeiten oder erstellen Sie einen neuen Messaging-Flow.
   • Wenn Sie einen Flow bearbeiten, klicken Sie auf einen Flow > Aktualisieren > Schritte. Klicken Sie im Builder auf einen Knoten (+), an dem Sie die Aktion platzieren möchten. Ein modales Fenster wird angezeigt. Klicken Sie auf die Option "Connect APIs" und dann auf die Schaltfläche "Add" 
   • Wenn Sie einen neuen Flow erstellen, wird im Flow-Builder ein modales Fenster angezeigt. Klicken Sie auf die Option "Connect APIs" und anschließend auf die Schaltfläche „Add“ 
3. Im angezeigten Modal „Schritt hinzufügen“:
   • Klicken Sie auf das Stiftsymbol und geben Sie Ihrem Schritt einen Namen. Wir empfehlen, eindeutige Namen zu verwenden, die kurz und aussagekräftig sind
   • Methodentyp – Wählen Sie die passende HTTP-Methode aus, basierend auf Ihrem Anwendungsfall
   • URL – Geben Sie die URL des externen API-Endpunkts ein, mit dem Sie eine Verbindung herstellen möchten
   • Fügen Sie alle erforderlichen API-Kopfzeilen hinzu, zum Beispiel Body, Headers und Query. Wenn der API-Endpunkt Abfrageparameter erfordert, können Sie diese hier hinzufügen. Für POST- oder PATCH-Anfragen definieren Sie das JSON-Objekt, das Formular oder den String, der als Request-Body gesendet wird.
   • Testanforderung – Klicken Sie auf diese Schaltfläche, um die API-Verbindung zu testen
   • Umschaltfläche „Escape-Zeichen in Variablen formatieren“ – Wenn aktiviert, werden die Sonderzeichen im Variablentext formatiert

Beispiele

Beispiel 1: Daten an ein CRM senden

Angenommen, Sie möchten die Informationen eines Kontakts in Ihrem CRM aktualisieren, sobald dieser einen Flow in ActiveCampaign abgeschlossen hat. Sie können den Schritt „APIs verbinden“ verwenden, um eine POST-Anfrage an die API des CRM zu senden, die die aktualisierten Kontaktdaten übermittelt. Gehen Sie dazu wie folgt vor:

1. Legen Sie die URL auf Ihr CRM fest. Zum Beispiel:  https://api.yourcrm.com/v1/contacts
2. Wählen Sie POST für die HTTP-Methode – POST
3. Kopfzeilen konfigurieren:

{
  "Authorization": "Bearer IHR_API_SCHLÜSSEL",
  "Content-Type": "Antrag/json"
}

4. Anfragetext definieren:

{
  "first_name": "{{contact.first_name}}",
  "last_name": "{{contact.last_name}}",
  "E-Mail": "{{contact.email}}",
  "phone": "{{contact.phone}}"
}

Beispiel 2: Daten aus einem externen System abrufen

Stellen Sie sich vor, Sie müssen den Bestellverlauf eines Kunden aus einem externen System abrufen und ihn diesem in einem Flow für WhatsApp Nachrichten anzeigen. Sie können den Schritt „APIs verbinden“ verwenden, um eine GET-Anfrage an die API eines externen Systems zu senden und die abgerufenen Daten in nachfolgenden Flow-Schritten zu nutzen.

1. Legen Sie die URL fest auf: https://api.yourordersystem.com/v1/orders?user_id={{contact.id}}
2. Wählen Sie GET als HTTP-Methode
3. Header konfigurieren:

{
  "Authorization": "Bearer IHR_API_SCHLÜSSEL"
}

Die API-Antwort kann dann im Flow verwendet werden, um den Bestellverlauf des Kunden anzuzeigen.

Beispiel 3: Einen externen Workflow auslösen

Angenommen, Sie möchten einen externen Workflow auslösen, sobald ein Kunde einen bestimmten Schritt in einem WhatsApp-Flow abschließt. Sie können den Schritt „APIs verbinden“ verwenden, um eine POST-Anfrage an die API eines externen Systems zu senden und dabei alle erforderlichen Daten zu übermitteln.

1. Setzen Sie die URL auf: https://api.yourworkflowtool.com/v1/trigger
2. Wählen Sie POST als HTTP-Methode
3. Header konfigurieren:

"Authorization": "Bearer IHR_API_SCHLÜSSEL",
  "Content-Type": "Antrag/json"

4. Den Request-Body definieren:

{
  "user_id": "{{contact.phone}}",
  "Veranstaltungen": "flow_completed",
}