WhatsApp

Provedores

Provedor	Como funciona	Observação
WuzAPI (padrão)	Conecta o número pelo protocolo do WhatsApp Web, como um aparelho conectado	Não é a API oficial: a Meta pode restringir números usados em automação. Use um número dedicado e volumes moderados
WhatsApp Business Cloud API	API oficial da Meta	Exige número verificado e modelos aprovados para escrever fora da janela de 24 h

Trocar de provedor é uma opção em Configurações → WhatsApp; o resto do sistema é o mesmo.

Conectar pela WuzAPI

Em Configurações → Conectar WhatsApp (ou na aba Bot WhatsApp do admin do site):

1. informe a URL da WuzAPI e o token de administrador dela;
2. clique em Conectar WhatsApp. O bot cria o usuário na WuzAPI, aponta o webhook (com chave na URL e assinatura HMAC) e mostra o QR Code;
3. no celular: WhatsApp → Aparelhos conectados → Conectar um aparelho, e leia o QR. Se não der, use o código de pareamento.

O número é identificado sozinho. Nenhum token da WuzAPI passa pelo navegador.

Janela de 24 h

O WhatsApp só permite mensagem livre até 24 h depois da última mensagem do cliente. O bot respeita isso em tudo (IA, fluxos, follow-up, resposta da equipe), com uma única exceção: o remarketing, abaixo.

Botões

Com Usar botões do WhatsApp ligado no widget "Link do checkout" do fluxo, saem botões de link ("Comprar agora") e de resposta rápida. O texto, com o link, vai sempre junto. Se o WhatsApp recusar os botões, o bot manda o texto com as opções numeradas (o cliente pode responder "1"). O painel mostra exatamente o que saiu.

Ritmo humano

Antes de cada mensagem, o bot marca as mensagens do cliente como lidas e mostra "digitando..." pelo tempo que alguém levaria para escrever aquele texto, além dos intervalos configurados no fluxo. Há um limite de envios por minuto.

Equipe e automação

• Quando alguém da equipe escreve na conversa (celular, WhatsApp Web ou painel), a conversa vai para Atendimento humano e a IA para nela, até alguém reativar (isso pode ser desligado por fluxo).
• O interruptor Automação (em Fluxos) desliga de uma vez a IA e todos os envios automáticos.

Pedido para parar (opt-out)

"Parar", "não quero mais mensagens" e afins tiram o contato de tudo, mandam uma confirmação e bloqueiam qualquer envio automático para sempre. O bloqueio é guardado por uma chave do telefone e continua valendo mesmo se a conversa for excluída. Só a equipe pode desfazer, quando o cliente não pediu para parar.

Remarketing e suas proteções

O gatilho X dias sem comprar escreve para quem ficou em silêncio, inclusive depois das 24 h. Por isso ele tem proteções que não podem ser desligadas:

• só entra quem já escreveu para o bot e não comprou;
• nunca entra quem pediu para parar, quem está com a equipe ou quem está com Atenção;
• só quem não está em outro fluxo;
• uma vez por pessoa, para sempre;
• só dentro da faixa de horário (Brasília) e até o limite por dia do fluxo;
• a condição é conferida de novo na hora de enviar (a pessoa pode ter escrito ou comprado);
• a 1ª mensagem sempre termina com "Se não quiser mais receber mensagens, é só responder PARAR.";
• se a pessoa comprar no meio do caminho, nada mais sai.

Comece com um limite baixo (5 a 10 por dia) e acompanhe as respostas. Com Quem recebe: só leads que vieram de anúncio, o remarketing vira o resgate dos leads do anúncio (os mais recentes primeiro), inclusive dos trazidos por Importar conversas. Um lead importado que nunca escreveu nada não entra (a regra de já ter escrito continua).