WaflyBlog › Trocar de API

Quanto custa de verdade trocar de API de WhatsApp

Atualizado em 31 de julho de 2026 · baseado em dados da nossa própria operação e em fontes primárias citadas ao longo do texto

A parte cara de trocar de API de WhatsApp não é a mensalidade nova, é a reescrita da integração e a janela em que o número fica fora do ar durante o repareamento. A boa notícia, que quase nenhum fornecedor conta porque não favorece a venda: o número e o histórico de conversa são seus e ficam no WhatsApp, não no fornecedor. A má notícia: trocar de API não resolve problema de banimento, porque a detecção independe da biblioteca. Se o motivo da troca é esse, a migração vai custar trabalho e repetir o resultado.

Todo fornecedor de API de WhatsApp tem uma página explicando por que você deveria migrar para ele. Nenhum publica o que a migração custa, nem em que situação ela não vale a pena. Somos um fornecedor e temos interesse óbvio em você trocar, então esta página tenta ser útil apesar disso: descreve o custo real e diz explicitamente quando ficar onde está é a decisão certa.

O que continua seu, e isso é a maior parte

A dúvida que mais aparece antes de migrar é sobre perder alguma coisa. Vale começar por aí porque a resposta é tranquilizadora.

O número é seu. Ele é uma linha telefônica, não um recurso do fornecedor. Você pareia e despareia quantas vezes quiser.

O histórico de conversa fica na conta do WhatsApp, não no fornecedor. Quando você conecta o mesmo número em outro serviço, as conversas continuam lá, com o mesmo contexto para o cliente que te escreveu semana passada.

A reputação do número também é sua e viaja com ele. Isso corta nos dois sentidos: se o número está bem, ele continua bem; se acumulou sinal ruim, o fornecedor novo não zera nada.

O que normalmente não migra é o que o fornecedor antigo guardou por conta: relatório de envio, logs, mensagens agendadas e eventuais contatos organizados dentro da plataforma dele. Exporte antes de cancelar, porque depois do cancelamento costuma não haver acesso.

Onde o custo realmente está

A mensalidade nova é a parte fácil de calcular e a menor da conta. O custo de verdade tem três partes.

Reescrita da integração

Cada fornecedor tem seu formato de rota, de autenticação e de payload de webhook. Não existe padrão de mercado. Na prática você vai mexer em três lugares: a chamada de envio, o receptor de webhook e o tratamento de erro.

O tamanho disso depende de como o seu código foi escrito. Se as chamadas ao fornecedor estão espalhadas pelo sistema, o trabalho é grande. Se estão atrás de uma única camada, costuma ser uma tarde.

Não vamos publicar uma estimativa em horas

Seria fácil escrever "migre em 2 horas" e isso apareceria bem no comparativo. Não medimos migrações de clientes com metodologia, e o número varia demais com o acoplamento do código de cada um. O que dá para afirmar com honestidade é qualitativo: o custo é proporcional a quantos lugares do seu sistema chamam o fornecedor direto.

Um jeito de reduzir esse custo para sempre, independente de com quem você fique: isole o fornecedor atrás de uma interface própria. A segunda migração custa uma fração da primeira quando existe uma única função enviarMensagem no seu código.

A janela de repareamento

É o único momento de indisponibilidade real. Você desconecta a sessão no fornecedor antigo e pareia o mesmo número no novo, por QR code ou código de pareamento. Com o aparelho em mãos e o processo ensaiado, é rápido.

O que estica isso para horas raramente é técnico. É descobrir quem tem o celular, precisar de aprovação para mexer no número principal, ou perceber no meio do caminho que ninguém sabe onde os webhooks estavam configurados.

Reconfiguração de webhook

Se você recebe mensagens, os webhooks precisam ser reapontados e os payloads reconferidos campo a campo. Os nomes de campo mudam entre fornecedores e é comum o novo entregar o mesmo dado com outro nome, o que produz aquele bug silencioso em que tudo parece funcionar mas um campo chega vazio. Nossa estrutura de callbacks está documentada em webhook de WhatsApp, com o payload real campo a campo.

Quando NÃO vale a pena trocar

Somos fornecedor e mesmo assim: existem casos em que migrar é desperdício de tempo.

Um roteiro de migração sem susto

  1. Ensaie em um número secundário. Nunca estreie o processo no número principal.
  2. Exporte o que você quer levar do fornecedor antigo antes de qualquer coisa.
  3. Suba a integração nova em paralelo, apontando para o número de teste, e valide envio, recebimento e erro.
  4. Reaponte os webhooks e confira o payload campo a campo, não só o status 200.
  5. Escolha a janela, de preferência no horário de menor movimento, com o aparelho em mãos.
  6. Despareie e pareie, nessa ordem, e confirme o recebimento com uma conversa real.
  7. Só cancele o plano antigo depois de um ciclo completo funcionando, não no mesmo dia.

O item 7 é o que mais gente pula. Manter o fornecedor antigo por mais um mês custa uma mensalidade e compra a possibilidade de voltar atrás sem correria.

O que perguntar antes de assinar o próximo

Quatro perguntas que revelam mais que qualquer tabela comparativa:

Do nosso lado: 1 instância dedicada desde o plano de entrada, 78 endpoints documentados em OpenAPI 3.1 e score de 0 a 100 por instância, além de eventos de desconexão com motivo. Rodamos whatsmeow, e R$ 59,90/mês com 3 dias grátis, sem cartão dá para ensaiar a migração inteira antes de pagar qualquer coisa.

Ensaie a migração sem cancelar nada

Crie uma instância, pareie um número de teste e valide a integração inteira em paralelo. 3 dias grátis, sem cartão.

Testar antes de migrar

Perguntas frequentes

Perco meu número ou meu histórico de conversa ao trocar de API de WhatsApp?

Não. O número é seu e o histórico das conversas fica na conta do WhatsApp, não no fornecedor. Ao migrar, você desconecta a sessão no fornecedor antigo e pareia o mesmo número no novo, e as conversas continuam lá. O que normalmente não migra é o que o fornecedor guardou por conta própria, como logs de envio, relatórios e a fila de mensagens agendadas. Se esses dados importam para você, exporte antes de cancelar.

Quanto tempo meu número fica fora do ar durante a migração?

A indisponibilidade real é a janela entre desconectar a sessão antiga e concluir o pareamento na nova, normalmente questão de minutos quando alguém está com o celular em mãos e o processo foi ensaiado. O que costuma esticar isso para horas não é a tecnologia e sim a organização: descobrir quem tem acesso ao aparelho, ajustar os webhooks e testar a integração já no ambiente novo. Ensaie em um número secundário antes de mexer no principal.

Trocar de API de WhatsApp reduz o risco de o número ser banido?

Praticamente não. As principais APIs não oficiais do mercado brasileiro rodam bibliotecas semelhantes e a detecção do WhatsApp é independente da implementação escolhida. O que muda o resultado é o padrão de uso: deixar o contato iniciar a conversa, controlar o ritmo de envio e evitar mensagem repetida em massa. Trocar de fornecedor sem mudar o comportamento tende a reproduzir o mesmo problema no fornecedor novo.

Vale a pena migrar só para economizar na mensalidade?

Só se a diferença anual superar com folga o custo de reescrever a integração e testar tudo de novo. Uma economia de trinta reais por mês são trezentos e sessenta reais por ano, o que pode ser menos que um dia de trabalho de desenvolvedor. Migração por preço faz sentido quando você opera vários números, porque a diferença é multiplicada, ou quando a troca resolve também alguma limitação técnica que já te incomodava.

Continue lendo

Quanto custa operar 3 ou 10 númerosA conta normalizada por instância, que é onde a economia de migrar aparece de verdade. Por que o WhatsApp bane números de APISe o motivo da troca é banimento, leia isto antes de migrar. API oficial vs não oficialQuando a migração certa não é para outro fornecedor não oficial, e sim para a Meta.

WhatsApp e Meta são marcas de seus respectivos donos, sem relação com a Wafly. Os preços de terceiros citados foram verificados na data indicada em cada tabela e mudam sem aviso: confira na fonte antes de decidir. Encontrou algo desatualizado ou discorda de alguma conclusão? Fale com a gente.