WhatsApp

O WhatsApp é o canal mais popular do Adonix Omnichannel. Você pode conectar de duas formas:

• WhatsApp Cloud API (Meta) — solução oficial para empresas com conta Business verificada.
• WhatsApp via WAHA — sessão própria conectada via QR Code (similar ao WhatsApp Web).

Cada uma tem casos de uso, custos e limitações diferentes. Escolha de acordo com o seu cenário.

Comparativo

Aspecto	Cloud API (Meta)	WAHA
Como conecta	Token + número verificado no Meta Business	QR Code escaneado pelo seu celular
Custo	Por mensagem fora da janela 24h (cobrança Meta)	Gratuito (sem cobrança Meta)
Templates fora de 24h	Obrigatório	Não tem janela 24h
Estabilidade	Alta (infra Meta)	Boa, mas depende do celular online
Editar mensagem enviada	❌ Não suportado pela Meta	✅ Sim
Deletar mensagem para todos	❌ Não suportado pela Meta	✅ Sim
Grupos do WhatsApp	❌ Não suportado	✅ Sim — veja Grupos WhatsApp
Mídia (foto, vídeo, áudio, doc)	✅ Sim	✅ Sim
Reactions	✅ Sim	✅ Sim
Reply / Quote	✅ Sim	✅ Sim
Templates aprovados pela Meta	✅ Sim	❌ N/A
Lista interativa (List Message)	✅ Sim	✅ Sim
Botões interativos	✅ Sim	✅ Sim
Ideal para	Operação em escala, marketing por template	Atendimento humano, grupos, números pessoais

WhatsApp Pessoal via QR direto não é mais suportado A opção antiga de "WhatsApp Pessoal" via QR direto na plataforma (whatsapp_personal) foi removida na v2.20. Agora a conexão por QR é feita através do WAHA — fluxo idêntico para o usuário, mas com infra dedicada e mais estável.

Quem pode criar canais WhatsApp

A criação de canais respeita os limites por plano do workspace:

Plano	Cloud API	WAHA
Starter	✅	✅
Growth	✅	✅
Enterprise	✅	✅

Cada plano tem um limite total de canais ativos. Quando estoura, o sistema rejeita a criação com mensagem clara em português ("Você atingiu o limite de X canais ativos no plano Y"). Veja Planos e Recursos para os limites exatos.

Conectar via Cloud API (Meta)

A Cloud API é a forma oficial da Meta para integração WhatsApp com sistemas externos. Recomendada para operações em escala.

Pré-requisitos

• Conta no Meta Business Manager (business.facebook.com).
• Número de telefone verificado no Meta (não pode estar em uso no app comum do WhatsApp).
• Templates de mensagem aprovados (necessários para mensagens fora da janela de 24h).
• Webhook de mensagens configurado no Meta apontando para o backend do Adonix.

Passo a passo

1. Acesse Canais na barra lateral.
2. Clique em Novo canal.
3. Selecione WhatsApp Cloud API.
4. Preencha:
   • Nome do canal (ex: "WhatsApp Vendas")
   • Phone Number ID (encontrado no Meta Business → WhatsApp → Visão geral)
   • Access Token (gerado em Configurações de sistema do Meta Business)
   • WABA ID (ID da WhatsApp Business Account)
   • App Secret (das configurações do app no Meta)
5. Clique em Conectar.
6. O sistema valida o token e exibe status Conectado.
7. Atribua o canal a uma fila de atendimento.

Janela de 24h e Templates Cloud API segue a regra da Meta: você só pode mandar texto livre dentro de 24h após o cliente te mandar mensagem. Fora dessa janela, é obrigatório usar templates pré-aprovados. Os templates aparecem automaticamente no compositor do Adonix quando aplicável.

Conectar via WAHA (QR Code)

WAHA é uma instância dedicada que abre uma sessão WhatsApp própria — equivalente a um WhatsApp Web "permanente" rodando para o seu workspace.

Pré-requisitos

• Um número de WhatsApp (pessoal ou Business) com WhatsApp instalado em um celular.
• Esse número não pode estar conectado a outra solução de automação ao mesmo tempo.

Passo a passo

1. Acesse Canais na barra lateral.
2. Clique em Novo canal.
3. Selecione WhatsApp (segunda opção, com QR Code).
4. Preencha:
   • Nome do canal — vem como WhatsApp (Nome do Workspace) mas você pode editar.
5. Clique em Criar. O sistema cria a sessão e exibe um QR Code.
6. No celular:
   • Abra o WhatsApp.
   • Toque em Configurações (ou Mais opções) → Aparelhos conectados → Conectar um aparelho.
   • Escaneie o QR Code que está na tela do Adonix.
7. O QR some quando a conexão é estabelecida.
8. Atribua o canal a uma fila de atendimento.

O QR expira O QR fica disponível por cerca de 60 segundos. Se expirar, recarregue a página do canal — um QR novo é gerado.

Manter a conexão estável

• O celular precisa ficar online (Wi-Fi ou dados móveis). Se ficar muito tempo offline, o WhatsApp desconecta a sessão.
• Não force-close o WhatsApp no celular — pode invalidar a sessão.
• Se desconectar, abra o canal no Adonix e clique em Reconectar → escaneie o QR novamente.

Grupos

Para ativar suporte a grupos no canal WAHA, veja Grupos WhatsApp.

Verificar status da conexão

1. Vá em Canais na barra lateral.
2. Cada canal mostra um indicador:
   • 🟢 Conectado — funcionando.
   • 🟡 Reconectando — sistema tenta restaurar.
   • 🔴 Desconectado — sessão caiu, precisa intervir (re-escanear QR no WAHA, validar token na Cloud API).

Reconectar um canal

WAHA

1. Abra o canal desconectado em Canais.
2. Clique em Reconectar.
3. Um QR novo é gerado.
4. Escaneie pelo celular.

Cloud API

1. Abra o canal em Canais.
2. Clique em Reconectar / Editar credenciais.
3. Atualize o Access Token (geralmente o problema é token expirado).
4. Salve.

Templates do WhatsApp (Cloud API)

Templates são mensagens pré-aprovadas pela Meta usadas fora da janela de 24h.

1. Em Canais, clique no canal Cloud API.
2. Vá na aba Templates.
3. A lista é sincronizada automaticamente do Meta Business Manager.
4. Para criar template novo, use o Meta Business Manager — o Adonix sincroniza em alguns minutos.

Templates podem ter:

• Texto fixo ou com variáveis (ex: {{1}} para nome).
• Botões (call-to-action ou resposta rápida).
• Mídia (imagem, vídeo, documento).

Quais templates ter Sugestão de templates essenciais: boas-vindas / follow-up / confirmação de pedido / pesquisa de satisfação / lembrete de pagamento. Assim você cobre 80% dos casos de uso.

Anexos e mídia

Os dois canais (Cloud API e WAHA) suportam:

• Imagem (JPG, PNG, WebP) — até 5MB.
• Vídeo (MP4) — até 16MB.
• Áudio — .mp3, .m4a, .ogg. Para iPhone receber corretamente, o Adonix transcoda para Opus 48kHz mono automaticamente.
• Documento (PDF, DOC, XLS) — até 100MB. Filename é preservado (cliente recebe com nome real, não "document.pdf").
• Stickers — só recebimento; o sistema não envia stickers.

Limitações por tipo de conexão (resumo)

Funcionalidade	Cloud API	WAHA
Editar mensagem	❌	✅
Deletar para todos	❌	✅
Grupos	❌	✅
Templates Meta	✅ obrigatórios fora 24h	❌ não usa
Reações	✅	✅
Reply	✅	✅
Forward	✅	✅
Botões interativos	✅	✅
Lista interativa	✅	✅
Localização	✅	✅
Chamadas (voz/vídeo)	✅	❌ depende da versão WhatsApp

Próximos passos

• Ative grupos: Grupos WhatsApp
• Configure mensagens automáticas: Automações (Flows)
• Veja seus limites: Planos e Recursos