Roboteka
Roboteka · Roboter · Zuverlässiger Webhook

Zuverlässiger Webhook

Der Roboter „Zuverlässiger Webhook“ sendet eine HTTP-Anfrage an eine externe Adresse mit Wiederholungsversuchen in Geschäftsprozessen und Robotern von Bitrix24 (Alaio). Er prüft den Antwortcode anhand ausgewählter Bänder (2xx, 3xx, 4xx, 5xx plus zusätzliche Codes), wiederholt fehlgeschlagene Versuche in einem festgelegten Intervall und kann bei endgültigem Misserfolg ausgewählte Benutzer benachrichtigen. Zurückgegeben werden ein Zustell-Kennzeichen Y/N, der Statuscode und der Text der letzten Antwort sowie die Anzahl der durchgeführten Versuche. Läuft nicht im Demo-Modus.

Der Roboter stellt eine HTTP-Anfrage (GET, POST, PUT, PATCH, DELETE) zuverlässig an eine externe Adresse zu und übernimmt — anders als eine einfache HTTP-Anfrage — die Zustellung selbst: Er entscheidet, was als Erfolg gilt, und wiederholt bei Misserfolg. Parameter: URL, Methode, Text und Header als JSON; die Menge der Erfolgscodes wird über die Bänder 2xx/3xx/4xx/5xx plus zusätzliche, durch Komma getrennte Codes gewählt (Standard 2xx); die Anzahl der Versuche beträgt 1–10 (Standard 3), das Intervall zwischen den Versuchen 1–3600 Sekunden (Standard 60) und das Timeout pro Versuch 1–25 Sekunden (Standard 10). Bei endgültigem Misserfolg kann er ausgewählte Benutzer mit einer Chat-Nachricht benachrichtigen. Typische Anwendungsfälle: Auftragsdaten zuverlässig an ein externes System oder CRM senden; einen Integrations-Webhook mit garantierten Wiederholungen auslösen, wenn der Dienst vorübergehend nicht erreichbar ist; den Verantwortlichen alarmieren, wenn die Zustellung nie gelingt. Zurückgegeben werden ein Zustell-Kennzeichen Y/N, der HTTP-Code und der Text der letzten Antwort sowie die Anzahl der durchgeführten Versuche — prüfen Sie das Y/N in der Bedingung des nächsten Schritts. Der Roboter läuft nicht, solange Bitrix24 (Alaio) im Demo-Modus ist.

Welche Eingabeparameter akzeptiert der Roboter?

Parameter Typ Pflichtfeld? Standard
Webhook-URL string ja
HTTP-Methode (Standard POST) select POST, GET, PUT, PATCH, DELETE — POST
Anfragetext string —
Header als JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Welche Codes als Erfolg gelten (Standard 2xx) select 2xx — Erfolg (200–299), 3xx — Weiterleitungen (300–399), 4xx — Client-Fehler (400–499), 5xx — Server-Fehler (500–599) — 2xx
Zusätzliche Erfolgscodes, durch Komma getrennt (z. B. 409, 422) string —
Anzahl der Versuche (1–10, Standard 3) int — 3
Intervall zwischen Versuchen in Sekunden (1–3600, Standard 60) int — 60
Timeout pro Versuch in Sekunden (1–25, Standard 10) int — 10
Wer bei fehlgeschlagener Zustellung benachrichtigt wird user —

Was gibt der Roboter zurück?

Parameter Typ
Zugestellt (Y/N) string
HTTP-Statuscode des letzten Versuchs int
Antworttext des letzten Versuchs string
Durchgeführte Versuche int

Welche Fehler kann der Roboter zurückgeben?

Diese Meldungen schreibt der Roboter ins Protokoll des Geschäftsprozesses, wenn er einen Schritt nicht ausführen kann. Der Text zeigt, was in den Einstellungen oder Daten zu korrigieren ist.

  • Fehler: Header müssen ein JSON-Objekt sein
  • Fehler: ungültiger Header-Name: {name}
  • Fehler: Steuerzeichen sind im Header {name} nicht erlaubt
  • Fehler: Header {name} wird automatisch gesetzt
  • cURL-Fehler: {error}
  • Dieser Roboter läuft nicht, solange Bitrix24 im Demo-Modus ist oder der Tarif nicht ermittelt werden konnte.

Szenario: zuverlässiges Senden von Auftragsdaten an ein externes System

  1. Ein Auftrag wechselt in die Phase „Bezahlt“ und ein Geschäftsprozess startet
  2. Der Roboter sendet eine POST-Anfrage an die URL des externen Systems; bei einer Antwort außerhalb von 2xx wiederholt er bis zu 3 Mal im Abstand von 60 Sekunden
  3. Bei Erfolg läuft der Prozess über den Y-Zweig weiter; bei endgültigem Misserfolg benachrichtigt er den Verantwortlichen und geht über den N-Zweig

Ähnliche Roboter

Passende Artikel

Installieren Aufgabe beschreiben — wir bauen den Roboter kostenlos