Webhooks empurram eventos do MonitoraSEI para uma URL externa em tempo real — perfeito para integrações com seu CRM, sistema de tickets, Slack ou automação.
Como configurar
- Em Configurações → Integrações, seção Webhooks.
- Clique em + Novo webhook.
- Preencha:
- URL de destino (deve aceitar POST com JSON).
- Eventos desejados (todos ou um subconjunto).
- Ativo marcado.
- Salve.
Eventos disponíveis
novo_documento— documento adicionado a um processo monitorado.novo_andamento— andamento/movimentação registrada.nova_movimentacao— mudança de unidade.prazo_detectado— IA identificou prazo em documento.prazo_proximo— alerta antes do vencimento.prazo_vencido— prazo passou sem ser cumprido.sei_keyword_match— termo de grupo de palavras-chave encontrado no SEI.qd_publications— publicação encontrada no Querido Diário (gazetas municipais).doe_publications— publicação encontrada em Diário Oficial Estadual.
Formato do payload
Cada requisição POST inclui um JSON no formato:
{
"id": "uuid-do-evento",
"evento": "novo_documento",
"timestamp": "2026-04-25T14:30:00Z",
"dados": { ... }
}
O header X-Webhook-Signature traz um HMAC-SHA256 do corpo da requisição calculado com o secret do webhook (gerado no momento da criação). Use-o para validar que a origem é o MonitoraSEI.
Testando
Use o botão Testar ao lado do webhook para enviar um payload de exemplo. O sistema mostra a resposta HTTP do seu endpoint, útil para depurar erros de conexão.
Seu endpoint deve responder em até 30 segundos.
Reentrega
Se a URL retornar erro (5xx ou timeout), o MonitoraSEI tenta novamente em backoff exponencial. Após várias falhas, o webhook é desativado automaticamente — consulte a aba de logs no painel para investigar.