Jede API aufrufen, mitten in einem Gespräch

GET liest etwas (eine Bestellung, eine Buchung), POST legt es an (einen Lead in deinem CRM), PUT ersetzt es, PATCH ändert einen Teil davon und DELETE entfernt es.

Eine GET-Anfrage hat keinen Body; sende Werte als Query-Parameter.

Füge die Adresse aus der Doku der API ein und setz an beliebiger Stelle eine Variable hinein, etwa die Bestellnummer in /orders/{{order_number}}.

Bis zu 2.000 Zeichen.

Jede Zeile wird als key=value an die Adresse angehängt und für dich kodiert. Mit „Diese Zeile senden“ schaltest du eine Zeile ab, ohne sie zu löschen.

Bis zu 20 Parameter.

Zusätzliche Zeilen, die die API verlangt, etwa Shop oder Sprache. Sperre jede Zeile, die einen Schlüssel enthält, dann wird sie verschlüsselt gespeichert.

Bis zu 20 Header.

JSON sendet Felder als Text, Zahl, wahr/falsch oder JSON, und ein Punkt im Schlüssel verschachtelt ihn: customer.email wird als email innerhalb von customer gesendet. Formular sendet Felder wie ein Webformular; Raw ist JSON, reiner Text oder XML, von Hand geschrieben.

Bis zu 40 JSON-Felder; ein Raw-Body bis zu 20.000 Zeichen.

Kopiere das Beispiel aus der Doku deiner API und füge es hier ein. Methode, Adresse, Header, Auth und Body füllen sich von selbst aus.

Kontakt (Vorname, Benutzername, E-Mail, Telefonnummer), Dieses Gespräch (letzte Nachricht der Person, ihr Kommentar, der Beitrag), Antworten und gespeicherte Felder, außerdem Aus API-Aufrufen: die Felder, die eine frühere Anfrage zurückgegeben hat.

Jede wird passend für ihre Stelle maskiert: URL-kodiert in der Adresse, JSON-maskiert in einem JSON-Body.

Ein Bearer-Token, Benutzername und Passwort oder ein API-Schlüssel, gesendet unter dem Namen, den die API vorgibt, in einem Header oder im Query-String.

Auth-Werte und jede als Secret markierte Zeile werden beim Speichern mit AES-256-GCM versiegelt, an dein Konto gebunden und nur auf unserem Server geöffnet. Niemand sieht sie wieder, auch nicht im Ausführungsverlauf.

Ein Schlüssel, der irgendwo eingetippt wird, selbst in einem eingefügten cURL, wird von selbst zum Secret.

Eine Adresse, die in ein privates Netzwerk, auf Loopback oder in einen Cloud-Metadatenbereich zeigt, wird dort abgelehnt, wo die Verbindung entsteht, Weiterleitungen eingeschlossen.

Höchstens 3 Weiterleitungen; deine Zugangsdaten gehen nie an eine andere Website weiter.

Benenne die Antwort einmal, dann lässt sich jedes zurückgegebene Feld in späteren Nachrichten, Anfragen und Bedingungen als {{name.path}} verwenden, etwa {{order.items[0].name}}, oder {{name.$status}} für den Statuscode.

Zwei HTTP-Schritte in einem Flow können nicht denselben Namen haben.

Neben jedem zurückgegebenen Feld: Speichere es als E-Mail, Telefonnummer oder Name der Person oder als gespeichertes Feld am Kontakt (so wie Feld setzen eines speichert). Spätere Schritte dieses Flows haben ohnehin schon jedes Feld.

Bis zu 20 gespeicherte Werte pro Schritt.

Ein gespeicherter Wert kann der Statuscode sein, die gesamte Antwort, ein Header oder ein beliebiges Feld wie data.items[0].email.

Die Antwort wird bis 512 KB gelesen.

Drücke „Testanfrage senden“, und jedes Feld der Antwort wird mit seinem Wert aufgelistet, bereit zum Einfügen über den Variablen-Button oder zum Kopieren, etwa {{ship.places[0].place name}}.

Erfolg ist eine 2xx-Antwort; Fehlgeschlagen ist ein Fehler, ein Timeout oder keine Antwort. Stell „Gilt als Erfolg“ auf „Jede Antwort“, dann kann stattdessen eine Bedingung den Statuscode prüfen.

Ein Ausgang „Fehlgeschlagen“ ohne Verbindung beendet die Ausführung als fehlgeschlagen, und der Builder warnt dich vorher.

Ist die API langsamer als das Limit, wartet der Schritt nicht länger und nimmt „Fehlgeschlagen“. Die Person ist mitten im Chat, kürzer ist also freundlicher.

3, 5, 8 oder 10 Sekunden, voreingestellt sind 8.

Bei einem Netzwerkfehler oder einem 5xx versucht er es kurz darauf noch einmal, ein- oder zweimal, und beachtet dabei Retry-After. Wiederholt werden nur Methoden, die sich gefahrlos zweimal senden lassen (GET, PUT, DELETE), oder eine Anfrage mit einem Idempotency-Key.

Höchstens 2 neue Versuche.

Eine Adresse, die 5-mal in Folge fehlschlägt, pausiert eine Minute und wird dann erneut versucht. So wird eine defekte API nie überflutet.

Höchstens 5 Aufrufe gleichzeitig pro Konto.