Se você quer que outro sistema converse com o Fluxo Jurídico — o formulário do seu site criando o contato sozinho, o seu CRM recebendo os leads, ou uma automação no n8n mandando mensagem — o caminho é a API. Ela é a porta pela qual um programa (e não uma pessoa) usa o Fluxo Jurídico.

Você não precisa programar para liberar o acesso: essa parte é feita aqui dentro, em poucos cliques. Quem escreve a integração é o seu desenvolvedor, ou a ferramenta de automação que você já usa.

Criar a chave de acesso

1. 1
   Abra Configurações › API e Integrações

   Só quem tem papel de Administrador enxerga essa área — a chave dá acesso aos dados do escritório inteiro.
2. 2
   Clique em Nova chave

   Dê um nome que diga de onde ela é, por exemplo "Site — formulário de contato". Esse nome é o que você vai olhar no dia em que precisar desligar alguma integração.
3. 3
   Marque só o que a integração precisa fazer

   As permissões são separadas por assunto: ler contatos, criar contatos, enviar mensagem, mexer no funil, e assim por diante. Marque o mínimo — se o site só cria lead, ele não precisa poder enviar mensagem.
4. 4
   Copie a chave na hora

   Ela aparece uma única vez. Guarde num lugar seguro (o gerenciador de senhas do escritório, por exemplo) e entregue ao desenvolvedor.

A chave é do escritório, não sua

Diferente da sua senha, a chave pertence ao workspace. Isso é de propósito: quando alguém sai da equipe, as integrações continuam funcionando. E quando você revoga uma chave, ninguém perde o acesso ao sistema — só aquela integração para.

Ver o que a API consegue fazer

Na mesma tela há o botão Ver a documentação, com a lista completa do que é possível: enviar mensagem de WhatsApp, criar e atualizar contatos, marcar etiquetas, mover o funil, consultar horários livres e marcar reuniões, ler relatórios e mais. Cada item traz um exemplo pronto e a lista de erros possíveis.

Essa mesma documentação existe num endereço público, em fluxojuridico.com.br/api-docs. Você pode mandar o link para o seu desenvolvedor sem precisar dar acesso ao sistema.

Quando desconfiar, revogue

Se a chave foi para o lugar errado — mandada por engano num grupo, deixada no computador de alguém que saiu, ou você simplesmente não sabe mais quem a tem — abra a tela, clique em Revogar e crie outra. A revogação vale na hora, sem espera.

Limite de uso

Cada chave pode fazer até 300 chamadas por minuto e 200 mil por dia. É folgado para uso normal; o limite existe para que uma integração mal configurada não deixe o sistema lento para o resto do escritório. Se sua integração bater no teto, ela recebe um aviso claro e basta espaçar as chamadas.

O caminho contrário: ser avisado quando algo acontece

A API serve para o seu sistema perguntar. Se você quer o contrário — que o Fluxo Jurídico avise o seu sistema quando algo acontece — isso são os Webhooks de saída, na aba ao lado, dentro da mesma tela de API e Integrações. Os dois se completam: um pergunta, o outro avisa.

Do que o sistema consegue avisar

São 23 avisos diferentes, agrupados por assunto: mensagem recebida e enviada, entrega e leitura, conversa iniciada, atendimento aberto, atribuído, transferido, encerrado, mudança de etapa no funil e de prioridade, contato criado, alterado e reetiquetado, robô que assumiu ou largou a conversa, reunião marcada e cancelada, contrato assinado, ligação encerrada, pesquisa de satisfação respondida, campanha concluída — e canal desconectado, que costuma ser o mais útil de todos: sem ele, o escritório só descobre que o WhatsApp caiu quando um cliente reclama.

Ao criar o aviso você escolhe quais quer receber, e a aba Documentação mostra exatamente o texto que o seu sistema vai receber em cada um — dá para o programador escrever o código antes mesmo de o primeiro aviso chegar.

• Tudo o que a API faz fica registrado na Auditoria, identificando qual chave fez cada ação.
• A chave respeita as mesmas regras do sistema: ela só enxerga os dados do seu workspace, nunca de outro escritório.
• A regra das 24 horas do WhatsApp vale igual pela API: fora da janela, só template aprovado.