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. 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. Nur in kostenpflichtigen Tarifen verfügbar.
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 ist nur in kostenpflichtigen Bitrix24-Tarifen verfügbar.
Welche Eingabeparameter akzeptiert der Roboter?
| Parameter | Typ | Pflichtfeld? | Standard |
|---|---|---|---|
| Webhook-URL | string | ja | |
| HTTP-Methode (Standard POST) | select | — | POST |
| Anfragetext | string | — | |
| Header als JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} | string | — | |
| Welche Codes als Erfolg gelten (Standard 2xx) | select | — | 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 |
Szenario: zuverlässiges Senden von Auftragsdaten an ein externes System
- Ein Auftrag wechselt in die Phase „Bezahlt“ und ein Geschäftsprozess startet
- 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
- 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