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:
| Richtung | Wer beginnt? | Beispiel |
|---|---|---|
| Eingehender Webhook | Ein anderer Dienst meldet GetMyBot ein Ereignis und startet eine Reaktion | Neue Website-Anfrage wird einem Mitarbeiter gemeldet |
| Ausgehende Web-Anfrage | Eine Reaktion ruft einen Dienst auf und erhält dessen Antwort | Bot 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,PUToderANY.
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,PATCHoderDELETE, 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
- Trigger: eingehender Webhook.
- Aktionen: Web-Anfrage und URL laden.
- Ersetzungen und Formeln: Anfragedaten in
ctx.