POST /proxy/set/{instancia}, com o header apikey.enabled, host, port e protocol."proxy" e enviar a porta como número — port é string.A Evolution API roda no seu servidor e conecta cada instância ao WhatsApp. Sem proxy, todas as instâncias saem pelo mesmo endereço IP — o do servidor.
Configurar um proxy por instância muda duas coisas: cada número passa a sair por um endereço próprio, então um número sinalizado não compromete os demais; e o endereço passa a ser de operadora móvel brasileira, em vez de um IP de datacenter.
O que isso não faz: proxy não é aquecimento de chip, não regula volume de disparo e não muda o conteúdo que os destinatários denunciam. Ele trata o fator IP, que é um dos fatores de bloqueio — não todos.
A v2 expõe o endpoint /proxy/set/{nome_da_instancia}. A autenticação é pelo header apikey, com a chave definida em AUTHENTICATION_API_KEY no seu .env.
| Campo | Tipo | Obrigatório | Valor na GTI Proxy |
|---|---|---|---|
| enabled | boolean | Sim | true |
| host | string | Sim | srv.gtiproxy.com |
| port | string | Sim | A porta HTTP ou SOCKS5 do painel, entre aspas |
| protocol | string | Sim | http ou socks5 |
| username | string | Não | Seu usuário do painel |
| password | string | Não | Sua senha do painel |
# Evolution API v2 — grava o proxy NA INSTÂNCIA, não no servidor
curl -X POST 'https://SEU-SERVIDOR/proxy/set/NOME_DA_INSTANCIA' \
-H 'apikey: SUA_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"enabled": true,
"host": "srv.gtiproxy.com",
"port": "PORTA_HTTP",
"protocol": "http",
"username": "USUARIO",
"password": "SENHA"
}'# confere o que ficou gravado na instância
curl -X GET 'https://SEU-SERVIDOR/proxy/find/NOME_DA_INSTANCIA' \
-H 'apikey: SUA_API_KEY'Configuração gravada não é o mesmo que configuração ativa. Vale testar o mesmo proxy fora da Evolution API antes de culpar a instância:
# o mesmo proxy, testado por fora: deve devolver um IP brasileiro de operadora
curl -x http://USUARIO:[email protected]:PORTA_HTTP https://ifconfig.meSe esse comando devolver o IP da sua internet em vez de um IP brasileiro de operadora, o problema está nas credenciais ou na porta, não na Evolution API.
Boa parte do material em português mostra o corpo assim:
# NÃO funciona na v2 — corpo aninhado dentro de "proxy"
{ "enabled": true, "proxy": { "host": "...", "port": "...", "protocol": "http" } }Na v2 os campos ficam na raiz do JSON, sem o objeto proxy em volta. O outro tropeço frequente é enviar "port": 8013 como número: o campo é string e precisa das aspas.
Em painéis que embrulham a Evolution — Typebot, Chatwoot, n8n — os campos têm os mesmos nomes. Para o passo a passo em outras ferramentas, veja como configurar o proxy.
A resposta muda conforme o tipo de IP, e a diferença é técnica, não comercial.
As operadoras móveis brasileiras entregam IPv4 por CGNAT (Carrier-Grade NAT): milhares de assinantes reais saem pelo mesmo endereço público ao mesmo tempo. Essa é a arquitetura padrão da rede móvel no Brasil, não uma exceção.
A consequência prática é direta: várias contas saindo de um mesmo IP móvel é o comportamento normal daquela rede. Por isso um proxy móvel costuma atender mais de uma instância da Evolution API sem que o compartilhamento do endereço seja, por si só, o sinal que derruba o número.
O limite que aparece primeiro, na prática, não é o endereço — é a franquia de dados, dividida entre todas as instâncias que passam por ali: 1 GB no passe de 24 horas, 5 GB no semanal e 60 GB no mensal.
No Residencial Fixo o endereço é dedicado e fixo — ninguém mais usa aquele IP enquanto a sua assinatura durar, e ele não rotaciona. Como o endereço não é naturalmente compartilhado como o da rede móvel, o padrão que faz sentido aqui é uma instância por IP.
Em troca vêm a banda ilimitada e a estabilidade do mesmo endereço amanhã, o que serve operação com mídia pesada, sessão longa ou volume que estouraria a franquia de um plano móvel. É também o que clientes usam em emulador e em navegador antidetect ou multilogin, onde cada perfil quer um endereço próprio e estável.
| Móvel 4G/5G | Residencial Fixo | |
|---|---|---|
| Origem do IP | Operadora (TIM, Vivo, Claro), via CGNAT | Provedor residencial, IP dedicado |
| Várias instâncias no mesmo IP | Compartilhar endereço é o normal da rede móvel | Melhor uma por IP: o endereço é exclusivo seu |
| Rotação de IP | Automática no 24h e no semanal; manual no mensal | Não rotaciona |
| Banda | Franquia por plano: 1 GB, 5 GB ou 60 GB | Ilimitada |
| Também usado em | Aquecimento de chip, várias instâncias | Emulador, antidetect e multilogin |
| Preço | R$ 15 / R$ 50 / R$ 200 | R$ 40 por mês (IPv4, ou 5 IPs na versão IPv6) |
Nenhuma das duas opções elimina o risco de bloqueio: o proxy trata o fator IP, e o resultado depende também do aquecimento do número, do volume enviado e do conteúdo. Detalhes de cada produto em proxy móvel 4G/5G e proxy residencial. Se a operação for de atendimento e não de disparo, proxy para WhatsApp cobre o cenário mais amplo.
Se os números continuam caindo com o proxy ativo e confirmado, o gargalo provavelmente não é o IP. Vale olhar para o aquecimento do chip, para o volume enviado em relação à idade da conta, para a taxa de denúncia dos destinatários e para a qualidade da lista. Nenhum proxy corrige esses quatro.
E não existe um tipo de proxy certo para toda operação: o móvel 4G/5G costuma ser a escolha para aquecer número novo e para concentrar várias instâncias, enquanto o Residencial Fixo atende quem quer endereço dedicado e banda sem franquia. A comparação completa entre os dois está em móvel vs. residencial.
Por instância, não no servidor inteiro. A Evolution API v2 expõe o endpoint POST /proxy/set/{nome_da_instancia}, autenticado pelo header apikey. Cada instância guarda o próprio proxy, que é justamente o comportamento desejado: um número por IP.
Os campos ficam no nível raiz do JSON, não dentro de um objeto proxy. São obrigatórios enabled, host, port e protocol; username e password são opcionais e necessários quando o proxy exige autenticação. Atenção: port é string, entre aspas. Muitos tutoriais em português mostram o corpo aninhado e por isso a configuração não pega.
Depende do tipo de proxy. No proxy móvel 4G/5G, não necessariamente: as operadoras brasileiras entregam IPv4 por CGNAT, então milhares de assinantes reais já dividem o mesmo endereço público, e várias instâncias saindo de um IP móvel é o comportamento normal daquela rede. O limite prático costuma ser a franquia de dados do plano, não o endereço. No Residencial Fixo o cálculo é outro: o IP é dedicado e não é naturalmente compartilhado, então o padrão que faz sentido é uma instância por IP.
Sim, e há clientes que preferem: o Residencial Fixo entrega IP dedicado e fixo, que não rotaciona, com banda ilimitada — útil quando a operação usa mídia pesada ou sessões longas e você quer o mesmo endereço amanhã. O padrão usual nesse caso é uma instância por IP, já que o endereço é só seu. Os mesmos clientes costumam usar o Residencial Fixo em emulador e em navegador antidetect ou multilogin, onde cada perfil quer um endereço estável e próprio.
Os dois funcionam; o campo protocol aceita o que você contratou. A GTI Proxy entrega HTTP e SOCKS5 no mesmo plano, em portas diferentes, ambas visíveis no painel. Na dúvida, comece por HTTP: é o caminho com mais material de referência e depuração mais simples.
Não publicamos esse número porque não o medimos em condições que valham como referência — depende do volume de mensagens, do uso de mídia e do comportamento da sua operação. O jeito honesto de descobrir é medir na sua: o passe móvel de 24 horas custa R$ 15 e mostra o consumo real do seu fluxo antes de você assinar o mensal.
Primeiro confirme que o tráfego está mesmo saindo pelo proxy, com GET /proxy/find/{instancia} e um teste de IP — configuração gravada não é o mesmo que configuração ativa. Depois considere o que o proxy não cobre: ele troca o endereço IP, que é um dos fatores de bloqueio, mas não corrige aquecimento insuficiente do chip, volume de disparo acima do normal para a idade da conta, conteúdo denunciado pelos destinatários ou fingerprint do dispositivo.
Passe móvel de 24 horas por R$ 15, com 1 GB. Se assinar o Mensal em até 48h, abatemos os R$ 15 na primeira mensalidade.