posthog-webhooks-events
Odbieraj i przetwarzaj zdarzenia PostHog przez webhooki z walidacją podpisu
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Skill do integracji PostHog z Twoją aplikacją poprzez webhooks. Skonfiguruj destinacje, które automatycznie wysyłają powiadomienia o zdarzeniach (np. rejestracja użytkownika) na Twój endpoint HTTPS. Obsługuje walidację podpisu, przetwarzanie payload'ów oraz zapytania do Events API i HogQL. Idealny dla zespołów, które chcą reagować na zdarzenia z PostHog w czasie rzeczywistym bez ręcznego monitorowania.
Jak używać
Przygotuj wymagane dane: identyfikator projektu PostHog (POSTHOG_PROJECT_ID), osobisty klucz API (phx_...) oraz HTTPS endpoint, na który PostHog będzie wysyłać webhooki.
Utwórz destinację webhook poprzez API PostHog, wysyłając żądanie POST do
/api/projects/{PROJECT_ID}/pipeline_destinations/. W konfiguracji określ URL Twojego endpointu, metodę POST oraz nagłówki zawierające tajny klucz webhook (np. X-Webhook-Secret).Zdefiniuj filtry dla destinacji — wybierz konkretne zdarzenia, które mają wyzwalać webhook (np. user_signed_up, purchase_completed). Możesz filtrować po ID zdarzenia lub właściwościach.
W body żądania mapuj zmienne PostHog ({event}, {distinct_id}, {person}, {properties}, {timestamp}) na pola, które chcesz otrzymać w webhoku.
Na Twoim endpoincie odbieraj POST'y i waliduj podpis webhook'a za pomocą tajnego klucza. Przetwarzaj payload zgodnie z logiką Twojej aplikacji (np. wyślij email, zaktualizuj bazę danych).
Opcjonalnie: użyj Events API lub HogQL do zapytań historycznych o zdarzenia, jeśli potrzebujesz analizy poza real-time webhook'ami.