Ir para o conteúdo
CL3 Marketing Orçamento grátis

API oficial do WhatsApp: quando usar, quando o aplicativo basta e o risco das ferramentas não oficiais


Em 30 segundos

  • A API oficial vale quando vários atendentes dividem um número, as conversas vão para o CRM e há mensagens automáticas.
  • Para uma ou duas pessoas atendendo pelo celular, o aplicativo WhatsApp Business costuma bastar.
  • Na API, só modelos aprovados podem ser enviados fora da janela de 24 horas; a cobrança é por mensagem entregue.
  • Ferramentas não oficiais ligam o celular a um painel por um caminho que o canal oficial não garante: há risco para o número.

A API oficial do WhatsApp (a WhatsApp Business Platform, da Meta) vale quando vários atendentes respondem pelo mesmo número, as conversas precisam entrar em um CRM ou sistema e parte das mensagens deve ser automática. Para uma pessoa atendendo pelo celular, o aplicativo WhatsApp Business basta. Ferramentas não oficiais são o caminho com mais risco.

O dono de uma empresa descobre o limite do WhatsApp comum quando o número fica cheio: três pessoas respondendo no mesmo aparelho, cliente repetindo o pedido para cada uma, conversa perdida quando o celular quebra, ninguém sabendo quem atendeu o quê. A pergunta seguinte é "preciso da API oficial?". A resposta depende do volume, do número de atendentes e, principalmente, do que a empresa quer ligar ao WhatsApp. Este texto compara as três opções que existem, diz o que cada uma exige e dá um veredito por situação. Não há valores, porque a cobrança muda, e o caminho certo é conferir na página oficial.

Qual a diferença entre o aplicativo WhatsApp Business, a API oficial e as ferramentas não oficiais?

O aplicativo é uma ferramenta de atendimento para quem usa o celular, a API oficial é uma plataforma para sistemas conversarem com o WhatsApp, e as ferramentas não oficiais tentam ligar o celular a um sistema sem a autorização da Meta. Cada uma resolve um tamanho de problema.

Aplicativo WhatsApp BusinessAPI oficial (WhatsApp Business Platform)Ferramenta não oficial
Como se usaBaixa no celular e atendeSistema ou provedor se conecta ao WhatsApp por programaçãoLiga o WhatsApp do celular a um painel por um método que a Meta não oferece
AtendentesPensado para um número operado por poucas pessoas, a partir do aparelhoQuantos o seu sistema comportar, cada um com seu loginVários, mas dependente do celular ligado e conectado
Mensagens automáticasFerramentas simples, como a mensagem de ausênciaFluxos automáticos com modelos de mensagem aprovadosVários recursos, sem a garantia do canal oficial
Integração com CRM e sistemaNãoSim, é o objetivo da plataformaSim, mas por um caminho frágil
Risco principalLimite de operaçãoComplexidade de montar e cobrança por mensagemBloqueio do número e perda do histórico de clientes
VereditoSuficiente para a maioria das empresas pequenasCerta quando o volume e a integração pedemEvite para número que traz clientes de verdade

Os detalhes do aplicativo, como a mensagem de ausência (que responde sozinha fora do horário, com texto personalizável), estão na central de ajuda do WhatsApp. Já o uso do WhatsApp ligado ao site, com botão e mensagem pronta, está em WhatsApp Business com site.

O que a API oficial permite que o aplicativo não permite?

Ela permite que um sistema envie e receba mensagens de forma programada, com vários atendentes e integração com o seu CRM ou o seu sistema. A documentação da Meta descreve a Cloud API como o meio de enviar mensagens e fazer chamadas no WhatsApp de forma programática, e indica que o material é voltado a desenvolvedores, sinal de que a plataforma exige uma integração (própria ou de um provedor), não só uma instalação.

Na prática, isso abre quatro possibilidades:

  • Vários atendentes no mesmo número, com fila, distribuição e histórico compartilhado. Quem já passou pela dor de atender em várias pessoas vai gostar do texto WhatsApp do site com várias pessoas atendendo.
  • Mensagens automáticas com modelo aprovado: confirmação de pedido, aviso de agendamento, lembrete de pagamento.
  • Integração com o CRM e com o sistema da empresa: a conversa vira registro do cliente, e o status do pedido pode ser consultado pelo próprio WhatsApp. É a lógica de site e CRM juntos.
  • Atendimento fora do horário com respostas padronizadas e encaminhamento ao responsável.

Quais as regras da API oficial que a empresa precisa conhecer?

Há duas regras estruturais: o modelo de mensagem aprovado e a janela de 24 horas de atendimento. Segundo a visão geral da Cloud API, os modelos de mensagem (templates) em geral precisam de aprovação antes do envio e são o único tipo de mensagem que pode ser enviado a quem está fora da janela de atendimento. Os modelos têm pontuação de qualidade e limites de mensagens.

A página sobre cobrança completa o quadro. A janela de 24 horas abre quando o cliente envia uma mensagem e reinicia a cada nova mensagem dele. Dentro dela, a empresa responde com mensagens livres. Fora dela, só com modelo. Para a empresa, isso significa:

  • Responder o cliente que acabou de escrever é o caso simples e flexível.
  • Puxar conversa com quem não escreveu há mais de um dia exige um modelo aprovado, e não vale para mensagem de improviso.
  • Mandar modelo a quem nunca pediu contato é má ideia: os modelos têm pontuação de qualidade e limites de mensagens, e o uso errado pesa nisso.

Antes de montar qualquer fluxo, leia a documentação oficial: as regras de modelo e de janela definem o que a sua automação pode e não pode fazer.

Como a cobrança da API oficial funciona?

A cobrança é por mensagem entregue, e não por conversa, e as mensagens do cliente para a empresa não são cobradas. Segundo a página oficial de cobrança, cada mensagem da empresa tem uma única categoria (marketing, utility e authentication são as dos modelos), e mensagens livres só podem ser enviadas com a janela de 24 horas aberta. A conta de mensagens gerencia modelos, cobrança e métodos de pagamento.

Aqui não há valores, de propósito: as tabelas mudam, variam por categoria e por mercado, e um número escrito agora pode estar errado quando você ler. O que dá para fazer, e é o certo, é abrir a página oficial, ver a categoria de cada mensagem que a sua operação pretende enviar e estimar o volume. Além da cobrança da Meta, há o custo de quem integra: o provedor, se você contratar um, ou o desenvolvimento, se a integração for própria (um trabalho de sistema web). Esse é o item que costuma surpreender, e merece entrar na comparação desde o começo, como no raciocínio de sistema sob medida: quando vale a pena.

Quando usar cada uma: o veredito por situação

  • Uma ou duas pessoas atendendo, poucas dezenas de conversas por dia: aplicativo WhatsApp Business, com respostas rápidas e mensagem de ausência. Ficar com ele é uma decisão correta, não um atraso.
  • Equipe de atendimento ou vendas, conversas que precisam ficar no CRM: API oficial, com um painel de atendimento ou um sistema que a use.
  • Avisos automáticos de pedido, agendamento ou cobrança: API oficial, com modelos aprovados.
  • "Só quero ligar o meu número a um painel barato": pare e avalie. É onde as ferramentas não oficiais tentam entrar, e o risco de bloqueio do número recai sobre quem o usa. Um número que traz clientes não deveria depender de um método que o canal oficial não oferece. Se quiser testar, use um número secundário, não o principal.

Repare que a decisão não é sobre tecnologia, e sim sobre tamanho de operação. Uma empresa pequena que pula direto para a API costuma gastar com uma estrutura que não usa. Uma que cresceu e continua no aplicativo perde conversas e tempo. Para decidir com calma, ajuda ter clareza da diferença entre site e sistema web, porque a integração com o WhatsApp só faz sentido quando existe um sistema do outro lado.

Como a CL3 liga o WhatsApp ao sistema da empresa

Quando o volume de conversas pede mais do que o aplicativo, a CL3 desenvolve a ligação como parte de um sistema web sob medida: o pedido ou o contato que chega pelo WhatsApp vira registro no sistema, o atendente vê o histórico do cliente e as mensagens automáticas saem dos eventos do negócio, como pedido confirmado ou agendamento marcado. O desenho começa por uma conversa sobre o seu atendimento (quantas pessoas, que tipo de pergunta, o que precisa ficar registrado), e a proposta chega por escrito, com valor fechado.

A CL3 também diz quando a API não é a resposta. Se o seu caso cabe no aplicativo, o melhor investimento é um site com botão de WhatsApp e mensagem pronta (o link de conversa, como explica a central de ajuda do WhatsApp, abre a conversa sem salvar o contato) e medição de quantos contatos o site gera. Em qualquer dos dois casos, a prévia fica num endereço provisório até você aprovar.

Para avaliar o seu caso, separe antes: quantas pessoas atendem, quantas conversas por dia, quais mensagens poderiam ser automáticas e o que precisa ir para o CRM ou o sistema. Com isso, o pedido de orçamento de sistemas web sob medida com integração ao WhatsApp chega com o escopo claro. Se o seu sistema atual for um ERP, o texto site integrado com ERP mostra como as peças se encaixam, e a página de contato leva à conversa.

Perguntas frequentes

Preciso de CNPJ ou de desenvolvedor para usar a API oficial?

A documentação da Meta é voltada a desenvolvedores, então a plataforma exige uma integração, feita por equipe própria ou por um provedor que já a oferece. Os requisitos da conta da empresa estão na documentação oficial e podem mudar, por isso confira lá antes de planejar. Para ligar a conversa ao sistema, veja site e CRM juntos.

Posso usar o mesmo número no aplicativo e na API oficial?

Isso depende das regras atuais da Meta para o número e do provedor escolhido, e elas mudam. Em geral, quem migra para a API precisa planejar o que acontece com o uso do aplicativo no mesmo número. Leia a documentação oficial e tire a dúvida com o provedor antes de mexer no número que já traz clientes, para não perder o histórico de conversas.

A API oficial do WhatsApp serve para disparar mensagem em massa?

Não é esse o desenho. Fora da janela de 24 horas, só modelos aprovados podem ser enviados, e eles têm pontuação de qualidade e limites. Mandar para quem não pediu contato pesa contra o número. A plataforma serve melhor para atender, avisar e confirmar com quem já tem relação com a empresa. Leia as regras oficiais antes de montar qualquer campanha.

Fontes citadas

Os documentos em que este artigo se apoia, na ordem em que aparecem no texto. Abra e confira.

  1. Central de Ajuda do WhatsApp Como usar as mensagens de ausência
  2. Meta para desenvolvedores API de Nuvem do WhatsApp Business Platform
  3. Meta para desenvolvedores Cobrança da WhatsApp Business Platform
  4. WhatsApp Link de conversa
Compartilhar no WhatsApp Marcar a CL3 como fonte preferida no Google

Pronto para ter um site que trabalha pela sua empresa?

Conte o que a sua empresa faz e a gente responde com uma proposta clara, sem enrolação.

Solicitar atendimento