WhatsApp via Z-API

Mande mensagens de WhatsApp do app sem precisar aprovar templates na Meta.

Pré-requisito

Conta Z-API (gateway brasileiro). Em app.z-api.io:

1. Crie uma instância e conecte um celular via QR Code.
2. Anote o Instance ID e o Token (tela da instância).
3. Vá em Settings > Account Security e copie o Client-Token.

⚠️ OS 3 VALORES SÃO OBRIGATÓRIOS. Sem o Client-Token, a Z-API retorna o erro "your client-token is not configured" — mesmo que o Instance ID e Token estejam corretos. Esse campo foi adicionado pela Z-API em 2024 e é obrigatório em todas as contas novas.

Configurar no app

1. Abra o app na plataforma.
2. Menu → Integrações → WhatsApp (Z-API) → Configurar.
3. Preencha os 3 campos.
4. Salvar.

Usar no código (gerado pela IA)

Numero sempre com DDI + DDD + número (sem +, sem espaços, sem traços). Ex: 5511999999999 = +55 (11) 99999-9999.

Inbound (receber mensagens)

A Z-API permite configurar webhooks pra notificar quando uma mensagem chega. Configure o webhook apontando pra:

Mensagens recebidas viram eventos em 'Bea.inbound.list()' ou via subscribe. Veja Webhooks de entrada.

Problemas comuns

"your client-token is not configured" Falta o Client-Token. Vai em Settings > Account Security no painel Z-API, copia, cola no campo correspondente da integração.

"instance not connected" O celular foi desconectado. Reconecte via QR Code no painel Z-API.

Mensagem nao chega Numero pode estar errado. Use 'Bea.whatsapp.status()' pra confirmar que a instancia esta conectada.