WhatsApp Web e Evolution API
- Os dois tipos de canal WhatsApp não oficiais disponíveis no AutoTalk
- Como configurar o WhatsApp QR Code (conexão por escaneamento)
- Como configurar o Evolution API (gateway WhatsApp auto-hospedado)
- Como configurar um proxy para conexões WhatsApp
- Como escolher entre eles
O AutoTalk oferece duas opções de canal WhatsApp que não exigem aprovação da API oficial Business da Meta. Ambas aparecem como opções separadas no menu suspenso de tipo de canal quando você adiciona um novo canal.
Opção 1: WhatsApp QR Code
Rótulo no menu: WhatsApp QR Code
Esta opção funciona exatamente como o WhatsApp Web em um computador. Você escaneia um QR code com seu celular, e o AutoTalk espelha sua sessão do WhatsApp para receber e enviar mensagens.
Quando usar o WhatsApp QR Code
- Você quer a configuração mais rápida possível sem contas externas ou chaves de API
- Você é um pequeno negócio ou operador individual com volumes moderados de mensagens
- Você não precisa de modelos de mensagem ou recursos da API oficial
Configurando o WhatsApp QR Code
- Na barra lateral, vá para Integrações > Canais para abrir a lista de Canais.
- Clique em Adicionar canal.
- No menu suspenso de tipo de canal, selecione WhatsApp QR Code.
- Um QR code aparecerá na tela.
- No seu celular, abra o WhatsApp e vá para Configurações > Aparelhos Conectados > Conectar um Aparelho.
- Escaneie o QR code exibido no AutoTalk com a câmera do seu celular.
- Quando o escaneamento for concluído, o status do canal muda para conectado.
Considerações importantes
- Seu celular deve permanecer conectado à internet para que a sessão vinculada fique ativa.
- Se a conexão cair (por exemplo, se seu celular perder internet por um período prolongado), pode ser necessário escanear um novo QR code.
- Este método é melhor para volumes pequenos a médios de mensagens. Para uso em alto volume, considere a API oficial do WhatsApp Business.
- Se o QR code expirar antes de você escaneá-lo, atualize a página ou o elemento de QR code para gerar um novo.
Opção 2: Evolution API
Rótulo no menu: Evolution API
O Evolution API é um gateway WhatsApp auto-hospedado. Em vez de depender da infraestrutura em nuvem da Meta, você (ou sua equipe de TI) executa o servidor Evolution API, e o AutoTalk se conecta a ele. Isso dá mais controle sobre a conexão WhatsApp, incluindo onde os dados são armazenados e como a sessão é gerenciada.
Quando usar o Evolution API
- Sua organização exige infraestrutura auto-hospedada por razões de conformidade ou soberania de dados
- Você quer mais controle técnico sobre a conexão WhatsApp
- Você tem uma equipe de TI que pode implantar e manter o servidor Evolution API
Configurando o Evolution API
- Implante uma instância do Evolution API no seu próprio servidor ou infraestrutura em nuvem. Consulte a documentação do projeto Evolution API para os passos de instalação.
- No AutoTalk, vá para Integrações > Canais e clique em Adicionar canal.
- No menu suspenso de tipo de canal, selecione Evolution API.
- Insira os campos de configuração que aparecem, incluindo a URL do servidor Evolution API e quaisquer credenciais de autenticação necessárias.
- Salve o canal.
- Siga as instruções para parear a instância do Evolution API com seu número WhatsApp (isso pode envolver escanear um QR code no lado do Evolution API).
Considerações importantes
- Você é responsável por hospedar, atualizar e manter o servidor Evolution API.
- O tempo de atividade do canal depende do tempo de atividade do seu servidor auto-hospedado.
- Esta opção oferece a maior flexibilidade e controle, mas também exige o maior envolvimento técnico.
Configurações de Proxy
Tanto os canais WhatsApp QR Code quanto Evolution API suportam um proxy opcional para rotear conexões WhatsApp através de um servidor intermediário. Isso é útil quando o IP do seu servidor está bloqueado, quando você precisa rotacionar IPs, ou quando a política da empresa exige que o tráfego de saída passe por um proxy.
A seção de proxy aparece como um painel recolhível rotulado Configurações de Proxy dentro da página de edição do canal.
Configurando um proxy
- Abra a página de edição do canal (Integrações > Canais, depois clique no canal).
- Expanda a seção Configurações de Proxy.
- Preencha os campos:
| Campo | Descrição | Exemplo |
|---|---|---|
| Host | Hostname ou endereço IP do servidor proxy | brd.superproxy.io |
| Porta | Número da porta | 33335 |
| Protocolo | Protocolo de conexão | http, https, socks4 ou socks5 |
| Usuário | Nome de usuário para autenticação (deixe em branco se não for necessário) | brd-customer-abc123 |
| Senha | Senha de autenticação, armazenada como segredo de segurança | Digite a senha e clique em Adicionar para criar o segredo |
- Clique em Salvar para salvar o canal.
- Clique em Testar Proxy para verificar se o proxy está acessível.
- Clique em Aplicar Proxy para aplicar a configuração de proxy à conexão WhatsApp ativa.
O campo Senha armazena suas credenciais de proxy como um segredo de segurança criptografado. Quando você digita uma senha e clica em Adicionar (ou seleciona a opção de criar no menu suspenso), o segredo é criado automaticamente -- você não precisa preencher nenhum formulário extra.
Você deve salvar o canal antes que os botões Testar Proxy e Aplicar Proxy fiquem ativos. Se os botões aparecerem desabilitados, salve primeiro.
Removendo um proxy
Para parar de usar um proxy, limpe o campo Host, salve o canal e clique em Aplicar Proxy para aplicar a alteração à conexão ativa.
Comparação: QR Code vs. Evolution API vs. API Oficial
| Recurso | WhatsApp QR Code | Evolution API | WhatsApp API (Official) |
|---|---|---|---|
| Dificuldade de configuração | Muito fácil | Moderada a avançada | Moderada |
| Aprovação da Meta necessária | Não | Não | Sim |
| Auto-hospedado | Não | Sim | Não |
| Celular deve ficar online | Sim | Depende da configuração | Não |
| Modelos de mensagem | Não | Não | Sim |
| Suporte a proxy | Sim | Sim | Não |
| Melhor para | Início rápido, pequenas equipes | Equipes técnicas, necessidades de conformidade | Alto volume, uso oficial |
Se você não tem certeza de qual opção escolher, comece com o WhatsApp QR Code para um teste rápido. Você sempre pode migrar para a API oficial do WhatsApp Business ou Evolution API depois, conforme suas necessidades crescerem.
Próximos passos
- WhatsApp Business (API Oficial) — Configure a integração oficial aprovada pela Meta
- Adicionando uma integração — Passo a passo geral de configuração de canal