Que número usar na API do WhatsApp (Cloud API / BSP)? Número virtual compatível
Por NumioPublicado em
Pra usar a API do WhatsApp Business (Cloud API da Meta ou uma plataforma oficial, BSP) você precisa de um número de telefone que não esteja registrado em nenhuma conta do WhatsApp e que consiga receber o código de verificação por SMS ou por ligação de voz. Um número fixo virtual atende ao segundo requisito pela ligação: no WhatsApp Manager, você escolhe verificação por "ligação de voz", a Meta liga pro número fixo e dita o código. Na Numio essa ligação é atendida automaticamente e o código aparece no painel.
Portanto, o número fixo virtual da Numio (R$ 25,90/mês, R$ 16,90/mês no anual) é compatível com a Cloud API e com BSPs como Zenvia, Twilio, 360dialog, Gupshup e Take Blip — desde que a conta comercial no Meta Business seja verificada (a Meta exige empresa, com CNPJ) e o número esteja livre. A Numio fornece o número e a verificação; a plataforma de API é escolha sua.
Pra quem constrói produto (CRM, plataforma omnichannel, revenda), a Numio tem uma API B2B de parceiros: contratar números em nome do cliente final, fazer a validação de identidade (KYC), obter credenciais SIP e ativar o recebimento da ligação de verificação — tudo por API REST com token Bearer. A documentação está em numio.com.br/docs e a especificação OpenAPI em /docs/openapi.json.
Quais são os requisitos da Meta pra um número na API do WhatsApp?
- O número precisa ser seu (ou da sua empresa) e não pode estar ativo em outra conta do WhatsApp (app pessoal, Business ou outra API). Se estiver, apague a conta no app antes de registrar na API.
- Precisa receber SMS ou ligação de voz pro código de verificação. Número fixo: ligação de voz.
- A conta no Meta Business Suite precisa passar pela verificação de empresa (documentos da empresa, CNPJ) pra liberar limites de envio maiores e o nome de exibição.
- Número fixo, celular, 0800 e número virtual são aceitos; o que a Meta bloqueia são números já usados de forma abusiva ou de faixas restritas.
Como ativar um número fixo virtual na Cloud API da Meta? Passo a passo
1. Contrate o número fixo virtual
Em comprar número, escolha DDD e número, pague e valide a identidade. Número pronto no mesmo dia.
2. Crie o app e a conta do WhatsApp Business no Meta for Developers
No painel de desenvolvedores da Meta, adicione o produto WhatsApp ao seu app e vincule (ou crie) a conta WhatsApp Business (WABA) no Business Manager.
3. Adicione o número e escolha verificação por ligação
Em "Adicionar número de telefone", informe o número fixo com DDD (+55), e na etapa de verificação selecione ligação de voz, não SMS.
4. Pegue o código no painel da Numio
A Meta liga pro número; a Numio atende e mostra o código de 6 dígitos no painel, na página do número. Digite no WhatsApp Manager.
5. Configure o nome de exibição e a verificação da empresa
Complete a verificação de empresa no Business Manager pra liberar o nome de exibição e os limites de mensagens. Depois, gere o token e aponte o webhook do seu app (ou conecte o número no seu BSP).
Funciona com BSP (Zenvia, Twilio, 360dialog, Gupshup, Take Blip)?
Sim. O BSP hospeda a API pra você, mas o registro do número segue a mesma verificação da Meta (SMS ou ligação). No fluxo de onboarding do BSP, escolha ligação de voz e use o código exibido no painel da Numio. Os BSPs costumam exigir CNPJ e verificação de empresa; a Numio aceita pessoa física, mas a API da Meta não.
A Numio fornece o número e trata a ligação de verificação. Envio de mensagens, templates, webhooks e limites são da Meta e do BSP.
Posso usar o mesmo número no app WhatsApp Business e na API?
Não ao mesmo tempo. Um número está no app ou na API. Pra migrar do app pra API, faça backup, apague a conta no app e registre na API; a Meta permite migrar o número mantendo o histórico só em condições específicas (co-existência), disponíveis em alguns BSPs.
O que a API B2B da Numio faz (pra parceiros)?
A API /api/v1/* é pra empresas que querem embutir número fixo virtual no próprio produto: CRMs, plataformas de atendimento, revendas. Autenticação por Bearer token, emitido pelo time Numio.
| Recurso | O que faz |
|---|---|
| Clientes e KYC | Cadastra o cliente final e conduz a validação de identidade exigida pela Anatel. |
| Catálogo | Consulta números disponíveis por DDD, cidade e nível. |
| Contratação | Contrata o número em nome do cliente final. |
| SIP | Entrega credenciais SIP do número pra integrar a softphone ou PABX. |
| Verificação do WhatsApp | Ativa o recebimento da ligação de verificação e devolve o código. |
Referência interativa em /docs. Pra virar parceiro, escreva pra contato@numio.com.br.
Perguntas frequentes
Sim. A verificação é feita por ligação de voz em vez de SMS. O número precisa estar livre (não registrado em outra conta) e a empresa precisa ser verificada no Business Manager.
Pra API oficial (Cloud API ou BSP), sim: a Meta exige verificação de empresa. Pra contratar o número na Numio, não — pessoa física também pode.
Não. A Numio fornece o número fixo virtual e a verificação; não envia mensagens nem hospeda a API da Meta. Você usa o número na Cloud API direto ou num BSP.
Não. Número fixo não recebe SMS. Escolha "ligação de voz" na verificação; a Numio atende e mostra o código no painel.
O número fica pronto no mesmo dia da contratação. O registro na API leva minutos; a verificação de empresa da Meta pode levar de horas a alguns dias.
Sim. A conta WhatsApp Business (WABA) aceita vários números. Na Numio você contrata vários no mesmo pedido, com fatura única.