Portfólio, conta WhatsApp e conta de mensagens
| Ativo | Responsabilidade | Como reconhecer |
|---|---|---|
| Portfólio empresarial | Estrutura da empresa que possui ou administra ativos e acessos. | Business ID; não é o ID do telefone nem da conta de mensagens. |
| WhatsApp account (WAAC) | Identidade empresarial e número de telefone, que pode ser compartilhado com integrações autorizadas. | A interface pode mostrar a aba “Contas do WhatsApp” ou “WhatsApp accounts”. Não invente um WAAC ID a partir do telefone ou de outro ID. |
| Messaging account | Templates, configuração de pagamento, métricas e assinaturas de webhook. | Aba “Contas de mensagens” ou “Messaging accounts”. O campo legado waba_id continua identificando essa conta nas integrações compatíveis. |
| Phone Number ID | Identificador técnico do telefone usado pelas chamadas compatíveis da API. | É diferente do telefone escrito com DDD, do Business ID e do ID da conta de mensagens. |
A documentação antiga usa WABA para a conta que reunia essas funções. No novo modelo, não trate “WABA”, “WhatsApp account” e “Messaging account” como nomes intercambiáveis de um único ativo. Confira o rótulo, o ID e a função de cada objeto. Veja o mapa de credenciais e IDs.
Fonte oficial: Meta — Account Model Evolution. Conferida em 23/10/2026.
Conversão existente não é um novo onboarding
| Situação | O que a Meta documenta | O que não concluir sozinho |
|---|---|---|
| Conversão automática da WABA existente | A conta existente passa a ser uma conta de mensagens com o mesmo ID; dados como templates, perfis e pagamento são preservados na conversão. | Não é necessário reconectar ou trocar IDs apenas para acompanhar a mudança de nomes. |
| Novo onboarding padrão de parceiro | O fluxo padrão associa o telefone à conta WhatsApp e cria uma conta de mensagens por parceiro, retornada no campo waba_id. | Um ID diferente não prova perda de ativos nem erro de cadastro. Também não comprova que os templates de outra conta foram copiados. |
| Coexistência do WhatsApp Business App | É uma exceção: a conta existente é convertida em conta de mensagens compatível e compartilhada, mantendo seu ID; não é criada a conta específica por parceiro descrita para o fluxo padrão. | A opção aparecer na janela não prova que foi escolhida ou que o número era elegível. Não exclua a conta do aplicativo para tentar obter coexistência. |
A implementação é descrita pela Meta por etapas e pode apresentar diferenças de interface. O calendário ou o nome de uma conta não substituem a conferência dos ativos e da modalidade efetivamente concluída. A conexão no Flow continua passando pela janela oficial e pelas validações de autorização e rota.
Fonte oficial: Meta — conversão de contas; Meta — onboarding e coexistência. Conferida em 23/10/2026.
Já tenho BM, número ou conta cadastrada
Ter um portfólio/BM existente não é uma proibição geral de usar o Embedded Signup. A Meta permite escolher um portfólio e uma conta WhatsApp existentes quando disponíveis no fluxo. Existe uma restrição específica para contas WhatsApp originalmente criadas pelo aplicativo de desenvolvedor: elas não podem ser diretamente selecionadas/integradas pelo Embedded Signup. Não aplique essa restrição a todo cadastro prévio.
Quando o fluxo padrão retorna outro waba_id, compare o portfólio, o telefone, o Phone Number ID e as duas contas de mensagens. Não substitua o ID retornado pelo antigo no Flow ou no CRM e não repita a conexão às cegas para forçar um resultado.
O fluxo concede ao aplicativo o acesso previsto na integração. Compartilhamento manual com parceiro não é uma exigência universal; depende do modelo, do ativo e das permissões. Acesso a um telefone ou a uma conta não comprova autorização para outra. Nunca envie token, código de autorização, PIN ou segredo no chat.
Fonte oficial: Meta — Embedded Signup e limitações; Meta — onboarding no novo modelo. Conferida em 23/10/2026.
Templates permanecem na conta em que foram criados
Templates são ativos da conta de mensagens. Duas contas ligadas ao mesmo telefone ou portfólio não compartilham automaticamente o catálogo. Modelos presentes na conta original e ausentes na conta nova não comprovam, sozinhos, perda de dados ou falha da integração.
A Meta documenta criação separada ou cópia explícita pela Template Migration API. Essa operação recria modelos no destino; não move os originais. O guia exige contas pertencentes ao mesmo negócio Meta e templates APPROVED com qualidade GREEN ou UNKNOWN. Permissões de origem e destino e elegibilidade precisam ser conferidas; podem ocorrer falhas parciais.
Confira a conta correta antes de listar e sincronizar templates.
Fonte oficial: Meta — contas de mensagens; Meta — Template Migration API. Conferida em 23/10/2026.
Pagamento é conferido por conta de mensagens
Cada conta de mensagens tem sua configuração de pagamento. Um cartão cadastrado em outra conta de mensagens, na conta de anúncios ou na assinatura HookCloud não comprova que a conta usada no envio está pronta para a cobrança da Meta.
Na integração HookCloud, o cliente usa seu próprio método de pagamento na Meta; a HookCloud não oferece linha de crédito. Confirme a conta selecionada, o método e as pendências sem alterar a configuração de outra integração. Esta divisão de ativos não muda os preços ou o contrato da assinatura Flow. Veja onde conferir a cobrança da Meta.
Fonte oficial: Meta — separação das configurações de pagamento. Conferida em 23/10/2026.
Não use a migração clássica como solução automática
A documentação atual informa que a migração de telefone entre contas não é suportada para contas no novo modelo. O compartilhamento da conta WhatsApp proprietária permite acesso ao número; ele não equivale a mover o telefone nem a compartilhar todos os templates.
As instruções antigas de migração entre WABAs, incluindo duplicação de templates em modalidades elegíveis, não devem ser aplicadas automaticamente ao novo onboarding por parceiro. Desconectar o telefone não o torna disponível para outra conta. Uma transferência entre workspaces no Flow é um procedimento diferente.
Fonte oficial: Meta — limites da migração entre contas. Conferida em 23/10/2026.
Múltiplos parceiros, roteamento e CRMs
Compartilhar o número com outra integração pode afetar o encaminhamento das conversas. A Meta orienta conferir o roteamento no Meta Business Suite antes de atribuir outro parceiro: se ainda não houver configuração, essa atribuição pode criar a configuração inicial para uma conta elegível. Uma configuração existente não é substituída automaticamente por essa atribuição.
Quando o roteamento se aplica, as mensagens recebidas não são necessariamente entregues da mesma forma a todas as integrações. A Meta seleciona o responsável principal pela conversa; outras integrações podem depender de visibilidade de espera e de suporte específico para receber cópias ou responder. Os efeitos também podem aparecer quando uma conversa for encaminhada novamente.
Fonte oficial: Meta — preparação antes de atribuir outro parceiro. Conferida em 23/10/2026.
Como conferir uma diferença de IDs
- No Meta Business Suite, confirme o portfólio e identifique separadamente as abas de contas WhatsApp e contas de mensagens.
- Compare o mesmo telefone, Phone Number ID e IDs das contas original e retornada, sem usar apenas o nome.
- Abra templates e pagamento dentro da conta de mensagens correta. Estar no mesmo portfólio não prova que o token acessa ambas.
- Para uma dúvida técnica, informe IDs, etapa e horário aproximado no suporte privado. Reaproveite os dados já enviados; não inclua credenciais ou dados de terceiros.
Sem essa conferência, não é possível afirmar que houve duplicação indevida, migração clássica, coexistência ou compartilhamento completo. Veja como localizar as áreas no Manager.
Fonte oficial: Meta — ativos e IDs no onboarding. Conferida em 23/10/2026.
Fontes oficiais e revisão
Conteúdo conferido em 23 de outubro de 2026. A disponibilidade e a nomenclatura podem mudar; as páginas oficiais e o estado atual dos ativos orientam o diagnóstico.