Empresa brasileira · Entrega automática · Suporte em português Seg a sex, 9h as 18h · PIX em reais
ProxyBox
API de WhatsApp · Conta e migração

Como migrar da Wafly para a ProxyBox?

As rotas da Wafly seguem o desenho instances/token. Veja o que continua igual trocando a base, o que muda de nome e o que só existe na API v1.

5 min de leitura Atualizado em 14 de novembro de 2026
Resposta curta
A Wafly usa caminhos no formato https://wafly.com.br/api-bridge-whats/instances/{instância}/token/{token}/<rota>. A ProxyBox tem uma base com o mesmo desenho: https://proxybox.com.br/api/whatsapp/zapi/instances/{slug}/token/{chave}/<rota>. Nas rotas cobertas, como send-text com phone e message, você troca a base e o código segue. O que muda de nome ou só existe na API v1 está nas tabelas abaixo.

Recurso em beta: pode mudar. Este mapa foi montado a partir da documentação pública da Wafly, lida em 14/11/2026. Não existe vínculo entre a ProxyBox e a Wafly. Teste cada rota que o seu sistema usa antes de desligar a instância antiga.

Por que migrar, e quando não?

Quem vem da Wafly ganha, na ProxyBox, o IP brasileiro de provedor dedicado por número (no plano com IP), a chave por instância, o modo de consulta de avisos para quem não pode expor um endereço público, a aprovação humana antes do envio e o conector de IA. Os detalhes do produto estão na página da API de WhatsApp.

Não migre se o seu sistema depende da API de gestão de instâncias da Wafly, de chamadas ou de publicação em canais: esses recursos não têm equivalente aqui. As duas são conexões não oficiais, por QR Code ou código de pareamento, e nenhuma é a API oficial da Meta.

Passo a passo

  1. Contrate a instância e conecte o número (veja os primeiros passos). Para testar antes, sem número, use o sandbox.
  2. Anote o slug (o nome técnico da instância, no painel) e a chave pbwa_….
  3. No seu sistema, troque a base. Nas rotas da primeira tabela, o resto do código fica.
  4. Se você recebe avisos, escolha no painel o formato de aviso zapi e cadastre o seu endereço.
  5. Teste cada rota em ordem de importância e só então desligue a instância antiga.
bash
# antes
curl -X POST "https://wafly.com.br/api-bridge-whats/instances/INSTANCIA/token/TOKEN/send-text" \
  -H "Client-Token: SEU_CLIENT_TOKEN" -H "Content-Type: application/json" \
  -d '{"phone":"5547999999999","message":"Seu pedido saiu."}'

# depois
curl -X POST "https://proxybox.com.br/api/whatsapp/zapi/instances/atendimento-da-loja/token/pbwa_SUA_CHAVE/send-text" \
  -H "Content-Type: application/json" \
  -d '{"phone":"5547999999999","message":"Seu pedido saiu."}'

Quais rotas continuam com o mesmo caminho?

Rota O que faz Observação
POST send-text enviar texto phone e message; messageId vira resposta a uma mensagem
POST send-image enviar imagem image por endereço ou base64, com caption
POST send-document/{tipo} enviar documento a extensão vai no caminho
POST send-audio, send-video, send-gif áudio, vídeo e GIF
POST send-contacts enviar contatos até 5 por pedido
POST send-link link com prévia o WhatsApp decide se mostra a prévia
POST send-poll enquete o voto chega no aviso
POST send-button-list, send-button-actions botões veja botões e listas
DELETE delete-message apagar mensagem
GET qr-code/image, status, disconnect, restart conexão
POST phone-exists-batch conferir números lote de até 50
GET groups, POST create-group, GET group-metadata/{id} grupos
PUT update-webhook-received, -delivery, -connected, -disconnected cadastrar os avisos

Os campos opcionais que a Wafly documenta em cada rota podem não existir aqui. Programe o seu código para tratar o erro 400, que vem com o nome do campo recusado.

Vai trocar de provedor? Rode as suas chamadas no sandbox antes de mudar a URL: é grátis e nada sai para o WhatsApp.

Testar grátis

O que muda de nome ou vai para a API v1?

Na Wafly Na ProxyBox
GET ou POST pairing-code GET phone-code/{telefone} na base de compatibilidade
GET group/invite-link GET group-invitation-link/{id do grupo}
POST send-ptv (vídeo redondo) API v1: POST /messages/video com round: true
POST send-button-pix API v1: POST /messages/pix, com o código "copia e cola" e o botão de copiar
POST send-event API v1: POST /messages/event
POST pin-message API v1: fixar mensagem (veja a referência)
POST connect a conexão é feita no painel ou pelas rotas de QR e código
publicar status send-text-status, send-image-status e send-video-status

A API v1 usa a mesma chave, só que no cabeçalho apikey, na base https://proxybox.com.br/api/whatsapp/v1.

O que não tem equivalente?

  • send-option-list e send-carousel: as rotas respondem, mas lista e carrossel hoje são recusados com interactive_unsupported, porque o WhatsApp não entrega esses formatos em conexões como esta.
  • send-button-otp: na base de compatibilidade não existe; na API v1, POST /messages/interactive aceita um botão do tipo copy (copiar código).
  • restart-with-disconnect: use disconnect e conecte de novo.
  • A API de gestão de instâncias (api-managment), as chamadas e a publicação em canais.

Como ficam os avisos?

A documentação da Wafly descreve o aviso de mensagem recebida com type igual a ReceivedCallback e campos como phone, senderName, messageId, momment, fromMe, isGroup e text.message. O formato de aviso zapi da ProxyBox usa esse mesmo desenho, com ReceivedCallback para o que chega, além dos avisos de entrega, conexão e desconexão.

Três cuidados:

  • Use o messageId como chave para não processar o mesmo aviso duas vezes.
  • A ProxyBox assina os avisos. Confira a assinatura como mostra o guia de avisos automáticos.
  • Se o seu servidor ficar fora do ar, a ProxyBox tenta de novo e guarda os avisos por alguns dias. Quem preferir pode buscar os avisos pelo modo de consulta.

Veja também

Índice completo: documentação. Sobre o produto: uma instância de WhatsApp por número.

Autoria: equipe técnica da ProxyBox. Atualizado em 14/11/2026, contra a documentação pública da Wafly lida nesta data. Recurso em beta.

Perguntas frequentes

O meu código da Wafly funciona só trocando a base?
Nas rotas cobertas (texto, imagem, documento, áudio, vídeo, contato, enquete, botões, grupos e avisos), o caminho e os campos principais são os mesmos. Teste cada rota que o seu sistema usa antes de desligar a instância antiga.
O Client-Token continua necessário?
Pode mandar, mas é ignorado. Na ProxyBox a segurança é a chave da instância, que vai na própria URL.
E o que não existe na base de compatibilidade?
Vídeo redondo, PIX, evento, fixar mensagem e código de pareamento existem na API v1, com outro caminho. Canais de transmissão em massa, chamadas e a API de gestão de instâncias não têm equivalente.

Guias relacionados

Pronto para colocar no ar?

Comece no sandbox, grátis. Quando funcionar, contrate a instância do seu número e pague com PIX ou saldo.

Com IP brasileiro dedicado R$ 89,90/mês
Só a instância (traga o seu IP) R$ 39,90/mês
Travou em alguma etapa?Manda o print do erro no WhatsApp. Respondemos em português.
Suporte em português Fale no WhatsApp