Guia definitivo para migrar seu número do WhatsApp para a API oficial sem perder entregabilidade

Migrar número do WhatsApp para a API oficial é uma decisão de infraestrutura, atendimento e receita. Para uma clínica, o número concentra leads de campanhas, confirmações, dúvidas, pedidos de orçamento e conversas que ainda podem virar agendamentos. Uma transição mal coordenada pode deixar pacientes sem resposta justamente nos horários de maior procura.

A API oficial do WhatsApp Business Platform permite estruturar mensagens automatizadas dentro das regras da Meta, com uso de modelos aprovados, gestão de qualidade e conexão a sistemas de atendimento. Ela não funciona como uma exportação integral do aplicativo: o histórico, os contatos, as permissões e os fluxos precisam ser tratados em frentes separadas.

Os riscos mais frequentes são perda de continuidade no atendimento, indisponibilidade temporária, mensagens enviadas pelo canal errado, duplicidade de respostas e falha na atualização de agenda. Também existe risco comercial quando a clínica migra sem definir quem será responsável por templates, qualidade do número, incidentes e recuperação de leads.

A Meta exige que as empresas observem políticas de uso, consentimento e qualidade das mensagens. Consulte a Política do WhatsApp Business antes de aprovar a arquitetura e os roteiros da migração.

O critério de sucesso não é apenas o número aparecer conectado. A migração deve preservar quatro resultados: o paciente consegue iniciar contato, a equipe identifica a origem da conversa, a agenda recebe dados corretos e os leads em aberto continuam sendo acompanhados.

A expressão DNS costuma aparecer na preparação da API, mas ela não significa que o número será transferido por uma alteração no domínio. DNS organiza a identidade técnica do domínio, enquanto a migração envolve a conta empresarial da Meta, o número de telefone, o provedor oficial e os eventos de mensagens.

Peça ao fornecedor uma lista escrita de registros necessários, finalidade de cada registro e responsável pela publicação. Não entregue acesso irrestrito ao domínio quando uma permissão limitada ou uma alteração acompanhada pelo time de TI puder atender ao requisito.

A verificação de empresa e a configuração de metadados devem refletir a razão social, o nome exibido ao paciente e o site utilizado pela clínica. Divergências entre esses dados podem atrasar a aprovação ou gerar dúvidas no suporte, especialmente em grupos hospitalares com várias unidades.

Na integração, valide o caminho completo: mensagem recebida, identificação do paciente, criação ou atualização do contato, consulta de disponibilidade, reserva do horário, confirmação e registro do evento. Para aprofundar essa etapa, use o checklist técnico de sincronização entre IA, prontuário e agenda.

Uma clínica que atende em Feegow ou Amplimed deve testar regras de unidade, profissional, procedimento, convênio e duração. A integração precisa impedir que dois pacientes recebam o mesmo horário e deve registrar quando uma tentativa de agendamento falhar, em vez de apresentar uma confirmação sem reserva efetiva.

O contrato de dados também merece atenção. Defina nomes de eventos, campos obrigatórios, formato de telefone, fuso horário, política de retentativa e comportamento quando a agenda ficar indisponível. O guia de contrato de dados e taxonomia de eventos para integrar IA ao prontuário ajuda a transformar essa discussão em uma especificação verificável.

O histórico de conversas é um ativo operacional, mas a capacidade de preservá-lo depende do provedor anterior, do produto utilizado e do formato de exportação disponível. Antes da mudança, solicite uma cópia dos dados e defina quais informações precisam permanecer acessíveis para auditoria, atendimento e recuperação de pacientes.

Nem todo histórico precisa ser exibido dentro da nova caixa de entrada para continuar útil. Uma planilha protegida, um arquivo estruturado ou a importação de campos essenciais pode preservar contexto, desde que a clínica controle acesso, retenção e finalidade conforme a Lei Geral de Proteção de Dados Pessoais.

O conjunto mínimo de leads deve incluir telefone em formato padronizado, nome, data do último contato, origem, especialidade, unidade, estágio, profissional desejado e próxima ação. Para conversas em andamento, acrescente um resumo aprovado pela equipe, sem copiar informações clínicas desnecessárias.

Mantenha um fallback operacional durante a virada. O número antigo pode permanecer sob observação pelo período acordado, com aviso interno para que ninguém responda simultaneamente por duas plataformas ou continue disparando mensagens pelo canal desativado.

A entregabilidade depende mais do comportamento da base do que de um aumento repentino de volume. Faça aquecimento operacional, envie para contatos com expectativa legítima de comunicação, retire destinatários que pedem para não receber mensagens e acompanhe sinais de qualidade antes de ampliar o tráfego.

A clínica também precisa distinguir falha de entrega, falta de resposta e recusa do paciente. Esses eventos alimentam decisões diferentes: revisar template, trocar o horário do contato, transferir para humano ou encerrar a sequência. O guia para recuperar pacientes que pararam de responder complementa essa rotina sem confundir reengajamento com envio indiscriminado.

A proposta comercial deve explicar quem administra a conta empresarial da Meta, quem é o titular do número e o que acontece se a clínica encerrar o contrato. Evite depender de uma conta controlada exclusivamente pelo fornecedor, pois a saída precisa preservar os ativos digitais e a capacidade de continuidade.

Inclua uma cláusula de portabilidade operacional. Ela deve prever entrega de contatos autorizados, templates, configurações documentadas, logs necessários, estágios do CRM e apoio técnico para desligamento ou transferência, sempre dentro dos limites impostos pela Meta e pela legislação de proteção de dados.

O SLA deve separar indisponibilidade da plataforma, atraso de integração, falha de agenda e incidente relacionado ao provedor oficial. Para cada evento, estabeleça canal de acionamento, prazo de reconhecimento, prazo de atualização e procedimento de contingência.

Também peça transparência sobre qualidade do número, limites de envio, rejeição de templates, denúncias e alterações de política. O fornecedor não controla todas as decisões da Meta, portanto a cláusula deve exigir diligência, comunicação e plano de resposta, sem prometer imunidade a bloqueios.

A responsabilidade por conteúdo precisa ser compartilhada de forma objetiva. A clínica aprova orientações, templates e regras de escalonamento; o fornecedor documenta a configuração, mantém registros técnicos e sinaliza riscos identificados durante a operação.

Antes de assinar, confira o checklist de cláusulas contratuais e SLA para plataformas de atendimento com IA em clínicas e use testes de aceite com critérios objetivos, como os descritos no checklist de aceitação contratual antes do go-live.