Visão geral
Ao escolher Proxy de conexão gerenciado, com o recurso habilitado, a plataforma reserva uma rota antes de criar a caixa. As credenciais dos provedores ficam sob controle do operador e nunca são exibidas aos administradores da conta ou agentes.
Você também pode escolher Sem proxy (conexão direta) desde o início. Nesse caso, a caixa usa o IP do servidor de conexão do WhatsApp Web. Essa escolha é preservada após o pareamento e as verificações automáticas; para usar um proxy depois, altere a rota explicitamente na aba Conexão.
Automática é a opção recomendada. A plataforma seleciona uma rota saudável usando região, prioridade do provedor, latência e capacidade. Depois do pareamento, o DDI do telefone pode provocar uma única reconexão suave para aproximar a região. A atribuição permanece fixa para a caixa, e gateways residenciais usam uma identidade de sessão persistente.
O fluxo é fail-closed: se não houver proxy saudável com capacidade, a criação é bloqueada antes do pareamento. A caixa nunca conecta diretamente de forma silenciosa. Em uma falha posterior, o failover tenta outra rota aprovada; sem substituta, a política salva decide entre reter a conexão e usar saída direta temporária.
Pré-requisitos
- O operador da plataforma adicionou e testou pelo menos uma conexão de proxy ativa.
- O recurso Proxy gerenciado do WhatsApp Web está habilitado para sua conta.
- Um administrador da conta pode criar uma caixa WhatsApp Web.
- O telefone está disponível para escanear o QR ou informar o código de pareamento.
Os provedores aceitos são somente Webshare, Bright Data e um endpoint personalizado informado conscientemente pelo operador. A compra e a administração do plano acontecem fora da ConversaLabs.
Credenciais por provedor:
- Webshare: uma API key pode sincronizar automaticamente o inventário de proxies estáticos; o modo de gateway/backbone pode usar o usuário e a senha nativos do proxy. Use a opção compatível com o modo contratado.
- Bright Data: use o usuário da Zone, como
brd-customer-...-zone-..., e a senha da Zone em Proxies → Access details. Não use uma API key da REST API. No modo HTTP, os padrões sãobrd.superproxy.ioe porta44445(contas antigas e o Proxy Manager ainda usam a33335; se o teste de conexão falhar em uma, tente a outra). - Personalizado: o operador informa protocolo, host, porta, capacidade/região e, quando exigido, usuário e senha. Cadastre somente endpoints controlados e confiáveis.
Passo a passo
- Acesse Configurações → Caixas de entrada → Adicionar caixa → WhatsApp Web.
- Informe o nome da caixa.
- Escolha Proxy de conexão gerenciado e mantenha a região automática ou selecione um país disponível. Para usar o IP do servidor de conexão, escolha Sem proxy (conexão direta).
- Configure as demais opções e clique em Criar canal WhatsApp Web.
- Se o proxy selecionado ficar sem capacidade, a criação informa a falha. Peça ao operador para restaurar a rota ou volte e escolha explicitamente Sem proxy se desejar conexão direta.
- Quando a reserva for confirmada, clique em Conectar WhatsApp e faça o pareamento por QR ou código no telefone.
- Depois do pareamento, a plataforma confirma o DDI e ajusta a região quando necessário. Isso não cria outra caixa.
Voltar para saída direta (sem proxy)
Uma caixa que já está num proxy gerenciado pode voltar a sair pelo IP do próprio servidor:
- Abra Configurações → Caixas de entrada → sua caixa → Conexão.
- No cartão de rota de rede, escolha Sem proxy (saída direta).
- Clique em Usar saída direta. A reserva de proxy é liberada e o gateway passa a sair direto.
A opção continua disponível mesmo se o recurso de proxy for desativado na conta depois — do contrário a caixa ficaria presa na rota antiga. Já uma caixa roteada por aparelho próprio não pode ser devolvida à saída direta por aqui: o gateway só desfaz essa rota apagando a sessão, o que desconecta o WhatsApp.
Configurações & opções
- Automática: escolhe a rota saudável mais adequada considerando geografia, prioridade, saúde, latência e capacidade.
- Seleção de país: solicita uma região. Outra região aprovada pode ser escolhida quando a preferida estiver indisponível; sem qualquer rota segura, a criação é bloqueada.
- Atribuição fixa: um endpoint estático ou dedicado permanece reservado para a caixa.
- Gateway persistente: provedores rotativos/residenciais recebem uma identidade de sessão estável para a caixa.
- Failover automático: falhas de saúde repetidas movem a caixa para outro endpoint aprovado. Um intervalo de proteção evita trocas rápidas.
- Política salva: políticas de retenção preservam a rota. Somente a política que permite saída direta usa o servidor temporariamente quando falta capacidade de proxy.
Casos de uso
- Manter a sessão WhatsApp Web próxima ao país do número.
- Dar a cada caixa um IP dedicado estável ou uma identidade residencial persistente.
- Distribuir muitas caixas entre assinaturas aprovadas sem expor credenciais.
- Fazer failover entre rotas confiáveis sem permitir saída direta silenciosa.
Dicas, limites e boas práticas
- Prefira endpoints estáveis, dedicados/estáticos quando o provedor oferecer. Evite mudanças desnecessárias de região ou identidade.
- Um proxy melhora o isolamento da rota, mas não ignora políticas do WhatsApp, limites de mensagens ou controles de qualidade da conta.
- Nunca cole credenciais do provedor no assistente da caixa. Administradores da conta escolhem apenas a preferência de roteamento.
- Na Bright Data, a senha necessária é a da Zone de proxy, não a senha da conta e não uma API key.
- Na Webshare, revogue imediatamente uma API key que tenha sido exposta em captura de tela, chat ou log.
- Ao escolher um país manualmente, use o país em que o número normalmente é operado.
- Pausar um provedor impede novas atribuições. Sem substituta aprovada, as rotas afetadas seguem a política de fallback salva.
- Em uma caixa de entrada híbrida (WhatsApp Web pareado com a Cloud), a rota vale só para o tráfego que sai pelo WhatsApp Web. As mensagens enviadas pela API da Cloud saem sempre pelo IP do próprio servidor, qualquer que seja o proxy escolhido. A rota é gerenciada na aba Conexão da caixa WhatsApp Web do par — a aba Híbrido da caixa Cloud mostra a rota atual e leva até lá.
Solução de problemas
- A seção de proxy não aparece: peça ao operador para habilitar o recurso na sua conta.
- Nenhum país aparece: o inventário pode estar sincronizando ou sem capacidade saudável. Para usar proxy, aguarde a correção. Para usar o IP do servidor de conexão, escolha explicitamente Sem proxy no assistente.
- A criação foi bloqueada por falta de rota: o comportamento é intencional. O operador deve testar credenciais, saúde, capacidade e regiões do provedor antes de uma nova tentativa.
- Bright Data pede credenciais: copie o usuário e a senha da Zone em Proxies → Access details. Não crie uma API key para este adaptador.
- Webshare não sincroniza proxies estáticos: confirme a API key e o plano escolhidos. Para gateway/backbone, confira o usuário, a senha, host e porta nativos.
- Endpoint personalizado falha: confira protocolo, DNS/host, porta, autenticação, capacidade e se o servidor da ConversaLabs consegue alcançá-lo com segurança.
- A sessão reconecta uma vez depois do pareamento: o DDI diferiu da estimativa inicial e a rota foi refinada. Isso é esperado.
- Desconexões repetidas: consulte a saúde dos provedores. O failover usa somente endpoints aprovados; se todos estiverem offline, a caixa segue a política de fallback salva.
Recuperação temporária da rota
Servidor (fallback temporário) indica que a política salva permite usar o IP do servidor enquanto a capacidade de proxy se recupera. Isso difere da escolha Sem proxy, mantida até você alterá-la. A recuperação repete as tentativas com intervalos crescentes, exibidos em Conexão → Rota de saída, e retorna ao proxy gerenciado quando houver capacidade.
A mudança de rota e a conexão do WhatsApp são confirmadas separadamente. Se o gateway perder uma resposta, o painel mostra a rota desejada, a aplicada e a observada enquanto aguarda confirmação. Sem leitura da rota, o estado permanece não confirmado. Não remova a caixa nem pareie outro número para corrigir uma falha temporária: a reconexão suave preserva o aparelho pareado. Um novo pareamento só é necessário quando o WhatsApp realmente encerra a autorização ou quando você o solicita explicitamente.