Migrar o número da clínica para a API oficial do WhatsApp

As regras abaixo são da documentação da Meta e da Central de Ajuda do WhatsApp, consultadas em 24/09/2026. Elas mudam, e cada uma tem o link.

Dois caminhos, e um terceiro para quem já está na API

No primeiro caminho, a coexistência, o aplicativo WhatsApp Business continua no celular da clínica e a API entra junto, no mesmo número. Até seis meses de conversas individuais passam para o sistema, e o que chega depois aparece nos dois lados. Nem todo provedor oferece: pela documentação da Meta sobre coexistência, ele precisa ser parceiro da Meta e ter o recurso ligado no cadastro dele. O que a coexistência muda no aplicativo está no artigo sobre o app e a API.

No segundo, a clínica apaga a conta do aplicativo e registra o número na API. Daí em diante, o número funciona só pelo sistema. É a regra geral da documentação da Meta sobre números: número em uso no WhatsApp só entra na API depois de apagado.

O terceiro vale para quem já está na API e quer trocar de provedor, a empresa que faz a ligação com a Meta. Os fornecedores chamam isso de "portabilidade", mas não tem relação com a portabilidade da operadora.

Caminho	Para quem	O aplicativo	O que fica
Coexistência	usa o app e quer manter o celular	continua no celular	até seis meses de conversas individuais no sistema
Apagar e registrar	usa o app e aceita deixá-lo	o número sai do app	o número; do histórico, só o que foi exportado
Trocar de provedor	já está na API	não se aplica	nome, limites e modelos aprovados

O que resolver antes do dia da troca

O celular do número, em nome da clínica. A Meta confirma que o número é da clínica antes de ligá-lo à API. Na coexistência, a confirmação passa pelo aplicativo no celular principal; no caminho de apagar e registrar, o código chega por SMS ou ligação. A Meta pede que o número seja da própria empresa. Por isso, vale ter a linha em nome da clínica; se está no CPF de alguém, resolva isso antes, como explica o artigo sobre o número perdido. Em linha fixa, o código vem por ligação, e a Meta pede para desligar o desvio de chamada e a URA, o atendimento eletrônico do "digite 1". Número bloqueado só entra depois do desbanimento, e esse caminho está no artigo sobre o WhatsApp bloqueado.

O portfólio da Meta em nome da clínica. A API fica num portfólio empresarial, o cadastro da empresa no Meta Business Suite, acessado com uma conta do Facebook. Ele precisa ser da clínica e ter o e-mail da clínica: é para esse e-mail que a Meta manda o link para desligar a verificação em duas etapas do número.

A verificação da empresa, quando for pedida. Desde maio de 2022, ela não é exigida para começar. Ela sobe o limite de pacientes alcançados fora da janela de 24 horas de 250 para 2.000 por dia, segundo a página de limites da Meta, e é exigida para trocar de provedor. A Central de Ajuda para Empresas pede a empresa registrada, um telefone ou endereço oficial e um código enviado ao telefone ou ao e-mail da empresa.

O nome de exibição. É o nome que o paciente vê no perfil. As diretrizes da Meta pedem relação clara com a razão social ou com o nome usado no site, sem as palavras "oficial" e "verificado" e sem frase de propaganda. Nome de pessoa vem junto com a atividade, como no exemplo da própria Meta, "Tom Ford Quiropraxia". Para uma clínica, algo como "Carla Lima Dermatologia".

Os modelos de lembrete aprovados. Na API, o lembrete da consulta marcada há dias só sai por modelo aprovado pela Meta, e a revisão pode levar até 24 horas. Aprovar antes evita que a agenda de amanhã fique sem lembrete. Os textos estão no artigo com modelos de lembrete.

Caminho 1: manter o aplicativo e ligar a API

Na coexistência, quem conduz é o provedor, pelo cadastro dele. A clínica precisa do aplicativo WhatsApp Business na versão 2.24.17 ou mais nova e do celular principal na mão. Pela documentação de coexistência, a sequência é esta:

1. No cadastro do provedor, escolher conectar a conta do aplicativo e informar o número.
2. Copiar o código que aparece na tela.
3. No aplicativo, abrir a mensagem da conta oficial do Facebook Business e tocar em Conectar.
4. Tocar no botão de conexão com a plataforma e depois em Confirmar, para compartilhar o histórico.
5. Colar o código e terminar o cadastro.
6. Deixar o aplicativo aberto enquanto as conversas são copiadas.

A Meta diz que a conexão e a cópia "podem levar vários minutos". O provedor tem 24 horas para copiar o histórico; se passar disso, a clínica refaz o cadastro.

Depois, os aparelhos conectados são desligados e podem ser conectados de novo, até quatro. Um detalhe pesa na recepção: a página lista o WhatsApp para Windows como incompatível. Pela nossa leitura, o computador do balcão passa para o WhatsApp Web, no navegador. A ligação cai se o celular principal ficar cerca de 14 dias sem uso, se o número for registrado em outro celular ou se alguém usar "Mudar número". E o paciente que escreveu pouco antes da conexão só recebe resposta por modelo aprovado, porque a janela de 24 horas da API só abre com mensagens que chegam depois. Para desfazer, o caminho fica no próprio aplicativo: Configurações > Conta > Plataforma empresarial > Desconectar.

Caminho 2: apagar a conta do aplicativo e registrar na API

Aqui a ordem importa, porque o primeiro passo não tem volta.

Exporte o que a clínica precisa guardar. Há fornecedor dizendo que o histórico fica no celular ou no backup. A Central de Ajuda do WhatsApp diz o contrário: apagar a conta apaga o histórico de mensagens e o backup da Conta do Google, e o WhatsApp não restaura nem transfere conversas de conta apagada. Para guardar uma conversa, use Exportar conversa, dentro de cada uma. O resultado é um arquivo de texto, que não volta para o WhatsApp: serve para consulta. Do lado do paciente, nada some, e a conversa com a clínica continua no celular dele.

Apague a conta no celular principal, em Configurações > Conta > Apagar minha conta. A mesma página avisa que a ação é irreversível, desconecta os aparelhos e tira a conta de todos os grupos.

Registre o número pelo cadastro do provedor. Pela documentação do cadastro, a clínica entra com a conta do Facebook, escolhe ou cria o portfólio e a conta do WhatsApp Business, informa o número e confirma o código recebido por SMS ou ligação. O nome de exibição e o perfil, com endereço e site, são preenchidos de novo. O registro exige um PIN de seis dígitos, a verificação em duas etapas da API. Guarde-o com quem é dono da clínica: ele é pedido para trocar o PIN ou tirar o número da API.

Pela nossa leitura dessas regras, entre apagar a conta e terminar o registro o número não atende pelo WhatsApp em lugar nenhum. A Meta não dá prazo para esse intervalo, então escolha um horário de pouco movimento. E não repita o registro à toa: a Meta limita as tentativas a 10 em 72 horas.

Se a clínica já está na API e quer trocar de provedor

A Meta documenta a migração entre provedores. O número muda de conta e mantém o nome de exibição, a nota de qualidade, o limite de mensagens, o selo de conta oficial e os modelos aprovados com boa qualidade. O registro no provedor novo é imediato; a cópia dos modelos leva um tempo, sem prazo publicado.

As exigências ficam do lado da clínica: portfólio verificado, conta do WhatsApp Business aprovada, forma de pagamento cadastrada e verificação em duas etapas desligada. Quem tem a conta no próprio nome desliga pelo Gerenciador do WhatsApp, com o link que chega ao e-mail do portfólio. Quem não tem depende do provedor atual para isso. É nessa hora que a clínica descobre em nome de quem ficou o portfólio.

O que se mantém e o que muda

O paciente não percebe a troca por fora: o número é o mesmo, o contato salvo continua valendo e as conversas antigas seguem no celular dele. A linha também continua recebendo ligação e SMS comuns, diz a documentação sobre números. O que muda está no uso da clínica.

	Coexistência	Apagar e registrar
Número e contato dos pacientes	mantém	mantém
Histórico da clínica	até seis meses de conversas individuais no sistema	só o que foi exportado
Aplicativo no celular	continua	o número sai do app
Grupos	ficam no app, fora do sistema	a conta sai de todos

No envio, valem as regras da API: a janela de 24 horas, os modelos aprovados e o limite inicial de 250 pacientes por dia fora da janela. O custo está no artigo sobre o custo da API.

O dia da troca na clínica

Pense na clínica dos nossos outros exemplos: quatro médicos, 24 consultas por dia e duas recepcionistas. Os lembretes das consultas de amanhã saem antes da troca, do jeito de sempre. Pela nossa leitura das regras da Meta, depois do registro na API nenhum paciente tem a janela de 24 horas aberta até escrever de novo, então o lembrete seguinte depende do modelo já aprovado.

A Júlia, uma das recepcionistas, fica com o celular do número, porque a confirmação passa por ele. A troca acontece no horário de menos movimento, e a outra recepcionista atende pelo telefone enquanto isso. Terminado o cadastro, alguém da equipe manda uma mensagem do próprio celular para o número da clínica e confere se ela chegou ao sistema. Na coexistência, é também a hora de conectar de novo os computadores da recepção.

Na Secretária V4, o número entra na implantação

A assistente virtual no WhatsApp que oferecemos atende pela API oficial, a conexão da própria Meta, no número que a clínica já usa. Se a clínica tem mais de um número, todos podem ser ligados, e a migração pode ser feita um de cada vez.

A implantação configura o WhatsApp oficial, o Painel com as contas da equipe e as mensagens aprovadas pela Meta para voltar a falar com o paciente depois de 24 horas. Ela leva de 5 a 15 dias, contados do pagamento e do envio dos dados, e o prazo depende de a Meta aprovar o número da clínica. Os cuidados deste artigo continuam valendo: linha em nome da clínica e o celular do número à mão. Você pode falar com a Maria no fim deste artigo, no papel de paciente.

Por onde começar

Hoje, descubra em nome de quem estão a linha e o portfólio da Meta. Esta semana, escolha o caminho com o provedor e preencha o checklist com a equipe, com quem faz cada passo e em que dia.