GitHub DevLog AI GitHub DevLog AIWebhook inbox privado para GitHub
Documentação para devs

Use o GitHub DevLog AI como inbox privado e auditável dos seus webhooks.

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.

Visão geral

O que a ferramenta resolve.

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.

Inbox privado

Cada workspace tem endpoint e secret próprios. Um dev não vê webhooks de outro workspace.

Assinatura validada

Eventos GitHub são aceitos com X-Hub-Signature-256 e payload sanitizado.

Colaboração

Dev, admin e viewer podem trabalhar com papéis diferentes sem compartilhar senha ou secret.

Primeiro webhook

Do GitHub ao primeiro evento recebido.

Crie ou acesse um workspace

Entre no painel e confirme se você está no workspace correto. O painel mostra seu papel, plano, uso mensal e status da assinatura.

Copie Payload URL e Secret

Na área de configuração GitHub, copie o endpoint privado e o secret do workspace. Somente owner/admin podem rotacionar o secret.

Configure no GitHub

No repositório, vá em Settings → Webhooks → Add webhook, use application/json, cole a URL e o secret.

Escolha eventos

Comece com push e pull_request. Depois adicione issues, workflow_run ou outros conforme a integração.

Envie um ping

O GitHub envia um evento ping quando o webhook é criado. Se ele chegou, você verá delivery id, repositório e payload no painel.

Investigue no painel

Abra o evento para ver assinatura, origem, action, commits, arquivos alterados, notas, tarefas e payload bruto sanitizado.

GitHub App

Quando usar webhook manual e quando usar GitHub App.

Webhook manual

Bom para testar rápido em um repositório específico. Você copia URL e secret, configura no GitHub e acompanha eventos imediatamente.

GitHub App

Melhor para uso recorrente, times e organizações. O app permite instalação controlada e roteamento por instalação vinculada ao workspace.

Equipe e permissões

Colaboração sem compartilhar credenciais.

Owner

Gerencia billing, equipe, secrets, GitHub App, testes e investigação.

Admin

Opera o workspace e gerencia membros, billing, secrets e GitHub App.

Developer

Investiga eventos, cria testes, notas e tarefas, sem mexer em billing ou secret.

Viewer

Acompanha eventos e pode abrir suporte, mas não executa ações sensíveis.

Eventos, notas e tarefas

Transforme payload em diagnóstico.

{
  "event_name": "push",
  "repository": "acme/api",
  "delivery_id": "8189e9a8...",
  "signature": "valid",
  "branch": "main",
  "commits": 3
}
Planos e uso

Controle consumo antes de perder eventos.

Limite mensal

Cada plano define quantidade mensal de eventos. O painel mostra uso e alertas preventivos.

Retenção

Eventos antigos seguem a política de retenção do plano. Isso ajuda a controlar custo e privacidade.

Cancelamento

Owner/admin podem cancelar a assinatura no dashboard. A ação fica auditada e registrada.

Troubleshooting

Se algo não funcionar, comece por aqui.

Webhook não chegou

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.

Assinatura inválida

Confira se o Secret no GitHub é exatamente o mesmo exibido no workspace. Se necessário, rotacione o secret e envie novo ping.

Evento aparece incompleto

Verifique se o GitHub está enviando application/json e se o evento selecionado inclui os campos esperados.

Billing ou plano

Veja a central da assinatura, referência Mercado Pago e notificações. Se algo não bater, abra chamado com a referência.

Suporte

Abra chamado com contexto técnico suficiente.

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.