Ir para o conteúdo
OmniChannels.ai

Qual número usar na API do WhatsApp Business? Regras

Qual número usar na API do WhatsApp Business? Regras da Meta para celular, fixo, 0800 e virtual, códigos por SMS ou voz e números que já estão no WhatsApp.

Atualizado em 9 min de leitura

Por OmniChannels.ai Editorial Team · Revisado por BroadNet Messaging Solutions Team

WhatsApp

Resposta curta

Para a API do WhatsApp Business, use um número que seja seu, com código do país e de área, e que receba SMS ou ligação de voz. Short codes não são aceitos. A Meta recomenda números de celular; fixo, 0800 e virtuais podem funcionar se receberem o código de verificação, em geral por ligação. Um número já usado no WhatsApp precisa ser excluído antes, exceto se for de um app WhatsApp Business conectado por coexistência.

Nesta página
  1. Qual número de telefone você pode usar na API do WhatsApp Business?
  2. Dá para usar telefone fixo, 0800 ou número virtual?
  3. Como receber o código de verificação?
  4. E se o número já estiver no WhatsApp?
  5. Quantos números de telefone uma empresa pode registrar?
  6. Há considerações por país?
  7. Como manter a propriedade do número?
  8. Quais são os erros comuns?
  9. Exemplo prático: uma varejista de Jidá
  10. Como a OmniChannels.ai ajuda

Pontos principais

  • A Meta exige que o número seja seu, tenha código do país e de área, receba ligações de voz ou SMS e não seja um short code.
  • Números de celular são o tipo recomendado; para fixo, 0800 e virtuais, a Meta classifica o código por SMS como não recomendado e o código por voz como padrão.
  • Um número em uso no WhatsApp não pode ser registrado até ser excluído, exceto números do app WhatsApp Business que você conecta por coexistência.
  • Um portfólio empresarial novo pode registrar dois números comerciais; a verificação, ou atingir o limite de 2.000 mensagens, eleva o teto para 20.
  • Mantenha o número no seu nome e no seu portfólio, porque um número que você não controla não pode ser recuperado, migrado nem verificado por você.

Este guia é para quem está escolhendo um número de telefone para a API do WhatsApp Business. Ele lista os tipos de número que a Meta aceita, como o código de verificação chega até você, o que fazer se o número já estiver no WhatsApp, quantos números uma empresa pode registrar e como manter o controle do número. As regras da Meta mudam, então confirme-as nas páginas para desenvolvedores indicadas.

Qual número de telefone você pode usar na API do WhatsApp Business?

Use um número que seja seu, que tenha código do país e de área e que receba SMS ou ligação de voz. A Meta também diz que o número deve ter capacidades escaláveis e que short codes não são aceitos.

As quatro condições da documentação de números de telefone da Meta são:

  1. Ser seu. O número deve pertencer à sua empresa, não a uma agência nem a um funcionário.
  2. Código do país e de área. Deve ser um número internacional completo, então short codes estão fora.
  3. Receber ligações de voz ou SMS. É assim que o código de verificação chega.
  4. Capacidades escaláveis. A Meta lista isso como requisito sem mais detalhes na página que revisamos; na dúvida, pergunte à sua operadora ou à nossa equipe.

A WhatsApp Business Platform trata cada número como um número comercial ligado a uma conta do WhatsApp Business. Um número não é um login nem uma vaga de equipe: todos os seus atendentes o compartilham pela caixa de entrada. Nosso guia de configuração mostra onde o número entra no onboarding.

Dá para usar telefone fixo, 0800 ou número virtual?

Muitas vezes sim, desde que o número receba a ligação de registro. A Meta recomenda números de celular e classifica os outros tipos assim.

Tipo de número Código por SMS (classificação da Meta) Código por voz (classificação da Meta) Observações
Celular Padrão (tipo recomendado) Padrão Caminho mais fácil
Fixo (linha fixa) Não recomendado Padrão Peça o código por ligação
Gratuito (0800) Não recomendado Padrão Peça o código por ligação
Virtual (VoIP) Não recomendado Padrão O provedor deve permitir SMS ou chamadas internacionais para OTP
Número atrás de uma URA (estilo 1-800) Não abordado Deve aceitar chamadas internacionais Pode ser registrado se a ligação de registro chegar até você
Pager Não aceito Não aceito
Chip M2M / IoT Não recomendado Não recomendado

Em números virtuais, o risco prático é o provedor bloquear códigos internacionais recebidos. Teste uma chamada internacional recebida antes de começar e mantenha o número ativo depois do registro.

Como receber o código de verificação?

Você solicita um código por SMS ou ligação de voz e depois informa o código recebido. A documentação da Meta diz que os números devem ser verificados com um código enviado por SMS ou ligação de voz.

Na API, são duas chamadas: uma de solicitação de código, com code_method igual a SMS ou VOICE e um idioma, e outra de verificação, com o código. Se o número já estiver verificado, a chamada de solicitação retorna HTTP 400 com o código de erro 136024, então consulte antes o status de verificação. Se você faz o onboarding com o Embedded Signup, as telas fazem isso por você.

Dicas para uma verificação sem problemas:

  • Use um chip ou uma linha que esteja em suas mãos quando começar.
  • Em um fixo, deixe alguém perto do telefone e peça a opção de voz.
  • Se usar uma URA, garanta que a ligação chegue a uma pessoa ou a um ramal que leia o código.
  • Lembre-se da verificação em duas etapas: a Meta exige um PIN ao registrar um número comercial, e você precisará dele depois para alterar o PIN ou excluir o número. Guarde-o no seu gerenciador de senhas.

E se o número já estiver no WhatsApp?

Um número já em uso no WhatsApp não pode ser registrado sem ser excluído antes. A documentação da Meta afirma isso e diz também que um número banido deve ser desbloqueado pelo processo de contestação antes do registro.

Você tem três opções:

Opção Quando serve O que você abre mão
Usar um número novo Você quer uma separação limpa Os clientes precisam aprender o novo número
Excluir o número da conta do WhatsApp e depois registrá-lo Você não precisa mais do histórico de conversas nesse app As conversas antigas; faça backup antes
Conectar um número do app WhatsApp Business por coexistência Você quer continuar usando o app Business junto com a API Alguns recursos do app mudam (veja abaixo)

Na coexistência, a empresa usa o Embedded Signup com um provedor, e a documentação da Meta descreve estes efeitos: a empresa continua usando o app Business, os apps complementares são desvinculados no onboarding, conversas em grupo não são sincronizadas, as listas de transmissão existentes passam a ser somente leitura e até seis meses de histórico de conversas podem ser sincronizados. As mensagens enviadas pelo app continuam gratuitas. A Meta exige uma versão mínima do app Business, então confira o requisito atual antes de começar.

Se você está levando para outro provedor um número que já está na API, isso é uma migração, não um novo registro. Veja migrar um número do WhatsApp entre provedores.

Quantos números de telefone uma empresa pode registrar?

Um portfólio empresarial novo pode registrar dois números comerciais. A documentação da Meta diz que o teto sobe para 20 quando a empresa é verificada ou atinge o limite de 2.000 mensagens.

Os limites de mensagens são definidos no nível do portfólio e compartilhados por todos os números dele, então um número pode usar toda a capacidade em um período. Ao planejar vários números, por exemplo vendas, suporte e cobrança, pense no papel de cada um:

  • um número por mercado, para que o código do país pareça local;
  • um número por marca, com seu próprio nome de exibição;
  • um número para marketing e outro para atendimento, o que facilita a leitura da qualidade.

Cada número precisa do próprio nome de exibição; veja o guia de nome de exibição. Elevar o teto é um dos motivos para concluir a verificação de empresa. Confira o teto atual do seu portfólio no Business Suite.

Há considerações por país?

Sim, principalmente na aparência dos números e em quem pode receber a ligação de verificação. Escolha um número coerente com o mercado que você atende e confirme que seu provedor consegue entregar os códigos nele.

  • Números locais e estrangeiros. Uma empresa sediada nos Emirados pode registrar um número +971; uma empresa que atende clientes sauditas pode registrar um número +966 se tiver um. Alguns clientes confiam mais em um número local.
  • Formatação. A Meta observa que, para Brasil e México, a Cloud API pode acrescentar um prefixo extra aos números, o que é tratado como comportamento normal. Guarde sempre os números no formato E.164; nosso formatador de números de telefone os valida.
  • Regras de telecomunicações. As regras locais sobre quem pode ter ou alugar um número podem variar por país. Pergunte à sua operadora e ao órgão regulador, em vez de presumir que um número estrangeiro ou virtual é permitido.

Nossas páginas de mercado explicam o contexto local, como WhatsApp nos Emirados Árabes e WhatsApp na Arábia Saudita.

Como manter a propriedade do número?

Mantenha o número registrado no nome da sua empresa, com o seu próprio portfólio empresarial como dono da conta do WhatsApp Business. Se um provedor mantém o número no nome dele, você não consegue movê-lo, recuperá-lo nem provar a titularidade.

  • Compre ou mantenha o número junto a uma operadora, no nome da sua empresa.
  • Mantenha o portfólio sob as suas contas de administrador, com pelo menos dois administradores.
  • Guarde o PIN de verificação em duas etapas em um gerenciador de senhas compartilhado.
  • Só um administrador do portfólio empresarial pode excluir um número comercial, e a Meta não permite a exclusão se o número enviou mensagens pagas nos últimos 30 dias.
  • Não deixe um provedor reatribuir um número de que você depende sem um plano por escrito.

O Embedded Signup, que a BroadNet usa, cria a conta sob os seus ativos da Meta desde o primeiro dia.

Quais são os erros comuns?

  • Usar um chip pessoal. Um número que sai da empresa com um funcionário é difícil de recuperar.
  • Escolher um short code ou uma linha premium. Short codes não são aceitos.
  • Começar a verificação sem o telefone à mão. Garanta que alguém consiga ler um SMS ou atender a ligação de voz quando você pedir o código.
  • Ignorar a conta existente no WhatsApp. O número precisa ser excluído ou conectado por coexistência antes.
  • Registrar por um provedor virtual que bloqueia SMS internacional. Use voz ou escolha outro número.
  • Esquecer o teto. Planeje a verificação antes de precisar do terceiro número.

Exemplo prático: uma varejista de Jidá

A "Waha Market", uma rede de mercados fictícia, quer um número de suporte e um de marketing. A equipe de suporte já usa o app Business no celular da loja, e o marketing tem um telefone fixo da matriz.

A equipe conecta o número do app Business da loja por coexistência com um provedor, aceitando que as listas de transmissão ficam somente leitura, e registra o fixo por ligação de voz. Os dois números estão no nome da empresa e ficam em um portfólio com dois administradores. Eles pedem a verificação antes de precisar do terceiro número, já que um portfólio novo é limitado a dois. Cada um recebe um nome de exibição com a marca e o departamento.

Como a OmniChannels.ai ajuda

A OmniChannels.ai faz o onboarding de números da API do WhatsApp Business pelo Embedded Signup da Meta, de modo que o número, o portfólio e o nome de exibição ficam sob os seus próprios ativos da Meta. A BroadNet é Provedora de Soluções Empresariais oficial da Meta, e nossa equipe prepara com você o registro do número, a verificação de empresa e o nome de exibição; as decisões de aprovação ficam com a Meta. Use o checklist de prontidão para a API do WhatsApp para testar seu número e depois agende uma demonstração.

Perguntas frequentes

Posso usar um telefone fixo na API do WhatsApp Business?

Sim, se ele atender aos requisitos da Meta: ser seu, ter código do país e de área e receber uma ligação de voz. A Meta classifica códigos por SMS para fixos como não recomendados e códigos por voz como padrão, então peça o código por ligação. Teste a ligação antes, porque um fixo que não atende a chamada de registro vai falhar.

Posso usar um número 0800 ou virtual?

Muitas vezes sim, com condições. Para números gratuitos (0800) e virtuais (VoIP), a Meta classifica a verificação por voz como padrão e o SMS como não recomendado. Números atrás de uma URA podem ser registrados, mas precisam aceitar chamadas de números internacionais. O provedor do número virtual precisa permitir SMS ou chamadas internacionais para o código.

Como recebo o código de verificação da API do WhatsApp Business?

Você solicita o código por SMS ou ligação de voz, escolhendo o método e o idioma, e depois informa o código recebido. Um número de celular aceita os dois métodos normalmente. Em fixos, 0800 e virtuais, a voz é a escolha confiável. Nossa equipe pode fazer isso com você durante o onboarding.

Posso usar um número que já está no app do WhatsApp?

Um número já em uso no WhatsApp não pode ser registrado na API sem ser excluído antes, então faça backup das conversas que quiser guardar. A exceção é um número do app WhatsApp Business conectado por coexistência pelo Embedded Signup, que permite à empresa continuar usando o app junto com a API.

Quantos números de telefone uma conta do WhatsApp Business pode ter?

A Meta limita um portfólio empresarial novo a dois números comerciais registrados. O teto sobe para 20 quando a empresa é verificada ou atinge o limite de 2.000 mensagens. Os limites de mensagens são compartilhados por todos os números do portfólio, então um número muito ativo pode consumir toda a cota.

Posso continuar ligando e enviando SMS pelo número depois de registrá-lo?

Sim. A Meta diz que um número registrado ainda pode ser usado no dia a dia, para ligações e mensagens de texto, mas não pode mais ser usado com o app comum do WhatsApp. Os códigos de verificação por voz e SMS continuam chegando ao número, então mantenha-o ativo.

Fontes

  1. Phone numbers: WhatsApp Business Platform, Meta for Developers
  2. Phone numbers: WhatsApp Cloud API, Meta for Developers
  3. Onboarding WhatsApp Business app users (coexistence): Meta for Developers
  4. Messaging limits: WhatsApp Business Platform, Meta for Developers
  5. Display names: WhatsApp Business Platform, Meta for Developers