Roboteka
Roboteka · Roboty · Niezawodny webhook

Niezawodny webhook

Robot „Niezawodny webhook” wysyła żądanie HTTP na zewnętrzny adres z ponawianiem prób w procesach biznesowych i robotach Bitrix24 (Alaio). Sprawdza kod odpowiedzi według wybranych zakresów (2xx, 3xx, 4xx, 5xx oraz dodatkowych kodów), ponawia nieudane próby w zadanym odstępie i może powiadomić wybranych użytkowników w razie ostatecznego niepowodzenia. Zwraca flagę dostarczenia Y/N, kod i treść odpowiedzi ostatniej próby oraz liczbę wykonanych prób. Nie działa w trybie demo.

Robot niezawodnie dostarcza żądanie HTTP (GET, POST, PUT, PATCH, DELETE) na zewnętrzny adres i — w przeciwieństwie do zwykłego żądania HTTP — sam przejmuje dostawę: decyduje, co uznać za sukces, i ponawia próby w razie niepowodzenia. Parametry: URL, metoda, treść i nagłówki w formacie JSON; zbiór kodów sukcesu wybiera się zakresami 2xx/3xx/4xx/5xx plus dodatkowe kody oddzielone przecinkami (domyślnie 2xx); liczba prób wynosi 1–10 (domyślnie 3), odstęp między próbami 1–3600 sekund (domyślnie 60), a limit czasu jednej próby 1–25 sekund (domyślnie 10). W razie ostatecznego niepowodzenia może powiadomić wybranych użytkowników wiadomością na czacie. Typowe przypadki użycia: niezawodnie wysłać dane deala do zewnętrznego systemu lub CRM; wywołać webhook integracji z gwarantowanymi ponowieniami, gdy usługa jest chwilowo niedostępna; zaalarmować osobę odpowiedzialną, jeśli dostawa się nie powiedzie. Zwraca flagę dostarczenia Y/N, kod HTTP i treść odpowiedzi ostatniej próby oraz liczbę wykonanych prób — sprawdź Y/N w warunku następnego kroku. Robot nie działa, dopóki Bitrix24 (Alaio) jest w trybie demo.

Jakie parametry wejściowe przyjmuje robot?

Parametr Typ Wymagany? Domyślnie
URL webhooka string tak
Metoda HTTP (domyślnie POST) select POST, GET, PUT, PATCH, DELETE — POST
Treść żądania string —
Nagłówki w formacie JSON: {"Authorization":"Bearer xxx","Content-Type":"application/json"} string —
Które kody uznawać za sukces (domyślnie 2xx) select 2xx — sukces (200–299), 3xx — przekierowania (300–399), 4xx — błędy klienta (400–499), 5xx — błędy serwera (500–599) — 2xx
Dodatkowe kody sukcesu, oddzielone przecinkami (np. 409, 422) string —
Liczba prób (1–10, domyślnie 3) int — 3
Odstęp między próbami w sekundach (1–3600, domyślnie 60) int — 60
Limit czasu jednej próby w sekundach (1–25, domyślnie 10) int — 10
Kogo powiadomić o nieudanej dostawie user —

Co zwraca robot?

Parametr Typ
Dostarczono (Y/N) string
Kod statusu HTTP ostatniej próby int
Treść odpowiedzi ostatniej próby string
Wykonane próby int

Jakie błędy może zwrócić robot?

Te komunikaty robot zapisuje w dzienniku procesu biznesowego, gdy nie może wykonać kroku. Z treści widać, co poprawić w ustawieniach lub danych.

  • Błąd: nagłówki muszą być obiektem JSON
  • Błąd: nieprawidłowa nazwa nagłówka: {name}
  • Błąd: znaki sterujące są niedozwolone w nagłówku {name}
  • Błąd: nagłówek {name} jest ustawiany automatycznie
  • Błąd cURL: {error}
  • Ten robot nie działa, dopóki Bitrix24 jest w trybie demo lub jeśli nie udało się ustalić planu.

Scenariusz: niezawodne wysłanie danych deala do zewnętrznego systemu

  1. Deal wchodzi na etap „Opłacone” i uruchamia się proces biznesowy
  2. Robot wysyła żądanie POST pod adres URL zewnętrznego systemu; przy odpowiedzi spoza 2xx ponawia do 3 razy w odstępie 60 sekund
  3. Przy sukcesie proces kontynuuje gałęzią Y; przy ostatecznym niepowodzeniu powiadamia osobę odpowiedzialną i idzie gałęzią N

Podobne roboty

Powiązane artykuły

Zainstaluj Opisz zadanie — zbudujemy robota bezpłatnie