Toolverse
All skills

instantly-webhooks-events

by jeremylongshore

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

Installation

Pick a client and clone the repository into its skills directory.

Installation

Quick info

Category
Security
Views
11

About this skill

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

How to use

  1. 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).

  2. 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.

  3. 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.

  4. 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.

  5. 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ę.

  6. 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.

Related skills