> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Números de telefone comerciais

> Escolha um número de telefone comercial e entenda seu registro, nome de exibição, perfil comercial e identificadores.

Um número de telefone comercial é o recurso do WhatsApp que você usa para enviar e receber mensagens. Ele pertence a uma conta do WhatsApp Business (WABA) e tem seu próprio nome de exibição e perfil comercial.

## Escolha como conectar seu número

Escolha um destes três caminhos com base em onde o número está registrado agora. “Novo” significa **não registrado atualmente no WhatsApp**, não necessariamente um chip SIM recém-adquirido.

| Seu ponto de partida | O que muda | Caminho de conexão |
| - | - | - |
| **Número novo, não registrado no WhatsApp** | Registre o número na WhatsApp Business Platform e conecte-o à YCloud. | [Conectar um novo número](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up). |
| **Número de API existente em outro BSP** | Mantenha o número de telefone comercial e migre sua conexão com a Platform do provedor atual para a YCloud. | [Migrar um número de API para a YCloud](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration). |
| **Número no WhatsApp Messenger ou no aplicativo WhatsApp Business** | Exclua a conta do aplicativo existente e registre o número liberado na Platform. A conta do aplicativo e seu histórico de conversas não se tornam uma conta da Platform e histórico do Inbox. | Siga as verificações de migração do aplicativo para a Platform abaixo e, em seguida, [conecte o número](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up). |

### 1. Registrar um novo número

Certifique-se de que você tem o controle do número e pode receber o código de verificação por SMS ou chamada de voz. Conclua o fluxo de conexão da YCloud, selecione o portfólio empresarial e a WABA pretendidos e registre o número. Você não precisa criar uma conta no WhatsApp Messenger ou no aplicativo Business antes.

Se a WABA já estiver conectada à YCloud, use [Adicionar números](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers).

### 2. Migrar um número de API existente de outro BSP

Use o caminho de migração de provedor, não a exclusão da conta do aplicativo. Antes de começar, confirme o portfólio empresarial proprietário, as WABAs de origem e destino, o acesso ao número e os pré-requisitos de migração com o provedor atual e a YCloud.

Planeje a transição de mensagens, modelos, webhooks e automações dependentes. Não presuma que a Inbox, contatos, dados de campanhas ou histórico de conversas do provedor anterior serão copiados para a YCloud. Exporte os registros que você precisa manter antes de encerrar o acesso ao provedor antigo.

O [guia de migração de números](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration) contém os passos de preparação e da YCloud. “Migrar uma conta de API” é um termo comum abreviado; o número é o recurso sendo movido, não todo o espaço de trabalho do seu provedor.

### 3. Migrar totalmente um número de aplicativo para a Platform

Este caminho é para um número que você não deseja mais usar no WhatsApp Messenger ou no aplicativo WhatsApp Business.

<Warning>
  **A exclusão de uma conta do aplicativo é irreversível.** Ela remove a conta e afeta suas mensagens, participação em grupos e backups. Desinstalar o aplicativo não é o mesmo que excluir a conta. O histórico de conversas do aplicativo não pode ser restaurado no YCloud Inbox ao registrar o número na Platform. Avalie o impacto e exporte todos os registros necessários antes de excluir qualquer coisa.
</Warning>

1. Confirme se você deseja parar de usar a conta do aplicativo neste número e se os pré-requisitos de conexão da YCloud estão prontos.
2. Guarde os registros necessários fora do aplicativo. Não dependa de um backup de conversas na nuvem como uma futura importação para a Platform.
3. No telefone principal, abra o aplicativo do WhatsApp correspondente e acesse **Configurações → Conta → Apagar minha conta**. Confirme o número exato e siga as instruções de exclusão.
4. Aguarde a liberação do número. O guia de migração da Meta indica que isso pode levar até três minutos; se o registro ainda falhar, verifique o erro real em vez de excluir ou recriar recursos repetidamente.
5. Conclua o fluxo de conexão da YCloud e verificação do número. Teste o recebimento de mensagens e uma resposta permitida de saída antes de direcionar os clientes para a nova configuração.

Fontes: [Guia de migração de número de aplicativo da Meta](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/migrate-existing-whatsapp-number-to-a-business-account) e [Orientações para exclusão de conta do WhatsApp](https://faq.whatsapp.com/2138577903196467/?cms_platform=android\&locale=en_US).

<Note>
  Deseja continuar usando o **aplicativo WhatsApp Business** no mesmo número? Consulte o [guia de coexistência do aplicativo Business](/pt/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence) separado antes de excluir a conta do aplicativo. A coexistência é um modo de conexão alternativo para números elegíveis do aplicativo Business, e não outro tipo de conta ou a rota de migração de provedor mencionada acima.
</Note>

## Requisitos e verificação de números

Você precisa ter o controle do número e acesso ao método de verificação exigido pelo seu fluxo de conexão. A verificação padrão de número usa um código por SMS ou chamada de voz.

Se o número estiver atrás de um menu telefônico automatizado ou URA, certifique-se de que uma pessoa possa receber a chamada de verificação. O WhatsApp não consegue navegar no seu menu telefônico automaticamente. Consulte os [requisitos para números de telefone comerciais](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers/) da Meta.

Mantenha estas verificações separadas:

| Verificação | O que estabelece |
| - | - |
| Verificação de titularidade do número | Você consegue receber o código de verificação para o número. |
| Registro na plataforma | O número está registrado para uso com a Business Platform. |
| Confirmação em duas etapas | Um PIN protege o registro do número. Não se trata do código de verificação por SMS ou voz. |
| Análise do nome de exibição | A Meta analisou o nome comercial solicitado voltado ao cliente. |
| Verificação da empresa | A Meta analisou a empresa representada pelo portfólio. |

Verificar a titularidade não é o mesmo que concluir o registro na Cloud API. Siga o fluxo completo de conexão da YCloud em vez de parar após receber um código. A Meta descreve essa distinção em [Registrar um número de telefone comercial](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/registration/).

## Limites de registro de números de telefone

O limite de registro de números controla quantos números de telefone comerciais um portfólio empresarial pode registrar. Ele é diferente do limite de mensagens que controla o alcance proativo de clientes.

Atualmente, a Meta documenta um limite inicial de dois números de telefone comerciais registrados para novos portfólios. O caminho documentado para atingir um limite de 20 é a verificação da empresa ou alcançar um limite de mensagens de 2.000. Confirme o limite realmente disponível para sua empresa antes de planejar números adicionais. Consulte [Limite de números registrados](https://developers.facebook.com/docs/whatsapp/business-management-api/manage-phone-numbers/#registered-number-cap).

Não interprete um limite de números maior como uma franquia de mensagens separada para cada número.

## Nome de exibição

O nome de exibição é o nome comercial associado ao seu número. Os clientes podem visualizá-lo no perfil comercial. A visibilidade em outras partes do WhatsApp depende das regras de exibição da Meta.

Escolha um nome que os clientes possam associar à sua empresa ou marca. Mantenha-o consistente com a identidade apresentada no seu site e em outros materiais voltados ao cliente.

Por exemplo, se a sua marca fictícia for **Example Store**, usar esse nome de marca reconhecível é mais claro do que um nome não relacionado ao negócio. Este exemplo é uma recomendação de redação, não uma garantia de aprovação.

Antes de enviar um nome:

* Verifique se a relação com a empresa ou marca está clara.
* Verifique a ortografia e a consistência com a identidade pública da sua empresa.
* Revise as [diretrizes para nomes de exibição](https://www.facebook.com/business/help/757569725593362) da Meta.
* Se o nome solicitado for rejeitado, use o motivo informado para corrigi-lo em vez de enviar repetidamente o mesmo nome.

Um nome de exibição solicitado pode estar em análise, aprovado ou rejeitado. Esses são resultados da análise do nome, não uma descrição completa do status de envio de mensagens do número. Uma alteração enviada pode não ficar ativa imediatamente.

Para conferir o processo de análise atual, consulte [Sobre nomes de exibição do WhatsApp Business](https://en-gb.facebook.com/business/help/338047025165344). Para a configuração na YCloud, abra o perfil comercial do número por meio de [Configurações do perfil do número de telefone](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).

### Avaliar um nome de exibição antes de enviá-lo

| Abordagem proposta | Por que é importante |
| - | - |
| Use a empresa ou marca estabelecida que os clientes reconhecem | O nome deve ter uma relação clara com a empresa representada. |
| Torne verificável a relação entre marca e entidade legal | Um nome comercial diferente precisa de uma conexão legítima, e não apenas de uma explicação interna. |
| Evite usar apenas descrições genéricas | Um nome como “Customer Support” não identifica claramente qual empresa está entrando em contato com o cliente. |
| Evite termos promocionais ou status oficial enganoso | Um nome de exibição é uma identidade, não um anúncio ou uma alegação de que a Meta endossou a empresa. |
| Mantenha a consistência na ortografia e apresentação | Diferenças inexplicadas entre o site, documentos e o nome solicitado podem dificultar a análise. |

Verifique o motivo exato caso um nome seja rejeitado. A verificação da empresa não anula os requisitos de nome.

Nas respostas da API, `verifiedName` é o campo de nome do número; isso **não** significa que o número é uma Conta comercial oficial. Use o status real de OBA para determinar isso.

## Perfil comercial

### Editar o perfil na YCloud

Abra **Contas do WhatsApp**, selecione as **Configurações** do número e abra **Perfil**. Atualize as informações relevantes e selecione **Salvar**. Em seguida, verifique o perfil voltado ao cliente a partir de um cliente do WhatsApp. Alterar uma observação interna não é o mesmo que alterar este perfil.

A API de perfil atual da YCloud define estes limites:

| Campo | Limite |
| - | - |
| Recado | 1 a 139 caracteres; texto sem formatação, sem formatação Markdown. |
| Descrição | 512 caracteres. |
| Endereço | 256 caracteres. |
| E-mail | 128 caracteres e um formato de e-mail válido. |
| Sites | Até 2 URLs, cada uma com até 255 caracteres e incluindo `http://` ou `https://`. |

Um campo de perfil válido não significa que uma alteração proposta de nome de exibição foi aprovada. Mantenha a atualização do perfil e o resultado da análise do nome separados.

O perfil fornece aos clientes mais contexto quando eles abrem os detalhes da sua empresa.

| Informações do perfil | O que fornecer |
| - | - |
| Foto do perfil | Uma imagem reconhecível da empresa ou marca. |
| Texto de recado e descrição | Uma explicação concisa do que sua empresa faz. |
| Categoria da empresa | A categoria que descreve sua empresa. |
| Endereço | Seu endereço comercial relevante. |
| E-mail | Um endereço de contato monitorado pela sua equipe. |
| Sites | URLs de sites relevantes e completas. |

Para campos disponíveis e restrições de formato, use [Gerenciar números de telefone do WhatsApp](/pt/api-reference/guides/whatsapp-platform/manage-whatsapp-phone-numbers). Para etapas no console, use [Configurações de perfil do número de telefone](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).

<Frame caption="Open Business Profile to review the number identity and customer-facing preview. Status and limits shown belong to this demo number.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/profile-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=1cfffa0d6f0355604b40180a3f6b2487" alt="Configurações do perfil comercial e a prévia exibida ao cliente para um número de demonstração." width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/profile-annotated.svg" />
</Frame>

### Apelido interno

Um apelido para o número no YCloud ajuda sua equipe a identificá-lo. Ele não é exibido aos clientes e não altera o nome de exibição do WhatsApp.

Por exemplo, sua equipe pode usar um apelido interno como **Equipe de suporte** , enquanto o nome de exibição visível para o cliente permanece sua marca. Consulte [Configurações de apelido do número de telefone](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/edit-phone-number-display-name).

## Nome de usuário comercial

Um nome de usuário comercial é separado do nome de exibição e do apelido interno. Onde disponível, ele é associado ao número de telefone.

O recurso de número de telefone do YCloud distingue um nome de usuário ativo de um nome de usuário solicitado que ainda está em análise. Uma solicitação pendente não deve ser tratada como um nome de usuário ativo. Verifique o status atual e a disponibilidade antes de incluir um nome de usuário em materiais voltados para o cliente.

## Status do número de telefone

Status de registro, análise de nome de exibição, verificação da empresa e qualidade descrevem aspectos diferentes do mesmo número. Não use um como prova dos outros.

Se uma mensagem falhar, inspecione os detalhes da falha e o [status de entrega da mensagem](/pt/documentation/whatsapp-business-platform/messaging/message-delivery-statuses) em vez de presumir que um nome de exibição aprovado garante a entrega.

## Classificação de qualidade

O feedback dos clientes pode afetar a qualidade do número. Envie mensagens relevantes para clientes que esperam recebê-las e respeite as [solicitações de descadastro (opt-out)](/pt/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out).

<a id="maintain-high-quality-rating" />

Os controles de qualidade e envio de mensagens são separados do limite de registro de números. Consulte [Controles de qualidade e entrega](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls) para ver a explicação completa.

<a id="xiao-xi-xian-e" />

## Limites de mensagens

Os limites de mensagens se aplicam no nível do portfólio empresarial e são compartilhados entre seus números de telefone comerciais. Eles não representam quantos números você pode registrar nem quantas mensagens uma API pode processar por segundo.

Verifique o limite atual do portfólio proprietário ao planejar mensagens proativas. Consulte [Limites de mensagens e throughput](/pt/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput) para obter detalhes sobre níveis, escalonamento e velocidade de envio.

## Próximos passos

* [Adicionar outro número](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers).
* [Editar seu perfil comercial](/pt/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings).
* [Revisar a coexistência do aplicativo Business](/pt/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence).
* [Migrar um número](/pt/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration).

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Desinstalei o WhatsApp, mas o número ainda está registrado. Por quê?">
    A desinstalação remove o aplicativo do telefone; ela não libera a conta do WhatsApp. Primeiro, identifique se o número pertence a uma conta de aplicativo ou a uma conexão de Plataforma existente. Para uma migração do aplicativo para a Plataforma, use o procedimento explícito de exclusão de conta acima. Para um número de API existente, use a migração de provedor. Não exclua uma WABA para corrigir um erro de registro no aplicativo.
  </Accordion>

  <Accordion title="Minhas conversas anteriores aparecerão no YCloud depois que eu conectar o número?">
    Não automaticamente. A exclusão padrão da conta do aplicativo não transfere o histórico do aplicativo para o Inbox, e a migração de BSP não copia o banco de dados de conversas do provedor antigo. Mantenha todos os registros necessários antes de alterar ou encerrar o acesso. O caminho separado de coexistência tem suas próprias regras de sincronização; não aplique essas garantias a uma mudança completa do aplicativo para a Plataforma.
  </Accordion>

  <Accordion title="O código de verificação nunca chega. O que devo verificar?">
    Confirme o número internacional completo e se você pode receber o SMS ou a chamada de voz selecionada. Para um telefone fixo ou uma URA, providencie o acesso à chamada de verificação. Use outro método se a tela de conexão oferecer um e respeite qualquer cronômetro de nova tentativa. Se ainda assim falhar, envie ao suporte o número, o método selecionado, o horário da tentativa e o erro exato — não o código de verificação ou o PIN de registro.
  </Accordion>

  <Accordion title="Meu nome de exibição foi aprovado. Por que o envio ainda falha?">
    A aprovação do nome abrange o nome comercial solicitado, não todos os requisitos de envio. Verifique se o registro foi concluído e, em seguida, inspecione o erro da mensagem para restrições de modelo, janela de 24 horas, faturamento, destinatário ou conta. Um apelido interno da YCloud também não tem efeito na aprovação do nome exibido aos clientes ou na entrega.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.