Como consultar e configurar o proxy de uma instância
Veja como consultar, atualizar e testar a configuração de proxy de uma instância GoZAP pela API, com as rotas e os passos de cada operação.

O proxy móvel individual já está incluído no plano de cada instância. Como cada instância usa seu próprio proxy, o IP fica isolado por instância. No Starter, R$ 200,00 por mês cobrem até 100 instâncias e seus 100 proxies, o que corresponde a R$ 2,00 por instância com proxy quando se divide o pacote por 100. Não há uma tarifa de proxy somada a esse valor.
Além do proxy incluído, cada instância tem um modo de proxy próprio: dynamic, global, custom ou managed. O modo dynamic inicia o proxy dedicado da instância.
Como configurar o proxy de uma instância?
A configuração é associada à instância e pode ser consultada pela API. Os quatro modos são:
| Modo | O que faz |
|---|---|
dynamic |
Inicia um proxy dedicado para a instância. |
global |
Usa o proxy global configurado na plataforma. |
custom |
Usa uma URL de proxy que você informa para a instância. |
managed |
Usa o proxy gerenciado da plataforma. |
“Depois de uma alteração, leia a configuração e verifique a conectividade da instância.”
Como consultar a configuração?
Use a rota autenticada de leitura para obter a configuração pública de proxy associada à instância.
GET /instance/proxy
Como atualizar ou remover um proxy customizado?
Envie a configuração para a rota de atualização. No modo custom, o corpo recebe uma URL de proxy. A rota de remoção pode restaurar o modo dynamic ou global, conforme o parâmetro e as opções habilitadas no serviço.
POST /instance/proxy GET /instance/proxy/check DELETE /instance/proxy
O que a verificação informa?
GET /instance/proxy/check solicita uma verificação de egress para a configuração atual e retorna o resultado produzido pelo serviço. A rota não documenta troca automática de IP por blacklist ou por limiar de latência.
Quando não escolher a GoZAP
Não escolha a GoZAP se sua política exige exclusivamente a plataforma oficial da Meta ou se é obrigatório usar um proxy que sua equipe contrata, hospeda e controla fora do serviço GoZAP. A conta pode conectar por Web, com QR ou código, ou por Mobile, com registro pelo número; os dois modos ficam fora da API oficial da Meta. Veja também o guia de modo Mobile sem celular. A API não promete resultado específico de conexão por ter proxy configurado.
O isolamento de IP por instância não elimina regras ou limites do WhatsApp. Abra a documentação de proxies para os parâmetros e as operações disponíveis.