Pular para o conteúdo

WhatsApp API oficial para vendas: o que é, quando você precisa e como conectar

A API oficial do WhatsApp — hoje chamada WhatsApp Business Platform — é a via autorizada pela Meta para uma empresa conversar com clientes em escala: vários atendentes no mesmo número, automação, integração com CRM e métricas de entrega. Você precisa dela quando o volume, o tamanho do time ou a automação passam do que o aplicativo WhatsApp Business consegue sustentar.

Definição

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.

Diagnóstico

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.

Comparativo

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 MetaConta e número registrados oficialmenteUso fora dos termos da plataforma
Risco para o númeroRegras públicas e qualidade monitoradaBloqueio sem aviso e sem recurso
Vários atendentes no mesmo númeroNativoDepende de contorno técnico instável
Mensagem após 24 horasTemplate aprovado pela MetaSem regra clara — e sem garantia
Métricas de entrega e leituraRecibos oficiais da MetaParciais e não auditáveis
CustoCobrança da Meta por mensagem, previsívelBarato 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.

Embedded Signup

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.

Você entra com a sua conta da Meta em uma janela da própria Meta — as credenciais não passam por nós.

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.

O número é registrado e passa a receber e enviar mensagens pela plataforma.

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.

Regras da API oficial

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.

Custos

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

Preciso trocar de número para usar a API oficial?

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.

A API oficial do WhatsApp tem aplicativo?

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 que é a janela de 24 horas do WhatsApp?

É 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.

Posso usar uma conexão por QR code em vez da API oficial?

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.

Quanto tempo leva para conectar o número?

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.

Quer conectar seu número sem QR code?

O onboarding é feito pelo fluxo oficial da Meta, dentro da plataforma, e o agente de IA já entra respondendo, qualificando e agendando.

Demo de 30 minutos com a sua oferta real. A partir de R$ 599/mês, sem cobrança por tokens de IA.

Falar com a Dialogra
Agendar demo de 30 min