Conectar outros sistemas (API e integrações)
Como ligar o Fluxo Jurídico ao seu site, ao seu CRM ou a ferramentas como n8n, Make e Zapier: criar a chave de acesso, escolher o que ela pode fazer, e o que fazer se ela vazar.
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
- 1Abra Configurações › API e IntegraçõesSó quem tem papel de Administrador enxerga essa área — a chave dá acesso aos dados do escritório inteiro.
- 2Clique em Nova chaveDê 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.
- 3Marque só o que a integração precisa fazerAs 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.
- 4Copie a chave na horaEla aparece uma única vez. Guarde num lugar seguro (o gerenciador de senhas do escritório, por exemplo) e entregue ao desenvolvedor.
A chave não pode ser recuperada depois. Nós guardamos só uma impressão digital dela — nem o suporte consegue mostrá-la de novo. Se você fechar a janela sem copiar, é só apagar essa chave e criar outra.
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 app.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.
Prefira uma chave por integração, em vez de uma chave usada por tudo. Assim, o dia em que precisar desligar uma delas, você desliga só aquela.
Limite de uso
Cada chave pode fazer até 30 chamadas por minuto e 10 mil por dia (a conta do dia zera à meia-noite). É bastante 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 a sua integração bater no teto, ela recebe um aviso claro pedindo para aguardar alguns segundos — e basta espaçar as chamadas. Precisa de mais que isso? Fale com o suporte: o limite pode ser aumentado na sua chave.
Mandar template com vídeo, imagem ou documento pela API
Se o template tem cabeçalho de imagem, vídeo ou documento e você anexou o arquivo a ele na tela de Templates, esse arquivo vai sozinho quando o seu sistema manda o template pela API. Não é preciso hospedar o arquivo em lugar nenhum nem repetir a mídia a cada chamada — é o mesmo comportamento da conversa e do disparo.
Se você quiser trocar o arquivo a cada envio (um contrato diferente por cliente, por exemplo), continue mandando o cabeçalho na sua chamada: o que você manda tem preferência sobre o arquivo anexado ao template.
Aí não há o que reaproveitar, e o WhatsApp recusa o envio — a mídia do cabeçalho é obrigatória para ele. A solução é abrir o template em Templates, clicar em Anexar mídia e subir o arquivo uma vez.
Preencher campos personalizados por outro sistema
A integração pode preencher os campos que o escritório criou (Área de atuação, Nome da mãe, o que for). O valor passa pela mesma conferência da tela: campo de número só aceita número, campo de data só aceita data, campo de seleção só aceita uma das opções cadastradas. Quando um valor não serve, a resposta diz qual campo e por quê, e nenhum campo daquela chamada é gravado — assim não sobra meia ficha preenchida.
Quase sempre é a forma do texto enviado: cada campo tem de ser um item próprio da lista. Se todos os pares forem escritos dentro de um item só, o padrão do formato faz os repetidos se anularem e só o último sobrevive — e isso acontece antes de a chamada chegar até nós, então não há erro nenhum, só um campo gravado. A conferência é simples: a resposta devolve exatamente o que foi gravado; se você mandou 8 e voltaram menos, é isso.
Ver as chamadas que a sua integração fez
Na aba Chamadas, dentro de API e Integrações, aparece tudo o que a API e o MCP receberam com as chaves deste workspace: o que foi chamado, o que respondeu, quanto demorou e qual chave foi usada. Guardamos os últimos 30 dias.
É o lugar de olhar quando alguém diz que "a integração não está funcionando". Os três números do topo respondem primeiro: quantas chamadas houve, quantas deram erro e o tempo de resposta. Depois, o filtro Só com erro mostra exatamente o que falhou e por quê.
Chamadas com chave inválida ou sem chave não aparecem — sem uma chave válida o sistema não tem como saber de qual escritório elas vieram. Então, quando a integração não aparece de jeito nenhum, o problema quase sempre é a chave: conferir se ela foi copiada inteira e se não foi revogada.
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
A lista completa aparece na própria tela, agrupada por assunto: Mensagens (recebida, enviada, entrega e leitura, e a *primeira* mensagem do contato), Conversas, Atendimentos (aberto, atribuído, transferido, encerrado, mudança de etapa e de prioridade), Contatos, Robôs, Agenda, Documentos, Ligações, Qualidade, Campanhas, Canais — e mais dois grupos que costumam passar despercebidos: Relógio (dispara sozinho quando falta pouco para uma reunião, quando o cliente está esperando há tempo demais ou quando um cartão empaca numa etapa) e Automações (o aviso que as suas próprias regras disparam). O mais útil de todos costuma ser canal desconectado: 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.
Cada aviso vai assinado. Quem recebe deve conferir a assinatura antes de confiar — assim ninguém consegue mandar um aviso falso para o seu sistema fingindo ser o Fluxo Jurídico. O seu programador vai saber o que fazer com isso; está explicado na Documentação.
Quando o endereço que recebe os avisos falha 20 vezes seguidas, o sistema desativa aquele webhook sozinho e manda um aviso no sininho para os administradores do escritório. Isso evita ficar tentando para sempre contra um endereço que não existe mais — o que costuma acontecer quando a empresa troca de sistema ou o site sai do ar. Na tela de Webhooks, ele aparece marcado como desativado pelo sistema, com o motivo e o último erro. Depois que o seu servidor voltar, é só ligar a chavinha de novo: a contagem zera e os próximos eventos seguem normalmente. Uma entrega bem-sucedida a qualquer momento também zera a conta — quem falha de vez em quando e volta nunca é desligado.
Ver se os avisos chegaram
Na aba Entregas, dentro de API e Integrações, aparece cada aviso que saiu daqui: qual evento foi, se chegou, quantas tentativas foram feitas, quanto tempo levou e — quando falhou — o erro que o seu servidor devolveu. Guardamos os últimos 30 dias, igual às Chamadas.
É o lugar de olhar quando o seu sistema "não recebeu". Os três números do topo respondem primeiro: quantos avisos saíram, de quantos desistimos e quanto tempo eles levam. O botão Ver de cada linha mostra o conteúdo exato que enviamos, então dá para comparar com o que chegou do outro lado, em vez de adivinhar.
A fila de envio roda a cada minuto, então é comum um aviso levar cerca de 30 segundos para sair — isso não é atraso nem falha. Quando muitos eventos acontecem ao mesmo tempo, alguns ficam para o ciclo seguinte. Enquanto isso, eles aparecem como na fila, e não como erro: ainda têm tentativas pela frente.
Disparar por fora do Fluxo Jurídico: o que se perde
Se a sua automação (n8n, Make, Zapier) manda a mensagem direto para o WhatsApp, e não pela nossa API, o texto dela não entra no Fluxo Jurídico — e não é possível trazer depois. Quem decide isso é o WhatsApp: ele nos avisa que a mensagem foi enviada, entregue e lida, mas nunca manda o conteúdo de uma mensagem que o próprio escritório enviou por fora. Não é limitação nossa e não tem configuração que resolva. Na prática, o atendente abre a conversa e vê a resposta do cliente sem saber o que foi dito para ele. E se o envio falhar, ninguém fica sabendo. Para marcar pelo menos o rastro, colocamos na conversa uma etiqueta "Mensagem enviada fora do Fluxo Jurídico" com a hora e o resultado (entregue, lida ou falhou). É um remendo: o texto continua não existindo. A solução é mandar pela nossa API. A mensagem passa a ser sua de verdade: aparece na conversa, abre o atendimento, entra nos relatórios e, quando falha, o erro aparece. Essa mesma etiqueta aparece, mais raramente, quando alguém responde pelo celular e o WhatsApp não nos espelha aquela mensagem. Por isso ela não afirma quem enviou — só que a mensagem não passou por aqui.
- 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. No canal conectado por QR Code essa regra não existe — lá dá para enviar texto a qualquer hora.