WhatsApp API Não Oficial (QR Code)
Caminho no sistema:
Configurações›Cadastros›Canais›WhatsApp QR Code
As conexões não oficiais conectam seu WhatsApp ao Galaxy Chat por meio da leitura de um QR Code, sem cobrança por mensagens enviadas. São a forma mais rápida de iniciar operações de atendimento.
É altamente recomendado utilizar contas do WhatsApp Business para conexão. Contas comuns do WhatsApp pessoal possuem restrições maiores da plataforma e podem apresentar desconexões ou instabilidades.
📊 Comparativo das Opções Não Oficiais
| Opção | Tecnologia | Vantagens | Quando Escolher |
|---|---|---|---|
| WuzAPI (WhatsMeow) | Golang nativo | Conexão ultra-leve, consumo mínimo de memória, rápida e altamente estável. | Recomendada para começar. Ideal para a maioria das empresas. |
| WhatsApp API PLUS | Engine Premium | Suporte a botões interativos, menus de lista, solicitação de localização e Proxy Regional por Cidade. | Para quem precisa de menus interativos sem o custo da API Oficial. |
| Baileys (Legado) | Node.js | Biblioteca antiga. | Descontinuada. Não recomendada para novas instalações. |
⚡ Conectando via WuzAPI (Passo a Passo)
Acesse os Canais
Vá em Configurações › Cadastros › Canais e clique em + Adicionar Canal.
Selecione WhatsApp (WuzAPI)
Escolha o tipo de conexão WuzAPI / WhatsMeow.
Defina Nome e Fila
Informe o nome identificador do canal e a fila de entrada dos atendimentos.
Gere e Escaneie o QR Code
Abra o WhatsApp no smartphone, acesse Aparelhos Conectados › Conectar um Aparelho e aponte a câmera para o QR Code gerado no painel.
Confirme a Conexão
Em poucos segundos o status será atualizado para CONECTADO.
⭐ Recursos Especiais da WhatsApp API PLUS
A API PLUS oferece recursos interativos e estabilidade reforçada:
- Botões Interativos: O cliente clica para escolher a opção desejada no chat.
- Listas de Menu: Menus suspensos elegantes para seleção de departamentos ou produtos.
- Botão 'Copiar e Colar': Facilita a cópia de códigos Pix e códigos de barras.
- Solicitação de Localização: Permite que o cliente compartilhe sua localização GPS com um toque.
🌍 Proxy Regional (Cidade)
O Proxy Regional permite definir a cidade mais próxima de onde o aparelho físico do WhatsApp opera. Isso faz com que a Meta identifique a conexão com endereço de IP e geolocalização compatíveis com a região real do chip, reduzindo drasticamente riscos de desconexões ou suspeitas de acesso estranho:
- Aparelho no interior do Paraná → configurar Proxy para Curitiba;
- Aparelho no interior de Santa Catarina → configurar Proxy para Florianópolis;
- Aparelho no interior de São Paulo → configurar Proxy para São Paulo.
🔄 Migração entre APIs Não Oficiais (Sem Perda de Dados)
Você pode alternar entre a WuzAPI e a API PLUS a qualquer momento sem perder o histórico de conversas:
- No painel de Canais, clique em Desconectar no WhatsApp atual;
- Edite o canal e altere o tipo para a nova API desejada;
- Salve e clique em Gerar QR Code;
- Leia o novo código com o WhatsApp no celular;
- Todas as conversas, filas e etiquetas permanecem intactas no banco de dados.
🛠️ Diagnóstico e Solução de Problemas
1. O QR Code não aparece ou a sessão fica em "Conectando"
- Desconecte de outros lugares: O WhatsApp não permite o mesmo chip conectado simultaneamente em múltiplos sistemas de automação ou várias abas antigas do WhatsApp Web. Desconecte sessões antigas no app do celular.
- Rede e Firewall do Servidor: Verifique se as portas internas do container estão liberadas e se o serviço WuzAPI está ativo.
2. Mensagem com indicador de falha ("X" ou não enviada)
- Verifique se o chip no celular possui conexão ativa com a internet e se não sofreu restrições temporárias da operadora ou do WhatsApp.
- Em Canais, confira o status da conexão do número.
👣 Próximos Passos
- Conectou o canal? Configure as Filas de Atendimento
- Crie a sua equipe: Cadastro de Usuários e Permissões
- Automatize o início: Mensagens Automáticas