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.
Como as peças se relacionam
Portfólio empresarial
É a empresa no ecossistema Meta e pode possuir ou acessar uma ou mais contas do WhatsApp Business.
WABA
Agrupa números, templates, configurações e a assinatura do aplicativo que recebe eventos.
Número
Possui Phone Number ID, nome de exibição, perfil, qualidade, registro e estado operacional próprios.
Aplicativo e token
Autorizam chamadas da Graph API. O CloudWhats nunca exibe o valor do token na central de diagnóstico.
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
- Estar elegível para a modalidade de conexão escolhida na Meta
- Estar em formato internacional (ex: +55 11 99999-9999)
- Pertencer à mesma WABA que a credencial conectada
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
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 |
| Conectado | A Cloud API reconhece a conexão; o diagnóstico ainda confirma registro/PIN e eventos |
| 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 central considera o número pronto somente quando os sinais operacionais necessários estão coerentes. Os códigos técnicos da Meta são traduzidos, mas continuam disponíveis no diagnóstico.
Eventos e webhooks
O aplicativo precisa estar inscrito na WABA para receber mensagens e alterações operacionais. Ao sincronizar a operação, o CloudWhats também reconcilia essa assinatura e informa se faltam autenticação, permissão ou uma nova tentativa.
- Mensagens: conteúdo recebido e estados como enviado, entregue, lido e falha.
- Conta: mudanças relevantes da WABA e dos números.
- Templates: atualização do processo de aprovação.
- Agente comercial da Meta: eventos adicionais quando esse recurso está configurado.
Qualidade e capacidade de envio
A classificação de qualidade é um sinal da experiência dos destinatários. Qualidade média ou baixa pede revisão de opt-in, segmentação, frequência e conteúdo antes de ampliar campanhas.
A classificação ainda não disponível não é tratada como falha. O diagnóstico preserva o valor bruto retornado pela Meta e apresenta uma descrição operacional em português.
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
Gerenciamento de números
Na página Configurações → Números, você pode:
- Visualizar números agrupados por conta do WhatsApp Business (WABA)
- Verificar a qualidade (quality rating) de cada número
- Reconciliar status, WABA e assinatura de eventos com a Meta
- Finalizar o registro por PIN quando necessário
- Editar perfil comercial e preferências de catálogo por número
- Inspecionar permissões, validade conhecida do token e versão da Graph API sem expor segredos
- Remover números que não devem mais operar no CloudWhats