Que número usar num agente de IA que atende no WhatsApp pela API oficial?
Por NumioPublicado em
Um agente de IA que atende no WhatsApp pela API oficial precisa de um número de telefone próprio, registrado na Cloud API da Meta. O agente não fala com a operadora nem com o aparelho: ele recebe as mensagens por webhook, gera a resposta e devolve pela API. Qualquer número que a Meta aceite serve, inclusive fixo e virtual, desde que esteja livre no WhatsApp e receba o código de verificação.
O mais prático é dar ao agente um número só dele, separado do WhatsApp que a equipe usa no celular. Um número registrado na API sai do app, então pôr o número principal da empresa no agente tira a equipe do aparelho. Um número fixo virtual da Numio custa R$ 25,90/mês (R$ 16,90/mês no anual), fica pronto no mesmo dia e é verificado por ligação: a Meta liga, a Numio atende e mostra o código.
A Meta permite IA que atende os clientes do seu próprio negócio. O que os termos da plataforma proíbem, desde 15 de janeiro de 2026, é usar a API pra distribuir um assistente de IA de uso geral como produto principal.
Como o agente de IA se liga ao número?
- O cliente manda mensagem pro número.
- A Meta entrega a mensagem no webhook do seu sistema (ou da plataforma de agentes que você usa).
- O sistema monta o contexto (histórico, base de conhecimento, ferramentas) e chama o modelo de linguagem.
- A resposta volta pela Cloud API, com
POST /{PHONE_NUMBER_ID}/messages. - Se o agente não resolve, o sistema passa a conversa pra uma pessoa, na mesma janela.
O número é só o endereço. Trocar de modelo, de plataforma de agentes ou de fornecedor de automação não muda o número, e trocar de número não muda o agente: basta registrar o novo e apontar o mesmo webhook.
A Numio fornece o número e entrega o código de verificação. Envio de mensagens, templates, webhook, token e cobrança por mensagem são da Meta (ou do provedor oficial que você escolher). O número é fixo: não recebe SMS.
Por que usar um número só pro agente?
- A equipe continua no app. Número na API não abre no app do WhatsApp do celular. Com um número novo pro agente, o número antigo segue onde está.
- O risco fica isolado. Bloqueio por template mal avaliado ou por denúncia de usuário atinge o número do agente, não o de vendas.
- Homologação separada da produção. Um número pra testar o agente e outro pro ar evitam que um teste com prompt ruim responda cliente de verdade.
- Um agente por função ou por cliente. Agência que entrega agentes pra vários clientes usa um número por cliente, na conta do WhatsApp Business de cada um.
O que um número a mais não faz é aumentar o limite de envio: ele é da conta empresarial e é dividido entre os números. Veja a tabela em API oficial do WhatsApp.
O que a Meta permite e proíbe em agentes de IA?
Pelos termos da plataforma WhatsApp Business (seção sobre provedores de IA, lidos em 13 de outubro de 2026):
| Uso | Situação |
|---|---|
| Agente que atende clientes da sua empresa: dúvidas, vendas, agendamento, suporte | Permitido. A IA é função acessória do seu negócio |
| Agente que você constrói pra um cliente atender os clientes dele | Permitido, na conta do WhatsApp Business do cliente |
| Assistente de IA de uso geral oferecido ao público pelo WhatsApp, como produto principal | Proibido desde 15 de janeiro de 2026, salvo nos países onde a Meta é obrigada a aceitar |
| Usar os dados das conversas pra treinar um modelo de terceiros | Proibido. Ajuste fino de um modelo de uso exclusivo seu é permitido |
O Brasil está entre os países onde a Meta é obrigada a aceitar provedores de IA de uso geral, com uma cobrança própria pra essas mensagens, em vigor desde 11 de março de 2026. Isso só interessa a quem distribui um assistente genérico. Agente de atendimento do próprio negócio segue as regras comuns da plataforma.
Quanto custa manter um agente de IA no WhatsApp?
| Custo | Quem cobra | Como é cobrado |
|---|---|---|
| Número de telefone | Numio | Fixo: R$ 25,90/mês, ou R$ 16,90/mês no anual. Sem cobrança por mensagem |
| Mensagens | Meta | Por mensagem, direto com a Meta, conforme a tabela dela |
| Modelo de linguagem | O fornecedor do modelo | Por uso (tokens) |
| Plataforma de agentes ou automação | A ferramenta que você escolher | Assinatura ou por execução; zero se você hospeda o próprio código |
O custo das mensagens fica direto com a Meta, na tabela publicada no site dela. A Numio cobra só o número.
Como pôr o número no ar pro agente? Passo a passo
1. Contrate o número
Em escolher número, com o DDD da praça que o agente vai atender. Não ative o número no app do WhatsApp.
2. Registre na Cloud API
Adicione o número na conta do WhatsApp Business e peça o código por ligação de voz. O código aparece no painel da Numio. O passo a passo por código está em registrar número por API.
3. Aponte o webhook pro agente
No app da Meta, assine o campo
messagescom a URL do seu sistema ou da plataforma de agentes.4. Crie os templates
Pra o agente iniciar conversa (lembrete, retorno, cobrança) ele precisa de template aprovado. Dentro da janela de 24 horas ele responde com texto livre.
5. Teste com o seu celular e defina a passagem pra humano
Converse com o agente, force os casos em que ele não sabe responder e confira pra onde a conversa vai.
O agente também pode atender ligação nesse número?
São duas coisas diferentes. Ligação dentro do WhatsApp é a API de chamadas da Meta, que exige número na Cloud API e limite de envio de pelo menos 2.000. Ligação telefônica comum pro número é telefonia: no número da Numio, com o adicional de chamadas, você recebe as credenciais SIP e liga o número ao seu PABX ou ao seu agente de voz. Detalhes em número SIP.
Perguntas frequentes
Não é obrigatório, mas é o recomendado. Número registrado na API oficial sai do app do WhatsApp, então usar o número principal tira a equipe do celular. Com um número só do agente, o número atual continua como está.
Funciona. O agente se liga ao número pela Cloud API da Meta, que aceita número fixo e virtual verificados por ligação de voz. Depois do registro, o número se comporta como qualquer outro.
Não. A Meta permite IA que atende os clientes do seu negócio. O que os termos proíbem desde 15 de janeiro de 2026 é usar a API pra oferecer um assistente de IA de uso geral como produto principal.
Pela API oficial, só no modo de coexistência, que depende de um provedor oficial e tem limitações. Fora dele, o número fica no app ou na API.
Não. A Numio fornece o número e entrega o código de verificação da Meta. O agente, o modelo e a plataforma de automação são escolha sua.
Pode. Uma conta empresarial verificada registra até 20 números, e na Numio você contrata até 20 por pedido. Agências costumam usar um número por cliente, na conta de cada um.