posthog-webhooks-events
Implement PostHog webhook signature validation and event handling.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling PostHog event notifications securely.\nTrigger with phrases like \
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Implement PostHog webhook signature validation and event handling.\nUse when setting up webhook endpoints, implementing signature verification,\nor handling PostHog event notifications securely.\nTrigger with phrases like \
How to use
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.