Integrações
Integrando no WhatsApp via Evolution QR
Guia completo para conectar seu agente ao WhatsApp utilizando a Evolution API com QR Code, incluindo recursos avançados de proteção contra banimento
Integrando o Super Agentes ao WhatsApp via Evolution API QR Code
Este guia explica como conectar seu agente do Super Agentes ao WhatsApp utilizando a Evolution API com QR Code, permitindo uma integração rápida e simples sem necessidade de configurações complexas.A Evolution API QR Code é uma alternativa não oficial para integração com WhatsApp. Embora inclua recursos avançados de proteção, ainda existe um risco reduzido de que números conectados possam ser banidos pelo WhatsApp. Use por sua conta e risco.
Visão Geral
A integração via Evolution API QR Code é uma solução avançada que permite conectar seu agente do Super Agentes ao WhatsApp de forma direta, sem necessidade de aprovação da Meta ou processo de verificação de negócio. Esta opção utiliza tecnologias de proteção contra banimento e balanceamento de carga para garantir maior estabilidade da conexão.Recursos Exclusivos
A integração via Evolution API QR Code oferece recursos avançados que não estão disponíveis em outras opções:- Proxy Rotativo: Utiliza um sistema de proxy rotativo para reduzir o risco de banimento do WhatsApp
- Balanceamento de Hosts: Distribui as conexões entre múltiplos servidores para garantir estabilidade
- Verificação de Conexão em Tempo Real: Monitora constantemente o status da conexão
- Reconexão Automática: Facilita a reconexão em caso de desconexão
Pré-requisitos
- Uma conta no Super Agentes com plano pago (a funcionalidade não está disponível no plano gratuito)
- Um agente configurado no Super Agentes
- Um número de WhatsApp para conectar ao seu agente (recomendamos usar um número dedicado)
Conectando seu Agente ao WhatsApp
Passo 1: Acessar a Configuração de WhatsApp no Super Agentes
- Acesse seu agente no Super Agentes
- Vá para a aba Ambientes
- Clique em WhatsApp
- Clique em Adicionar Conta
Passo 2: Selecionar a Evolution API QR Code
- No modal de conexão, selecione Evolution QR na lista de opções
- Clique em Gerar QR Code
- O sistema irá criar uma instância dedicada para seu agente em um dos servidores disponíveis
Passo 3: Escanear o QR Code
- Um QR Code será exibido na tela
- Abra o WhatsApp no seu celular
- Vá em Configurações > Dispositivos Conectados > Conectar um Dispositivo
- Escaneie o QR Code exibido na tela do Super Agentes
- Aguarde a confirmação da conexão
- O sistema verificará automaticamente se a conexão foi estabelecida
Passo 4: Finalizar a Configuração
- Após a confirmação da conexão, a tela fechará automaticamente.
- Pronto! Seu agente agora está conectado ao WhatsApp
Verificando o Status da Conexão
Após a conexão, você pode verificar o status a qualquer momento:- Acesse seu agente no Super Agentes
- Vá para a aba Ambientes > WhatsApp
- Ao lado do nome da conexão, você verá um indicador de status:
- Conectado (verde): A conexão está ativa e funcionando
- Desconectado (vermelho): A conexão foi perdida
- Verificando… (cinza): O sistema está verificando o status da conexão
Como Funciona a Proteção Contra Banimento
A integração via Evolution API QR Code utiliza várias camadas de proteção para minimizar o risco de banimento:Proxy Rotativo
Cada conexão é estabelecida através de um proxy rotativo (webshare.io) que alterna automaticamente entre diferentes IPs, dificultando a detecção por parte do WhatsApp. Isso reduz significativamente o risco de banimento por uso de APIs não oficiais.Balanceamento de Hosts
O Super Agentes distribui as conexões entre múltiplos servidores Evolution API, garantindo que:- Nenhum servidor fique sobrecarregado (máximo de 200 conexões por servidor)
- Se um servidor apresentar problemas, os outros continuam funcionando
- Novas instâncias de servidor são criadas automaticamente quando necessário
Reconectando em Caso de Desconexão
Se a conexão com o WhatsApp for perdida:- Vá para a aba Ambientes > WhatsApp
- Verifique o status da conexão (deve estar como “Desconectado”)
- Clique no ícone de deletar (lixeira)
- Crie uma nova conexão
- Um novo QR Code será gerado
- Escaneie o QR Code com seu WhatsApp
- Aguarde a confirmação da nova conexão
Solução de Problemas
QR Code Expirado
Se o QR Code expirar antes de você conseguir escaneá-lo:- Feche o modal de conexão
- Inicie o processo novamente clicando em Adicionar Conta
- Selecione Evolution QR e gere um novo QR Code
Conexão Instável
Se você notar que a conexão cai frequentemente:- Verifique se o número de WhatsApp está sendo usado em outros dispositivos
- Certifique-se de que o celular com o WhatsApp tenha uma conexão estável com a internet
- Tente reconectar seguindo as instruções acima
Erro ao Gerar QR Code
Se ocorrer um erro ao gerar o QR Code:- Aguarde alguns minutos e tente novamente
- Verifique se você está usando um plano pago do Super Agentes
- Se o problema persistir, entre em contato com o suporte
Limitações e Considerações
- A Evolution API QR Code é uma solução não oficial e não é endossada pela Meta (Facebook)
- Apesar das proteções implementadas, ainda existe um risco reduzido de que números conectados possam ser banidos pelo WhatsApp
- O Super Agentes suporta a versão 1.8.2 da Evolution API
- A funcionalidade de conexão via Evolution API QR Code está disponível apenas para planos pagos
- Cada agente pode ter apenas uma conexão de WhatsApp ativa por vez
Diferenças Entre as Opções de Integração
| Recurso | Evolution QR | Evolution API | Z-API | API Oficial |
|---|---|---|---|---|
| Facilidade de configuração | ★★★★★ | ★★★☆☆ | ★★★★☆ | ★☆☆☆☆ |
| Proteção contra banimento | ★★★★☆ | ★★☆☆☆ | ★★☆☆☆ | ★★★★★ |
| Necessidade de aprovação | Não | Não | Não | Sim |
| Balanceamento de carga | Sim | Não | Não | Não |
| Verificação de status | Sim | Não | Não | Sim |
| Custo adicional | Não | Não | Sim | Não |
Perguntas Frequentes
P: A integração via Evolution API QR Code é segura contra banimentos?R: Embora nenhuma solução não oficial possa garantir 100% de proteção, a integração via Evolution API QR Code implementa várias camadas de proteção, como proxy rotativo e balanceamento de hosts, que reduzem significativamente o risco de banimento. P: Posso usar meu número pessoal de WhatsApp com esta integração?
R: É possível, mas recomendamos fortemente usar um número dedicado para seu agente, para evitar possíveis problemas com sua conta pessoal. P: O que acontece se eu perder a conexão?
R: O sistema detectará automaticamente a desconexão e mostrará o status como “Desconectado”. Você pode facilmente reconectar gerando um novo QR Code. P: Quantos agentes posso conectar ao mesmo número de WhatsApp?
R: Cada número de WhatsApp só pode ser conectado a um agente por vez. P: Como sei se minha conexão está ativa?
R: Na aba Ambientes > WhatsApp, você verá um indicador de status ao lado da sua conexão, mostrando se está “Conectado” (verde) ou “Desconectado” (vermelho). P: É possível usar a API oficial do WhatsApp em vez da Evolution API QR Code?
R: Sim, o Super Agentes também oferece integração com a API oficial do WhatsApp Business. Essa opção requer aprovação da Meta e um processo de verificação de negócio, mas oferece maior estabilidade e segurança contra banimentos. Consulte nossa documentação de integração com WhatsApp oficial para mais informações.