Webhooki: bezpieczny odbiór zdarzeń

Wybierz zdarzenie i odbiorcę

Webhook informuje zewnętrzną aplikację o zdarzeniu w Chatwoot. Zanim go dodasz, ustal potrzebne dane, docelowy adres HTTPS i osobę odpowiedzialną za odbiornik. Użyj konta i skrzynki testowej.

Nie przekazuj całej treści rozmowy, jeżeli integracja potrzebuje tylko identyfikatora i statusu. Ustal retencję logów po obu stronach.

Przygotuj endpoint

Odbiornik powinien akceptować wyłącznie oczekiwane metody i strukturę danych. Sposób uwierzytelniania lub sprawdzania podpisu zweryfikuj w dokumentacji konkretnego wydania. Nie zakładaj, że dowolny nagłówek potwierdza pochodzenie żądania.

Po przyjęciu zdarzenia zapisz je trwale i przekaż pracę do kolejki. Zwróć potwierdzenie dopiero po zaakceptowaniu danych. Klucze do innych usług przechowuj po stronie serwera.

Zapobiegaj duplikatom i pętlom

Obsługa tego samego zdarzenia dwa razy nie powinna wywołać dwóch płatności, zgłoszeń ani odpowiedzi. Wybierz klucz idempotencji oparty na identyfikatorach dostępnych w rzeczywistym payloadzie. Nie wymyślaj pola, którego API nie dostarcza.

Jeżeli odbiornik zapisuje coś z powrotem do Chatwoot, sprawdź, czy nie uruchamia ponownie tego samego obiegu. Ogranicz zdarzenia i warunki do potrzebnego zakresu.

Test i wyłączenie

Sprawdź poprawne zdarzenie, duplikat, niepoprawny payload i chwilowy błąd odbiornika. Loguj wynik bez sekretów i zbędnej treści rozmów. Wyłącz konkretny webhook w konfiguracji przed usunięciem endpointu. Szczegóły API znajdziesz we wprowadzeniu dla programisty.