WhatsApp não-oficial (Z-API) e grupos
Como conectar um número pela Z-API para ter grupos, reações, menções e apagar mensagens — sem janela de 24h nem template.
Além do WhatsApp oficial (Cloud API), o Fluxo Jurídico permite conectar um número pela Z-API — uma forma não-oficial de ligar o WhatsApp, lendo um QR Code como no WhatsApp Web. Ela desbloqueia recursos que a versão oficial não tem: grupos, reações, menções e apagar mensagem.
Por ser não-oficial, existe risco de o número ser banido pelo WhatsApp em caso de uso abusivo. Use com moderação — o ideal é um número dedicado só para a Z-API, separado do número oficial.
A Z-API é um serviço contratado por você, à parte. Quando a assinatura da instância vence, ela recusa todos os envios e continua recebendo normalmente — e é isso que engana: o canal segue aparecendo como conectado, as mensagens dos clientes continuam entrando, o funil continua andando, mas ninguém consegue responder, nem os atendentes nem os robôs. Quando isso acontece, o Fluxo Jurídico avisa no sininho. Renove a assinatura no site da Z-API e o envio volta sozinho — não é preciso ler o QR Code de novo.
Como conectar
- 1Abra Configurações → CanaisClique em Adicionar canal e escolha Z-API (WhatsApp não-oficial).
- 2Crie a conta na Z-API, se ainda não tiverA Z-API é um serviço à parte, contratado por você. Pelo link que aparece na janela de conexão, você cria a conta com 10% de desconto.
- 3Informe as credenciais da instânciaCole o Instance ID, o Token e o Client-Token da sua conta Z-API.
- 4Leia o QR CodeNo celular: WhatsApp → Aparelhos conectados → Conectar um aparelho, e aponte para o QR da tela. As conversas começam a chegar no inbox.
O que muda em relação ao oficial
- Sem janela de 24h e sem template: envia texto livre a qualquer hora.
- Grupos: as conversas de grupo aparecem no inbox (o oficial não tem).
- Reações, responder e menções funcionam como no WhatsApp normal.
- Apagar mensagem pelo próprio inbox (some no WhatsApp e fica riscada aqui).
Contatos que chegam sem telefone
O WhatsApp permite que a pessoa esconda o próprio número. Quando alguém assim escreve para você — é comum em quem vem de anúncio —, a conversa entra normalmente, com nome e foto, mas o campo de telefone do cadastro fica vazio. Você responde por ali sem diferença nenhuma, e o robô também.
No card do contato, esse caso aparece com o selo Número protegido ao lado do telefone. Ele existe para você não perder tempo procurando um cadastro incompleto: não está faltando preencher, o número não chega até nós. O campo continua livre para digitar — se você vir o número pelo WhatsApp e quiser anotar, é só preencher.
- O número aparece sozinho no cadastro se, mais tarde, a pessoa escrever com ele exposto — e a conversa continua sendo a mesma, sem virar um contato novo.
- Enquanto o telefone não aparece, esse contato não entra em disparo pelo canal oficial e sai sem telefone na exportação.
- É limitação de privacidade do WhatsApp, não do Fluxo Jurídico: não existe como descobrir o número de quem escolheu escondê-lo.
Grupos no inbox
Os grupos aparecem na aba Grupos do inbox. Cada mensagem mostra quem do grupo enviou (pelo nome). O robô não atende grupos — eles são só para a equipe acompanhar e responder.
Se não quiser receber grupos, ligue Ignorar grupos nas configurações do canal Z-API — só as conversas privadas entram no inbox.
Se o número cair (desconectou)
Por ser uma conexão como a do WhatsApp Web, o número pode cair — celular sem internet por muito tempo, aparelho desconectado na lista do WhatsApp, troca de celular. Quando isso acontece, o canal fica marcado como desconectado na tela de Canais e para de receber mensagens.
A queda é percebida sozinha: assim que o número cai, o canal muda para desconectado na tela de Canais e o aviso Canal desconectado é disparado para quem escolheu recebê-lo. Não é preciso abrir Verificar status de tempos em tempos — esse botão continua ali para quando você quiser conferir na hora.
- 1Abra Configurações → CanaisClique em Conf. no canal Z-API que caiu.
- 2Clique em Reconectar (QR Code)Um QR Code novo aparece na hora — não precisa entrar no site da Z-API.
- 3Leia com o celular do númeroWhatsApp → Aparelhos conectados → Conectar um aparelho. A tela avisa sozinha quando conectar.
Reconectar não cria um canal novo: é o mesmo canal, com as mesmas credenciais. Todo o histórico, os atendimentos abertos e a fila continuam como estavam.
Gerenciar o canal (botão Conf.)
- Verificar status: confere na hora se a instância Z-API ainda está conectada.
- Reconectar (QR Code): gera um QR novo para religar o número quando ele cai.
- Ligações Z-API: escolhe se este número recebe ligações e qual mensagem é enviada quando uma chamada é recusada.
- Grupos: ligados / desligados: liga ou ignora as mensagens de grupo neste canal.
- Atualizar IDs e token: reinsira o Instance ID, o Token e o Client-Token — útil se você trocar de conta na Z-API. O canal não é recriado, então as conversas e os tickets continuam vinculados.
- A Z-API não tem os Analytics da Meta, nem templates nem token da Cloud API — por isso esses botões não aparecem neste canal.
Ligações pelo mesmo número
Se o seu plano na Z-API incluir ligações, o mesmo número que troca mensagens também recebe e faz chamadas dentro do Fluxo Jurídico — sem contratar nada à parte e sem parear um segundo aparelho. O ícone de telefone aparece sozinho no topo da conversa quando o recurso está ativo; se o plano não tiver ligações, ele simplesmente não aparece.
A ligação entra no mesmo chat das mensagens e fica registrada na tela Ligações, com direção, duração e quem atendeu. O funcionamento do telefone na tela é o mesmo dos outros canais — veja Atender e fazer ligações.
A Z-API tem uma opção de recusar todas as chamadas automaticamente. Com ela ligada, o cliente liga, a chamada é recusada na hora e ninguém no sistema é avisado — não aparece erro nenhum, simplesmente não toca. Pior: a Z-API não permite consultar esse ajuste, só defini-lo. Se as ligações não estiverem tocando, abra Conf. → Ligações Z-API e salve uma vez com Receber ligações ligado: é a única forma de ter certeza de como está.
Evite ligar o mesmo número no canal oficial e na Z-API ao mesmo tempo: isso cria conversas duplicadas (uma em cada canal). Um alerta aparece na tela de Canais quando isso acontece.
Se o número cair, as mensagens desse período não voltam
O WhatsApp não-oficial pode cair sozinho — a sessão expira, a internet do celular oscila, o aparelho desliga. Enquanto ele está fora do ar, quem escreve para você recebe normalmente no celular do escritório, mas essas mensagens não entram no Fluxo Jurídico, nem naquele momento nem depois que o número volta.
Isso não é uma falha do Fluxo Jurídico, e não tem conserto: a Z-API não guarda as mensagens que passaram enquanto o número estava desconectado — ela apenas repassa o que chega ao vivo. O que não passou por ela não existe para ela, e não há de onde buscar depois.
1. Assim que o número cai, chega um aviso no sininho e no celular dizendo que ele parou de enviar e receber. 2. Quando volta, chega um segundo aviso. 3. Nesse momento o sistema confere o aparelho e diz onde ficou o buraco: as conversas que receberam mensagem durante a queda ganham um recado dentro delas, e quem escreveu pela primeira vez (e por isso não virou conversa aqui) aparece num aviso com o número, para você responder pelo celular.
As mensagens que você mandar pelo sistema enquanto o número está fora do ar não falham: elas ficam numa fila da Z-API e são disparadas todas juntas no instante em que ele reconecta. Uma pergunta escrita às 17h pode chegar ao cliente às 23h. Se a queda for longa, vale reabrir as conversas e conferir o que ainda faz sentido — ou, no painel da Z-API, ligar a opção Desabilitar enfileiramento quando WhatsApp estiver desconectado, que faz o envio falhar na hora em vez de guardar.