whatsapp-docs-mcp 1.0.0

package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_programmatically.md

@@ -0,0 +1,292 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-programmatically -->
+<!-- Scraped: 2025-12-20T17:54:05.156Z -->
+
+# Como migrar um número de telefone comercial entre Parceiros de Soluções de forma programática
+
+Updated: 14 de nov de 2025
+
+Este documento descreve como os parceiros de soluções podem migrar números de telefone comerciais de um parceiro de soluções e Conta do WhatsApp Business (WABA) para outro parceiro de soluções e WABA usando a API. Siga este método somente se você for trabalhar com o cliente empresarial usando o modelo "em nome de" (ou seja, você criará e terá a propriedade da WABA de destino, bem como dos respectivos ativos e os compartilhará com o cliente).
+
+Para migrar números de telefone de clientes via cadastro incorporado (recomendado), consulte o documento [Como migrar números de telefone entre contas comerciais do WhatsApp via Cadastro incorporado](/docs/whatsapp/business-management-api/guides/migrate-phone-to-different-waba).
+
+## Visão geral
+
+Os parceiros de soluções e as empresas integradas à plataforma do WhatsApp Business podem migrar um número de telefone registrado de uma WABA para outra. Os números de telefone migrados mantêm o nome de exibição, a classificação de qualidade, o [limite de mensagens](/documentation/business-messaging/whatsapp/messaging-limits), o status de [conta comercial oficial](/documentation/business-messaging/whatsapp/official-business-accounts) e os modelos de mensagem de [alta qualidade](/documentation/business-messaging/whatsapp/templates/template-quality) aprovados anteriormente.
+
+Na prática, migração significa que uma empresa pode manter o mesmo número de telefone nos seguintes casos:
+
+-   Estiver usando a plataforma com um dos nossos parceiros de soluções **e** quiser mudar para um fornecedor diferente.-   Estiver usando uma implementação própria **e** quiser mudar para um parceiro de solução.
+
+Apenas os parceiros de soluções e as empresas integradas à plataforma do WhatsApp Business podem realizar a migração de números de telefone.
+
+O processo de migração envolve três ativos principais:
+
+Uma WABA de origem
+
+Um número de telefone
+
+Uma WABA de destino
+
+A conta em que o número de telefone está registrado atualmente.
+
+O número que será migrado.
+
+A conta para a qual o número será migrado.
+
+A migração de telefone sempre é iniciada pelo parceiro de solução ou pela empresa proprietária da WABA de destino.
+
+As WABAs são contas criadas dentro de uma empresa no Gerenciador de Negócios. Cada empresa tem uma identificação, também conhecida como identificação do Gerenciador de Negócios.
+
+Tanto as WABAs de origem como as de destino podem ser associadas às empresas de duas maneiras diferentes:
+
+![Image](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/565331603_1339318201260164_1404407423147875823_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=g34bcUe4m9EQ7kNvwF5Fyyc&_nc_oc=Adljwtf0Sy4UTwfer__yq7p34lD3NgdkWzw5sCYtTX4Gd7lVQAwJ0JMTeCT2W-qOVUU&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=T-HBdH4Dd1Gv1OheB98BCQ&oh=00_AflRZJAEKKmhE8Rf6Mqyfmwjnp_63STpfGnjlo634ZHIaw&oe=696109DC)
+
+![Image](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/561215785_1339318267926824_6000455041075810602_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=lpxDa0xzna4Q7kNvwGw8Mcd&_nc_oc=Adkm86-HBqpKUi3TAdl-p67StscAMe2p8WKm1X2Yoadvc-tRL8kAWduXzD_cX8QUGuw&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=T-HBdH4Dd1Gv1OheB98BCQ&oh=00_AfnnVTtVQPXiSykswxVnAT-eED7gYkqePDNisFo_UYGoEw&oe=69612C3A)
+
+### Como funciona a migração
+
+#### Inatividade
+
+A API não é compatível com a migração em massa. Os números de telefone comercial precisam ser migrados individualmente.
+
+#### Modelos de mensagem
+
+Todos os modelos de mensagem de [alta qualidade](/documentation/business-messaging/whatsapp/templates/template-quality) na WABA de origem serão duplicados e automaticamente aprovados na WABA de destino desde que a WABA de destino possa acomodar novos modelos. Isso não afetará os modelos de mensagem existentes na WABA de destino. Os modelos de baixa qualidade, rejeitados ou pendentes não serão duplicados.
+
+Os modelos duplicados serão sujeitos às verificações das [Diretrizes de Categorização de Modelos](/documentation/business-messaging/whatsapp/templates/template-categorization) para garantir a categorização correta. Com isso, alguns dos modelos duplicados poderão ser `REJECTED`.
+
+Se a WABA de destino não conseguir acomodar todos os novos modelos, duplicaremos o maior número possível até que o limite de modelos da WABA de destino seja atingido. Para que a WABA de destino possa usar os modelos não duplicados, eles precisarão ser recriados e enviados para aprovação.
+
+As classificações de qualidade dos modelos **NÃO** serão migradas. Todos os modelos migrados terão a classificação inicial definida como `UNKNOWN`. Essa classificação será mantida nas **primeiras 24 horas**. Após esse período, uma nova classificação será gerada se houver dados suficientes disponíveis.
+
+#### Migração de cobrança
+
+As mensagens enviadas antes da migração serão cobradas da empresa de origem. As mensagens enviadas após a migração serão cobradas da empresa de destino. As mensagens enviadas da fonte e não entregues antes da migração ainda serão cobradas da empresa de origem quando forem entregues.
+
+#### Limites de volume
+
+Os [limites de volume padrão da Graph API](/docs/graph-api/overview/rate-limiting) se aplicam à migração.
+
+#### Limitações
+
+-   Os números de telefone comerciais de teste emitidos pelo WhatsApp não podem ser migrados.
+    -   Os números de telefone comercial em uso com o app WhatsApp Business não podem ser migrados usando esse processo. Para migrar um número do app WhatsApp Business, consulte [Como migrar um número existente para a API Local](/docs/whatsapp/on-premises/get-started/migrate-existing-whatsapp-number-to-a-business-account) e [Como migrar um número existente para a API de Nuvem](/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account).
+    -   O histórico de mídias e mensagens não será migrado se a WABA de origem ou de destino estiver na API Local. Se as WABAs de origem e de destino estiverem na API de Nuvem, as identificações de mídia e de mensagem carregadas poderão continuar a ser usadas.
+    -   A API não é compatível com a migração em massa. Os números de telefone comercial precisam ser migrados individualmente.
+    -   Os números de telefone comerciais devem ter um nome de exibição aprovado (`name_status` é `APPROVED`).
+    -   Os números de telefone comerciais não podem ter solicitações pendentes de alteração do nome de exibição.
+    -   As classificações de qualidade dos modelos **NÃO** serão migradas. Todos os novos modelos migrados iniciarão com a classificação `APPROVED`, e a nova classificação de modelos migrados será determinada usando dados das últimas 24h.
+    
+
+#### Resumo
+
+  
+
+Migram:
+
+-   Nome de exibição-   Classificação de qualidade do número de telefone-   Limites de mensagem-   Status de conta comercial oficial-   Todos os modelos de mensagem de qualidade alta aprovados anteriormente
+
+Não migram:
+
+-   Modelos de mensagem de baixa qualidade, rejeitados ou pendentes.-   Classificação de qualidade do modelo
+
+## Antes de começar
+
+Para se qualificarem para migração, os ativos de uma empresa precisam cumprir os seguintes critérios:
+
+Ativo
+
+Requisitos para migração
+
+Número de telefone
+
+-   Deve estar registrado na WABA de origem.-   Caso a confirmação em duas etapas tenha sido habilitada para o número em questão, o proprietário da WABA de origem precisará [desabilitá-la](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#disabling-two-step-verification).
+
+O dono do número de telefone é responsável por entrar em contato com o dono da WABA de origem.
+
+WABA de origem
+
+-   Deve ter a verificação da empresa concluída e aprovada.-   O status de análise da WABA deve ser `Approved`.
+
+WABA de destino
+
+-   É necessário ter a Verificação de Negócios e a análise da WABA concluída e aprovada.-   É preciso ter uma [forma de pagamento](https://www.facebook.com/business/help/1684730811624773) definida.
+
+Webhooks
+
+**Somente números de telefone na API de Nuvem**  
+Pelo menos um app deve estar inscrito no webhook para a WABA de destino. Consulte [Webhooks na API de Nuvem](/documentation/business-messaging/whatsapp/webhooks/overview).
+
+### Permissões
+
+Todas as chamadas de API para migração de telefone devem ser feitas com um app que tenha a permissão `whatsapp_business_management`. Consulte a seção sobre [como usar a API de Gerenciamento do WhatsApp Business](/documentation/business-messaging/whatsapp/get-started) para saber mais sobre a análise do app, tokens de acesso e como fazer chamadas de API. A migração de telefone sempre é iniciada pelo parceiro de solução ou pela empresa proprietária da WABA de destino.
+
+### Como preparar a WABA de destino
+
+O tipo de WABA de destino determina o que precisa ser feito para que a conta esteja pronta para migração:
+
+Tipo de WABA
+
+Considerações para parceiros de soluções que fazem migração
+
+WABA existente
+
+Confirme se a WABA existente (de destino) tem uma forma de pagamento configurada.
+
+Se a WABA de origem estiver na API de Nuvem, verifique se pelo menos um app assinou os webhooks para a WABA de destino.
+
+Nova WABA criada por um parceiro de solução para enviar mensagem a clientes
+
+Ao criar uma nova WABA no Gerenciador de Negócios, um parceiro de solução deve fazer o seguinte:
+
+-   Inserir o nome de uma conta para o cliente (Nome da WABA)-   Selecionar uma [forma de pagamento](https://www.facebook.com/business/help/1684730811624773?id=2129163877102343)-   Selecionar **Conta do cliente** no campo **Enviando mensagens em nome de**-   Inserir a identificação do Gerenciador de Negócios do cliente. Consulte [Como encontrar a identificação da empresa no Gerenciador de Negócios da Meta](https://www.facebook.com/business/help/1181250022022158?id=180505742745347).
+
+Os parceiros de soluções podem então instruir os clientes a aceitar a solicitação de **Enviando mensagem em nome de** enviada para o Gerenciador de Negócios. Para orientar os clientes, consulte [Criar conta do WhatsApp Business com provedores de soluções de negócios do WhatsApp: Approve messaging on behalf of your business](https://www.facebook.com/business/help/524220081677109). Assim que a solicitação for aceita, a WABA de destino estará pronta para a migração de telefone.
+
+Se a WABA de origem estiver na API de Nuvem, verifique se pelo menos um app assinou os webhooks para a WABA de destino.
+
+Nova WABA criada por um cliente e compartilhada com um parceiro de solução via cadastro incorporado
+
+Esse tipo de WABA é criado assim que um cliente passa pelo fluxo de cadastro incorporado no site do parceiro de solução. Para orientar os clientes, consulte [Como criar conta do WhatsApp Business com provedores de soluções de negócios do WhatsApp: cadastro incorporado](https://www.facebook.com/business/help/524220081677109). Durante o fluxo de cadastro incorporado, instrua o cliente a fazer o seguinte:
+
+-   Selecionar a empresa que é dona da sua WABA existente-   Não adicionar um número de telefone por meio do fluxo de cadastro, pois vamos usar a API de migração para isso. Os clientes podem concluir o fluxo de cadastro incorporado depois de criarem a conta do WhatsApp Business.
+
+Use APIs de cadastro incorporado para [obter a WABA criada pelo cliente](/documentation/business-messaging/whatsapp/solution-providers/manage-accounts#get-list-of-shared-wabas), [adicionar usuários do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) e [configurar uma forma de pagamento para a WABA](/documentation/business-messaging/whatsapp/solution-providers/share-and-revoke-credit-lines#sharing-your-credit-line).
+
+Como a WABA já foi compartilhada com o parceiro de solução, ela está pronta para a migração de telefone. **Lembrete:** a migração só acontecerá se a empresa do cliente tiver concluído o processo de verificação.
+
+Se a WABA de origem estiver na API de Nuvem, verifique se pelo menos um app assinou os webhooks para a WABA de destino.
+
+### Exclusão da WABA de origem
+
+Depois da migração, verifique se todos os modelos necessários foram duplicados na WABA de destino **antes de excluir a de origem** (se você pretende fazer isso).
+
+## Começar
+
+Todas as chamadas de migração são feitas para o ponto de extremidade com a identificação da WABA de destino. A migração de telefone sempre é iniciada pelo parceiro de solução ou pela empresa proprietária da WABA de destino.
+
+### Passo 1: desabilitar a confirmação em duas etapas
+
+A confirmação em duas etapas precisa ser desabilitada no número de telefone antes de a migração ser iniciada. Para usuários da API de Nuvem, isso pode ser feito pelo [Gerenciador de Negócios da Meta](https://business.facebook.com). Para usuários da API Local, isso pode ser feito por meio de uma chamada para o ponto de extremidade em [Confirmação em duas etapas](/docs/whatsapp/on-premises/reference/settings/two-step-verification#disable).
+
+Se você for dono da WABA de origem e o dono do número de telefone pedir a você para migrar seu número, você mesmo pode desabilitar a confirmação em duas etapas. Se você não for dono da WABA de origem, o dono do número de telefone deve pedir ao dono da WABA de origem para desabilitar a confirmação em duas etapas no seu número de telefone.
+
+### Passo 2: iniciar migração do telefone
+
+Faça uma chamada `POST` para o ponto de extremidade `/WHATSAPP_BUSINESS_ACCOUNT_ID/phone_numbers`. Lembre-se de que `WHATSAPP_BUSINESS_ACCOUNT_ID` representa a identificação da WABA de destino. Na chamada, especifique os seguintes campos:
+
+Nome
+
+Descrição
+
+`cc`
+
+**Obrigatório.**
+
+Código numérico do país do número de telefone registrado.
+
+`phone_number`
+
+**Obrigatório.**
+
+Número de telefone sendo migrado, sem o código do país ou o símbolo de mais (`+`).
+
+`migrate_phone_number`
+
+**Obrigatório.**
+
+Para migrar um número de telefone, defina isso como `true`.
+
+Para encontrar a identificação de uma conta do WhatsApp Business, acesse [**Gerenciador de Negócios**](https://business.facebook.com/) > **Configurações do negócio** > **Contas** > **Contas do WhatsApp Business**. Encontre a conta que você quer usar e clique nela. Um painel é aberto, contendo as informações sobre a conta, inclusive a identificação.
+
+  
+
+Exemplo de chamada de API:
+
+```
+curl -X POST \
+  'https://graph.facebook.com/v24.0/<DESTINATION_WHATSAPP_BUSINESS_ACCOUNT_ID>/phone_numbers' \
+  -d 'cc=1' \
+  -d 'phone_number=<PHONE_NUMBER>' \
+  -d 'migrate_phone_number=true' \
+  -d 'access_token=<ACCESS_TOKEN>'
+```
+
+Uma chamada de API bem-sucedida retorna:
+
+```
+{
+  'id': '<PHONE_NUMBER_ID>'
+}
+```
+
+### Passo 3: verificar a propriedade do telefone
+
+Depois de solicitar a migração, você precisa confirmá-la verificando a propriedade do número de telefone. Para fazer isso, solicite um código de registro com uma chamada `POST` para `/PHONE_NUMBER_ID/request_code`. Aqui, `PHONE_NUMBER_ID` representa a identificação retornada no Passo 1.
+
+Na chamada, especifique os seguintes campos:
+
+Nome
+
+Descrição
+
+`code_method`
+
+**Obrigatório.**
+
+Método para receber o código de registro. Valores compatíveis: `SMS` e `VOICE`.
+
+`language`
+
+**Obrigatório.**
+
+Idioma em que você deseja receber o código de registro. Confira os [códigos de idioma](/documentation/business-messaging/whatsapp/templates/supported-languages).
+
+Veja um exemplo de chamada:
+
+```
+curl -X POST \
+'https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/request_code' \
+  -d 'code_method=SMS' \
+  -d 'language=en_US' \
+  -d 'access_token=<ACCESS_TOKEN>'
+```
+
+Se a sua chamada de API retornar `success: true`, você deve obter o código por meio do `code_method` selecionado para o número de telefone a ser migrado. A entrega do código pode demorar alguns minutos. O dono do número de telefone precisa fornecer esse código antes que você possa confirmá-lo.
+
+Para confirmar o código, faça uma chamada de API para o ponto de extremidade `/PHONE_NUMBER_ID/verify_code`. Especifique o seguinte campo:
+
+Nome
+
+Descrição
+
+`code`
+
+**Obrigatório.**
+
+Código de registro de 6 dígitos recebido após fazer a chamada `/PHONE_NUMBER_ID/request_code`.
+
+Por exemplo:
+
+```
+curl -X POST \
+'https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/verify_code' \
+  -d 'code=<6-DIGIT-CODE>' \
+  -d 'access_token=<ACCESS_TOKEN>'
+```
+
+Se a sua chamada de API retornar `{"success":true}`, a propriedade do seu número de telefone foi confirmada.
+
+### Passo 4: registrar número de telefone
+
+Envie uma solicitação POST com o PIN de seis dígitos para o ponto de extremidade em [Número de telefone do WhatsApp Business > Registrar](/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/register-api) para registrar o número de telefone novamente. Consulte [Como registrar um número de telefone comercial](/documentation/business-messaging/whatsapp/business-phone-numbers/registration#register-phone).
+
+## Solução de problemas
+
+Se a migração do modelo falhar, consulte a documentação a seguir para instruções sobre como disparar manualmente esse processo: [Migração de modelo](/documentation/business-messaging/whatsapp/templates/template-migration).
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_phone_numbers_among_solution_partners_via_embedded_signup.md

@@ -0,0 +1,118 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-via-embedded-signup -->
+<!-- Scraped: 2025-12-20T17:53:57.114Z -->
+
+# Como migrar um número de telefone comercial entre parceiros de soluções via Cadastro Incorporado
+
+Updated: 14 de nov de 2025
+
+Este documento descreve como usar o Cadastro Incorporado para migrar números de telefone comerciais entre parceiros de soluções e entre contas do WhatsApp Business (WABA, pelas iniciais em inglês).
+
+Os clientes podem migrar números de telefone comercial entre Contas do WhatsApp Business e manter o nome de exibição, a classificação de qualidade, o limite de mensagens de modelo, o status de conta comercial oficial, além dos modelos aprovados com alta qualidade. Normalmente, a migração só é realizada quando um cliente deseja migrar o número de telefone comercial de um parceiro de solução para outro.
+
+Há duas formas de migrar o número de um cliente: via Cadastro Incorporado ou migração programática.
+
+**A migração via Cadastro Incorporado é a opção mais simples e a solução preferencial**. Isso porque ela pode ser iniciada pelos clientes, gera e concede automaticamente a propriedade de todos os ativos necessários, concede ao seu app acesso a esses ativos e exige menos chamadas de API.
+
+Já a migração programática deve ser iniciada por você e envolve mais chamadas de API. Nesse processo, você precisa verificar se os ativos dependentes estão configurados da forma correta, bem como gerar todos os novos ativos necessários por conta própria e associá-los a outros ativos. Por esse motivo, a migração programática só será recomendada caso você trabalhe com o cliente usando o modelo "em nome de" (ou seja, você criará e terá a propriedade da WABA de destino e dos respectivos ativos e os compartilhará com o cliente).
+
+Se você quiser migrar os números de telefone dos clientes de forma programática, consulte o documento [Migrating Numbers Between WhatsApp Business Accounts Programmatically](/documentation/business-messaging/whatsapp/solution-providers/support/migrating-phone-numbers-among-solution-partners-programmatically).
+
+## Como funciona
+
+Os clientes podem usar a implementação do cadastro incorporado para iniciar o processo de migração. No fluxo de cadastro incorporado, os clientes precisarão fornecer o número de telefone comercial e uma nova conta do WhatsApp Business de destino.
+
+![](https://scontent-gru2-1.xx.fbcdn.net/v/t39.2365-6/401509275_1483624899146347_3913430138749391948_n.png?_nc_cat=107&ccb=1-7&_nc_sid=e280be&_nc_ohc=8fLXJXpQGrYQ7kNvwHmKJeL&_nc_oc=AdkowjS0ibvaLrcTrEFbqCTZDQweH7YrqvSXG_kFNOtq3hm8BedKndQAYzE0LZ_K6ZI&_nc_zt=14&_nc_ht=scontent-gru2-1.xx&_nc_gid=b2mZ3mwmV2L-WeVYMT5ERw&oh=00_AfkzJ9eq_nXPc0_H8P4iZ209wreL9TY8XGJI1T9uBGtFBQ&oe=69610E36)
+
+Quando o cliente conclui o fluxo, o Cadastro Incorporado gera a nova conta do WhatsApp Business, associa-a ao respectivo portfólio empresarial da Meta, concede ao seu app acesso à WABA e, depois, retorna a identificação da WABA recém-criada e do número de telefone comercial.
+
+Você precisa armazenar esses números de identificação e usá-los com a API a fim de compartilhar sua linha de crédito, assinar webhooks e registrar o número para uso com a API de Nuvem. Depois de concluir a etapa final (registro), o número de telefone comercial será reassociado à WABA de destino e poderá ser usado para enviar e receber mensagens novamente.
+
+Como não há alteração no número de telefone comercial do cliente, mantemos o nome de exibição, a classificação de qualidade, o limite de mensagens e o status de conta comercial oficial.
+
+Todos os modelos qualificados são duplicados automaticamente na WABA de destino e recebem o mesmo status que os equivalentes de origem. Além disso, é possível continuar usando todas as mídias carregadas no número de telefone comercial do cliente.
+
+### Contas do WhatsApp Business
+
+O Cadastro Incorporado gera automaticamente a nova WABA do cliente, associa-a à respectiva conta comercial da Meta e concede ao seu app acesso à WABA.
+
+### Modelos
+
+Os modelos são duplicados automaticamente na WABA de destino e inicialmente recebem o mesmo status que seus equivalentes de origem.
+
+No entanto, após a duplicação, os modelos são verificados outra vez para garantir que estão corretamente categorizados de acordo com as nossas [diretrizes](/documentation/business-messaging/whatsapp/pricing). Isso pode fazer com que alguns modelos duplicados tenham seu `status` alterado para `REJECTED`.
+
+Apenas os modelos com `status` de `APPROVED` e `quality_score` de `GREEN` são qualificados para duplicação. Se a WABA de destino não conseguir acomodar todos os novos modelos, duplicaremos o maior número possível até que o limite de modelos da WABA de destino seja atingido. Para que a WABA de destino possa usar os modelos não duplicados, eles precisarão ser recriados e enviados para aprovação.
+
+Observe que **as classificações de qualidade dos modelos não são duplicadas**. Todos os modelos duplicados terão a classificação inicial definida como `UNKNOWN`. Essa classificação será mantida nas primeiras 24 horas. Após esse período, uma nova classificação será gerada se houver dados suficientes disponíveis.
+
+### Cobrança
+
+As mensagens entregues antes da conclusão da migração serão cobradas do antigo Parceiro de Soluções. Já as mensagens não entregues que tiverem sido enviadas antes da conclusão da migração serão cobradas do antigo parceiro de solução se a entrega for realizada após a migração.
+
+As mensagens entregues após a conclusão da migração serão cobradas do cliente corporativo.
+
+### Período de inatividade do modelo
+
+O registro de número de telefone comercial acontece instantaneamente, portanto, você poderá continuar enviando e recebendo mensagens sem interrupções.
+
+Porém, a duplicação de modelos leva tempo. Por isso, você não poderá usar os modelos afetados até que eles sejam migrados.
+
+Para evitar essa inatividade, você pode começar a migração dos modelos antes de registrar o número de telefone.
+
+### Limites de volume
+
+A [duplicação de modelos](#templates) disparada automaticamente como parte do processo de migração não tem impacto no limite de volume. No entanto, as chamadas de API realizadas por você serão contabilizadas no limite.
+
+## Limitações
+
+-   Os números de telefone comerciais de teste emitidos pelo WhatsApp não podem ser migrados.-   Os números de telefone comerciais migrados só podem ser registrados para uso com a API de Nuvem.-   Não faremos a migração do histórico de mensagens nem das mídias carregadas se a WABA de origem estiver na API Local.-   Os números de telefone comerciais devem ter um nome de exibição aprovado (`name_status` é `APPROVED`).-   Os números de telefone comerciais não podem ter solicitações pendentes de alteração do nome de exibição.-   As classificações dos modelos **NÃO** serão migradas. Todos os modelos migrados terão a classificação inicial definida como `UNKNOWN`. Essa classificação será mantida nas **primeiras 24 horas**. Após esse período, uma nova classificação será gerada se houver dados suficientes disponíveis.
+
+## Requisitos
+
+### Clientes
+
+Peça para o cliente proprietário do número de telefone comercial confirmar se ele atende aos requisitos a seguir. Para isso, ele pode abrir o Gerenciador de Negócios da Meta (caso seja o proprietário da WABA) e acessar [Contas do WhatsApp](https://business.facebook.com/settings/whatsapp-business-accounts/) > (nome da WABA do cliente) > **Configurações**. Se ele não for o proprietário da WABA, será preciso solicitar a confirmação do parceiro de solução.
+
+-   A conta comercial do cliente na Meta precisa ter o status de **verificada**.-   A WABA existente deve ter o status de **aprovada**.-   A WABA existente deve ter uma forma de pagamento válida anexada em **Configurações de pagamento**.-   O número de telefone comercial deve ter a confirmação em duas etapas desabilitada. Os clientes que forem os proprietários das WABAs poderão usar o Gerenciador do WhatsApp para [desabilitar a confirmação em duas etapas](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#disabling-two-step-verification) nos números de telefone deles. Caso contrário, eles precisarão solicitar aos parceiros de soluções que realizem essa ação.
+
+### Provedores de soluções
+
+É preciso que pelo menos um app já tenha assinado webhooks na WABA de destino. Consulte [Webhooks](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener). Além disso, você deve usar o Cadastro Incorporado com o [registro de sessão](/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#subscribe-to-a-whatsapp-business-account) habilitado.
+
+## Etapas de migração
+
+### Etapa 1: instruir o cliente a desabilitar a confirmação em duas etapas
+
+Caso ainda não tenha feito isso, oriente seu cliente a usar o Gerenciador do WhatsApp para [desabilitar a confirmação em duas etapas](/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers#disabling-two-step-verification) no número de telefone comercial (ou diga para ele pedir ao parceiro de solução atual que desabilite o recurso).
+
+**Não será possível concluir os próximos passos até que a confirmação em duas etapas seja desabilitada.**
+
+### Etapa 2: exibir o cadastro incorporado
+
+Oriente o cliente a acessar sua implementação do cadastro incorporado, além de fornecer o número de telefone comercial e o nome de exibição associado durante o fluxo.
+
+### Etapa 3: capturar IDs de ativos
+
+Quando o cliente concluir o fluxo, capture o ID do número de telefone comercial e a nova WABA [retornados no evento de mensagem](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener).
+
+### Etapa 4: compartilhar sua linha de crédito
+
+[Compartilhe sua linha de crédito com a WABA](/documentation/business-messaging/whatsapp/solution-providers/share-and-revoke-credit-lines#sharing-your-credit-line) como você faria normalmente depois de integrar um cliente por meio do Cadastro Incorporado.
+
+### Etapa 5: assinar webhooks
+
+[Assine webhooks para seu app](/documentation/business-messaging/whatsapp/solution-providers/manage-webhooks#subscribe-to-a-whatsapp-business-account) na nova WABA do cliente.
+
+### Etapa 6: registrar o número de telefone na API de Nuvem
+
+[Registre o número de telefone comercial](/documentation/business-messaging/whatsapp/solution-providers/registering-phone-numbers#step-4--register-the-number) para uso com a API de Nuvem. Não é possível registrar um número migrado para uso com a API Local.
+
+## Solução de problemas
+
+Se o processo de migração do modelo falhar, consulte nosso documento [Migração de modelo](/documentation/business-messaging/whatsapp/templates/template-migration) para ver instruções sobre como acionar manualmente esse processo.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solution_partners_via_embedded_signup.md

@@ -0,0 +1,76 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-wabas-among-solution-partners-via-embedded-signup -->
+<!-- Scraped: 2025-12-20T17:53:16.296Z -->
+
+# Como migrar a WABA de um parceiro de soluções para outro via cadastro incorporado
+
+Updated: 4 de nov de 2025
+
+Caso você seja um parceiro de soluções, os clientes empresariais poderão migrar para seus serviços deixando de compartilhar a Conta do WhatsApp Business (WABA, pelas iniciais em inglês) com o parceiro de soluções atual para compartilhar com sua empresa. Todos os números de telefone comerciais e modelos associados continuarão funcionando normalmente após a conclusão do processo.
+
+Depois que o cliente iniciar o processo, ele não poderá enviar mensagens novamente até que você substitua a linha de crédito atual dele pela sua. Isso acontece no primeiro dia do mês seguinte ao que você usa a API para compartilhar sua linha de crédito. No entanto, não é possível usar a API para compartilhar sua linha de crédito (com um cliente que mudou de parceiro) nos últimos três dias ou nos primeiros quatro dias de qualquer mês. Por isso, para garantir o menor tempo de inatividade possível, oriente os clientes a iniciar o processo perto do final do mês, mas pelo menos três dias antes do término, para que você possa realizar a chamada de API no mesmo mês.
+
+## Limitações
+
+-   Os clientes precisam de ter uma WABA. As WABAs dos parceiros de soluções (o [modelo "Em nome de"](/documentation/business-messaging/whatsapp/whatsapp-business-accounts#messaging-on-behalf-of)) não são compatíveis.-   Assim que o cliente iniciar o processo, ele será impedido de enviar mensagens até que sua linha de crédito substitua a dele. Isso acontece no primeiro dia do mês após você usar com sucesso a API para compartilhar sua linha de crédito com o cliente.-   A moeda da sua linha de crédito precisa ser igual à da WABA do cliente no momento da migração.-   Não é possível usar a API para compartilhar sua linha de crédito (com um cliente que mudou de provedor) nos últimos três dias ou nos primeiros quatro dias de qualquer mês.-   Será preciso registrar os números de telefone comercial em uso com a API Local novamente como parte do processo. Os números de telefone comercial em uso com a API de Nuvem não precisam ser registrados outra vez.
+
+## Etapa 1: instruir o cliente a cancelar o compartilhamento da WABA
+
+Instrua o cliente a usar o Meta Business Suite para cancelar o compartilhamento da Conta do WhatsApp Business com o parceiro atual dele. O cliente pode fazer isso navegando até:
+
+**Configurações do negócio** > **Contas** (seção do menu) > **Contas do WhatsApp** > **Parceiros** (aba)
+
+Na aba **Parceiros**, ele poderá selecionar o parceiro atual, clicar no ícone de exclusão (lixeira) e concluir o fluxo para cancelar o compartilhamento da WABA.
+
+Você pode fornecer ao cliente o link a seguir para ele carregar diretamente o portfólio empresarial no painel "Configurações do negócio":
+
+`https://business.facebook.com/settings`
+
+Outra opção é direcionar o cliente para este artigo da Central de Ajuda:
+
+[Como gerenciar as permissões do seu provedor de soluções do WhatsApp Business](https://www.facebook.com/business/help/861444384718867)
+
+Depois que o cliente concluir essa etapa, ele será impedido de enviar mensagens até que sua linha de crédito substitua a opção atual. Isso acontece no primeiro dia do mês _após_ você compartilhar sua linha de crédito com o cliente.
+
+Se o cliente tentar enviar uma mensagem durante esse período, a API retornará o código de erro `131042`. Além disso, um webhook `messages` será enviado ao parceiro de soluções atual com o mesmo código.
+
+## Etapa 2: instruir o cliente a concluir o cadastro incorporado
+
+Caso você não tome nenhuma medida, a Meta moverá sua conta para seu portfólio empresarial após 90 dias. Esse processo não interromperá os serviços de troca de mensagens.
+
+Direcione o cliente para sua implementação do cadastro incorporado. Instrua-o a completar o fluxo e selecionar a WABA existente quando vir o aviso **Esta Conta do WhatsApp Business foi compartilhada anteriormente**.
+
+![](https://scontent-gru1-1.xx.fbcdn.net/v/t39.2365-6/435163409_465518599131244_3999655418914952752_n.png?_nc_cat=104&ccb=1-7&_nc_sid=e280be&_nc_ohc=06NN5n1jU6oQ7kNvwG5RLVs&_nc_oc=AdkTQuG_6TredcNwdCHJOsx73m-TovRYIjG6xYC9XL9PN95mfU9oYB9beOfIpBzXDnk&_nc_zt=14&_nc_ht=scontent-gru1-1.xx&_nc_gid=W_hTnkgsiKUqTp8KTqsGQg&oh=00_AfloibVC1ZRPGhb4NzARqybSdYMS_ssaChAYlA4_CHXuwQ&oe=69611E62)
+
+Depois que o cliente selecionar a WABA e prosseguir, o fluxo será encerrado. Não será preciso selecionar um número de telefone comercial.
+
+## Etapa 3: receber as identificações de ativos do listener de eventos de mensagem do registro da sessão
+
+Receba a identificação da WABA do cliente e o número de telefone comercial capturado pelo [listener de eventos de mensagem do registro da sessão](/documentation/business-messaging/whatsapp/embedded-signup/implementation#session-logging-message-event-listener) ao concluir o fluxo.
+
+O número de telefone comercial do cliente não será incluído no registro da sessão por meio desse fluxo.
+
+## Etapa 4: trocar o código do token por um token da empresa
+
+[Troque o código do token](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-solution-partner#step-1--exchange-the-token-code-for-a-business-token) capturado no [retorno de chamada da resposta](/documentation/business-messaging/whatsapp/embedded-signup/implementation#response-callback) pelo [token comercial](/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens) do cliente.
+
+## Etapa 5: adicionar o usuário do sistema à WABA do cliente
+
+Se você estiver usando um [token do sistema](/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) (o que não é recomendado) em vez de um token comercial, adicione o usuário do sistema à WABA do cliente usando o Gerenciador de Negócios no Meta Business Suite.
+
+[**Configurações do negócio**](https://business.facebook.com/settings) > **Contas** (seção do menu) > **Contas do WhatsApp** > \[WABA do cliente\] > **Pessoas** (aba) > **Atribuir pessoas** (botão)
+
+## Etapa 6: compartilhar sua linha de crédito com o cliente
+
+[Compartilhe sua linha de crédito](/documentation/business-messaging/whatsapp/solution-providers/share-and-revoke-credit-lines#sharing-your-credit-line) com o cliente. Essa alteração não será refletida até o primeiro dia do mês seguinte. Até lá, o cliente continuará compartilhando a linha de crédito do antigo parceiro de soluções, mas ficará impedido de enviar mensagens.
+
+No primeiro dia do próximo mês, sua linha de crédito substituirá a linha de crédito anterior e o cliente poderá retomar a troca de mensagens.
+
+### Exemplo
+
+-   **20 de abril**: um cliente deixa de compartilhar a WABA com um parceiro de soluções anterior. O cliente agora está impedido de trocar mensagens.-   **21 de abril:** o cliente conclui a implementação do cadastro incorporado. Você captura as credenciais e o token de acesso do cliente, compartilhando sua linha de crédito com ele. A linha de crédito do antigo parceiro de soluções ainda é compartilhada com o cliente, mas ele continua impedido de trocar mensagens.-   **1º de maio:** sua linha de crédito substitui a linha de crédito anterior. O cliente agora pode trocar mensagens novamente. Todas as [mensagens cobráveis](/documentation/business-messaging/whatsapp/pricing) enviadas pelo cliente serão cobradas da sua linha de crédito.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

package/docs/parceiros/gerenciamento/suporte_ao_parceiro/migrating_wabas_among_solutions_via_embedded_signup.md

@@ -0,0 +1,90 @@
+<!-- Source: https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/support/migrating-wabas-among-solutions-via-embedded-signup -->
+<!-- Scraped: 2025-12-20T17:52:59.911Z -->
+
+# Como migrar uma WABA de uma solução multiparceiros para outra via Cadastro incorporado
+
+Updated: 10 de nov de 2025
+
+Os Provedores de Tecnologia podem usar a API e o [Cadastro incorporado](/documentation/business-messaging/whatsapp/embedded-signup/overview) para migrar a Conta do WhatsApp Business (WABA, pelas iniciais em inglês) de um cliente empresarial de uma solução multiparceiros (a "solução de origem") para outra (a "solução de destino").
+
+Como parte desse processo, uma nova conta do WhatsApp Business (WABA) será criada para o cliente empresarial, os modelos da WABA de origem serão duplicados na WABA de destino, e o acesso à WABA e aos respectivos ativos será concedido ao Parceiro de Soluções de destino.
+
+## Requisitos
+
+O app (ou apps, se você estiver usando apps separados) usado para criar ou aceitar as soluções multiparceiros de origem e destino deve estar associado ao mesmo portfólio empresarial. A solução de destino também deve estar em estado "Ativo".
+
+## Modelos
+
+Os modelos são duplicados automaticamente na WABA de destino e inicialmente recebem o mesmo status que seus equivalentes de origem.
+
+No entanto, após a duplicação, os modelos são verificados outra vez para garantir que estão corretamente categorizados de acordo com nossas [diretrizes](/documentation/business-messaging/whatsapp/pricing). Isso pode fazer com que alguns modelos duplicados tenham seu `status` alterado para `REJECTED`.
+
+Apenas os modelos com `status` de `APPROVED` e `quality_score` de `GREEN` são qualificados para duplicação. Se a WABA de destino não conseguir acomodar todos os novos modelos, duplicaremos o maior número possível até que o limite de modelos da WABA de destino seja atingido. Para que a WABA de destino possa usar os modelos não duplicados, eles precisarão ser recriados e enviados para aprovação.
+
+Observe que **as classificações de qualidade dos modelos não são duplicadas**. Todos os modelos duplicados terão a classificação inicial definida como `UNKNOWN`. Essa classificação será mantida nas primeiras 24 horas. Após esse período, uma nova classificação será gerada se houver dados suficientes disponíveis.
+
+## Cobrança
+
+As mensagens entregues antes da conclusão da migração serão cobradas do antigo Parceiro de Soluções. Já as mensagens não entregues que tiverem sido enviadas antes da conclusão da migração serão cobradas do antigo Parceiro de Soluções se a entrega for realizada após a migração.
+
+As mensagens entregues após a conclusão da migração serão cobradas do cliente corporativo.
+
+## Etapas do Provedor de Tecnologia
+
+### Etapa 1: marcar a WABA do cliente para migração
+
+Use o ponto de extremidade [POST /<WHATSAPP\_BUSINESS\_ACCOUNT>/set\_solution\_migration\_intent](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/set-solution-migration-intent-api#Creating) para marcar a WABA do cliente empresarial para migração. Isso gera uma [intenção de migração](/documentation/business-messaging/whatsapp/reference/whatsapp-business-account/migration-intent-api), que indica sua intenção de migrar a WABA.
+
+#### Solicitação
+
+```
+curl 'https://graph.facebook.com/<API_VERSION>/<WABA_ID>/set_solution_migration_intent' \
+-H 'Content-Type: application/json' \
+-H 'Authorization: Bearer <BUSINESS_TOKEN>' \
+-d '
+{
+  "solution_id": "<DESTINATION_MULTI-PARTNER_SOLUTION_ID>"
+}'
+```
+
+#### Resposta
+
+Caso a solicitação seja bem-sucedida:
+
+```
+{
+  "id": "<MIGRATION_INTENT_ID>"
+}
+```
+
+Capture o ID da intenção de migração.
+
+### Etapa 2: desabilitar a confirmação em duas etapas no número de telefone comercial
+
+Se você tiver acesso à WABA do cliente empresarial no Gerenciador do WhatsApp, desabilite a confirmação em duas etapas no número de telefone comercial associado à WABA.
+
+Como alternativa, você pode instruir o cliente a fazer isso. Veja as instruções para fazer isso:
+
+-   _Acesse o Gerenciador do WhatsApp em [https://business.facebook.com/latest/whatsapp\_manager/](https://business.facebook.com/latest/whatsapp_manager/)._-   _Navegue até **Ferramentas da conta** > **Números de telefone** e clique no ícone de engrenagem (configurações) do número de telefone. Caso não veja seu número de telefone comercial, clique em **Visão geral** no menu do lado esquerdo, localize o número e clique nele._-   _Clique na aba **Confirmação em duas etapas**._-   _Clique no botão **Desativar a confirmação em duas etapas** e conclua o fluxo._
+
+### Etapa 3: instruir o cliente a concluir o Cadastro incorporado
+
+Instrua o cliente a concluir a implementação do Cadastro incorporado pelo parceiro de solução.
+
+Direcione o cliente para a implementação do cadastro incorporado configurada corretamente com o ID da solução multiparceiros de destino. Caso contrário, o cliente poderá ser integrado por meio da solução errada.
+
+Forneça ao cliente estas instruções:
+
+-   _Insira o nome do seu portfólio empresarial existente na [tela do portfólio empresarial](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-portfolio-screen)._-   _Crie uma nova Conta do WhatsApp Business na [tela de seleção da WABA](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#business-asset-selection-screen)._-   _Insira seu número de telefone comercial existente na [tela de adição de número de telefone](/documentation/business-messaging/whatsapp/embedded-signup/default-flow#phone-number-addition-screen). Isso disparará um aviso de que o número será movido para uma nova Conta do WhatsApp Business._
+
+![](https://scontent-gru1-2.xx.fbcdn.net/v/t39.2365-6/466392707_1274428157316091_5418623531369238611_n.png?_nc_cat=110&ccb=1-7&_nc_sid=e280be&_nc_ohc=SzV5WYPGNfIQ7kNvwH78MfV&_nc_oc=AdlYZ6YDEGlglz9U0fgh9cFZAtL6d0WoZAeyKrACBybH6JtldZG8NswPQ0B7c-_GGsA&_nc_zt=14&_nc_ht=scontent-gru1-2.xx&_nc_gid=iLM0ts6aG1bvkwASXbJiRw&oh=00_Aflfm2EhysU3-y1xzOvwIZ19Ru1ePbJt_wjr_pRtjNi9Ug&oe=696118B5)
+
+## Etapas do parceiro de solução
+
+Forneça ao Provedor de Tecnologia um link para sua implementação do Cadastro incorporado configurada com o ID da solução multiparceiros. Quando um cliente empresarial concluir o fluxo de implementação, [faça a integração](/documentation/business-messaging/whatsapp/embedded-signup/onboarding-customers-as-a-solution-partner) como faria normalmente.
+
+Você achou esta página útil?
+
+![Ícone de polegar para cima](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)
+
+![Ícone de polegar para baixo](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)