O que é a API oficial do WhatsApp?
É a interface que a Meta oferece para empresas integrarem o WhatsApp aos seus próprios sistemas. Diferente do aplicativo, ela não é feita para ser usada por uma pessoa em um celular: ela é feita para ser conectada a uma plataforma, que passa a enviar e receber mensagens, distribuir conversas entre atendentes, aplicar automações e registrar tudo em um CRM.
Na prática, isso significa que a API oficial nunca é contratada sozinha. Você contrata a plataforma que vai operá-la — e é essa plataforma que determina o que você consegue fazer com o canal.
Como saber se a sua empresa precisa da API oficial?
Vale avaliar a migração se pelo menos uma destas situações descreve a sua operação:
- Mais de uma pessoa precisa atender no mesmo número, ao mesmo tempo, sem passar o celular de mão em mão.
- Os leads chegam mais rápido do que o time consegue responder, e a demora está custando venda.
- Você precisa que a conversa vire registro no CRM automaticamente, sem alguém copiando e colando.
- Você quer automação de verdade — qualificação, agendamento, follow-up — e não só respostas rápidas salvas.
- Você precisa de dados confiáveis de entrega, leitura e resposta para tomar decisão.
- O histórico do relacionamento não pode depender de um aparelho que pode quebrar, ser roubado ou sair da empresa junto com um funcionário.
Se nenhuma delas se aplica — você atende sozinho, com volume baixo e sem integração — o aplicativo WhatsApp Business provavelmente resolve, e migrar só adicionaria custo e complexidade.
API oficial ou conexão por QR code: a diferença que importa
Existem serviços que conectam o WhatsApp lendo o QR code do aplicativo, como se fossem o WhatsApp Web. É mais barato e mais rápido de ligar. O que se compra junto é risco:
| Critério | API oficial | Conexão por QR code |
|---|---|---|
| Autorização da Meta | Conta e número registrados oficialmente | Uso fora dos termos da plataforma |
| Risco para o número | Regras públicas e qualidade monitorada | Bloqueio sem aviso e sem recurso |
| Vários atendentes no mesmo número | Nativo | Depende de contorno técnico instável |
| Mensagem após 24 horas | Template aprovado pela Meta | Sem regra clara — e sem garantia |
| Métricas de entrega e leitura | Recibos oficiais da Meta | Parciais e não auditáveis |
| Custo | Cobrança da Meta por mensagem, previsível | Barato até o dia em que o número cai |
A Dialogra opera exclusivamente pela API oficial. Não oferecemos conexão por QR code — nem como alternativa mais barata.
Como conectar sem QR code
O maior atrito da API oficial sempre foi o começo: criar conta de negócio, criar a WABA, registrar o número, pedir verificação. A Dialogra é Tech Provider verificada da Meta e usa o Embedded Signup — o fluxo oficial da própria Meta, que roda dentro da plataforma.
- 01 Você entra com a sua conta da Meta em uma janela da própria Meta — as credenciais não passam por nós.
- 02 No mesmo fluxo, cria a conta de negócio e a WABA, ou importa uma WABA que você já tem, com os números e os templates já aprovados.
- 03 O número é registrado e passa a receber e enviar mensagens pela plataforma.
- 04 Você associa um agente de IA àquele número. Cada número pode ter o seu, com playbook e tom de voz próprios.
Em nenhum momento existe QR code, celular ligado ou aparelho que precise ficar online.
O que muda na operação depois de conectar
A API oficial traz regras que não existem no aplicativo. Elas não são burocracia: são o que mantém o canal saudável — e o que a sua plataforma precisa gerenciar por você.
Janela de 24 horas
Depois da última mensagem do cliente, você responde livremente por 24 horas. Passado esse prazo, só com template aprovado. A Dialogra bloqueia o envio livre fora da janela em vez de deixar a mensagem falhar silenciosamente.
Templates
Toda reabertura de conversa usa um modelo aprovado previamente. Os templates são criados, sincronizados e versionados dentro da plataforma, com as variáveis mapeadas para os dados do lead.
Qualidade e limite diário
A Meta atribui uma nota de qualidade e um limite de envio a cada número, que sobem conforme o histórico. A plataforma respeita esse limite ao disparar, em vez de estourar a cota e derrubar a reputação do número.
Opt-out
Pedido de descadastro é detectado na conversa e verificado antes de qualquer novo envio. Ignorar isso é o caminho mais rápido para derrubar a qualidade do número.
Quanto custa usar a API oficial
São dois custos separados, e confundi-los é o erro mais comum de quem está avaliando:
- — O que você paga à Meta, pelas mensagens. O preço varia por categoria — utilidade, marketing, autenticação e serviço têm valores diferentes — e é cobrado direto no meio de pagamento cadastrado na sua conta de negócio.
- — O que você paga à plataforma, pelo software que opera o canal.
A política de cobrança da Meta muda com alguma frequência, e uma mudança relevante entra em vigor em outubro de 2026. Explicamos o que muda em detalhe no blog: WhatsApp API oficial com novos valores.
Perguntas frequentes
Não necessariamente. Um número já em uso pode ser registrado na API oficial, mas ele deixa de funcionar no aplicativo WhatsApp Business — os dois não convivem no mesmo número. Muitas empresas preferem manter o app em um número de atendimento local e registrar um segundo número na API para a operação comercial. Na Dialogra é possível operar vários números ao mesmo tempo, com um agente de IA dedicado a cada um.
Não. A API oficial não tem tela própria: ela existe para ser conectada a uma plataforma que forneça a interface de atendimento, a automação e os relatórios. É por isso que contratar a API é sempre contratar também a plataforma que vai operá-la.
É o período em que a empresa pode responder livremente depois da última mensagem enviada pelo cliente. Passadas as 24 horas, só é possível reabrir a conversa com um template aprovado previamente pela Meta. Essa regra vale para qualquer plataforma que use a API oficial, e é ela que torna o gerenciamento de templates parte central da operação.
Tecnicamente existem serviços que fazem isso, mas é uso fora dos termos da Meta: o número pode ser bloqueado sem aviso e sem direito a recurso, levando junto o histórico de conversas e o relacionamento com os clientes. A Dialogra opera exclusivamente pela API oficial e não oferece conexão por QR code.
A conexão em si é feita em uma sessão, dentro do próprio fluxo da Meta, sem sair da plataforma. O que costuma alongar o processo é o que depende da Meta e da sua empresa: verificação do negócio, quando exigida, e aprovação dos primeiros templates. Números e WABAs já existentes podem ser importados com os templates já aprovados.
Leia também
- SDR com IA: o que é, como funciona e quando faz sentido
- WhatsApp comum, Business e API Oficial: qual é a diferença (e qual você precisa)?
- WhatsApp API Oficial com novos valores, entenda!
- Chatbot tradicional ou agente de IA: 7 diferenças práticas
- Verificador de WhatsApp: cheque de graça se um número tem conta
- Os canais em que o agente de IA da Dialogra atua