instantly-webhooks-events
Walidacja i obsługa webhooków Instantly do śledzenia zdarzeń email w czasie rzeczywistym
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do integracji webhooków Instantly umożliwia bezpieczne odbieranie i przetwarzanie powiadomień o zdarzeniach email — wysłania, otwarcia, odpowiedzi, odbicia czy zmian statusu leadów. Implementujesz walidację podpisu webhook, konfigurując HTTPS endpoint, który nasłuchuje zdarzeń z Instantly i reaguje na nie automatycznie. Idealny dla zespołów obsługujących kampanie email outreach, którzy chcą integrować dane o interakcjach z leadami bezpośrednio w swoje systemy.
Jak używać
Przygotuj środowisko: upewnij się, że masz konto Instantly z włączonym dostępem API oraz klucz API zapisany w zmiennej środowiskowej INSTANTLY_API_KEY. Skill wymaga dostępu do narzędzi Read, Write, Edit i Bash (curl).
Zdefiniuj endpoint webhook: skonfiguruj HTTPS endpoint w swojej aplikacji (np. /webhooks/instantly), który będzie odbierać POST requesty od Instantly. Endpoint musi być dostępny publicznie i obsługiwać JSON.
Implementuj walidację podpisu: skill pomaga dodać weryfikację nagłówka x-api-key lub innego mechanizmu podpisu, aby upewnić się, że webhook pochodzi od Instantly. Porównaj klucz API z tym przesłanym w żądaniu.
Obsługuj typy zdarzeń: zarejestruj handlery dla zdarzeń takich jak email.sent, email.opened, email.replied, email.bounced, email.unsubscribed, lead.interested i lead.meeting_booked. Każde zdarzenie zawiera payload z danymi o leadzie, kampanii i szczegółach interakcji.
Przetwarzaj dane i reaguj: wyodrębnij informacje z payloadu webhook (email, ID kampanii, typ zdarzenia) i zintegruj je z własnym systemem — zapisz w bazie danych, wyślij notyfikację lub wyzwól automatyzację.
Testuj integrację: użyj curl lub narzędzia do testowania API, aby wysłać przykładowe żądania webhook do swojego endpointu i upewnić się, że walidacja i obsługa działają poprawnie.