Integracje / PostHog
Dokumenty i dane firmy
Integracja AI: PostHog
Podłączamy PostHog przez REST API do endpointów lejków, retencji, sesji i feature flags. Asystent czyta logi kliknięć z nagrań sesji, porównuje kohorty według person_properties i ocenia, jak aktywne przełączniki funkcji zmieniają zachowanie użytkowników.
Po prezentacji do 2 tygodni testów, z dostępem tego samego dnia. Płacicie dopiero po decyzji.

W skrócie
Jak asystent AI łączy się z systemem PostHog?
Łączymy się przez REST API PostHog. Klucz Personal API Key generujecie w Settings → Personal API Keys, wskazujecie project ID i asystent wysyła zapytania do endpointów /api/projects/{id}/... z nagłówkiem Authorization.
- Na start potrzebujemy
- Personal API Key z Settings → Personal API Keys w koncie PostHog.
- Czego asystent nie robi
- Nie zmienia żadnych danych w PostHog: nie edytuje zdarzeń, kohort ani flag funkcji bez potwierdzenia.
- Gdzie są dane
- Na Waszym serwerze. Zaczynamy od odczytu, zapis włączacie sami.
Dane z PostHog w czacie i we własnym module
Pracujecie na dwa sposoby. W czacie pytacie o cokolwiek z programu i dostajecie odpowiedź na Waszych danych. Do rzeczy, które wracają co dzień, budujemy w portalu osobne narzędzie: Lejki konwersji w PostHog. W portalu budujemy moduł, który łączy się z PostHog API i pokazuje wszystkie monitorowane lejki konwersji w jednym miejscu: platformę, krok odpadów i tygodniowy trend. Zespół widzi od razu, które lejki wymagają uwagi, bez logowania do PostHog i bez szukania właściwego projektu.
- Pobiera lejki z PostHog API z podziałem na $os i $device za ostatnie 30 dni
- Wykrywa kroki z odpórem wyraźnie wyższym na jednej platformie i oznacza je alertem
- Liczy tygodniową zmianę konwersji i porównuje z poprzednim tygodniem w pp
- Otwiera kartę ze szczegółami kroków i ścieżkami sesji powiązanymi z odpórem
- Eksportuje zestawienie lejków do XLSX na żądanie

Pytanie w czacie
Asystent pobiera dane kohortowe z PostHog, zestawia je tygodniami i wskazuje wprost, kiedy i która grupa zaczyna odpadać.
Sprawdź w PostHog, jak retencja użytkowników z planem Pro wypada tygodniami w porównaniu z planem Free. Chcę wiedzieć, kiedy Free odpada wyraźnie szybciej i czy różnica rośnie po tygodniu 1.

Karta w narzędziu
Każdy lejek z tabeli otwiera kartę z pełnym podziałem kroków, historią zmian i podpowiedzią, co sprawdzić jako pierwsze.
Moduł zbiera dane z PostHog API i układa je w jeden przegląd: bez logowania do PostHog, bez ręcznego szukania między projektami.
Ekrany na danych przykładowych. Narzędzie dla Waszej firmy układamy pod Wasz sposób pracy: inne kolumny, inne progi, inne powiadomienia.
Co podłączamy
Zaczynamy od odczytu danych. Zapis i akcje w systemie PostHog włączamy dopiero wtedy, gdy sami tego chcecie.
CzytamyDane lejka z /api/projects/{id}/funnels/ z podziałem na właściwości $os i $device za ostatnie 30 dni.
AsystentWykrywa, czy konkretny krok lejka odpada wyraźnie częściej na jednej platformie niż drugiej, i wskazuje te kroki jako pierwsze do sprawdzenia przez zespół.
CzytamyUstrukturyzowany log kliknięć i zatrzymań z konkretnej sesji pobrany przez /api/projects/{id}/sessions/.
AsystentOdtwarza ścieżkę użytkownika krok po kroku: co kliknął, gdzie się zatrzymał i na którym ekranie opuścił aplikację.
CzytamyLista aktywnych przełączników z /api/projects/{id}/feature_flags/ i zdarzenia otagowane polem $feature_flag_called.
AsystentPorównuje lejek grupy z włączoną flagą z grupą kontrolną i mówi wprost, czy nowa funkcja poprawia konwersję, czy nie ma wpływu.
CzytamyGrupy użytkowników zdefiniowane przez właściwości osoby: kraj, plan abonamentowy, data dołączenia pobrane z bazy PostHog.
AsystentZestawia retencję wybranych kohort w kolejnych tygodniach i pokazuje, która grupa wraca rzadziej po pierwszym tygodniu niż pozostałe.
CzytamyLiczba wystąpień każdego zdarzenia z /api/projects/{id}/trends/ z tygodniowym granulowaniem za ostatnie cztery tygodnie.
AsystentWskazuje trzy zdarzenia, których użycie wzrosło lub spadło najbardziej w stosunku do poprzedniego tygodnia.
CzytamyDane lejka i retencji pobrane z funnels i trends API dla okresu przed datą wdrożenia i po niej.
AsystentAutomatycznie sprawdza po wdrożeniu, czy główny lejek zmienił się, i dołącza wynik z jednozdaniowym komentarzem do dziennika produktu.
O co pytają w praktyce
Po polsku, jak koledze z pracy. Asystent odpowiada na danych z Waszego programu, a nie z ogólnej wiedzy.
- „Gdzie użytkownicy odpadają w lejku onboardingu w tym tygodniu?”
- „Czy nowa funkcja z włączoną feature flagą poprawia kończenie rejestracji?”
- „Co robił użytkownik, który zamknął aplikację na ekranie płatności?”
- „Jak retencja kohorty z Polski z planem Pro wypada wobec reszty użytkowników?”
Co się zmienia
Zespół produktowy dostaje co poniedziałek gotowy raport z odpadami w lejkach, wynikiem każdej feature flagi i opisem ścieżki sesji, zamiast ręcznie klikać przez dashboardy.
Asystent działa na Waszym serwerze, na Waszych uprawnieniach. Każdy odczyt i każda akcja zostawiają ślad w logu. Program zostaje tam, gdzie jest, razem z historią danych i nawykami zespołu.
O programie
PostHog to open-source platforma analityki produktowej, którą można postawić na własnym serwerze. Zbiera zdarzenia z aplikacji webowych i mobilnych, nagrywa sesje użytkowników jako logi kliknięć i ruchów kursora, a do tego pozwala zarządzać feature flags: przełącznikami włączającymi nową funkcję dla wybranego odsetka użytkowników. Opcja self-hosted ma znaczenie dla firm z wymaganiami RODO.
Na co dzień zespół pracuje z czterema głównymi obszarami: lejkami konwersji, nagraniami sesji, retencją z kohortami i wynikami flag funkcji. Dane w wersji self-hosted trafiają do bazy ClickHouse na własnym serwerze; firmy, które nie chcą stawiać infrastruktury, korzystają z chmury PostHog. Każde zdarzenie ma pola event_name i person_properties, co pozwala segmentować użytkowników po kraju, planie abonamentowym czy dacie dołączenia.
Gdzie to działa najlepiej
Menedżer produktu
W poniedziałek rano przed sprintem menedżer pyta asystenta o wyniki tygodnia: czy lejek onboardingu zmienił się po piątkowym wdrożeniu i które kohorty odpadają na etapie pierwszej akcji.
Z asystentem: Asystent pobiera dane z funnels i trends API, porównuje dwa tygodnie i odpowiada w kilka sekund. Menedżer idzie na spotkanie z liczbami gotowymi, bez czekania na developera.
Programista w zespole
Developer uruchomił nową wersję onboardingu pod feature flagą dla 20% użytkowników. Po trzech dniach pyta asystenta, czy flaga ma mierzalny wpływ na lejek rejestracji i retencję pierwszego tygodnia.
Z asystentem: Asystent pobiera zdarzenia otagowane $feature_flag_called z API, zestawia grupy i mówi, czy różnica jest istotna. Developer decyduje, czy funkcja idzie do wszystkich użytkowników.
Analityk UX
Analityk dostaje zgłoszenie, że użytkownicy z iOS nie kończą zakupu. Prosi asystenta o przejrzenie logów sesji z ostatnich 50 sesji mobilnych na etapie potwierdzenia zamówienia.
Z asystentem: Asystent odczytuje ścieżki z sessions API, wskazuje, gdzie sesje się urywają, i opisuje wzorzec. Analityk dostaje konkretny ekran do sprawdzenia, zamiast ręcznie przewijać nagrania.
Jak się łączymy
Łączymy się przez REST API PostHog. Klucz Personal API Key generujecie w Settings → Personal API Keys, wskazujecie project ID i asystent wysyła zapytania do endpointów /api/projects/{id}/... z nagłówkiem Authorization. Tryb pracy: wyłącznie odczyt. W wersji self-hosted z ClickHousem możliwy jest też bezpośredni dostęp SQL do surowych zdarzeń przy bardzo dużych wolumenach.
Asystent pracuje na serwerze klienta. Przed wysłaniem pytania do modelu AI przycinamy dane do fragmentów potrzebnych do odpowiedzi. Jeśli zdarzenia w Waszym projekcie zawierają e-maile lub inne dane osobowe użytkowników końcowych, konfigurujemy maskowanie na etapie integracji, zanim cokolwiek trafi do modelu.
Czego potrzebujemy od Was
- Personal API Key z Settings → Personal API Keys w koncie PostHog.
- Numer project ID: widoczny w adresie URL dashboardu PostHog.
- Plan PostHog z dostępem do API lejków i feature flags; wersja self-hosted bez ograniczeń planowych.
- Osoba techniczna znająca nazwy zdarzeń (event_name) i strukturę person_properties w projekcie.
- Adres instancji: URL chmury PostHog (EU lub US) albo własny URL w przypadku self-hosted.
Czego asystent nie robi
- Nie zmienia żadnych danych w PostHog: nie edytuje zdarzeń, kohort ani flag funkcji bez potwierdzenia.
- Nie ogląda plików wideo: czyta tylko ustrukturyzowane logi kliknięć i ruchów kursora z sessions API.
- Nie pracuje na surowych danych osobowych użytkowników końcowych: przy potrzebie konfigurujemy maskowanie przed wysłaniem do modelu.
- Nie zastępuje diagnozy kodu: wskazuje wzorzec zachowania, ale przyczynę błędu technicznego szuka developer.
Częste pytania
Czy muszę dawać asystentowi dostęp do wszystkich projektów PostHog?
Nie. Personal API Key możecie wygenerować z uprawnieniami do konkretnego projektu i wskazać tylko ten project ID. Klucz możecie unieważnić w każdej chwili w Settings → Personal API Keys, bez wpływu na resztę konta PostHog.
Co się stanie, gdy zdarzenia mają niespójne nazwy albo brakuje właściwości?
Asystent pokaże wynik na podstawie tego, co znajdzie w API. Niespójne nazewnictwo, np. purchase_complete i purchase_completed jako dwa oddzielne zdarzenia, da niepełne lejki. Na etapie integracji razem z osobą techniczną z Waszego zespołu przejrzymy nazwy zdarzeń i ustalimy, które wchodzą do raportów.
Czy integracja działa z chmurą PostHog i z wersją self-hosted tak samo?
Tak, obie wersje mają ten sam REST API i integracja wygląda identycznie. Różnica: self-hosted daje opcję bezpośredniego zapytania SQL do bazy ClickHouse, co przyspiesza pracę przy bardzo dużych wolumenach zdarzeń. W chmurze PostHog tej opcji nie ma.
Jak często asystent pobiera dane i czy obciąża API PostHog?
Raport tygodniowy odpytuje API raz w tygodniu, w nocy. Zapytania na żądanie przez czat generują kilka wywołań API na pytanie. Przy wyższych wolumenach warto sprawdzić limity planu; wersja self-hosted z dostępem SQL do ClickHouse nie ma tych ograniczeń.
Jak zaczynamy
- Bezpłatna prezentacja. Mówicie, na czym pracujecie i co Was korkuje. Mówimy wprost, czy da się to spiąć, a jeśli nie ma czego automatyzować, też to powiemy.
- Do 2 tygodni testów. Dostęp do portalu tego samego dnia, podłączenie w trybie odczytu, sprawdzacie na własnych danych.
- Rozszerzanie. Kolejne moduły i akcje dokładamy, gdy zespół ufa temu, co dostaje. W abonamencie jest wdrożenie, integracja, szkolenie i opieka.
Pokażemy to na Waszych danych z PostHog
Jedno zdanie wystarczy: czego szukacie w PostHog albo co ma się dziać samo. Odpiszemy, co podłączymy i od czego zacząć.
Inne programy: dokumenty i dane firmy
PostHog jest znakiem towarowym swojego właściciela. Nie jesteśmy z nim powiązani ani przez niego autoryzowani. Nazwy używamy wyłącznie po to, żeby wskazać, z jakim programem integrujemy asystenta.