Este guia é para quem vai usar a ferramenta no dia a dia: configurar GitHub, validar assinatura, entender eventos, colaborar com o time, controlar uso e abrir suporte quando algo não bater.
Webhooks do GitHub são poderosos, mas difíceis de depurar quando você só tem logs locais, payloads enormes e respostas espalhadas. O DevLog AI centraliza esses eventos em workspaces privados, valida a assinatura e transforma cada entrega em uma timeline legível.
Cada workspace tem endpoint e secret próprios. Um dev não vê webhooks de outro workspace.
Eventos GitHub são aceitos com X-Hub-Signature-256 e payload sanitizado.
Dev, admin e viewer podem trabalhar com papéis diferentes sem compartilhar senha ou secret.
Entre no painel e confirme se você está no workspace correto. O painel mostra seu papel, plano, uso mensal e status da assinatura.
Na área de configuração GitHub, copie o endpoint privado e o secret do workspace. Somente owner/admin podem rotacionar o secret.
No repositório, vá em Settings → Webhooks → Add webhook, use application/json, cole a URL e o secret.
Comece com push e pull_request. Depois adicione issues, workflow_run ou outros conforme a integração.
O GitHub envia um evento ping quando o webhook é criado. Se ele chegou, você verá delivery id, repositório e payload no painel.
Abra o evento para ver assinatura, origem, action, commits, arquivos alterados, notas, tarefas e payload bruto sanitizado.
Bom para testar rápido em um repositório específico. Você copia URL e secret, configura no GitHub e acompanha eventos imediatamente.
Melhor para uso recorrente, times e organizações. O app permite instalação controlada e roteamento por instalação vinculada ao workspace.
Gerencia billing, equipe, secrets, GitHub App, testes e investigação.
Opera o workspace e gerencia membros, billing, secrets e GitHub App.
Investiga eventos, cria testes, notas e tarefas, sem mexer em billing ou secret.
Acompanha eventos e pode abrir suporte, mas não executa ações sensíveis.
{
"event_name": "push",
"repository": "acme/api",
"delivery_id": "8189e9a8...",
"signature": "valid",
"branch": "main",
"commits": 3
}
Cada plano define quantidade mensal de eventos. O painel mostra uso e alertas preventivos.
Eventos antigos seguem a política de retenção do plano. Isso ajuda a controlar custo e privacidade.
Owner/admin podem cancelar a assinatura no dashboard. A ação fica auditada e registrada.
Confirme se a URL está pública, se o GitHub recebeu HTTP 200, se o endpoint está correto e se o limite mensal não foi atingido.
Confira se o Secret no GitHub é exatamente o mesmo exibido no workspace. Se necessário, rotacione o secret e envie novo ping.
Verifique se o GitHub está enviando application/json e se o evento selecionado inclui os campos esperados.
Veja a central da assinatura, referência Mercado Pago e notificações. Se algo não bater, abra chamado com a referência.
Inclua repositório, delivery id, horário aproximado, evento GitHub, URL configurada, resposta HTTP do GitHub/Mercado Pago e o resultado esperado. Isso reduz ida e volta e acelera a resolução.