Quem já usa uma API de WhatsApp e pensa em trocar trava sempre na mesma dúvida: vou perder o meu número? vou ficar fora do ar? A resposta curta é não e sim. O número continua seu — o que muda é qual sistema está pareado com ele. A indisponibilidade existe, é curta, e o tamanho dela depende inteiramente do quanto você preparou antes de desconectar.
Migração de API assusta mais do que deveria porque a linguagem do mercado sugere posse: “meu número está na ferramenta X”. Não está. O número é uma linha de telefone com uma conta de WhatsApp em cima, e a ferramenta é apenas um aparelho conectado a essa conta — o mesmo lugar onde entra o WhatsApp Web. Trocar de API é desconectar um aparelho e parear outro.
O que segue é o roteiro honesto dessa troca: o que muda, o que se perde, quanto tempo o atendimento fica parado e como encolher esse tempo para poucos minutos. Sem prometer migração sem interrupção nenhuma, porque essa promessa não é verdadeira em canal nenhum.
Não. O número é da linha telefônica e a conta é do WhatsApp — nenhuma API se torna dona de nenhum dos dois. O que a sua API atual tem é um aparelho conectado à sua conta, exatamente como o WhatsApp Web tem. Ao migrar, você remove esse aparelho e conecta outro no lugar. O número, o nome do perfil, a foto e a lista de conversas seguem intactos.
Dá para conferir isso no seu próprio celular, agora, sem migrar nada. Abra o WhatsApp do número, vá em Aparelhos conectados e olhe a lista: a ferramenta que você usa hoje está ali, como um dispositivo. É esse item que sai, e é no lugar dele que o zapon entra quando você lê o QR Code no painel.
A consequência prática é boa: a migração não passa por aprovação de ninguém, não depende de liberar a portabilidade com o fornecedor atual e não exige que você peça permissão para sair. Você desconecta de um lado e conecta do outro, e a decisão é inteiramente sua.
As conversas não estão na API — estão no WhatsApp e no aparelho. Elas continuam lá depois da troca, visíveis no celular do número como sempre estiveram. O que não vem junto é o histórico que a sua ferramenta atual guardou no banco de dados dela: relatórios, etiquetas, painéis de atendimento e logs de mensagens são dados daquele sistema, e saem com ele.
Vale separar as três coisas, porque elas se confundem na hora do medo:
| O que é | Onde vive | Depois da migração |
|---|---|---|
| Conversas do WhatsApp | No WhatsApp e no aparelho do número | Continuam existindo, intactas |
| Registro de mensagens da sua API atual | No banco daquele fornecedor | Não migra — exporte antes se precisar |
| Mensagens gravadas pelo seu sistema | No seu banco de dados | Continuam suas, não dependem de API |
Se o registro guardado pelo fornecedor atual importa para você — por auditoria, por conferência de venda, por obrigação de guarda —, exporte antes de encerrar a conta lá. Depois do cancelamento, esse pedido costuma virar suporte, e suporte de quem está perdendo cliente é o mais lento que existe.
Nova conexão começa sem histórico próprio de mensagens: o zapon passa a registrar do momento da conexão em diante, e é por isso que o seu sistema gravar o que passa pelo webhook é a única garantia real de continuidade. O que está no seu banco é seu em qualquer fornecedor.
O tempo entre desconectar o aparelho da sua API atual e o número aparecer conectado no painel do zapon — na prática, alguns minutos, e não mais que isso se você chegou preparado. Não existe migração com zero interrupção: um número só está pareado com um sistema por vez, então há um intervalo em que nenhuma automação está no comando. O que dá para fazer é encolher esse intervalo até ele caber em uma pausa do expediente.
Durante essa janela, três coisas acontecem. Mensagens que chegam continuam chegando ao WhatsApp — elas não somem, ficam na conversa. O que não acontece é o disparo automático: nada é enviado pela API e nenhum evento é entregue ao seu webhook enquanto o número não está conectado do lado de cá. E o chatbot, obviamente, não responde nesse intervalo.
A janela cresce quando você improvisa. Ela vira meia hora se, no meio da troca, você descobrir que precisa criar conta, achar o cartão, decidir a URL do webhook e reescrever o header de autenticação. Todo esse trabalho é preparável — e feito antes, com um número secundário, a troca do número principal fica reduzida a: remover o aparelho antigo, ler um QR Code, testar um envio.
Três coisas, e todas ficam em um arquivo de configuração se o seu código estiver bem organizado: o endereço base das chamadas passa a ser https://api.zapon.dev; a autenticação passa a ser o header token com o token daquela conexão, sem Authorization e sem OAuth; e a URL que recebe os eventos é reapontada no painel, na tela da conexão, marcando quais dos 38 eventos você quer receber.
O corpo das requisições muda de nomes e de formato — cada API tem o próprio contrato, e não existe compatibilidade automática entre fornecedores. O envio de texto do zapon é um POST para /chat/send/text com Phone e Body, e a resposta traz o identificador da mensagem:
curl -X POST https://api.zapon.dev/chat/send/text \
-H "token: SEU_TOKEN_DA_CONEXAO" \
-H "Content-Type: application/json" \
-d '{
"Phone": "5511999999999",
"Body": "Olá! Sua consulta está confirmada para amanhã às 14h."
}'O token identifica um número, não a sua conta: cinco números conectados são cinco tokens, isolados entre si. O telefone vai só com dígitos, com código do país e DDD (5511999999999), sem sinal de mais, espaço ou parêntese. São 49 endpoints no total — 23 de conversa, 18 de grupo e 8 de conta —, e o contrato inteiro está na documentação.
Do lado do recebimento, o webhook é um por conexão: você informa uma URL pública que aceite POST e responda rápido. Se o seu fluxo hoje já roda em n8n, em Make ou no seu próprio backend, quase sempre é a mesma URL — muda quem chama e muda o formato do corpo, não o endereço. Reapontar antes de desconectar o antigo é o que mantém a janela curta.
A ordem abaixo foi montada para uma coisa só: manter o número principal produzindo até o último minuto e só tocar nele quando todo o resto já estiver testado e funcionando.
https://api.zapon.dev. Troque o header de autenticação pelo header token com o token dessa conexão de teste e ajuste os nomes dos campos.Repare que a única etapa que envolve o número principal é a sexta, e que ela dura o tempo de ler um QR Code. Tudo o que costuma dar errado em migração — formato de payload, autenticação, webhook mudo — foi descoberto antes, num número que ninguém está usando para vender.
Consegue, e é exatamente assim que a migração deve ser feita. O teste é de 14 dias, sem cartão de crédito, e a contagem só começa quando o primeiro número conecta — criar a conta hoje não gasta dia de trial. Conecte um número secundário, refaça a integração inteira nele e só encoste no número de produção quando não houver mais nenhuma dúvida técnica.
Usar um número secundário resolve o problema que assusta: você não precisa escolher entre “continuar como está” e “apostar tudo na troca”. Durante o teste, a sua operação segue rodando na ferramenta atual, sem interrupção nenhuma, enquanto a nova integração amadurece em paralelo.
Se você não tem um número sobrando, um chip pré-pago barato resolve — e continua útil depois, como número de homologação para toda mudança futura no seu fluxo. É o investimento mais barato de qualquer migração.
Não automaticamente — e nenhum fornecedor sério promete o contrário, porque não existe formato comum entre APIs de WhatsApp. Contatos você recadastra (ou importa do seu próprio banco, que é onde eles deveriam estar). Fluxos e chatbot são remontados. O que atravessa a troca sem esforço é o que já era seu: o número, as conversas no aparelho e os dados no seu sistema.
| Item | Migra? | Como fica |
|---|---|---|
| O número de WhatsApp | Sim | Continua seu; troca só o aparelho pareado |
| Conversas no aparelho | Sim | Ficam no WhatsApp, não na API |
| Perfil, foto e nome | Sim | São da conta de WhatsApp |
| Contatos | Reconfiguração | Recadastro, ou importação do seu banco |
| Chatbot e fluxos | Reconfiguração | Remontados no painel ou pela IA |
| Mensagens antigas da API | Não | Ficam no fornecedor atual; exporte antes |
| Token de autenticação | Não | Cada conexão tem o próprio token |
Encare a lista de reconfiguração como oportunidade, não como prejuízo. Fluxo que foi crescendo por remendo durante dois anos raramente merece ser copiado linha a linha: a migração é a chance de refazer só o que ainda é usado e aposentar o resto.
Reconstruir, sim; programar, não. O chatbot do zapon é montado no painel por uma entrevista guiada — nome do assistente, primeira mensagem, quais botões o cliente vê e o que cada botão faz —, sem escrever código e sem desenhar diagrama. Quem preferir pode pedir a mesma coisa a um assistente de IA pelo conector MCP, descrevendo o atendimento em português comum.
Na prática, chegue à migração com o desenho do seu atendimento em mãos: quais opções o cliente vê, para onde cada uma leva, quando entra uma pessoa. Com isso escrito, remontar leva minutos, e a estrutura de menus com botões cobre o que a maioria dos atendimentos por WhatsApp realmente faz. Os detalhes estão em chatbot de WhatsApp com menus.
Antes de ligar, use o simulador nos caminhos que quebram bot na vida real: a resposta que não bate com botão nenhum, o pedido de falar com um humano, a mensagem que chega fora do horário. É o teste que evita a estreia constrangedora com cliente do outro lado — e ele cabe inteiro no número secundário, antes da troca.
São R$ 27 por mês por número conectado, sem cobrança por mensagem, sem taxa de setup e sem fidelidade — o pagamento é por cartão, via Stripe. Cada número tem uma cota de 300 mensagens por dia, cerca de 9.000 por mês; acima disso a chamada é recusada com HTTP 429, e o painel avisa em 80%, 90%, 95% e 100% do consumo.
Há uma diferença de comportamento que costuma surpreender quem vem de outra ferramenta, e é melhor saber antes: entre um envio e o seguinte existe uma pausa aleatória de 8 a 20 segundos, cumprida pelo próprio servidor. Você não implementa nada; a chamada simplesmente aguarda o tempo que falta antes de sair.
Isso muda o cálculo de qualquer rotina que hoje dispara em rajada. Se o seu fluxo atual manda cinquenta mensagens em dois segundos, aqui ele vai levar por volta de dez minutos — de propósito. A pausa é uma das travas que protegem o número de parecer robô, e ela não é configurável. Vale medir isso ainda no número de teste, no passo cinco do roteiro.
Você faz o caminho inverso, com o mesmo esforço: remove o aparelho do zapon na tela de aparelhos conectados do WhatsApp e reconecta o número na ferramenta que você usava. O número continua sendo seu em qualquer cenário, e não há fidelidade nem multa para sair — assinatura mensal, cancelável quando você quiser.
Duas precauções tornam a volta trivial, e ambas custam nada: não cancele a conta do fornecedor atual no mesmo dia da troca — espere as primeiras 48 horas de operação — e guarde a integração antiga no seu repositório atrás de uma configuração, em vez de apagar o código. Reverter vira trocar uma variável.
Se você cancelar o zapon e voltar depois, a configuração é preservada: mesmo em corte por inadimplência, o número, o chatbot e o webhook voltam ao pagar, com o mesmo token. Você não recomeça do zero por ter parado.
Uma parte de quem procura trocar de API está, na verdade, procurando resolver outra coisa: número que levou bloqueio, entrega que caiu, cliente que denunciou. Trocar de fornecedor não conserta isso sozinho, porque o que o WhatsApp avalia é o comportamento do número — para quem você escreve, com que frequência, e quantos marcam a sua mensagem como indesejada.
Não. O número é da sua linha telefônica e a conta é do WhatsApp; a API é apenas um aparelho conectado a essa conta. Migrar é remover um aparelho e parear outro no lugar, e o número, o perfil e as conversas seguem exatamente onde estão.
As conversas ficam no WhatsApp e no aparelho, então continuam lá depois da troca. O que não vem junto é o registro que a sua ferramenta atual guardou no banco dela — relatórios, etiquetas e logs são dados daquele sistema. Se precisar deles, exporte antes de encerrar a conta.
O intervalo entre desconectar o aparelho da ferramenta atual e o número aparecer conectado no painel — alguns minutos, quando você chega preparado. Não existe migração sem janela nenhuma, porque um número fica pareado com um sistema por vez; o que dá para fazer é encolher esse intervalo escolhendo o horário e deixando tudo testado antes.
Não. Para quem está do outro lado nada muda: mesmo número, mesmo nome, mesma foto e mesma conversa. A troca é invisível para o cliente, salvo pelo tempo em que a automação ficar parada — e por isso a janela é escolhida em horário de baixo movimento.
Não recomendamos. Mesmo quando o WhatsApp aceita mais de um aparelho conectado, dois sistemas automáticos no mesmo número disputam os mesmos eventos e produzem resposta duplicada, que é pior do que ficar minutos fora do ar. A forma segura de rodar em paralelo é usar um número secundário para o teste.
Precisam ser recadastrados, ou importados do seu próprio banco de dados, que é onde eles deveriam estar. Não existe formato comum entre APIs de WhatsApp, então nenhuma migração de contatos é automática entre fornecedores diferentes.
Consegue, pelo caminho inverso: remove o aparelho do zapon nos aparelhos conectados do WhatsApp e reconecta o número onde estava. Não há fidelidade nem multa, a assinatura é mensal, e o número continua sendo seu em qualquer cenário.
Não há taxa de setup nem custo de migração. O teste é de 14 dias sem cartão, contado a partir da primeira conexão, e depois são R$ 27 por mês por número conectado, sem cobrança por mensagem. O pagamento é por cartão, via Stripe.
14 dias grátis, sem cartão — a contagem só começa na primeira conexão. R$ 27 por mês por número, sem cobrança por mensagem.