Use o GitHub DevLog AI como inbox privado e auditável dos seus webhooks.
Este guia cobre o uso diário: configurar GitHub, validar assinaturas, entender eventos, colaborar com o time, acompanhar o uso e abrir suporte.
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 eventos em workspaces privados, valida a assinatura e transforma cada delivery 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
Developers, admins e viewers trabalham com papéis distintos sem compartilhar senha ou Secret.
Do GitHub ao primeiro evento recebido.
Crie ou acesse um workspace
Abra o painel e confirme se você está no workspace correto. Ele mostra seu papel, plano, uso mensal e status da assinatura.
Copie Payload URL e Secret
Na configuração do GitHub, copie o endpoint privado e o Secret do workspace. Apenas owners e admins podem rotacionar o Secret.
Configure o GitHub
No repositório, abra Settings → Webhooks → Add webhook, selecione application/json e cole a URL e o Secret.
Escolha eventos
Comece com push e pull_request. Depois adicione issues, workflow_run ou outros eventos da sua integração.
Envie um ping
O GitHub envia um evento ping quando o webhook é criado. Quando ele chega, o painel mostra Delivery ID, repositório e payload.
Investigue no painel
Abra um evento para inspecionar assinatura, origem, action, commits, arquivos alterados, notas, tarefas e payload bruto sanitizado.
Quando usar webhook manual e quando usar GitHub App.
Webhook manual
Ideal para testar rapidamente um repositório. Copie URL e Secret, configure o GitHub e investigue eventos imediatamente.
GitHub App
Ideal para uso recorrente, times e organizações. O app permite instalação controlada e roteamento pela instalação vinculada ao workspace.
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 e cria testes, notas e tarefas sem alterar billing ou Secrets.
Viewer
Acompanha eventos e pode abrir suporte, mas não executa ações sensíveis.
Transforme payload em diagnóstico.
{
"event_name": "push",
"repository": "acme/api",
"delivery_id": "8189e9a8...",
"signature": "valid",
"branch": "main",
"commits": 3
}Controle o consumo antes de perder eventos.
Limite mensal
Cada plano define uma franquia mensal de eventos. O painel mostra uso e alertas preventivos.
Retenção
Eventos antigos seguem a política de retenção do plano, ajudando a controlar custo e privacidade.
Cancelamento
Owners e admins podem cancelar a assinatura no painel. A ação é auditada e registrada.
Se algo não funcionar, comece por aqui.
Webhook não chegou
Confirme que a URL está pública, o GitHub recebeu HTTP 200, o endpoint está correto e o limite mensal não foi atingido.
Assinatura inválida
Confira se o Secret no GitHub corresponde exatamente ao Secret do workspace. Se necessário, rotacione-o e envie novo ping.
Evento parece incompleto
Verifique se o GitHub envia application/json e se o evento selecionado inclui os campos esperados.
Billing ou plano
Revise a central de assinatura, a referência Mercado Pago e as notificações. Se algo não bater, abra um chamado com a referência.
Abra um chamado com contexto técnico suficiente.
Inclua repositório, Delivery ID, horário aproximado, evento GitHub, URL configurada, resposta HTTP do GitHub ou Mercado Pago e resultado esperado. Isso reduz idas e vindas e acelera a resolução.