WhatsApp API Oficial (Meta WABA)
Caminho no sistema:
Configurações›Cadastros›Canais›WhatsApp API Oficial
A WhatsApp Cloud API (API Oficial da Meta) é a solução corporativa homologada para atendimento em grande escala. Oferece alta estabilidade, suporte a botões clicáveis, listas, modelos pré-aprovados (templates), carrosséis e conformidade total com os termos da Meta, eliminando riscos de banimento por infraestrutura.
🔀 Métodos de Conexão Disponíveis
No Galaxy Chat você pode conectar a API Oficial através de três caminhos:
- Hub MultiAPIWA (Conexão Integrada em Poucos Cliques): Conexão direta dentro do Galaxy Chat com login do Facebook. Não exige tokens manuais, criação de aplicativos ou configuração de webhook.
- Conexão Direta com a Meta (App Próprio no Meta Developers): Para empresas com desenvolvedores próprios que desejam gerenciar seu próprio aplicativo na Meta Cloud API.
- Hub NotificaMe / ConnectionHub: Para operações que utilizam serviços de mensageria parceiros.
🚀 Método 1: Hub MultiAPIWA (Conexão Integrada Rápida)
O Hub MultiAPIWA é o método mais ágil para colocar a API Oficial em funcionamento sem complexidade técnica.
Acesse a Área de Canais
Vá em Configurações › Cadastros › Canais e clique em + Adicionar Canal.
Escolha WhatsApp Oficial (Hub)
Selecione a opção de conexão integrada oficial.
Clique em 'Conectar WABA'
Uma janela oficial da Meta (Facebook) será aberta na tela.
Autorize a Conexão no Facebook
Faça login com a conta do Facebook vinculada ao seu WhatsApp Business, selecione a empresa e confirme o número de telefone.
Pronto!
O canal será ativado automaticamente no Galaxy Chat, sem necessidade de copiar tokens ou configurar webhooks.
🛠️ Método 2: Conexão Direta com a Meta (WABA Própria)
Para conectar diretamente via aplicativo próprio no portal da Meta:
Acesse o Meta for Developers
Entre em developers.facebook.com com sua conta comercial do Facebook e clique em Meus Apps › Criar Aplicativo (tipo: Empresa).
Adicione o Produto WhatsApp
No painel do aplicativo, localize o produto WhatsApp e clique em Configurar. Vincule o aplicativo ao seu Portfólio Empresarial (Business Manager).
Adicione e Valide o Número de Telefone
Na seção Configuração da API, clique em Adicionar Número de Telefone, insira o número desejado e conclua a validação via SMS ou ligação.
Gere o Token Permanente
Gere um Token Permanente via Usuário do Sistema com as permissões whatsapp_business_messaging e whatsapp_business_management.
Configure o Webhook
Copie a URL de Callback e o Token de Verificação gerados no Galaxy Chat e cole no painel da Meta em Configuração da API › Webhooks. Marque a inscrição no campo principal messages.
Defina o PIN de 6 Dígitos
No Galaxy Chat, informe o PIN numérico de segurança do número para concluir o registro.
💰 Como Reduzir os Custos da API Oficial
Na API Oficial da Meta, as mensagens enviadas podem gerar cobranças conforme as regras vigentes da plataforma. O Galaxy Chat inclui ferramentas nativas para economizar mensagens sem perder clientes:
1. Concatenador de Mensagens
Quando o atendente humano envia frases curtas consecutivas (ex.: "Olá!", "Tudo bem?", "Como posso ajudar?"), sem o concatenador isso geraria 3 mensagens cobradas separadamente pela Meta.
- Com o Concatenador Ativo: O Galaxy Chat aguarda alguns segundos configuráveis (de 2 a 15s) e agrupa todas as frases em uma única mensagem antes de despachar para o WhatsApp.
- Modo Simples: Junta os textos mantendo exatamente o que foi digitado.
- Modo com IA: Utiliza Inteligência Artificial para reescrever as frases soltas em uma mensagem fluida e profissional.
2. Chat Externo por Link (Modo Alternativo)
Permite enviar ao cliente um link para continuar a conversa em uma página web segura idêntica ao WhatsApp:
- O cliente clica no botão "Abrir Chat" no WhatsApp e conversa livremente pelo navegador.
- Toda a conversa segue sem cobrança de mensagens adicionais da Meta.
- Para segurança, pode-se exigir que o cliente informe os 4 últimos dígitos do telefone para entrar.
- O atendente continua respondendo normalmente dentro do painel do Galaxy Chat.
3. Franquia Mensal Grátis da Meta (1.000 Mensagens/Mês)
A Meta concede por padrão uma franquia de 1.000 mensagens de serviço gratuitas por mês para cada número conectado.
- O Galaxy Chat exibe uma barra de progresso em tempo real no cartão do canal e no relatório financeiro, mostrando exatamente quantas mensagens gratuitas ainda restam antes do ciclo renovar.
🔀 Modo Coexistência (COEX)
O Modo Coexistência (COEX) permite que você mantenha o aplicativo do WhatsApp Business ativo no seu smartphone físico ao mesmo tempo em que o número está conectado à API Oficial no Galaxy Chat.
⚠️ Regras e Limitações do COEX
- Limite de Envio: Na Coexistência, a Meta estabelece um limite de 20 mensagens por segundo (20 mps) para evitar conflitos entre o celular e a nuvem.
- Mensagens de Grupos: Ficam acessíveis no smartphone, mas a API Oficial da Meta não processa automações de grupos.
🆘 Problemas de Conexão no COEX?
Se as mensagens pararem de chegar no COEX, nunca apague o canal no Galaxy Chat, pois isso apagará o histórico de conversas e tickets vinculados.
O procedimento correto de reconexão é:
- Abra o app do WhatsApp Business no celular;
- Vá em Configurações › Conta › Plataforma do WhatsApp Business;
- Localize a integração e clique em Desconectar;
- Em seguida, reconecte o canal no Galaxy Chat normalmente.
❓ FAQ da API Oficial do WhatsApp
Preciso ter uma empresa verificada na Meta?
Para volumes básicos de teste não é obrigatório, mas para aumentar os limites diários de envio de mensagens e garantir a estabilidade máxima da conta comercial, a Meta exige a verificação dos documentos da empresa no Business Manager.
Posso enviar campanhas com a API Oficial?
Sim! As campanhas na API Oficial utilizam Templates Pré-Aprovados, que garantem a maior taxa de entrega do mercado sem risco de bloqueio do chip.
O que significa a mensagem com 'X' vermelho?
Quando uma mensagem enviada na API Oficial ganha um indicador vermelho, significa que ela foi rejeitada pela Meta (por exemplo, envio fora da janela de 24 horas sem template, formato de mídia inválido ou falta de saldo na conta de anúncios da Meta).