GetMyBot-Wissensdatenbank

Web-Anfragen und Webhooks

Bot-Reaktionen durch Website-Ereignisse starten und aus Reaktionen externe Dienste abfragen: eingehende und ausgehende Anfragen.

Auf dieser Seite

Eine Website kann dem Bot eine neue Anfrage melden; der Bot kann umgekehrt den Bestellstatus auf der Website abfragen. Das sind zwei verschiedene Richtungen:

RichtungWer beginnt?Beispiel
Eingehender WebhookEin anderer Dienst meldet GetMyBot ein Ereignis und startet eine ReaktionNeue Website-Anfrage wird einem Mitarbeiter gemeldet
Ausgehende Web-AnfrageEine Reaktion ruft einen Dienst auf und erhält dessen AntwortBot fragt Preis oder Bestellstatus ab

Ein Webhook ist eine automatische Benachrichtigung zwischen Diensten. Beide Wege verwenden HTTP, das Protokoll gewöhnlicher Website-Aufrufe. Fertige Verbindungen erklärt Integrationen.

Eingehender Webhook als Trigger

Der Trigger Eingehende Web-Anfrage (Webhook) startet eine Reaktion durch eine externe HTTP-Anfrage:

  • Adresse: Aktivieren Sie den Trigger und speichern Sie die Reaktion. GetMyBot erzeugt danach die Webhook-URL und zeigt sie im Feld. Sie können sie kopieren, aber nicht ändern.
  • Geheimtoken: Verhindert, dass Fremde über die Adresse Reaktionen auslösen.
  • Methode: POST, GET, PUT oder ANY.

Felder der eingehenden Anfrage werden in temporären Reaktionsdaten (ctx) gespeichert. Sendet ein Dienst beispielsweise order_id, steht es als {{ctx.order_id}} zur Verfügung. Senden Sie nach dem Einrichten eine Testanfrage und prüfen Sie die empfangenen Felder.

Ausgehende Web-Anfrage als Aktion

Die Aktion Web-Anfrage sendet aus einer Reaktion heraus eine HTTP-Anfrage:

  • Methode GET, HEAD, OPTIONS, POST, PUT, PATCH oder DELETE, Header und Körper als JSON oder Text;
  • Erfolgscodes, Timeout und Wiederholungen bei Fehlern;
  • Speicherung der Antwort in einem Nutzerparameter oder in ctx; JSONPath wählt das benötigte Antwortfeld;
  • asynchroner Modus: Der Bot setzt die Reaktion fort, ohne auf den Dienst zu warten. Eine eigene Erfolgs- oder Fehlerreaktion kann das Ergebnis behandeln.

Verwandte Aktionen sind URL laden (Seitentext in ctx) und Quelle abfragen / In Quelle schreiben für gespeicherte Konnektoren. Siehe Quellen und Schlüssel.

Webhook-Integration

Für regelmäßige Datenübertragung an denselben Dienst richten Sie die Integration Webhook ein. Tragen Sie URL und HMAC-Signatur ein, mit der der Empfänger den Absender prüfen kann. Siehe Integrationen.

Sicherheit

Schützen Sie eingehende Anfragen mit dem Geheimtoken. Ausgehende Anfragen können über die Plattform keine privaten Adressen des internen Netzwerks erreichen. Dieser Schutz heißt SSRF-Schutz. Auch die Antwortgröße ist begrenzt.

Weiterführende Artikel