Números de Telefone

Números de telefone são o ponto de contato direto entre sua empresa e seus clientes no WhatsApp. Cada número precisa ser verificado e registrado na API do WhatsApp Cloud antes de poder enviar e receber mensagens de forma estável.

Requisitos do número

Para usar um número de telefone no CloudWhats, ele deve atender aos seguintes requisitos:

Ser um número de telefone válido que pode receber SMS ou ligações
Não estar vinculado ao WhatsApp pessoal ou ao WhatsApp Business App
Estar em formato internacional (ex: +55 11 99999-9999)
Pertencer à mesma WABA que a credencial conectada

Se o número estiver sendo usado no WhatsApp pessoal ou no WhatsApp Business App, você precisará desvinculá-lo primeiro. Esse processo remove o número do app, mas não apaga o histórico no dispositivo.

Adicionando um número

Existem duas formas de adicionar um número ao CloudWhats:

Via Embedded Signup (recomendado)

Durante o fluxo de Embedded Signup, o Meta permite selecionar um número existente ou adicionar um novo. Esse é o caminho principal de onboarding para novas conexões no CloudWhats.

Operação manual em WABA existente

Se você já opera sua WABA manualmente, pode preparar o número no Meta e depois refletir essa conexão no CloudWhats:

Adicione e verifique o número no ecossistema Meta
Garanta que ele pertença à WABA correta
Conecte ou atualize a credencial correspondente no CloudWhats
Revise a página de Números para validar status e registro final

Processo de verificação

Após adicionar um número, é necessário verificá-lo:

Solicite o código — escolha receber por SMS ou ligação de voz
Insira o código — digite o código de 6 dígitos recebido
Finalize o PIN — algumas conexões exigem concluir o registro final com um PIN de 6 dígitos na própria plataforma
Revise o status final — confirme se o número ficou pronto para uso

O código de verificação deve ser inserido em até 10 minutos. Se expirar, solicite um novo código.

Status do número

No CloudWhats, os status mais relevantes para operação são:

Status	Descrição
Verificado (Meta)	A Meta reconheceu o número, mas ele ainda pode não estar operacional na API
CONNECTED	Número conectado pela Meta e apto a seguir para o registro final
Registro pendente	Falta concluir o passo final do PIN / 2-step verification
Sandbox ou erro	A conta ainda está limitada ou com algum problema de token/configuração

A página de números consulta e sincroniza o status com a Meta para ajudar você a identificar se o número realmente está pronto para uso.

Nome de exibição (Verified Name)

Cada número possui um nome de exibição verificado que aparece para os contatos no WhatsApp. Esse nome:

Precisa ser aprovado pelo Meta
Deve refletir o nome real da empresa ou marca
Não pode conter caracteres especiais ou nomes genéricos
Pode ser alterado, mas a alteração requer re-aprovação

PIN de verificação em duas etapas

O PIN de verificação em duas etapas é uma camada extra de segurança que protege seu número contra uso não autorizado:

PIN de 6 dígitos definido durante o registro
Necessário para re-registrar o número em outra plataforma
Pode ser atualizado via API ou Meta Business Manager

Guarde o PIN em local seguro. Se você perder o PIN e precisar migrar o número, será necessário aguardar 7 dias para poder redefini-lo.

Gerenciamento de números

Na página Configurações → Números, você pode:

Visualizar todos os números conectados e seus status
Verificar a qualidade (quality rating) de cada número
Atualizar o status diretamente na Meta
Finalizar o registro por PIN quando necessário
Editar o perfil comercial do número ativo
Remover números que não devem mais operar no CloudWhats