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ê 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.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 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.- 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.Próximos passos
- Adicionar outro número.
- Editar seu perfil comercial.
- Revisar a coexistência do aplicativo Business.
- Migrar um número.
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ê?
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.
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 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.
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 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.
Meu nome de exibição foi aprovado. Por que o envio ainda falha?
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.