Ir para o conteúdo
CRM JurídicoEntrar

Central de ajuda › Gestão e configurações

Captura só-motor: API e webhooks

Para o escritório que já tem o seu sistema — receber cada movimentação já classificada pelo motor (tipo do ato, favorabilidade, prazo em dias úteis, urgência, providência e peça indicada) pela API com chave e pelo webhook publicacao.nova.

Atualizado em 07/10/2026 · 4 min de leitura

Nesta página
  1. Para que serve
  2. Passo a passo
  3. Perguntas frequentes
  4. O que o sistema não faz

Para que serve

Nem todo escritório quer trocar de sistema. Na captura só-motor, o CRM capta as intimações (DJEN, tribunal e as outras fontes ligadas), passa cada uma pelo motor e entrega o resultado já classificado no sistema do escritório: o tipo do ato, se foi favorável ou não ao cliente, a providência, o prazo em dias úteis com a data fatal, a urgência e as peças cabíveis. É a mesma conclusão que aparece na tela Movimentações e no botão «Gerar peça».

Há dois caminhos, que podem ser usados juntos: buscar (GET /api/v1/movimentacoes, com a chave da API) e receber (webhook publicacao.nova, assinado). Os dois trazem a classificação no mesmo formato.

Passo a passo

1. Gerar a chave e cadastrar o webhook

  1. Em Integrações › Para desenvolvedores (só o administrador), gere uma chave de leitura e copie — ela aparece uma vez.
  2. Se quiser ser avisado na hora, cadastre um webhook (endereço https do seu sistema) com o evento publicacao.nova e guarde o segredo.

2. Buscar as movimentações classificadas

Exemplo com curl (troque a chave e o endereço do seu CRM):

curl -H "Authorization: Bearer crm_SUA_CHAVE" "https://SEU-CRM/api/v1/movimentacoes?desde=2026-10-01&fonte=djen&limite=50"

Próxima página: repita a chamada com cursor= e o valor de pagina.proximo da resposta, até ele vir nulo. A ordem é a data do ato e depois o id, então o cursor não pula nem repete mesmo com publicações entrando no meio.

Filtros: desde e ate (data do ato, AAAA-MM-DD; sem desde, os últimos 7 dias), inserido_desde (quando o CRM viu, para buscar só o que chegou desde a última leitura), processo (número CNJ), grupo (prazo, audiencia, decisao ou ciencia), fonte (djen, tribunal ou outras), copias=1 (inclui as cópias da mesma intimação no DJEN) e limite (1 a 200, padrão 50). Valor inválido devolve 400 com a explicação.

3. O que vem em cada movimentação

  • id (fixo), fonte, comunicacao_id (publicação) ou andamento_id (tribunal), processo, tribunal, orgao, data_evento, data_disponibilizacao, titulo, resumo, ativo e cancelado_em (cancelada na fonte fica, riscada), situacao, copia_de, visto_em e url (abre no CRM).
  • classificacao, com estas chaves (sempre presentes; sem valor vem null):
  • tipo_ato (o rótulo do motor, como «SENTENÇA»), tipo (sentenca, acordao, decisao, despacho, ato_ordinatorio, citacao, intimacao, audiencia…), tpu (código e nome da Tabela Processual Unificada), grupo e grupo_rotulo («Com prazo», «Audiências», «Decisões e sentenças», «Só ciência»), regra e fora_do_mapa.
  • natureza (PECA, RECURSO, DILIGENCIA, COMPROMISSO ou CIENCIA), resultado, favorabilidade (FAVORÁVEL, DESFAVORÁVEL, PARCIAL ou NEUTRO), providencia e fundamento.
  • prazo: dias, contagem («úteis» ou «corridos»), limite (a data fatal do calculador, com feriados e recesso do tribunal), origem, dias_restantes e dias_uteis_restantes (0 = vence hoje; negativo = em atraso).
  • urgencia (0 a 100, recalculada no dia da consulta) e urgencia_nivel (alta a partir de 70, media a partir de 40, baixa abaixo).
  • audiencia (tipo, data, hora e se é virtual, quando o ato marca uma), peca_indicada e pecas: as peças cabíveis, cada uma com peca, titulo, esqueleto, dias, limite, fundamento e as marcas principal, generica e mesmo_ato.
  • motor_versao: a versão do motor que analisou o ato.

4. Receber pelo webhook

O evento publicacao.nova continua com o mesmo nome e os mesmos campos de sempre (comunicacao_id, processo, tribunal, data_disponibilizacao, tipo_comunicacao, orgao, tipo_ato, natureza, providencia, prazo_limite e url) e agora traz também classificacao, igual à da API. Confira a assinatura no cabeçalho X-CRM-Assinatura (HMAC-SHA256 do segredo sobre «carimbo.corpo») antes de aceitar. Os demais eventos (prazo.vencendo, andamento.importante…) não mudaram.

Perguntas frequentes

Por que o webhook não traz o texto da intimação?

Porque o webhook não exige chave: só leva a conclusão do motor, sem teor, resumo ou nome de parte. O texto vem pela API, com a chave: GET /api/v1/publicacoes?texto=1.

A urgência mudou de um dia para o outro. Está errado?

Não. A urgência é refeita no dia da consulta: o mesmo prazo fica mais urgente conforme a data fatal se aproxima.

Posso confiar no prazo sem conferir?

O prazo é o do calculador do CRM (dias úteis, feriados e recesso do tribunal), o mesmo da tela. Como em toda sugestão do motor, a conferência final é do advogado — e o que estiver errado pode ser marcado em Divergências do motor.

Recebo a mesma intimação duas vezes?

Não pelo webhook: cada publicação nova sai uma vez por endereço. Na API, as cópias da mesma intimação no DJEN ficam de fora, a não ser com copias=1.

O que o sistema não faz

  • Não devolve o andamento do tribunal com peças: para os andamentos (fonte tribunal), a lista de peças vem vazia — a providência deles depende do lado do cliente, que o advogado define no CRM.
  • Não junta o mesmo ato de fontes diferentes na API: a intimação do DJEN e o andamento do tribunal do mesmo ato vêm como dois itens (a tela Movimentações é que agrupa).
  • Não escreve no seu sistema: o CRM só oferece a API e manda o webhook; gravar do lado de lá é com o seu sistema (ou com Zapier, Make e n8n).