HTTP-Anfrage aus einem Flow senden

Für Agenten

Anleitung: HTTP-Anfrage aus einem Flow senden

Diese Seite: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

Thema: HTTP-Anfragen

Zeit: etwa 5 Minuten

Wer das darf: Inhaber, Administrator oder Manager

Autor: https://anantgupta.xyz (Anant Gupta, Gründer von CommentWatchDog)

In der App starten: https://app.commentwatchdog.com/de/inbox

Ergebnis am Ende: Dein Flow sendet Daten an ein anderes System oder liest dort welche und nimmt dann den Ausgang „Erfolg“ oder „Fehlgeschlagen“.

Kontext: Der Schritt „HTTP-Anfrage“ ruft mitten im Gespräch die API eines anderen Systems auf: eine Bestellung nachschlagen, eine Postleitzahl prüfen, einen neuen Lead an dein CRM senden. Er läuft an jeder Stelle eines Flows, auf Instagram und Facebook. Alles steht in einem Formular: Methode und Adresse, Authentifizierung, Body, Query-Parameter und Header; was du über die Person weißt, setzen Variablen ein. Eine gute Antwort nimmt den Ausgang „Erfolg“; ein Fehler, eine Zeitüberschreitung oder keine Antwort nimmt „Fehlgeschlagen“. So bleibt die Person nie hängen.

Bevor du loslegst

1. Der Schritt „HTTP-Anfrage“ gehört zum Flow-Builder, ab Starter (und bei Mini und Lite mit dem 7-Tage-DM-Pass).

2. Der Schritt ruft nur hinaus: Andere Systeme können nicht in einen Flow hineinrufen.

3. Zur Authentifizierung dient ein Bearer-Token, Basic Auth oder ein API-Schlüssel; Schlüssel werden verschlüsselt gespeichert und nie wieder angezeigt.

Schritte

Schritt 1 von 5: Schritt „HTTP-Anfrage“ hinzufügen.

Wo: Öffne den Flow auf der Arbeitsfläche. Tippe im Bereich „Schritte“ links bei „Schritte durchsuchen“ HTTP ein und ziehe „HTTP-Anfrage“ auf die Arbeitsfläche. Oder klicke darauf, um den Schritt hinter dem ausgewählten einzufügen. Auf dem Handy: „Schritt hinzufügen“, dann „HTTP-Anfrage“.

Link: https://app.commentwatchdog.com/de/inbox (App öffnen)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http.de.webp (Der Schritt „HTTP-Anfrage“ auf der Arbeitsfläche, rechts seine geöffneten Einstellungen.)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-phone.de.webp (Die Einstellungen des Schritts auf dem Handy.)

Das solltest du sehen: Der Schritt liegt mit zwei Ausgängen, „Erfolg“ und „Fehlgeschlagen“, auf der Arbeitsfläche, und daneben sind seine Einstellungen geöffnet.

Schritt 2 von 5: Methode wählen und Adresse eingeben.

Wo: Unter „Adresse“, weit oben in den Einstellungen: links die Methode (GET, aufgeklappt auch POST, PUT, PATCH und DELETE), dann das Adressfeld, dann der Variablen-Button {x}. Er fügt Werte ein, die sich je Person ändern, zum Beispiel https://api.zippopotam.us/us/{{zip}}. Eine Variable in der Adresse wird für dich kodiert.

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http.de.webp (Die Adresse mit der Variable {{zip}}; links davon die Methode, rechts der Variablen-Button.)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-phone.de.webp (Dasselbe auf dem Handy.)

Das solltest du sehen: Der Schritt auf der Arbeitsfläche zeigt Methode und Adresse.

Schritt 3 von 5: Eintragen, was die API verlangt: Authentifizierung, Body, Parameter, Header.

Wo: Unter der Adresse geht das Formular weiter, Abschnitt für Abschnitt. „Authentifizierung“: „Keine Auth“, „Bearer-Token“, „Basic Auth“ oder „API-Schlüssel“ (im Header oder im Query-String gesendet). „Body“ (nicht bei GET; ein GET sendet seine Werte als Query-Parameter): „JSON“ mit bis zu 40 Feldern, jedes gesendet als „Text“, „Zahl“, „Wahr/falsch“ oder „JSON“ (ein Punkt im Schlüssel verschachtelt ihn), „Formular“, „Raw“ (JSON, reiner Text oder XML) oder „Keiner“. „Query-Parameter“: bis zu 20 Zeilen, als key=value an die Adresse angehängt. „Header“: bis zu 20 Zeilen; sperre eine Zeile, um ihren Wert geheim zu halten. „Diese Zeile senden“ schaltet eine Zeile aus, ohne sie zu löschen.

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http.de.webp („Authentifizierung“, der erste Abschnitt unter der Adresse.)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-phone.de.webp (Dasselbe auf dem Handy.)

Das solltest du sehen: Jeder Abschnitt füllt sich nach und nach: „Parameter hinzufügen“ und „Header hinzufügen“ zählen ihre Zeilen (0/20, 1/20). Ein Schlüssel, den du eintippst, wird verschlüsselt gespeichert; danach steht dort „Gespeichert und ausgeblendet“, mit „Ersetzen“.

Schritt 4 von 5: „Mehr Optionen“ für Erfolg, Zeitlimit und Wiederholungen öffnen.

Wo: „Mehr Optionen“, eingeklappt am Ende des Formulars; seine Zeile zeigt die aktuellen Einstellungen (zum Beispiel „Nur eine 2xx-Antwort · 8 s · Einmal“). „Gilt als Erfolg“: „Nur eine 2xx-Antwort“ oder „Jede Antwort“ (dann prüfst du den Statuscode in einer Bedingung). „Zeitlimit“: 3, 5, 8 oder 10 s (voreingestellt sind 8). „Bei Fehlern erneut versuchen“: „Nicht wiederholen“, „Einmal“ oder „Zweimal“, bei keiner Antwort oder einem 5xx, und nur bei Anfragen, die gefahrlos zweimal gesendet werden können.

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-more.de.webp („Mehr Optionen“ am Ende des Formulars, mit den aktuellen Einstellungen in seiner Zeile.)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.de.webp (Dasselbe auf dem Handy.)

Das solltest du sehen: Die Zeile „Mehr Optionen“ zeigt, was du gewählt hast.

Schritt 5 von 5: „Erfolg“ und „Fehlgeschlagen“ verbinden.

Wo: Ziehe vom Punkt „Erfolg“ eine Verbindung zum nächsten Schritt (einer Nachricht, die die Antwort verwendet) und von „Fehlgeschlagen“ zu dem, was stattdessen passieren soll (dein Team benachrichtigen, an eine Person übergeben oder eine freundliche Nachricht). Auf dem Handy wählst du die Schritte unter „Nächste Schritte“ am Ende der Einstellungen. Ein Ausgang „Fehlgeschlagen“ ohne Verbindung beendet die Ausführung als fehlgeschlagen, und die Leiste warnt dich.

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http.de.webp (Die zwei Ausgänge am Schritt, „Erfolg“ und „Fehlgeschlagen“, jeder mit seinem nächsten Schritt verbunden.)

Screenshot: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.de.webp (Auf dem Handy: „Erfolg“ und „Fehlgeschlagen“ unter „Nächste Schritte“, jeweils mit dem Schritt, zu dem sie führen.)

Das solltest du sehen: Beide Ausgänge sind verbunden; in der Leiste steht „Startklar“, sobald nichts mehr zu beheben ist.

Wenn etwas nicht passt

Problem: Blockiert

Lösung: Die Adresse zeigt in ein privates Netzwerk (oder auf Loopback oder eine Cloud-Metadaten-Adresse) und wird deshalb aus Sicherheitsgründen abgelehnt. Nimm die öffentliche Adresse der API.

Problem: Zeitlimit überschritten

Lösung: Die API hat länger gebraucht als das Zeitlimit unter „Mehr Optionen“ (höchstens 10 Sekunden). Die Ausführung hat den Ausgang „Fehlgeschlagen“ genommen.

Problem: Nach Fehlern pausiert

Lösung: Die Adresse ist 5-mal hintereinander fehlgeschlagen. Aufrufe an sie pausieren deshalb eine Minute, dann wird sie wieder versucht.

Problem: Ungültige Adresse

Lösung: Mit eingesetzten Variablen ist die Adresse kein gültiger http- oder https-Link. Prüfe, ob die Variable an dieser Stelle des Flows einen Wert hat.

Häufige Fragen

Frage: Kann ein Flow jede API aufrufen?

Antwort: Ja, jede API, die im öffentlichen Internet erreichbar ist, mit GET, POST, PUT, PATCH oder DELETE, ohne Auth, mit Bearer-Token, Basic Auth oder API-Schlüssel. Adressen in privaten Netzwerken werden aus Sicherheitsgründen abgelehnt.

Frage: Kann ein anderes System Daten in einen Flow senden?

Antwort: Nein. Der Schritt „HTTP-Anfrage“ ruft nur aus einem Flow hinaus; es gibt keinen eingehenden Webhook, der einen Flow startet oder mit Daten versorgt.

Frage: Wie lange kann eine HTTP-Anfrage höchstens warten?

Antwort: 10 Sekunden, mehr lässt das Zeitlimit nicht zu (voreingestellt sind 8). Die Leute sind mitten im Chat, kürzer ist also freundlicher.

Frage: Sind meine API-Schlüssel sicher?

Antwort: Auth-Werte und jede als Secret markierte Zeile werden beim Speichern verschlüsselt, an dein Konto gebunden und nie wieder angezeigt, auch nicht im Ausführungsverlauf.

Verwandte Anleitungen

Antwort in deinem Flow verwenden: https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

cURL-Befehl einfügen: https://commentwatchdog.com/help/http-requests/paste-a-curl-command

Anfrage mit KI erstellen: https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

Reiner Text dieser Anleitung: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow.md

Alle Anleitungen für Assistenten: https://commentwatchdog.com/help/llms.txt