Como criar a chave pessoal do PostHog e conectar no FarejaLeads
Atualizado em
Com o PostHog conectado, o FarejaLeads lê os visitantes reais (sem robôs), as origens e o funil dos eventos que você escolher. Só leitura: a chave tem só os escopos de consulta.
O que você ganha
- Visitantes e funil do PostHog no Analytics e no MCP (crm_resumo, crm_funil_posthog)
Antes de começar
- Acesso à organização do PostHog que tem o projeto do site.
- Saber a região: US (us.posthog.com) ou EU (eu.posthog.com) — é o endereço em que você entra.
Passo a passo
1. Abra as chaves pessoais
No PostHog, clique no seu avatar (canto inferior esquerdo) → Account settings → Personal API keys. Endereço direto: us.posthog.com/settings/user-api-keys (troque us por eu na região EU).
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
2. Crie a chave com dois escopos
Clique em Create personal API key, dê o nome FarejaLeads e, em escopos, marque só query:read e project:read. Em Organização/Projetos, deixe a organização do site.
Copie a chave (começa com phx_). Ela aparece uma vez só.
O nome deste menu pode ter mudado na plataforma. Viu outro? Conte abaixo: o guia se corrige com o seu relato.
3. Cole no FarejaLeads
No app, Conexões (farejaleads.com/app/conexoes) → PostHog → Conectar. Escolha a região, cole a chave e salve: o FarejaLeads confere listando os projetos.
Marque os projetos, ponha o domínio do site em cada um e, se quiser, o funil em ordem (ex.: $pageview, cadastro, checkout_iniciado). Salve de novo.
4. Teste
Em Analytics aparecem os visitantes do PostHog. Pelo MCP, crm_funil_posthog devolve o funil. Erro "chave sem permissão" = falta um dos dois escopos.
Regras que valem sempre
- A chave nunca entra pela conversa com o agente: só pelo formulário.
- Para desligar, Conexões → PostHog → Remover (a chave é apagada) e revogue a chave no PostHog.