Automação de Processos Judiciais no n8n: API, Webhooks HMAC e Resumo por IA no WhatsApp

Equipes de LegalOps, escritórios digitais e operações de crédito/compliance têm substituído dezenas de horas semanais de consulta manual nos portais judiciais por workflows visuais no n8n e no Make. Em vez de manter robôs quebradiços com navegador headless para cada tribunal, o n8n orquestra regras de negócio enquanto a API para automação jurídica no n8n e Make cuida da coleta padronizada em JSON.

Neste tutorial mão na massa mostramos os detalhes que evitam erros em produção: configuração segura de credenciais, o padrão exato para lidar com HTTP 202 Accepted, verificação criptográfica de webhooks e uso de agentes com MCP.

1. Configurando a credencial sem expor sua API Key

Nunca cole sua chave diretamente no campo de texto fixo de vários nós espalhados pelo workflow (isso vaza a credencial quando alguém exporta o JSON do template). No n8n:

1. Acesse Credentials → Add Credential → Header Auth.
2. Preencha Name como x-api-key e Value com a chave gerada no painel do BuscaProcessos.
3. Nos nós HTTP Request, selecione Authentication: Generic Credential Type → Header Auth.

2. Fluxo 1: Triagem de CPF/CNPJ no onboarding (com loop HTTP 202)

Imagine que um lead preenche o formulário (Typebot, Tally, HubSpot ou WhatsApp) com o CPF ou CNPJ. Antes de disparar a requisição:

• Adicione um nó Code rápido para limpar caracteres não numéricos (document.replace(/\D/g, '')) e validar se tem 11 (CPF) ou 14 (CNPJ) dígitos.
• Adicione o nó HTTP Request:
  • Method: GET
  • URL: https://api.buscaprocessos.app.br/v1/processos
  • Query Parameters: cpf_cnpj = {{ $json.documentoLimpo }}
  • Options → Response → Include Response Headers and Status: true (essencial!).

Tratando 200 OK vs. 202 Accepted

Conecte um nó IF logo após o HTTP Request testando {{ $json.statusCode }} igual a 202:

• Ramo false (200 OK): os processos já estão prontos em {{ $json.body.data.processos }}. Siga para gravar no CRM ou filtrar classes relevantes.
• Ramo true (202 Accepted): passe por um nó Wait (por exemplo, {{ Number($json.headers['retry-after'] || 5) }} segundos) e chame um segundo HTTP Request apontando para a URL de acompanhamento (statusUrl), limitando um contador máximo de iterações (ex.: 12 ciclos) para nunca criar um loop infinito caso algum tribunal esteja fora do ar (veja em tempo real em /status).

3. Fluxo 2: Webhook de movimentação + Resumo por IA no WhatsApp / Slack

Em vez de agendar um Cron no n8n para reconsultar toda a sua carteira todos os dias (o que encarece qualquer operação), cadastre os processos estratégicos em POST /v1/monitoramentos/processos apontando para a Production URL de um nó Webhook (POST) do seu n8n.

Validando a assinatura HMAC-SHA256 no nó Code

Como a URL do Webhook do n8n fica acessível na internet, valide sempre a assinatura enviada pela API usando o segredo do seu endpoint antes de disparar mensagens ao cliente:

const crypto = require('crypto');

// No nó Webhook do n8n, habilite Raw Body para validar o payload exato
const secret = $env.BUSCAPROCESSOS_WEBHOOK_SECRET;
const signatureHeader = $input.first().json.headers['x-webhook-signature'] || '';
const rawBody = $input.first().binary?.data
  ? Buffer.from($input.first().binary.data.data, 'base64')
  : Buffer.from(JSON.stringify($input.first().json.body));

const expected = crypto
  .createHmac('sha256', secret)
  .update(rawBody)
  .digest('hex');

if (!signatureHeader.includes(expected)) {
  throw new Error('Assinatura HMAC inválida no webhook');
}

return $input.all();

Traduzindo o andamento sem precisar engenheirar prompts

Quando o webhook avisa que o processo 0001234-56.2024.8.26.0100 teve nova movimentação:

1. Um nó HTTP Request chama GET https://api.buscaprocessos.app.br/v1/processos/cnj/{{ $json.body.cnj }}/resumo-ia (custo fixo de R$ 0,12).
2. O retorno entrega um resumo claro em português, sem jargão forense truncado.
3. Envie o resumo para o canal interno do escritório (Slack, Microsoft Teams, ClickUp) com botão de revisão antes do disparo na Evolution API / WhatsApp Cloud API do cliente.

4. Bônus: Agentes de IA no n8n via MCP Client

Se você constrói AI Agents dentro do n8n (nó AI Agent + MCP Client Tool), nem precisa mapear rota por rota manualmente: basta apontar o transporte Streamable HTTP para https://api.buscaprocessos.app.br/mcp enviando sua credencial x-api-key.

O Servidor MCP Jurídico oficial expõe automaticamente as ferramentas de consulta por CPF/CNPJ, capa por CNJ, busca por OAB, precatórios e saldo, já protegidas com confirmação explícita de cobrança (confirmar_cobranca) para evitar que o LLM dispare buscas pagas sem autorização do fluxo.

Próximos passos

Comece com a API jurídica pré-paga sem mensalidade, explore os payloads completos na documentação pública no ReadMe e combine seus fluxos de atendimento com o monitoramento de intimações por OAB e DJEN.