Perguntas frequentes sobre WhatsApp Business API e agentes de IA
As dúvidas que mais aparecem sobre atender no WhatsApp com a API oficial da Meta e com agentes de IA. Cada resposta é independente — leia só a que interessa.
Atualizado em 2 de setembro de 2026
Nivox e a API oficial do WhatsApp
- O que é a Nivox?
- A Nivox é uma plataforma de atendimento no WhatsApp construída sobre a API oficial da Meta (Cloud API). Você conecta o número da sua empresa pelo cadastro incorporado da Meta, atende os clientes em uma caixa de entrada em tempo real com a equipe toda e, no mesmo número, pode dar acesso a agentes de IA com papéis e permissões definidos por você.
- O que é a API oficial do WhatsApp (Cloud API)?
- A Cloud API é a interface que a Meta hospeda para empresas enviarem e receberem mensagens no WhatsApp de forma programática. Ela é a única via oficial e suportada: a conta fica registrada no seu nome, as mensagens passam pelos servidores da Meta e não há celular ligado nem QR code no meio do caminho.
- A Nivox é parceira da Meta?
- A Nivox conecta números pelo caminho oficial de Tech Provider da Meta: Cloud API mais Embedded Signup, o cadastro incorporado que acontece dentro do site. A WhatsApp Business Account criada é sua — se um dia você sair da Nivox, o número e o histórico de aprovação continuam com você.
- Preciso de um número novo para usar a Nivox?
- Não necessariamente. Você pode usar um número que ainda não está em nenhuma conta de WhatsApp, migrar um número que hoje está no app WhatsApp Business ou adquirir um número virtual dentro da própria plataforma. O que não dá é usar um número que continue ativo no WhatsApp pessoal comum.
- Posso continuar usando o aplicativo WhatsApp Business no celular?
- Sim, através do modo de coexistência. Nele o número funciona ao mesmo tempo no aplicativo do celular e na API oficial: a equipe continua respondendo pelo app se quiser, e as mesmas conversas aparecem na caixa de entrada da Nivox. A conexão é feita lendo um QR code dentro do fluxo oficial da Meta, uma única vez.
- Quanto custa enviar mensagens pelo WhatsApp?
- A Meta cobra por mensagem enviada a partir de modelos (templates), com preço diferente por categoria — marketing, utilidade e autenticação — e por país de destino. Respostas de atendimento dentro da janela de 24 horas aberta pelo cliente não são cobradas pela Meta. A tabela oficial de preços é publicada pela própria Meta e vale para a sua conta, independentemente da plataforma que você usa.
Agentes de IA, MCP e OAuth
- Como um agente de IA atende no meu WhatsApp?
- A Nivox expõe a conta de WhatsApp como um servidor MCP. Clientes como Claude, ChatGPT, Cursor, Codex, n8n ou um agente próprio se conectam a esse servidor e passam a ler a caixa de entrada, responder conversas e enviar templates — sempre com as mesmas regras que a equipe humana segue.
- O que é MCP (Model Context Protocol)?
- MCP é um protocolo aberto que padroniza como um modelo de IA conversa com ferramentas e dados externos. Em vez de escrever uma integração para cada assistente, você publica um servidor MCP uma vez e qualquer cliente compatível passa a usá-lo. A Nivox fala MCP por HTTP, com autenticação por OAuth 2.1 ou por chave de API.
- O cliente sabe que está falando com um agente?
- Sim. Cada mensagem enviada registra quem a enviou — uma pessoa da equipe ou um agente identificado pelo nome —, e a caixa de entrada mostra essa autoria na conversa. O cliente vê um número só, e o histórico deixa claro em que momento o atendimento passou do agente para uma pessoa.
- Que permissões um agente de IA recebe?
- O acesso do agente é uma credencial com escopo, e o escopo é um papel: leitura equivale a um visualizador, mensagens equivale a um atendente e completo equivale a um gerente. Um agente com escopo de leitura nunca envia mensagem, e nenhum escopo dá acesso a ações administrativas como convidar pessoas ou desconectar números.
- Posso revogar o acesso de um agente?
- Sim, a qualquer momento e sem afetar o resto da equipe. As credenciais ficam listadas na área de integrações — tanto as chaves criadas manualmente quanto os acessos concedidos por OAuth — e revogar uma delas derruba aquele agente imediatamente.
- O agente pode enviar mensagem para qualquer número?
- Só dentro das mesmas regras que valem para a equipe: uma conversa já aberta pode ser respondida livremente por 24 horas, e fora disso apenas um template aprovado pode iniciar contato. Além disso, cada credencial só enxerga os números de WhatsApp que o administrador liberou para ela.
Mensagens, templates e regras do WhatsApp
- O que é a janela de 24 horas do WhatsApp?
- É o período em que a empresa pode responder livremente, com qualquer tipo de mensagem, depois que o cliente escreve. A janela abre a cada nova mensagem recebida e dura 24 horas. Passado esse prazo, só um template aprovado pode reabrir a conversa.
- O que são templates e por que precisam de aprovação?
- Templates são mensagens pré-cadastradas — com variáveis, botões e mídia opcionais — que a Meta revisa antes de permitir o envio. A revisão existe para conter spam: como o template é a única forma de iniciar uma conversa fora da janela de 24 horas, a Meta verifica categoria e conteúdo antes de liberar. A aprovação costuma sair em minutos.
- Posso enviar mensagens em massa pelo WhatsApp?
- Pode enviar templates para listas de contatos que optaram por receber, respeitando a categoria correta e o limite de envio da sua conta. O que a Meta não permite é disparo para listas compradas ou contatos que nunca autorizaram: isso derruba a qualidade do número e leva a restrição de envio.
- Meu número pode ser banido?
- Na API oficial, o risco vem da qualidade das mensagens, não da ferramenta: bloqueios e denúncias dos destinatários derrubam a classificação de qualidade do número e podem reduzir o limite de envio ou restringir a conta. Enviar só para quem pediu, usar a categoria certa em cada template e responder rápido é o que mantém o número saudável.
- Qual a diferença entre a API oficial e uma API não oficial por QR code?
- A API não oficial automatiza o WhatsApp comum lendo um QR code, sem contrato com a Meta — é uma violação dos termos de uso e o número pode ser desativado sem aviso nem recurso. A API oficial é o contrário: conta registrada, regras públicas, suporte da Meta e um histórico de qualidade que você acompanha.
Conta, equipe e dados
- Quantas pessoas podem usar a mesma conta?
- A conta é da organização, não de uma pessoa. Você convida a equipe por e-mail e atribui um papel a cada um — administrador, gerente, atendente ou visualizador —, e cada papel enxerga apenas o que precisa. Todos atendem pelo mesmo número, na mesma caixa de entrada.
- A Nivox lê as minhas conversas?
- As mensagens ficam guardadas na sua organização para montar a caixa de entrada e o histórico, isoladas por regras de acesso no banco de dados. Elas não são usadas para treinar modelos, não são vendidas e não são compartilhadas com terceiros para publicidade.
- Onde ficam armazenados os dados?
- A infraestrutura roda em Supabase na região de São Paulo (sa-east-1), com isolamento por organização em nível de banco. Os tokens de acesso da conta de WhatsApp ficam em uma tabela sem nenhuma política de leitura: nem o navegador nem a equipe têm acesso a eles.
- Como excluo minha conta e meus dados?
- A página de exclusão de dados, ligada no rodapé do site, descreve o pedido e o prazo. Ao excluir a conta, as conexões de WhatsApp são desfeitas e as mensagens e os dados da organização são removidos.
- Já posso criar uma conta?
- O cadastro aberto ainda não está liberado: novas contas entram por lista de espera enquanto a plataforma está em acesso controlado. A documentação para agentes já é pública e pode ser lida antes de entrar.
Ficou alguma dúvida?
As perguntas frequentes cobrem preço, regras da Meta, papéis da equipe e acesso de agentes. A documentação técnica é pública e pode ser lida por qualquer agente de IA.