Plataformas
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 Business | API oficial (WhatsApp Business Platform) | Ferramenta não oficial | |
|---|---|---|---|
| Como se usa | Baixa no celular e atende | Sistema ou provedor se conecta ao WhatsApp por programação | Liga o WhatsApp do celular a um painel por um método que a Meta não oferece |
| Atendentes | Pensado para um número operado por poucas pessoas, a partir do aparelho | Quantos o seu sistema comportar, cada um com seu login | Vários, mas dependente do celular ligado e conectado |
| Mensagens automáticas | Ferramentas simples, como a mensagem de ausência | Fluxos automáticos com modelos de mensagem aprovados | Vários recursos, sem a garantia do canal oficial |
| Integração com CRM e sistema | Não | Sim, é o objetivo da plataforma | Sim, mas por um caminho frágil |
| Risco principal | Limite de operação | Complexidade de montar e cobrança por mensagem | Bloqueio do número e perda do histórico de clientes |
| Veredito | Suficiente para a maioria das empresas pequenas | Certa quando o volume e a integração pedem | Evite 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.
- Central de Ajuda do WhatsApp Como usar as mensagens de ausência
- Meta para desenvolvedores API de Nuvem do WhatsApp Business Platform
- Meta para desenvolvedores Cobrança da WhatsApp Business Platform
- WhatsApp Link de conversa