Segunda-feira, 8h40. Você abre o WhatsApp da empresa e, no lugar das 47 conversas da noite, aparece o aviso de que a conta foi suspensa. O número está no cartão, na fachada e no anúncio. Esse é o cenário que quem pesquisa “API oficial do WhatsApp” quer evitar, e que é um risco real para quem conectou o sistema de atendimento por um caminho que a Meta não oferece. Esta página explica o que é a API oficial, como ela difere do app e das conexões não oficiais, quem pode usar e como contratar, em linguagem de dono de empresa.
O que é a API oficial do WhatsApp
O nome técnico é WhatsApp Business Platform. É o conjunto de ferramentas que a Meta oferece para empresas conectarem o WhatsApp a sistemas de atendimento, automação e envio de mensagens. A parte que quem desenvolve usa é a Cloud API; para quem não desenvolve, existem plataformas que fazem essa ligação (você ouve “WhatsApp Business API”, “WhatsApp oficial para empresas” e “API de WhatsApp para empresas” para falar da mesma coisa).
Segundo a documentação da Meta, o requisito de base é ter um portfólio empresarial (a conta da empresa na Meta). A conta de WhatsApp e a de mensagens ficam dentro dele, e o número da empresa recebe um nome de exibição.
Importante: API não é um programa que você abre. Ela é a conexão. Para a equipe atender, é preciso um sistema por cima, como um sistema de atendimento no WhatsApp. E se o seu objetivo é programar a integração você mesmo, o guia técnico de WhatsApp Cloud API explica o caminho.
API oficial × app WhatsApp Business × conexão não oficial
| App WhatsApp Business | API oficial | Conexão não oficial | |
|---|---|---|---|
| Quem fornece | WhatsApp (grátis) | Meta, por meio de plataformas parceiras | Ferramentas de terceiros que imitam o WhatsApp Web |
| Como conecta | App no celular | Cadastro incorporado da Meta | Imita o WhatsApp Web: você lê um QR code e a ferramenta passa a controlar a conta |
| Várias pessoas atendendo | Até 4 aparelhos (10 com assinatura da Meta) | Sim, pelo sistema | Sim, mas fora do que a Meta autoriza |
| Regra do WhatsApp | Dentro dos termos | Dentro dos termos, com regras de uso e de consentimento | Os termos barram meios “não autorizados ou automatizados” |
| Custo | Sem mensalidade | Plataforma + tarifa da Meta por mensagem entregue | Varia por ferramenta |
Por que robô pendurado no WhatsApp Web bloqueia número
Não é azar. É consequência de regra. Os termos de serviço do WhatsApp proíbem usar o serviço para mensagens em massa e mensagens automáticas, proíbem criar contas ou acessar o serviço por meios não autorizados ou automatizados, e dizem que o WhatsApp pode desativar ou suspender a conta de quem descumprir. As conexões não oficiais operam nesse espaço: a Meta não oferece essa conexão como produto.
A API oficial não é uma garantia contra qualquer problema. A política da Meta diz que as pessoas podem bloquear ou denunciar empresas, e que os sistemas da Meta podem limitar quantas mensagens uma empresa envia quando há feedback negativo (política do WhatsApp Business). A diferença é que, na API oficial, as regras são as da própria Meta, você sabe quais são, e a conexão é uma que ela reconhece. A página número de WhatsApp bloqueado: por que acontece e como evitar detalha o que derruba.
Pergunte antes de contratar. “A conexão usa a WhatsApp Business Platform da Meta, com o cadastro incorporado da Meta?” Se a resposta for evasiva, desconfie. Atenção: o cadastro oficial por coexistência também pode usar a leitura de um código no celular, mas ele passa pelo fluxo da Meta, com login na conta da empresa; a conexão não oficial é a que se faz passar pelo WhatsApp Web.
Quem pode usar a API oficial (inclusive empresa pequena)
Quem tem uma empresa e um número. Não é restrita a empresa grande: o que costuma travar a empresa pequena é a parte técnica, e é isso que as plataformas parceiras resolvem. O que importa saber:
- Portfólio empresarial na Meta. É o requisito de base da plataforma.
- Verificação da empresa. Não é o único caminho, mas é um deles para subir o limite de envio. Contas novas começam podendo iniciar conversa com 250 pessoas por período de 24 horas; completar a verificação (ou enviar mensagens de qualidade para muita gente) leva o limite a 2.000 e, depois, a patamares maiores (limites de mensagem da Meta). O limite vale para mensagens iniciadas por você; responder quem escreve não depende dele.
- Consentimento. Para escrever primeiro com mensagem de modelo, o cliente precisa ter aceito receber, e fora da janela de 24 horas só vão mensagens de modelo aprovado.
Como contratar a API oficial, passo a passo
- Escolha uma plataformaPergunte se a conexão usa a API oficial da Meta, quanto custa a plataforma e quanto custa a Meta. Peça o preço dos dois.
- Conecte pelo cadastro da MetaA plataforma abre o fluxo de cadastro incorporado: você entra com a conta do Facebook, escolhe ou cria o portfólio da empresa e informa o número.
- Defina o que acontece com o seu númeroSe ele já está no app WhatsApp Business, o caminho é a coexistência, que mantém o app funcionando. Sem coexistência, o número deixa de ser usado no app.
- Cadastre o nome de exibição e, se quiser, verifique a empresaO nome aparece para o cliente. A verificação ajuda a subir o limite de envio.
- Organize a equipeCrie os setores, os atendentes e os prazos. Os modelos de mensagem aprovados só são necessários para falar primeiro com o cliente.
Conectar sem trocar de número. No Cenvia você liga o número pela API oficial com coexistência, e a gente acompanha a conexão com você.
Testar grátisQuanto custa a API oficial do WhatsApp
São duas contas. A da plataforma, que no Cenvia é de R$270 por mês com até 6 atendentes (extra: R$50 por atendente), sem taxa para começar e sem multa. E a da Meta, cobrada à parte, direto da Meta, por mensagem entregue, com valor que depende da categoria e do país do cliente. As mensagens que o cliente envia para você não são cobradas. A tabela em reais, com a data da conferência, está em quanto custa a API do WhatsApp. O site cenvia.com.br traz as condições atuais do plano.
API oficial sem largar o app: a coexistência
Até pouco tempo, ligar um número à API significava abandonar o app no celular. A Meta criou a coexistência para isso: o mesmo número funciona no WhatsApp Business e no sistema ao mesmo tempo. Pela documentação da Meta, exige o app WhatsApp Business na versão 2.24.17 ou superior, e o histórico das últimas conversas (até 180 dias) pode ser sincronizado. No Cenvia, os 180 dias de conversa e a agenda de contatos entram na conexão. Tudo sobre o assunto está em coexistência: API oficial sem perder o app nem o número.
Perguntas frequentes
Vou perder meu número de WhatsApp ao ligar a API oficial?
Não precisa. Com a coexistência, o número continua no app WhatsApp Business do celular e passa a funcionar também no sistema. Sem ela, o número passa a ser usado só pela API.
E as conversas antigas?
No Cenvia, a conexão por coexistência importa até 180 dias de histórico e a agenda de contatos, e quem assumir o cliente vê o que já foi conversado.
Vou ser bloqueado se usar a API oficial?
Qualquer número pode ser limitado se muitos clientes bloquearem ou denunciarem as mensagens. A API oficial segue as regras da Meta e reduz o risco que existe nas conexões não oficiais, sem eliminá-lo. Disparo sem consentimento é o que mais derruba. Veja o guia de disparo em massa pela API oficial.
A API oficial inclui um chatbot ou IA?
A API é só a conexão. O robô vem da plataforma que você escolher. No Cenvia, a resposta automática é opcional e a IA responde pelos documentos que você enviar; se a resposta não estiver lá, ela avisa que não sabe e chama uma pessoa.
Quanto custa de verdade, contando a Meta?
Plataforma (no Cenvia, R$270 por mês com até 6 atendentes) mais a tarifa da Meta por mensagem entregue, paga à parte, direto à Meta. O detalhe por categoria está no guia de preço da API do WhatsApp.
Empresa pequena pode usar a API oficial?
Pode. O que exige conhecimento técnico é montar a conexão sozinho; uma plataforma faz isso por você. Para equipes de poucas pessoas, o multiatendimento costuma ser o motivo de ir para a API.
