Czym są webhooki?
Webhooki w RemOnline umożliwiają systemom otrzymywanie aktualizacji w czasie rzeczywistym, gdy wystąpią określone zdarzenia. Aktualizacje są wysyłane jako żądania HTTP POST do określonego punktu końcowego, umożliwiając automatyzację procesów i integrację z innymi aplikacjami.
Jaka jest różnica między API a Webhookami?
Parametr | API | Webhooks |
Jak to działa | Użytkownik wysyła żądanie do interfejsu API i otrzymuje odpowiedź. | System automatycznie wysyła dane do punktu końcowego, gdy wystąpi zdarzenie. |
Inicjator interakcji | Twoja aplikacja inicjuje żądanie (na przykład, aby uzyskać listę zleceń). | RemOnline inicjuje wysyłanie danych do twojego serwera. |
Częstotliwość użycia | Należy okresowo wysyłać żądania, nawet jeśli nie ma żadnych zmian (Polling). | Dane są wysyłane tylko wtedy, gdy coś się wydarzy (Event-driven). |
Zasoby serwera | Zależy od częstotliwości żądań - częste żądania mogą przeciążyć serwer. | Zużywa mniej zasobów, ponieważ żądania są wysyłane tylko wtedy, gdy wystąpią zdarzenia. |
Przykłady użycia | Pobieranie na żądanie informacji o zleceniach, klientach, zadaniach itp. | Otrzymywanie powiadomień w czasie rzeczywistym o zmianie statusu zlecenia, utworzeniu zadania lub otrzymaniu nowej recenzji klienta. |
Opóźnienie aktualizacji | Może wystąpić opóźnienie spowodowane koniecznością ręcznego lub automatycznego okresowego wysyłania żądań. | Aktualizacja jest wysyłana natychmiast po wystąpieniu zdarzenia. |
Złożoność konfiguracji | Wymaga opracowania i integracji żądań (GET, POST, PUT, DELETE itp.). | Wystarczy określić miejsce docelowe i wybrać zdarzenia, którymi jesteś zainteresowany. |
💡Mówiąc prościej:
API jest jak sklep, do którego idziesz, aby uzyskać potrzebne informacje. Ty decydujesz, kiedy pójść i poprosić o to, czego potrzebujesz. Użyj API, jeśli chcesz zażądać danych lub wykonać działania na żądanie.
Webhooki są jak dostawa do domu. Nie musisz nigdzie iść; dane są automatycznie dostarczane, gdy tylko są dostępne. Korzystaj z webhooków, jeśli chcesz automatycznie otrzymywać aktualizacje w czasie rzeczywistym bez konieczności ciągłego ich żądania.
Jak działają webhooki?
Następuje zdarzenie: W systemie wyzwalane jest określone zdarzenie, takie jak utworzenie zlecenia lub aktualizacja statusu.
Wysyłanie danych: System wysyła żądanie HTTP POST ze szczegółami zdarzenia w formacie JSON do twojego punktu końcowego.
Przetwarzanie danych: System przetwarza otrzymane dane do dalszych działań lub integracji.
Konfigurowanie webhooków
1. Zaloguj się do swojego konta.
2. Przejdź do Ustawienia > API.
3. Kliknij + Webhook i wprowadź następujące informacje:
Destination URL: Adres URL, na który będą wysyłane dane zdarzeń.
Opis: Krótki opis elementu webhook.
Wydarzenia: Wybierz zdarzenia, dla których chcesz otrzymywać aktualizacje.
4. Kliknij przycisk Utwórz.
Ważne: Upewnij się, że punkt końcowy jest dostępny i używa protokołu HTTPS do bezpiecznego przemieścić dane.
Możesz utworzyć maksymalnie 5 webhooków na konto, aby zapewnić wydajność systemu.
Wszystkie szczegóły można znaleźć na tej stronie.
Obsługiwane zdarzenia
Webhooki obsługują różne kategorie zdarzeń, w tym zadania, zlecenia, klientów i faktury.
Pełną listę zdarzeń można znaleźć w sekcji Ustawienia > API > Webhooks w oknie tworzenia nowego elementu webhook lub w niniejszej dokumentacji.
Jak mogę korzystać z webhooków?
Mając bezpośredni dostęp do interfejsów API innych usług lub korzystając z konektorów online, takich jak Zapier lub Make.com, możesz utworzyć punkt końcowy i określić jego adres URL dla elementu webhook, do którego RemOnline będzie automatycznie wysyłać powiadomienia o wybranym zdarzeniu.
W ten sposób można zautomatyzować wiele procesów:
Wysyłanie powiadomień SMS:
Korzystanie z usług SMS innych firm w celu informowania klientów o zmianach statusu zlecenia, dacie dostępności lub zmianie menedżera.
Integracja z Arkuszami Google:
Automatyczne dodawanie nowych zleceń lub danych zadań do Arkuszy Google w celach analitycznych lub raportowych.
Automatyzacja przypomnień:
Wysyłaj przypomnienia do klientów lub pracowników za pośrednictwem wybranego kanału (e-mail, komunikatory, powiadomienia push) o terminach realizacji zleceń lub wygaśnięciu zadań.
Raportowanie w czasie rzeczywistym:
Aktualizuj pulpity nawigacyjne (np. w Power BI lub Tableau), gdy zlecenia, zadania, faktury itp. są tworzone lub zmieniane.
Integracja z programami księgowymi:
Automatyczne przemieścić dane o utworzonych fakturach i zmianach w płatnościach do programów księgowych (np. 1C, QuickBooks).
Powiadomienia o usunięciu danych:
Powiadamianie menedżerów lub osób decyzyjnych o usunięciu klientów, zleceń, faktur lub zadań w celu śledzenia zmian w systemie.
Powyższe przykłady pokazują, w jaki sposób webhooki mogą automatyzować procesy biznesowe, integrować się z różnymi platformami i usprawniać komunikację. Możliwości ich wykorzystania są jednak niemal nieograniczone - wszystko zależy od Twoich potrzeb i kreatywności!