Painel do desenvolvedor: visão geral
O Painel do desenvolvedor reúne apps, integrações, eventos e logs num só lugar - o centro de controle das conexões da sua loja com sistemas externos.
2 min
Por que acompanhar os eventos
Depois de conectar o ERP e autorizar remetentes de e-mail, você quer saber se tudo está funcionando. O Painel do desenvolvedor tem duas telas para isso: Eventos, um feed do que aconteceu, e Logs de API, um registro mais detalhado dos recebimentos e execuções. Juntas, elas garantem que você nunca fique no escuro sobre o que os conectores estão fazendo.
Antes de começar
Você precisa da permissão de Integrações.
Faz mais sentido depois de já ter pelo menos um conector ativo (ERP conectado ou remetente de e-mail autorizado) - sem conexões, as telas aparecem vazias.
A tela de Eventos
Em Painel do desenvolvedor > Eventos você vê o feed cronológico dos conectores e das rotinas de ingestão da sua loja: recebimento de webhook, execução de sync do ERP, captura de e-mail e erros de credencial, do mais recente para o mais antigo. Cada linha traz a origem, o status e o horário do evento.
No topo há um filtro de Origem para focar em um tipo de conector, e a tela informa a janela de dias e o limite de eventos por fonte que estão sendo exibidos. Se não houver nada na janela, aparece "Nenhum evento encontrado".
A tela de Logs de API
Em Painel do desenvolvedor > Logs de API o registro é mais técnico: os recebimentos e as execuções de ingestão dos conectores, paginados. No topo, os contadores de Webhook recebidos e Webhook rejeitados dão um resumo rápido, com o horário e o motivo da última rejeição.
A tabela mostra, por linha, a Origem, o Status e quantos documentos foram Encontrados, Ingeridos e quantas Falhas houve, além da referência e do horário. No topo há filtros de Origem e Status. A própria tela deixa claro: isto não é um APM - é um registro operacional dos conectores, não uma ferramenta de monitoramento de performance.
Como usar no dia a dia
Abra Eventos para a visão rápida do que rodou recentemente.
Use o filtro de Origem para isolar o conector que você quer conferir.
Se um envio deu problema, abra os Logs de API e olhe a linha com status de falha ou os webhook rejeitados - o motivo da rejeição está ali.
Corrija na origem (credencial do ERP, remetente autorizado) e confira no próximo evento se voltou ao normal.
Dica
Se você autorizou um remetente de e-mail e a nota não aparece em Notas fiscais, os Logs de API costumam explicar: um envio rejeitado quase sempre é remetente fora da lista ou assinatura inválida no webhook.
Próximo passo
Você fechou a trilha de Integrações. Para revisar todo o mapa da área, volte a "Painel do desenvolvedor: visão geral" sempre que precisar.
