Como funciona a API oficial do WhatsApp na prática

A primeira coisa que confunde quase todo mundo: a API oficial do WhatsApp não tem tela de conversa. Você não abre um app, não vê balõezinhos verdes. Quando você entende como funciona a API oficial do WhatsApp, percebe que ela é apenas um canal de comunicação entre os servidores da Meta e o seu sistema. Quem mostra as mensagens em formato de conversa é a ferramenta que você conecta em cima dela (um CRM, um Chatwoot, um bot ou um sistema próprio).

Na prática, a API é a WhatsApp Cloud API, hospedada pela própria Meta na nuvem dela. Você não precisa manter servidor de WhatsApp, não instala nada pesado. Seu sistema fala com a Meta por requisições HTTP e recebe as mensagens de volta por webhook. Só isso.

O que muda em relação ao app comum

O WhatsApp Business que você baixa na Play Store ou na App Store é um aplicativo. Ele roda no celular, precisa do aparelho ligado e serve para atendimento manual, um por vez. A API é outra coisa: ela permite que um software envie e receba mensagens em escala, integrado a bancos de dados, filas de atendimento e automações.

A dúvida que mais aparece quando um cliente nos procura é se vai perder tudo ao migrar. Não perde. Com a coexistência, o mesmo número continua funcionando no app do celular e passa a funcionar também na API, ao mesmo tempo. Você não apaga a conta, não desinstala o app e não perde o histórico. A equipe segue atendendo pelo celular quando quiser, e o sistema automatizado roda por cima da API. Quem não usa coexistência tem outro cenário: ao levar o número para a API, ele deixa de abrir no app comum.

Quem configura o número

Na covercut, você não cria aplicativo na Meta nem mexe no painel de desenvolvedor. A conexão do número acontece pelo fluxo oficial da Meta, o Embedded Signup, direto pela covercut, que é parceira Meta para WhatsApp. Você autoriza, escolhe o número e pronto. O que costuma travar aqui é gente tentando fazer sozinho pelo painel de desenvolvedor da Meta e se perdendo em permissões de Business Manager.

Número dedicado ou coexistência

Você tem dois caminhos. Pode conectar um número novo, exclusivo para a API, ou trazer o número que a empresa já usa no WhatsApp Business por coexistência. O número dedicado é útil quando você quer separar totalmente o robô do atendimento humano. A coexistência é o que a maioria prefere, porque mantém o número conhecido pelos clientes e não interrompe o atendimento que já existe.

Um detalhe que vale saber: na coexistência, as conversas iniciadas pelo próprio celular não têm custo. Você continua puxando papo com clientes pelo app normalmente, sem entrar na contagem de conversas cobradas. Mas vale uma resalva! Faça isso de modo moderado, a preferência para iniciar as conversas deve ser sempre através dos templates de mensagens.

Templates: por que você não sai mandando mensagem

Aqui está a parte que mais gera template rejeitado e cliente irritado. A API oficial não deixa você disparar qualquer texto para quem quiser, na hora que quiser. Para iniciar uma conversa com alguém que não te escreveu, você precisa de um template aprovado pela Meta, também chamado de modelo de mensagem.

O template é um texto pré-cadastrado que passa por revisão. Hoje as categorias são três:

Marketing: promoções, novidades, reengajamento.
Utilidade (utility): confirmações de pedido, avisos de entrega, lembretes de agendamento, atualizações de conta.
Autenticação: códigos de verificação e login.

Quando um cliente nos chega com o template reprovado, quase sempre é a mesma história: colocaram texto de marketing disfarçado de utilidade, ou deixaram variáveis soltas sem contexto, ou usaram uma linguagem que a Meta lê como spam. A categorização errada é o erro campeão. Se você cadastra algo promocional como utilidade para pagar menos, a Meta reclassifica e pode reprovar.

A janela de 24 horas

Esse é o conceito central de custo e de comportamento da API. Funciona assim: quando o cliente te manda uma mensagem, abre uma janela de 24 horas. Dentro dela, você responde com texto livre, imagens, áudios, o que precisar, sem template e sem burocracia.

Passadas as 24 horas sem nova mensagem do cliente, a janela fecha. A partir daí, para voltar a falar com ele, você só consegue com um template aprovado. É por isso que o atendimento reativo (quem responde quem chamou) é simples, e o ativo (quem inicia contato) exige planejamento.

Regra prática: se o cliente falou com você nas últimas 24 horas, responda o que quiser. Se passou disso, só template.

Webhooks: como as mensagens chegam até você

Como a API não tem tela, ela precisa de um jeito de te avisar que chegou mensagem. Esse jeito é o webhook. Você configura uma URL do seu sistema, e toda vez que acontece um evento (mensagem recebida, mensagem entregue, mensagem lida, mudança de status do número) a Meta dispara uma notificação para essa URL.

Enviar é uma requisição sua para a Meta. Receber é a Meta chamando o seu webhook. Esse ciclo é o coração da integração. Se o webhook cai ou responde com erro, você para de receber mensagens em tempo real, então monitorar essa URL é parte do trabalho de operação.

O que os webhooks entregam

Mensagens novas de clientes, com texto, mídia e identificação do remetente.
Status de entrega de cada mensagem que você enviou (enviada, entregue, lida, falhou).
Eventos da conta, como mudança na qualidade do número.

Qualidade do número e limites de envio

Todo número na API tem uma classificação de qualidade: Alta (verde), Média (amarela) ou Baixa (vermelha). Ela reflete como as pessoas reagem às suas mensagens. Muito bloqueio e muita denúncia derrubam a nota. Na prática, o que mais derruba a qualidade é disparar template de marketing para lista fria, sem opt-in de verdade, para gente que não lembra de ter dado o número.

Junto da qualidade existem os limites diários de conversas iniciadas pela empresa, organizados em faixas que sobem conforme volume, qualidade e verificação. Esses patamares mudam com o tempo, então não vale decorar número. O que importa: quanto melhor a qualidade e mais estabelecida a conta, mais a Meta libera. Completar a verificação da empresa no Gerenciador de Negócios ajuda a subir esses tetos.

O opt-in não é detalhe jurídico opcional. Você precisa do consentimento do cliente para mandar mensagem ativa fora da janela de 24 horas. Sem isso, além do risco de bloqueio, sua qualidade despenca e os limites encolhem.

Quem paga o quê

Essa parte costuma vir cheia de mito. A cobrança das mensagens é feita pela Meta, direto no cartão que o cliente cadastra na conta dele. A Meta cobra por conversa, não por mensagem individual, e o modelo de preço muda de tempos em tempos. Segundo a covercut, BSP oficial do WhatsApp, o BSP não intermedia nem repassa essa cobrança: ela é entre a empresa e a Meta.

A covercut cobra apenas uma mensalidade fixa pelo serviço, que inclui a plataforma, a conexão do número pelo fluxo oficial com suporte a coexistência, a infraestrutura e o suporte. Não existe taxa por mensagem, por conversa ou por template da nossa parte. Se alguém te oferece API oficial cobrando por mensagem enviada, desconfie do que está sendo vendido.

Juntando as peças

Resumindo o fluxo real: você conecta o número pela covercut, cadastra os templates que vai precisar, aponta o webhook para o seu sistema e começa a operar. Cliente escreve, abre a janela de 24 horas, você responde à vontade. Precisa iniciar contato depois? Usa template aprovado, com opt-in na mão. A Meta cuida da infraestrutura e da cobrança das conversas; você cuida da qualidade das suas mensagens.

Se o seu próximo passo é sair do app manual e ganhar escala sem perder o número atual, comece verificando se a coexistência atende o seu caso. É o caminho de menor atrito, porque você não interrompe nada enquanto migra.

Perguntas frequentes

Preciso apagar minha conta do WhatsApp Business para usar a API oficial?

Não. Com coexistência, o mesmo número funciona no app do celular e na API ao mesmo tempo, mantendo o histórico e o atendimento manual. Só quem não usa coexistência tem o número saindo do app comum ao migrar.

A API oficial do WhatsApp tem um aplicativo próprio para conversar?

Não. A API não tem tela de conversa. As mensagens entram e saem por integração, usando requisições HTTP e webhooks, exibidas em uma ferramenta que você conecta em cima, como um CRM ou o Chatwoot.

Por que não consigo mandar mensagem para qualquer contato quando quiser?

Porque fora da janela de 24 horas você só inicia conversa com template aprovado pela Meta e com opt-in do cliente. Dentro das 24 horas após o cliente te escrever, você responde com texto livre.

Quanto custa enviar mensagens pela API oficial?

A Meta cobra por conversa, direto no cartão da empresa, e o valor varia com o tempo e com a categoria. A covercut cobra apenas uma mensalidade fixa pelo serviço e não cobra por mensagem, conversa ou template.

O que faz a qualidade do meu número cair?

Bloqueios e denúncias dos clientes. Na prática, disparar marketing para lista fria sem opt-in real é o que mais derruba a nota, e qualidade baixa reduz seus limites de envio.