Leve ao canal os sinais do PostHog que pedem uma ação.

Alerts ou Destinations: qual caminho usar?

Use um alerta quando a equipe precisa acompanhar uma condição em uma métrica. Para encaminhar eventos selecionados de produto, configure uma HTTP Webhook Destination no pipeline do PostHog. Evite enviar todo evento capturado: um canal cheio de ocorrências sem ação definida perde sua utilidade.

Um exemplo ilustrativo de evento é a conclusão de uma etapa importante de implantação de um cliente. Já uma queda de conversão exige olhar a definição da métrica, a janela de avaliação e o volume que sustenta a comparação. A chegada da mensagem não explica por si só a causa da mudança.

Crie a conexão e configure o destino

1. No Joii, abra Configurações → Integrações → Aplicativos e alertas e escolha PostHog. Você precisa de permissão para gerenciar integrações e poder publicar no canal interno de destino; em canais públicos, entre no canal antes de configurar.
2. Dê um nome que explique o sinal recebido e selecione o canal.
3. Para Alerts, use o modo de URL secreta. Na notificação Webhook do alerta, cole a URL gerada pelo Joii.
4. Para eventos, abra Data pipelines, Destinations e HTTP Webhook no PostHog. Configure POST, o corpo com o evento e filtros específicos.
5. Se optar por Standard Webhooks na Destination, configure o mesmo segredo de assinatura nos dois lados. Não escolha esse modo no receptor se a origem não estiver assinando as requisições.
6. Envie um teste pelo PostHog e acompanhe a entrega no Joii.

A URL é uma credencial de publicação. Não a coloque em documentos públicos, capturas de tela ou código entregue ao navegador. Para substituir um segredo de assinatura, siga o fluxo de nova conexão e revogação da antiga.

Defina uma mensagem que ajude a decidir

O adaptador do Joii reconhece campos de título e texto, além de estruturas de evento e propriedades de alerta. Para uma Destination personalizada, este corpo é um exemplo ilustrativo do formato aceito; substitua os valores por campos realmente disponíveis no seu evento:

{
  "title": "Implantação: primeira equipe convidada",
  "text": "Ambiente de demonstração concluiu a etapa do piloto.",
  "url": "https://example.com/analise-do-evento"
}

Prefira descrições suficientes para a triagem e um link HTTPS para a análise. Não envie senhas, tokens, documentos de clientes ou propriedades pessoais que o canal não precisa receber. O Joii não interpreta o payload como uma instrução para escolher outro canal ou executar comandos.

Diferencie aceitação de publicação

Uma resposta HTTP 202 indica entrada na fila; confirme depois a mensagem no canal e o histórico de entregas. Falhas de assinatura ocorrem antes da aceitação e não aparecem como entregas concluídas. Se o teste falhar, confira URL, estado da conexão, formato JSON e modo de autenticação.

Corpos idênticos podem ser deduplicados durante a retenção. Uma nova ocorrência deve ter identificação que a distinga; uma tentativa repetida da mesma ocorrência deve preservar o corpo. Respeite os limites e o Retry-After recebido, em vez de repetir sem espera.

Pausar recusa novos eventos e invalida publicações pendentes daquela geração. Reativar não recupera automaticamente o que foi recusado. O destino atual é um canal interno; esta conexão não é uma API de leitura do PostHog nem uma integração bidirecional. Consulte também o guia de webhooks.