Para registrar um número de telefone na WhatsApp Business API, confira se ele recebe um código por SMS ou chamada de voz, remova o número do app pessoal do WhatsApp, faça a verificação com esse código e envie uma solicitação de registro. Desde as mudanças de contas da Meta no segundo semestre de 2026, o número não sai do lugar quando você troca de parceiro. Basta dar acesso ao novo parceiro, e o histórico de conversas e a classificação de qualidade continuam como estão. Escolha o portfólio empresarial com cuidado no registro, porque um número não pode ser transferido para outro portfólio.
Principais conclusões
- Qualquer número que seja seu pode ser registrado se tiver código de país e código de área e receber um código por SMS ou chamada de voz.
- Um número que está no WhatsApp pessoal precisa ter essa conta apagada antes do registro, enquanto um número no app WhatsApp Business pode manter o app com a Coexistence.
- Cada grupo de números vinculados começa com dois números registrados, e a Meta aumenta o limite para 20 quando a empresa é verificada ou atinge um limite de mensagens de 2.000.
- Adicionar ou trocar de parceiro mantém o número, as conversas e a classificação de qualidade onde estão.
- A 360Dialog, Official Meta Solution Partner, registra números pelo Embedded Signup da Meta, onde o número é verificado com um código de uso único.
O que um número precisa ter antes do registro?
Um número se qualifica se for seu, tiver código de país e código de área, puder receber uma chamada de voz ou um SMS e atender à exigência da Meta de que ele tenha “capacidade de escala”.[1] Conferir esses quatro pontos antes ajuda a escolher um número que consiga concluir a verificação. Depois do registro, o número continua funcionando para chamadas e mensagens de texto comuns, enquanto o app pessoal do WhatsApp deixa de rodar nele.
A Meta classifica cada tipo de número pela confiabilidade com que ele recebe o código de verificação:
| Tipo de número | Código por SMS | Código por chamada de voz |
|---|---|---|
| Celular, o tipo recomendado pela Meta | Padrão | Padrão |
| Telefone fixo, número gratuito, número de tarifa premium, acesso universal, VoIP ou somente para chamadas recebidas | Não recomendado | Padrão |
| Custo compartilhado, número pessoal ou M2M/IoT | Não recomendado | Não recomendado |
| Pager | Sem suporte | Sem suporte |
Antes da verificação, libere chamadas e SMS internacionais na linha e desative o encaminhamento de chamadas e os menus de URA. Um número gratuito (0800) com URA também se qualifica se aceitar chamadas internacionais, colocar na lista de permissões o número ou os dois números que o WhatsApp usa para ligar e encaminhar o código para uma pessoa.
Um número banido precisa de um recurso aprovado antes do registro. Se você só precisa de um número de teste, as regras de elegibilidade definem se o Embedded Signup oferece um número +1 555 fornecido pela Meta.[2]
Seu número já está no WhatsApp? Como verificar
Envie uma mensagem de teste para o número a partir de qualquer celular, e o resultado mostra em qual dos quatro estados ele está: novo no WhatsApp, ativo no app pessoal, ativo no app WhatsApp Business ou já na API.[3] Esse estado define o caminho de integração.
| O que a mensagem de teste mostra | Estado atual | Caminho até a API |
|---|---|---|
| Um pop-up diz que o número não está no WhatsApp | Novo no WhatsApp | Registrar diretamente |
| A conversa abre com o aviso de criptografia de ponta a ponta | App pessoal do WhatsApp | Apagar a conta do WhatsApp no app ou escolher outro número |
| Um rótulo “Conta comercial” no perfil e uma mensagem amarela do sistema | App WhatsApp Business | Manter o app com a Coexistence ou apagar a conta do app e perder o histórico de conversas |
| Um aviso do sistema aparece na conversa | WhatsApp Business API | Já registrado; a troca de parceiro acontece por compartilhamento |
Um número ativo no app pessoal do WhatsApp não tem caminho de migração para a API. A conta precisa ser apagada no app antes que o número possa ser registrado.[4] Depois disso, o número pode levar até 3 minutos para ficar disponível, e as mensagens enviadas a ele nesse intervalo ficam na fila. Para um número no app WhatsApp Business, a WhatsApp Coexistence permite usar o app e a API no mesmo número, e o nosso guia mostra como configurar a Coexistence.
Como registrar um número novo, passo a passo
Registrar um número novo leva quatro ações: adicionar o número a uma WhatsApp account, solicitar um código de uso único, informar esse código e registrar o número para uso na API.[5] O Embedded Signup cobre as três primeiras, e o seu desenvolvedor só faz a última chamada à API.
Com a atualização de contas da Meta, a conhecida conta do WhatsApp Business (WABA) virou duas contas: uma WhatsApp account, que guarda um número de telefone, e uma Messaging account, que guarda os modelos, o faturamento e as assinaturas de webhook.[6]
- Adicione o número. Adicione o número, o código de país e o nome de exibição à WhatsApp account que fica sob a Messaging account. A Meta devolve um ID do número de telefone para as próximas chamadas.
- Solicite um código. Confira antes o
code_verification_status, porque uma solicitação para um número já verificado falha com o erro 136024. Depois, peça o código por SMS ou por chamada de voz. A chamada de voz é uma ligação automática em inglês que lê seis dígitos. - Verifique o código. Envie os dígitos de volta sem o hífen que aparece no SMS.
- Registre o número. Chame
POST /<PHONE_NUMBER_ID>/registercommessaging_productdefinido comowhatsappe umpinde seis dígitos.[7] A Meta permite 10 solicitações de registro por número em uma janela móvel de 72 horas. A 11ª solicitação retorna o erro 133016 e bloqueia o registro por 72 horas.
Um número adicionado e verificado no WhatsApp Manager também precisa dessa chamada à API para concluir o registro.
Registro pelo Embedded Signup com a 360Dialog
A 360Dialog, Official Meta Solution Partner, registra números de telefone comerciais para a WhatsApp Business API apenas pelo Embedded Signup.[8] Como o fluxo entra com o Login do Facebook, só um proprietário ou administrador do portfólio empresarial consegue concluí-lo. Essa pessoa informa o número, confirma o estado atual dele, aceita os termos da Meta, verifica o número, escolhe o portfólio empresarial e a WhatsApp account e revisa o que é compartilhado com a 360Dialog.
O fluxo atual da Meta pede o número de telefone primeiro, sem opção de adicioná-lo depois.[9] A versão mais recente é a v5, lançada em 20 de outubro de 2026, e o nosso artigo sobre as versões do Embedded Signup mostra o que mudou.[10] Um parceiro também pode pré-verificar um número, e aí você pula a etapa do código.[11] O nosso guia sobre como conseguir a aprovação da sua primeira WABA explica a análise da conta que vem depois do registro.
Clique em Começar a usar a API para registrar o seu primeiro número pelo Embedded Signup e enviar mensagens pela WhatsApp Business API.
Quantos números um portfólio empresarial pode registrar?
Um portfólio empresarial novo começa com dois números registrados em cada hierarquia de WhatsApp accounts, e a Meta pode aumentar esse limite para 20.[12] Uma hierarquia é um grupo de WhatsApp accounts vinculadas, e um portfólio pode ter 20 hierarquias no início. O limite mostra se a verificação da empresa precisa vir antes de um terceiro número entrar em um grupo.
A Meta aumenta o limite automaticamente em duas situações:
| Situação da empresa | Números registrados por hierarquia de WhatsApp accounts |
|---|---|
| Portfólio empresarial novo | 2 |
| Empresa verificada ou limite de mensagens de 2.000 atingido | 20 |
Quando o limite aumenta, a Meta envia uma notificação no Meta Business Suite e um webhook business_capability_update com o novo max_phone_numbers_per_business. O nosso guia de Meta Business Verification mostra a verificação passo a passo.
Como a portabilidade funcionava e o que a Meta mudou
Antes, a portabilidade significava transferir um número registrado entre duas contas do WhatsApp Business (WABAs) quando você trocava de provedor, reorganizava números ou passava para outro portfólio empresarial.[13] O novo modelo de contas da Meta acabou com essas transferências. Ele foi lançado a partir de 23 de setembro de 2026 e chegou a todas as empresas até meados de outubro de 2026. Hoje, a data de um guia de portabilidade mostra se os passos dele ainda valem.
No modelo anterior, um número migrado mantinha o nome de exibição, a classificação de qualidade, os limites de mensagens e os modelos de alta qualidade aprovados. A transferência exigia um nome de exibição aprovado, e os números de teste fornecidos pelo WhatsApp não podiam ser transferidos. Passar para outro portfólio empresarial também exigia que os dois portfólios estivessem verificados e que a verificação em duas etapas estivesse desativada, e os números da Coexistence ficavam de fora.[14]
A Meta agora recusa uma solicitação de transferência de número, a menos que a WhatsApp account de destino já seja dona dele, e desconectar o número da conta não o libera.[15] Portar um número da API do WhatsApp passou a significar que o número fica onde está e é compartilhado com cada parceiro que você adiciona. A troca para um novo provedor segue o mesmo caminho de compartilhamento.
Como reorganizar números dentro de um portfólio empresarial
Os números dentro de um portfólio empresarial são reorganizados no Meta Business Suite, onde as WhatsApp accounts são vinculadas a um grupo ou desvinculadas dele. Cada número continua conectado, com as conversas, durante a mudança. Assim, dá para reorganizar os números sem registrar nenhum deles de novo.
- No Meta Business Suite, abra Configurações > Contas > Contas do WhatsApp e selecione a conta principal do grupo. Depois, abra a aba Contas do WhatsApp vinculadas.
- Para tirar um número do grupo, escolha Desvincular número. O número vira uma hierarquia própria ou entra em outra hierarquia do mesmo portfólio.
- Para incluir outro número que seja seu, escolha Vincular conta do WhatsApp e depois Conta do WhatsApp existente.
Só um número conectado pode ser reorganizado, e quem faz a mudança precisa de permissão de gerenciamento de números de telefone nas duas hierarquias. Os parceiros de uma hierarquia acessam todos os números dela. Por isso, reorganizar um número muda quais parceiros podem usá-lo. Um número independente não pode entrar em uma hierarquia enquanto um parceiro o compartilha ou enquanto ele tem Messaging accounts próprias. Se essas opções ainda não aparecem, é porque a Meta está liberando a vinculação e a desvinculação aos poucos.
Observação: o número fica no portfólio empresarial escolhido no registro, porque um número não pode ser transferido para outro portfólio.
O que muda quando você adiciona um parceiro ao seu número
Adicionar um parceiro significa compartilhar a WhatsApp account do número com esse parceiro, enquanto o número, as conversas e a classificação de qualidade ficam onde estão. Dá para trazer um novo parceiro, ou trabalhar com dois ao mesmo tempo, sem registrar o número de novo nem pausar conversas.
Uma WhatsApp account pode ser compartilhada com até cinco Parceiros de Soluções, e o Embedded Signup cria uma Messaging account dedicada para cada um deles. O compartilhamento é cumulativo, e você decide se o parceiro anterior continua no número ou sai.
| Fica com o número | Separado para cada parceiro | Compartilhado por todos os parceiros do número |
|---|---|---|
| Número de telefone, histórico de conversas e classificação de qualidade; a verificação da empresa fica com o portfólio empresarial | Modelos, faturamento e assinaturas de webhook, guardados na Messaging account do parceiro | Taxa de transferência e limite de mensagens |
Os modelos não passam de uma Messaging account para outra. Um novo parceiro recria os modelos ou os copia com a API de Migração de Modelos (Template Migration API). Os modelos copiados recomeçam com a classificação de qualidade e o nível de mensagens zerados e levam cerca de duas a quatro semanas para ganhar volume.
O que acontece com o PIN da verificação em duas etapas
A Meta está aposentando o PIN de seis dígitos da verificação em duas etapas para os números elegíveis da Cloud API, e um número elegível não tem PIN nenhum. Abra o WhatsApp Manager para conferir o número. Se a aba Verificação em duas etapas não aparece, a mudança já chegou a esse número, e não há PIN para guardar nem gerenciar.
Para números elegíveis, a Meta ignora o PIN no registro e não cria um novo. A chamada de registro ainda precisa levar um pin válido de seis dígitos até a Meta anunciar uma mudança no contrato da API. Quando um segundo parceiro registra um número compartilhado, a chamada funciona sem redefinir o PIN.
Os números que ainda aguardam elegibilidade mantêm o comportamento antigo. Se um número desses não tem PIN, o valor de seis dígitos enviado no registro vira o PIN dele, e um PIN esquecido pode ser alterado no WhatsApp Manager.[16] Nenhum ponto de extremidade da API desativa a verificação em duas etapas.
Escolha um número que atenda aos requisitos da Meta e registre esse número no portfólio empresarial certo, e ele pode continuar com você enquanto os parceiros e os agrupamentos mudam. Clique em Começar a usar a API para registrar o seu número pelo Embedded Signup com a 360Dialog.
Perguntas frequentes
Um número de telefone fixo pode ser registrado na WhatsApp Business API?
Um telefone fixo pode ser registrado na WhatsApp Business API se receber o código de verificação por chamada de voz. A Meta classifica as linhas fixas como padrão para código por chamada de voz e não recomendadas para código por SMS. Antes da verificação, configure a linha para aceitar chamadas internacionais e desative o encaminhamento e qualquer menu de URA. Assim, a chamada automática chega a uma pessoa.
Um número da API do WhatsApp pode ser transferido para outro portfólio empresarial?
Não, um número da API do WhatsApp não pode ser transferido para outro portfólio empresarial no novo modelo de contas da Meta, que chegou a todas as empresas até meados de outubro de 2026. Dentro de um portfólio, a reorganização continua funcionando com a vinculação e a desvinculação de WhatsApp accounts no Meta Business Suite. Cada número continua conectado e mantém as conversas durante a mudança.
Posso manter meu número do WhatsApp ao trocar de BSP?
Sim, o número do WhatsApp continua o mesmo quando você troca de BSP. No modelo de contas da Meta, o novo parceiro recebe acesso à WhatsApp account do número, e o número fica onde está. As conversas e a classificação de qualidade continuam sem migração, e você decide se o parceiro anterior mantém o acesso.
O que acontece se o ponto de extremidade de registro for chamado vezes demais?
O ponto de extremidade de registro aceita 10 solicitações por número de telefone dentro de uma janela móvel de 72 horas. A 11ª solicitação retorna o erro 133016, e a Meta bloqueia o registro desse número pelas 72 horas seguintes. O ponto de extremidade de cancelamento de registro tem o mesmo limite e retorna o mesmo código de erro quando um número o ultrapassa.
Fontes
[1] Meta for Developers, “Business phone numbers,” https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers/ (updated May 21, 2026; accessed October 29, 2026).
[2] 360Dialog Docs, “Embedded Signup,” https://docs.360dialog.com/docs/hub/embedded-signup (accessed October 29, 2026).
[3] 360Dialog Docs, “Confirm Number details,” https://docs.360dialog.com/docs/hub/embedded-signup/confirm-number-details (accessed October 29, 2026).
[4] Meta for Developers, “Migrate an existing WhatsApp number to a business account,” https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account/ (updated June 16, 2026; accessed October 29, 2026).
[5] Meta for Developers, “Registering business phone numbers,” https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers/ (updated June 28, 2026; accessed October 29, 2026).
[6] Meta for Developers, “Updates to WhatsApp Business accounts,” https://developers.facebook.com/documentation/business-messaging/whatsapp/account-model-evolution (updated September 22, 2026; accessed October 29, 2026).
[7] Meta for Developers, “Register a business phone number,” https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/registration/ (updated October 27, 2026; accessed October 29, 2026).
[8] 360Dialog Docs, “Phone Numbers,” https://docs.360dialog.com/docs/resources/phone-numbers (accessed October 29, 2026).
[9] Meta for Developers, “Onboarding changes,” https://developers.facebook.com/documentation/business-messaging/whatsapp/account-model-evolution/onboarding/ (updated October 27, 2026; accessed October 29, 2026).
[10] Meta for Developers, “WhatsApp versioning,” https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/versions (updated October 28, 2026; accessed October 29, 2026).
[11] Meta for Developers, “Pre-verified phone numbers,” https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/pre-verified-numbers/ (updated October 27, 2026; accessed October 29, 2026).
[12] Meta for Developers, “WhatsApp accounts and Messaging accounts,” https://developers.facebook.com/documentation/business-messaging/whatsapp/whatsapp-business-accounts/ (updated August 5, 2026; accessed October 29, 2026).
[13] 360Dialog Docs, “Migrations,” https://docs.360dialog.com/docs/hub/migrations (accessed October 29, 2026).
[14] 360Dialog Docs, “Moving numbers between Business Portfolios,” https://docs.360dialog.com/docs/hub/migrations/moving-numbers-between-business-portfolios (accessed October 29, 2026).
[15] Meta for Developers, “Migrate a phone number via Embedded Signup,” https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup (updated May 21, 2026; accessed October 29, 2026).
[16] Meta for Developers, “Two-Step Verification,” https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification/ (updated June 28, 2026; accessed October 29, 2026).
