proxy por conexão
API WhatsApp com IP dedicado, sem você gerenciar proxy
Na API WhatsApp com IP dedicado da D-API, cada conexão recebe um proxy assim que é criada, a troca acontece sozinha quando o proxy falha e o seu SaaS escala números sem manter uma frota de IPs.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Proxy atribuído na criação
Ao criar a sessão, a conexão já recebe o proxy. Ao apagar, a atribuição é liberada. Nenhuma chamada extra na sua integração.
Distribuição pelo menos ocupado
A escolha considera só proxies ativos com capacidade livre e prioriza o que atende menos conexões no momento.
Troca automática em falha
Proxy com falha é desativado, as conexões dele ganham outro proxy e são reiniciadas sem ação do seu time.
Seu servidor fora do caminho
A conexão roda na infraestrutura da D-API. O seu backend só fala com a API REST, e o IP dele nunca chega ao WhatsApp.
Uma API WhatsApp com IP dedicado resolve um problema que todo SaaS encontra quando passa de alguns números para algumas centenas: de onde sai a conexão de cada cliente. Quem monta a própria infraestrutura descobre rápido que dezenas de números saindo do mesmo servidor, com o mesmo IP, viram um ponto único de falha. Comprar proxies, distribuir as conexões entre eles, perceber quando um parou e mover quem estava nele vira um projeto à parte, que não tem nada a ver com o produto que você vende.
Na D-API, esse trabalho vem dentro da conexão. Cada número da API não-oficial recebe um proxy no momento em que é criado, e a plataforma cuida da atribuição, da distribuição e da troca. O seu SaaS integra pela API de WhatsApp e não toca em proxy.
Por que o IP de saída importa para um SaaS
Três motivos aparecem com frequência entre quem atende muitos clientes finais:
- Origem previsível. Cada conexão com o seu proxy atribuído mantém a mesma origem enquanto a atribuição não for trocada, em vez de depender do servidor em que o seu worker está rodando naquele dia.
- Ponto único de falha. Se todas as conexões saem por um servidor, um problema de rede nesse servidor derruba todos os clientes de uma vez.
- Custo operacional. Gerenciar frota de proxies exige inventário, rotação, monitoramento e plantão. É o tipo de infraestrutura que o artigo sobre construir ou contratar uma API de WhatsApp coloca na conta de quem decide fazer em casa.
Como a D-API atribui o proxy de cada conexão
O fluxo acontece na criação da sessão, sem campo extra no payload:
curl -X POST https://api.d-api.cloud/api/v1/sessions \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "cliente-4821",
"connectionMode": "qr",
"webhookUrl": "https://seu-saas.com.br/webhooks/whatsapp/cliente-4821"
}'
Quando a conexão é criada, a plataforma escolhe o proxy dela. A seleção considera apenas proxies ativos que ainda têm capacidade e ordena pelo número de conexões atribuídas, do menor para o maior. A conexão nova vai para o proxy menos ocupado. A atribuição fica registrada com data e motivo, e é liberada quando a sessão é apagada com DELETE /api/v1/sessions/{sessionId}.
O resultado prático: o seu código cria 10 ou 500 conexões do mesmo jeito, e a distribuição entre IPs acontece no lado da D-API.
O que acontece quando um proxy falha
Proxy cai. O que importa é quanto tempo a conexão do seu cliente fica parada e quem precisa agir. Na D-API, quando um proxy é identificado com falha:
- O proxy é marcado como desativado e sai da lista de escolha.
- Cada conexão que estava nele recebe um novo proxy ativo, escolhido pela mesma regra de menor ocupação.
- A instância da conexão é reiniciada para assumir a nova origem.
A sincronização do inventário de proxies também procura conexões que tenham ficado em proxies desativados ou substituídos e as reatribui. E para que uma falha compartilhada não vire uma tempestade de reinícios, a plataforma limita quantos reinícios pelo mesmo motivo acontecem por minuto. Nesse cenário, a verificação de saúde de cada instância continua como rede de segurança para a conexão que realmente travou.
Como o seu SaaS acompanha a conexão
Você não precisa saber qual proxy cada conexão usa. Precisa saber se ela está de pé. Para isso, o evento connection.status do webhook avisa cada mudança de estado, com data.status em connected, disconnected, logged_out ou qrcode_timeout, e um reason nas desconexões:
{
"event": "connection.status",
"sessionId": "cliente-4821",
"timestamp": "2026-01-24T22:00:30.000Z",
"data": {
"status": "connected",
"phone": "5511999999999",
"name": "Loja Exemplo",
"connected": true
}
}
Com esse evento, o painel do seu SaaS mostra para o cliente final se o WhatsApp dele está conectado, e o seu time de suporte sabe quando agir. A lista completa de eventos de conexão está na documentação da D-API.
IP dedicado e isolamento: o que cada um resolve
O proxy por conexão cuida da origem da rede. O isolamento cuida do processo. Na D-API, cada número roda na própria instância: um problema em uma conexão não derruba as outras. A rota GET /api/v1/sessions/{sessionId}/connect força a reconexão reiniciando a instância daquela sessão, sem afetar o restante da sua base.
| Camada | O que a D-API faz | O que sobra para o seu SaaS |
|---|---|---|
| Origem de rede | Proxy atribuído por conexão, distribuição e troca automáticas | Nada |
| Processo | Uma instância por número, reinício automático | Reconectar sob demanda, se quiser |
| Estado | Webhook connection.status |
Mostrar o estado ao cliente final |
| Dados | sessionId em todo evento |
Rotear cada evento para o tenant certo |
Essa divisão é o que permite a um SaaS multi-tenant crescer sem criar um time de infraestrutura só para WhatsApp. O artigo sobre API de WhatsApp multi-tenant aprofunda o desenho do roteamento por tenant.
Saindo de uma infraestrutura própria
Se hoje o seu SaaS roda as conexões em servidores próprios, a migração para a D-API elimina algumas tarefas da sua lista de plantão:
- Inventário de IPs. Deixa de existir no seu lado. Não há proxy para comprar, renovar ou cadastrar.
- Distribuição de números. Some a lógica de “qual servidor recebe o próximo cliente”. Você cria a sessão e pronto.
- Detecção de proxy com falha. Sai do seu monitoramento. Você observa o estado da conexão, não da rede.
- Reinício em massa. O limite de reinícios por motivo evita que um incidente compartilhado vire efeito cascata.
O que continua com você é o que é do seu produto: o sessionId de cada cliente, o roteamento dos eventos e a experiência no painel.
Quando o IP dedicado não se aplica
Na API Oficial, a mensagem sai pela Cloud API da Meta, e a conexão não roda numa instância da D-API. Proxy por conexão é uma característica da API não-oficial. Se a sua base mistura as duas modalidades, a página da API WhatsApp não oficial explica onde cada uma se encaixa, e a de alta disponibilidade mostra o restante da infraestrutura que sustenta as conexões.
Time D-API. Atualizado em .
Perguntas frequentes
Preciso contratar ou configurar proxy para usar a API?
Não. A atribuição faz parte da criação da conexão não-oficial. Você cria a sessão com POST /api/v1/sessions e o proxy já vem junto, sem campo de configuração no payload.
O IP é exclusivo de um único número?
Cada conexão tem o seu proxy atribuído e gerenciado pela D-API, que controla quantas conexões cada IP atende e distribui para o menos ocupado. Se o seu contrato exige um IP exclusivo por número, alinhe com o time antes de fechar.
O que acontece com a minha conexão se o proxy cair?
O proxy com problema é desativado, a conexão recebe outro proxy ativo e é reiniciada automaticamente. O seu sistema acompanha pelo webhook connection.status.
A API Oficial também usa proxy?
Não. Na API Oficial, o envio acontece pela Cloud API da Meta, sem sessão rodando na infraestrutura da D-API. O proxy por conexão é uma característica da API não-oficial.
Posso escolher o IP ou trazer o meu próprio proxy?
A API pública não tem campo para escolher ou informar proxy. A atribuição é automática e gerenciada pela D-API. Necessidades específicas passam pelo time.