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
- Contrate a instância e conecte o número (veja os primeiros passos). Para testar antes, sem número, use o sandbox.
- Anote o
slug(o nome técnico da instância, no painel) e a chavepbwa_…. - No seu sistema, troque a base. Nas rotas da primeira tabela, o resto do código fica.
- Se você recebe avisos, escolha no painel o formato de aviso zapi e cadastre o seu endereço.
- Teste cada rota em ordem de importância e só então desligue a instância antiga.
# 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átisO 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-listesend-carousel: as rotas respondem, mas lista e carrossel hoje são recusados cominteractive_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/interactiveaceita um botão do tipocopy(copiar código).restart-with-disconnect: usedisconnecte 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
messageIdcomo 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.