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.
Criar um grupo pelo sistema
No inbox, o botão + (no topo da lista de conversas) abre duas opções: Nova conversa e Novo grupo. Em Novo grupo você dá o nome, escolhe as pessoas entre os seus contatos — ou digita um número com DDD — e escolhe por qual canal o grupo será criado. Só aparecem canais conectados por QR Code: o WhatsApp oficial da Meta não permite criar grupos.
- Quem pode criar: administradores e supervisores. Atendente participa do grupo normalmente, mas não cria.
- O nome tem limite de 25 caracteres — é o limite do próprio WhatsApp, não do sistema.
- O grupo já aparece no inbox assim que é criado, pronto para a primeira mensagem.
- Você entra como administrador do grupo, então dá para renomear, adicionar e remover gente pelo painel do grupo depois.
O WhatsApp deixa cada pessoa escolher quem pode colocá-la em grupos. Quem tiver essa restrição não entra direto: o grupo é criado sem ela. Quando isso acontece, o sistema mostra quem ficou de fora e entrega o link de convite para copiar — basta mandar o link para a pessoa e ela entra sozinha. Também ficam de fora contatos de quem o sistema só tem o identificador de privacidade do WhatsApp, sem o número (esses aparecem marcados na lista, antes de você criar).
Criar vários grupos em pouco tempo por um número conectado por QR Code faz o WhatsApp restringir o número — e a restrição atinge as mensagens do escritório inteiro, não só os grupos. Por isso o sistema permite até 5 grupos por hora e avisa quando o ritmo passa disso.
Administrar o grupo pelo painel
Com o grupo aberto no inbox, o painel da direita traz duas abas: Geral e Membros. Tudo o que dá para fazer ali exige duas coisas ao mesmo tempo: que o número conectado seja administrador do grupo (o painel avisa quando não é) e que você seja administrador ou supervisor do escritório. Atendente enxerga o grupo, os membros e o link, mas não altera.
- Nome e descrição — edite e salve na aba Geral.
- Foto do grupo — clique no ícone de câmera sobre a imagem e escolha um arquivo JPG, PNG ou WEBP. O sistema reduz a imagem automaticamente antes de enviar, então não precisa se preocupar com o tamanho.
- Adicionar participante — na aba Membros, digite o número com DDD.
- Promover, rebaixar ou remover alguém — veja abaixo.
Ações em um membro
Na aba Membros, cada pessoa tem um botão ⋮ ao lado do nome — e, no computador, você também pode clicar com o botão direito sobre a linha. Os dois abrem o mesmo menu: copiar o número, promover a administrador (ou remover a administração) e remover do grupo. Remover pede confirmação, porque a pessoa sai na hora.
O Dono do grupo não pode ser removido nem rebaixado — é regra do próprio WhatsApp. E o número do escritório também não aparece com essas opções: remover a si mesmo seria sair do grupo, o que ainda não é feito por aqui.
Link de convite
Na aba Geral existe o link de convite do grupo, com botão de copiar. Quem receber esse link entra sozinho, sem precisar ser adicionado — é a saída para quem tem a privacidade do WhatsApp restrita. Se o link nunca foi buscado, clique em Buscar link de convite e ele fica guardado.
Sair do grupo
No fim da aba Geral existe Sair do grupo. O número do escritório sai, deixa de receber as mensagens dali, e para voltar alguém de dentro precisa adicioná-lo de novo. O histórico não se perde: as conversas continuam guardadas e consultáveis no sistema, e o painel passa a mostrar uma faixa dizendo quando a saída aconteceu.
No WhatsApp não existe "apagar grupo": o grupo deixa de existir quando o último participante sai. Por isso, quando o escritório é o único que restou, o botão muda para Sair e excluir o grupo e a confirmação avisa disso. Não há como recriar o grupo depois com o mesmo link — quem tinha o link antigo não entra em lugar nenhum.
O botão Gerar novo link cria um link novo e derruba o antigo na hora. Quem tiver recebido o link velho — inclusive em mensagens antigas ou publicações — não consegue mais entrar por ele. Use quando o link tiver vazado para quem não deveria; para o uso normal, basta copiar o que já existe.
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.