Pular para o conteúdo
D-APITestar grátis

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:

  1. O proxy é marcado como desativado e sai da lista de escolha.
  2. Cada conexão que estava nele recebe um novo proxy ativo, escolhido pela mesma regra de menor ocupação.
  3. 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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.