clay-webhooks-events

Implement Clay webhook signature validation and event handling.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling Clay event notifications securely.\nTrigger with phrases like \

1. Przygotuj tabelę w Clay z włączonym źródłem webhook lub kolumną wzbogacającą HTTP API — będziesz potrzebować unikalnego adresu URL webhooka oraz dostępu do dokumentacji API Clay.

2. Upewnij się, że Twój endpoint jest dostępny przez HTTPS z internetu — Clay musi móc wysyłać żądania POST do Twojego serwera. Jeśli testujesz lokalnie, użyj tunelu (np. ngrok) do wystawienia aplikacji na zewnątrz.

3. Dla webhooków przychodzących (inbound): skonfiguruj endpoint, który odbiera POST'y na unikalny adres URL Clay'a. Każde żądanie zawiera dane wiersza — przetwórz je i zapisz w bazie danych lub wyślij dalej do systemu.

4. Dla webhooków wychodzących (outbound): skonfiguruj kolumnę HTTP API w Clay'u, która wskazuje na Twój endpoint. Po wzbogaceniu danych Clay wyśle wynik POST'em — odbierz, zwaliduj sygnaturę i przetwórz wzbogacone dane.

5. Implementuj walidację sygnatur — Clay dołącza nagłówek podpisu do każdego żądania. Zweryfikuj go, aby upewnić się, że żądanie pochodzi naprawdę z Clay'a i nie zostało zmienione.

6. Monitoruj limity: każdy webhook inbound ma limit 50 000 przesłań — jeśli go przekroczysz, utwórz nowy webhook w interfejsie Clay'a i zaktualizuj adres URL w konfiguracji.