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.1. Registrar um novo número
Certifique-se de que você controla o número e consegue receber o código de verificação por SMS ou voz. Conclua o fluxo de conexão do YCloud, selecione o portfólio empresarial e a conta do WhatsApp (WAAC) desejados e registre o número. Você não precisa criar primeiro uma conta no WhatsApp Messenger nem no aplicativo Business. Para conectar outro número ao YCloud, use Adicionar números.2. Migrar um número de API existente de outro BSP
Use a rota de migração do provedor, e não a exclusão da conta do aplicativo. No modelo de conta atualizado, o número pertence a uma conta do WhatsApp (WAAC). A YCloud usa uma conta de mensagens separada para sua integração e recebe acesso autorizado ao número. Planeje a transição das mensagens, dos Modelos, dos webhooks e das automações dependentes. Não presuma que a Caixa de entrada, os contatos, os dados de campanha ou o histórico de conversas do provedor anterior serão copiados para o YCloud. Exporte os registros que você precisa manter antes de encerrar o acesso ao provedor antigo. O guia de migração de número contém as etapas de preparação e as etapas da YCloud.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.- 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.
- 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.
- 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.
- 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.
- 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.
Deseja continuar usando o aplicativo WhatsApp Business no mesmo número? Consulte o guia de coexistência do aplicativo Business 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.
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 da Meta. Mantenha estas verificações separadas:
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.
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. 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 da Meta.
- Se o nome solicitado for rejeitado, use o motivo informado para corrigi-lo em vez de enviar repetidamente o mesmo nome.
Avaliar um nome de exibição antes de enviá-lo
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:
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.
Para campos disponíveis e restrições de formato, use Gerenciar números de telefone do WhatsApp. Para etapas no console, use Configurações de perfil do número de telefone.
Open Business Profile to review the number identity and customer-facing preview. Status and limits shown belong to this demo number.
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.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 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). Os controles de qualidade e envio de mensagens são separados do limite de registro de números. Consulte Controles de qualidade e entrega para ver a explicação completa.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 para obter detalhes sobre níveis, escalonamento e velocidade de envio.Perguntas frequentes
Desinstalei o WhatsApp, mas o número ainda está registrado. Por quê?
Desinstalei o WhatsApp, mas o número ainda está registrado. Por quê?
Desinstalar remove o aplicativo do telefone; isso não libera a conta do WhatsApp. Primeiro, identifique se o número pertence a uma conta de aplicativo ou a uma conexão existente com a plataforma.
- Conta do app: Abra o WhatsApp Messenger ou o app WhatsApp Business e acesse Configurações → Conta → Excluir minha conta. Siga as instruções para excluir a conta antes de desinstalar o app.
- Conexão de plataforma existente: No Meta, remova o número de telefone da Conta de mensagens à qual ele está vinculado atualmente.
Minhas conversas anteriores aparecerão no YCloud depois que eu conectar o número?
Minhas conversas anteriores aparecerão no YCloud depois que eu conectar o número?
Não de forma automática. A exclusão padrão da conta do app não transfere o histórico do app para o Inbox, e a migração de BSP não copia o banco de dados de conversas do provedor antigo. Mantenha os registros necessários antes de alterar ou encerrar o acesso. A rota de coexistência separada tem suas próprias regras de sincronização; não aplique essas promessas a uma migração completa do app para a Plataforma.
O código de verificação nunca chega. O que devo verificar?
O código de verificação nunca chega. O que devo verificar?
Confirme o número internacional completo e que você consegue receber o SMS ou a chamada de voz selecionados. Para um telefone fixo ou uma IVR, garanta acesso à chamada de verificação. Use outro método se a tela de conexão oferecer essa opção e respeite qualquer temporizador de nova tentativa. Se ainda 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 nem o PIN de registro.
Meu nome de exibição foi aprovado. Por que um envio ainda falha?
Meu nome de exibição foi aprovado. Por que um 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 em busca de restrições de modelo, janela, cobrança, destinatário ou conta. Um apelido interno da YCloud também não afeta a aprovação do nome exibido ao cliente nem a entrega.

