## 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ão
  `brd.superproxy.io` e porta `44445` (contas antigas e o Proxy Manager ainda usam a `33335`;
  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

1. Acesse **Configurações → Caixas de entrada → Adicionar caixa → WhatsApp Web**.
2. Informe o nome da caixa.
3. 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)**.
4. Configure as demais opções e clique em **Criar canal WhatsApp Web**.
5. 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.
6. Quando a reserva for confirmada, clique em **Conectar WhatsApp** e faça o pareamento por QR ou código
   no telefone.
7. 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:

1. Abra **Configurações → Caixas de entrada → sua caixa → Conexão**.
2. No cartão de rota de rede, escolha **Sem proxy (saída direta)**.
3. 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.

## Veja também

- [Conectar WhatsApp Web por pareamento de QR](/hc/ajuda/articles/inboxes-channels-whatsapp-web-wazmeow-pt-br)
- [Caixa de entrada híbrida do WhatsApp](/hc/ajuda/articles/inboxes-channels-whatsapp-hybrid-inbox-pt-br)
- [WhatsApp Inbox Suite](/hc/ajuda/articles/inboxes-channels-whatsapp-inbox-suite-pt-br)