Niezawodny webhook
Robot „Niezawodny webhook” wysyła żądanie HTTP na zewnętrzny adres z ponawianiem prób w procesach biznesowych i robotach Bitrix24. 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. Dostępny tylko w płatnych planach.
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 jest dostępny tylko w płatnych planach Bitrix24.
Jakie parametry wejściowe przyjmuje robot?
| Parametr | Typ | Wymagany? | Domyślnie |
|---|---|---|---|
| URL webhooka | string | tak | |
| Metoda HTTP (domyślnie POST) | select | — | 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 |
| 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 |
Scenariusz: niezawodne wysłanie danych deala do zewnętrznego systemu
- Deal wchodzi na etap „Opłacone” i uruchamia się proces biznesowy
- Robot wysyła żądanie POST pod adres URL zewnętrznego systemu; przy odpowiedzi spoza 2xx ponawia do 3 razy w odstępie 60 sekund
- Przy sukcesie proces kontynuuje gałęzią Y; przy ostatecznym niepowodzeniu powiadamia osobę odpowiedzialną i idzie gałęzią N