Receba só o que importa: filtre movimentações por palavras-chave

O problema: excesso de notificações

Você configurou o monitoramento de processos da Judit. Parabéns — isso já representa um enorme avanço. No entanto, logo que o sistema entra em operação, surge inevitavelmente outro problema: notificações demais.

Para começar, é importante entender que nem toda movimentação processual exige ação imediata. Por exemplo, uma juntada de petição da outra parte, um despacho de mero expediente ou, ainda, uma certidão de publicação são informações devidamente registradas pelo tribunal, mas que, na prática, não mudam absolutamente nada na sua estratégia. Em outras palavras, trata-se de ruído — não de sinal útil.

Sendo assim, a pergunta que realmente importa é: o que deve acionar um alerta? Sentença. Intimação com prazo. Decisão liminar. Acordo homologado. Penhora. Bloqueio. São justamente esses eventos que devem acender a luz vermelha — e somente eles, nada mais.

Como funciona o filtro step_terms

Sempre que você cria um monitoramento na Judit via endpoint /tracking, é possível incluir um campo chamado notification_filters com uma lista de step_terms. Para entender melhor, veja como isso funciona na prática:

Primeiramente, a Judit continua monitorando todas as movimentações normalmente — ou seja, nada muda nessa primeira camada de coleta. Contudo, no momento exato de enviar a notificação via webhook, o sistema só dispara o alerta se a movimentação contiver algum dos termos que você definiu previamente. Desse modo, a triagem acontece de forma completamente automática, muito antes de qualquer alerta chegar até você.

Exemplo de payload com filtro de termos{
  "recurrence": 1,
  "search": {
    "search_type": "lawsuit_cnj",
    "search_key": "1234567-89.2023.8.26.0100"
  },
  "notification_emails": ["[email protected]"],
  "notification_filters": {
    "step_terms": [
      "sentença",
      "intimação",
      "acordo",
      "penhora",
      "bloqueio",
      "liminar",
      "tutela",
      "recurso"
    ]
  }
}

Como o matching funciona na prática

A busca é realizada por substring case-insensitive: isso significa que, sempre que a movimentação contiver o termo em qualquer parte do texto, o webhook será disparado imediatamente. Isso implica, portanto, que mesmo variações de capitalização são cobertas automaticamente:

Apesar dessa ampla flexibilidade, termos muito curtos ou excessivamente genéricos podem acabar gerando falsos positivos indesejados. pro, por exemplo, pode casar simultaneamente com “protocolo”, “processo” e “procedente”. Por essa razão específica, recomenda-se sempre optar por termos mais precisos e descritivos.

Montando sua lista de termos ideal

Antes de tudo, é preciso reconhecer que não existe uma lista universal — tudo depende, fundamentalmente, da área do direito e do perfil específico da sua carteira de processos. Ainda assim, a seguir estão pontos de partida amplamente testados, que funcionam muito bem como base inicial para qualquer equipe jurídica:

Passo a passo: configure agora

A seguir, confira o passo a passo completo para ativar o filtro em um monitoramento novo ou, se preferir, para atualizar um já existente via API da Judit.

Comparativo: com e sem filtro

Para tornar ainda mais clara a diferença entre as duas abordagens, observe a tabela abaixo. Nela, é possível ver exatamente como cada tipo de movimentação se comporta antes e depois da ativação do filtro:

Como resultado direto dessa mudança, com o filtro devidamente ativo, toda a equipe passa finalmente a confiar nas notificações — pois, quando o alerta chega, a certeza é de que algo verdadeiramente importante aconteceu.

Limitações que você precisa conhecer

Embora o filtro seja extremamente útil, é igualmente importante conhecer suas limitações antes de colocá-lo em produção. Dessa forma, você evita surpresas e configura o sistema com expectativas realistas:

Caso surjam dúvidas técnicas adicionais sobre o comportamento da API, basta consultar a documentação oficial ou, se preferir, entrar em contato diretamente com o suporte da Judit.

Próximos passos

Agora que os filtros estão devidamente configurados e funcionando, é hora de ir além e explorar ainda mais tudo o que a plataforma tem a oferecer. Para isso, confira os recursos abaixo: