Artigos

WhatsApp Business API sem mistério: acesso, templates, custos e conexão com o CRM

A WhatsApp Business API é o caminho oficial da Meta para ligar um número a um software, e não a um celular. Veja o que você precisa, quanto custa e o que muda no dia a dia.

Resumo: A WhatsApp Business API, hoje oferecida como Cloud API, é a interface oficial da Meta que permite a um software enviar e receber mensagens de WhatsApp de um número comercial. Você precisa de um portfólio empresarial na Meta, de um app, de um número de telefone com nome de exibição e de templates aprovados para tudo o que for enviado fora da janela de 24 horas após a última mensagem do cliente. A Meta cobra por mensagem entregue, conforme a categoria e o país; as mensagens dos clientes são gratuitas. O NeuroCRM conecta a Cloud API manualmente, com os seus próprios tokens, e também oferece o gateway GREEN-API.

O que é a WhatsApp Business API?

É uma interface, não um aplicativo. Não há nada para baixar nem tela para fazer login. O seu software (um CRM, um sistema de atendimento, um script próprio) conversa com o WhatsApp por meio dela: as mensagens recebidas chegam a um endereço de webhook, e as respostas saem como chamadas à API.

Hoje, a interface que a Meta documenta é a Cloud API, hospedada pela própria Meta. Quando alguém pesquisa "api do whatsapp" ou "whatsapp cloud api", é disso que está falando. "WhatsApp Business Platform" é o nome mais amplo que a Meta dá à sua oferta de mensagens para empresas; a Cloud API é a interface dentro dela.

O que você ganha em relação a um celular: várias pessoas podem atender o mesmo número, as mensagens podem ser enviadas por software, e cada conversa pode ficar ao lado de um contato e de um negócio. O que você aceita em troca: regras sobre templates, uma janela de 24 horas e cobrança por mensagem, tudo explicado abaixo.

Qual é a diferença entre o app WhatsApp Business, o WhatsApp Business Web e a API?

  • App WhatsApp Business. Um aplicativo de celular que o próprio WhatsApp descreve como pensado para o dono de pequena empresa. Uma empresa e, normalmente, uma pessoa digitando.
  • WhatsApp Business Web. É o termo que as pessoas pesquisam para abrir a mesma conta comercial no navegador. Continua sendo a janela de chat do app, e não uma integração: nada fica ligado a negócios, tarefas ou relatórios.
  • WhatsApp Business API (Cloud API). Uma interface de programação. O número é registrado na plataforma, e quem cuida das conversas é um programa, não um celular.

Se você só precisa responder a algumas pessoas pelo notebook, o app com a versão para navegador pode bastar. Passe para a API quando várias pessoas da equipe dividirem o número, quando as mensagens tiverem de sair automaticamente ou quando as conversas precisarem entrar num CRM.

Quem pode ter acesso e do que você precisa?

O guia de primeiros passos da Meta pede uma conta do Facebook ou uma conta gerenciada da Meta, o cadastro como desenvolvedor e um aparelho com WhatsApp para as mensagens de teste. No mesmo fluxo, você escolhe ou cria um portfólio empresarial na Meta, cria um app com o caso de uso do WhatsApp e adiciona um número de telefone.

O número tem regras, segundo a documentação da Meta sobre números de telefone:

  • Um número que já é usado no WhatsApp só pode ser registrado depois de ser excluído do WhatsApp.
  • O número precisa ser seu, ter código do país e DDD e receber um SMS ou uma ligação para a verificação.
  • O nome de exibição é obrigatório no registro. É ele que aparece no perfil do número no WhatsApp.

Para começar a testar, você não precisa de templates: o próprio guia rápido da Meta envia um template pronto, o hello_world. Os seus próprios templates aprovados passam a ser necessários quando você escreve primeiro ou responde depois que a janela fechou.

Como funciona a janela de 24 horas?

Quando um cliente escreve ou liga para você, abre-se uma janela de 24 horas. Cada nova mensagem do cliente reinicia a contagem. Enquanto ela está aberta, você pode mandar mensagens livres. Depois que ela fecha, só são permitidas mensagens de template (a página de preços da Meta deixa essa regra explícita).

Os templates se dividem em três categorias: marketing, utilidade e autenticação. Você os cria no WhatsApp Manager, e a Meta faz a revisão; conte com uma espera até um template novo funcionar.

Como a Meta cobra pela WhatsApp Business API?

Segundo a página de preços da Meta, conferida em 18 de novembro de 2026:

  • Desde 1º de julho de 2025, a Meta cobra por mensagem entregue, e não por conversa. O preço depende da categoria da mensagem e do código de país do destinatário.
  • As mensagens que os clientes mandam para você não são cobradas.
  • Os templates são de marketing, utilidade ou autenticação; as respostas sem template dentro da janela são de serviço. A Meta também lista o Meta Business Agent.
  • Cada número comercial ganha 1.000 mensagens de serviço gratuitas por mês, com a cota renovada todo mês. A partir de 1º de outubro de 2026, as mensagens de serviço passam a ser cobradas a partir da 1.001ª.
  • Sem uma forma de pagamento cadastrada na conta de mensagens, a Meta só entrega mensagens de serviço dentro da cota gratuita.
  • Os templates de utilidade enviados com a janela aberta eram gratuitos até 30 de setembro de 2026 e são cobrados a partir de 1º de outubro de 2026.
  • Se um cliente escreve para você a partir de um anúncio de clique para o WhatsApp (Click to WhatsApp) no app de celular e você responde dentro da janela, abre-se uma janela de entrada gratuita de até 7 dias para mensagens de marketing, utilidade, autenticação e serviço.

As tarifas em dólar estão em planilhas de preços que a Meta disponibiliza nessa página e variam por país e categoria. Confira a planilha dos seus países antes de fazer o orçamento; aqui não citamos nenhuma tarifa.

As cobranças da Meta vão para a conta do WhatsApp que você conectar. O CRM ou outro fornecedor de software cobra a própria taxa à parte.

Dá para enviar mensagens de marketing e usar bots?

Sim, dentro das regras da Meta: os templates de marketing são uma categoria de mensagem com preço próprio, e um bot é um software que usa a mesma API, sujeito às mesmas regras de janela e de templates.

Na prática, "enviar mensagem pela API do WhatsApp" significa dois tipos de chamada: uma mensagem livre dentro da janela ou uma mensagem de template fora dela. O horário da última mensagem do cliente decide qual das duas está disponível.

Como o NeuroCRM se conecta à WhatsApp Business API?

O NeuroCRM oferece duas formas de conectar o WhatsApp. Para uma comparação mais longa entre elas, veja CRM para WhatsApp: API oficial ou gateways por QR Code. Esta página detalha o lado da API.

Conectando a Cloud API manualmente

Em Configurações → Integrações, escolha "API de Nuvem do WhatsApp Business" e preencha quatro campos:

  1. "ID do Número de Telefone" (Phone Number ID), da tela de configuração da API (API Setup) da Meta.
  2. "Token de Acesso Permanente (Usuário do Sistema)", gerado em Configurações do negócio → Usuários do sistema.
  3. "Segredo do Aplicativo" (App Secret), usado para verificar a assinatura dos webhooks recebidos.
  4. "ID da Conta do WhatsApp Business" (WABA ID).

Depois, clique em "Verificar e conectar". O NeuroCRM mostra uma "URL de Retorno" (Callback URL) e um "Token de Verificação" (Verify Token); você cola os dois no seu app da Meta, em WhatsApp → Configuração → Webhooks, e assina o campo messages. Dá para adicionar vários números.

Não existe um botão único. O app da Meta, o usuário do sistema e o token são criados por você, então conte com algum tempo para a primeira conexão. Deixe o lado da Meta pronto antes de começar.

O que os atendentes veem

Cada conversa do WhatsApp cai na mesma caixa de entrada dos seus outros canais, com o card do contato. O NeuroCRM conta as 24 horas a partir da última mensagem de verdade que o cliente enviou pelo WhatsApp e considera a janela fechada cinco minutos antes do prazo.

Com a janela fechada, o NeuroCRM envia um template aprovado no lugar do seu texto: o que você escolheu, o padrão da conta ou um template aprovado sem variáveis nem mídia. O seu rascunho fica esperando na caixa de texto até o cliente responder. Se não houver template aprovado, o envio é recusado, e um segundo template só sai antes da resposta do cliente se você escolhê-lo de novo na lista.

Regras, automações e IA

  • Automações. Fora da janela, a automação não envia nada e não escolhe template: o passo fica marcado como não enviado. Nos eventos de negócio, a mensagem vai para a conversa mais antiga do contato, seja qual for o canal.
  • Sequências de vendas. O passo de WhatsApp envia o template aprovado que você indicar nesse passo.
  • Respostas por IA. O Neuro Contact Center é um módulo pago: US$ 200 por mês mais US$ 0,50 por diálogo bem-sucedido, com a sua própria chave de IA, com 0% de acréscimo, ou pelo NeuroCRM, com +20%. Fora da janela de 24 horas, ele não responde nem envia template. Ele também não marca horários sozinho.

A alternativa GREEN-API

O GREEN-API é um gateway não oficial. Você conecta um número pessoal por QR Code no console do GREEN-API e depois informa idInstance e apiTokenInstance no NeuroCRM. A dica da própria integração diz que ela é adequada "para casos em que a API oficial do WhatsApp Business não está disponível". Não é a plataforma da Meta, então as regras de templates e de janela descritas acima não se aplicam a ele.

O que o NeuroCRM não faz com a WhatsApp Business API?

  • Sem conexão com um clique. As credenciais da Meta são digitadas manualmente; o fluxo de cadastro incorporado da Meta (Embedded Signup) não é oferecido como botão.
  • Sem coexistência. Um número usado ao mesmo tempo no app WhatsApp Business e na API não funciona pelo NeuroCRM.
  • As tarifas de mensagem da Meta não fazem parte do preço por usuário e não são definidas pelo NeuroCRM; quem cobra é a Meta, na conta que você conectar.
  • Sem escolha automática de template pelas automações ou pela IA fora da janela de 24 horas.

Quanto custa usar o WhatsApp no NeuroCRM?

As licenças custam US$ 13 por usuário por mês, ou US$ 10,40 no plano anual, e não há plano grátis. O teste de 14 dias inclui tudo, com usuários ilimitados, e depois a conta fica somente leitura. Veja os preços. O Neuro Contact Center é o módulo à parte descrito acima. As tarifas por mensagem da Meta são uma terceira linha de custo, cobrada pela Meta.

Para comparar sistemas, veja as comparações do NeuroCRM e o guia de alternativas ao Kommo. Para o WhatsApp ao lado dos seus outros canais, veja a caixa de entrada unificada.

Checklist: antes de conectar

  1. Escolha um número que seja seu e no qual você consiga receber um SMS ou uma ligação de verificação. Se ele já estiver no WhatsApp, programe-se para excluí-lo de lá antes.
  2. Crie o portfólio empresarial na Meta, o app com o caso de uso do WhatsApp e um usuário do sistema com token permanente.
  3. Defina o nome de exibição.
  4. Cadastre uma forma de pagamento do lado da Meta; senão, as mensagens de serviço além da cota gratuita não serão entregues.
  5. Envie pelo menos um template de utilidade no WhatsApp Manager e espere a aprovação da Meta antes de entrar no ar.
  6. Anote o Phone Number ID e o WABA ID na tela de configuração da API.
  7. Conecte no NeuroCRM, copie a URL de retorno e o token de verificação para a Meta e assine o campo messages.
  8. Mande uma mensagem para você mesmo, responda, depois espere a janela fechar e teste um template.

Perguntas frequentes

A WhatsApp Business API é gratuita?

Não totalmente. A Meta cobra por mensagem entregue, com exceção das mensagens dos clientes, das 1.000 primeiras mensagens de serviço por número a cada mês e das mensagens enviadas numa janela de entrada gratuita.

Qual é a diferença entre a API do WhatsApp e a Cloud API?

Para uma configuração nova, na prática são a mesma coisa: a Cloud API é a versão que a Meta hospeda e documenta, e é ela que a integração "API de Nuvem do WhatsApp Business" do NeuroCRM usa.

Posso usar o número do meu app WhatsApp Business na API?

A Meta diz que um número que já é usado no WhatsApp precisa ser excluído do WhatsApp antes do registro. Pelo NeuroCRM, usar o mesmo número no app e na API ao mesmo tempo (coexistência) não funciona.

Por que a minha mensagem não chegou ao cliente?

Há duas causas comuns: a janela de 24 horas tinha fechado e a mensagem não era um template, ou não havia forma de pagamento na conta da Meta quando as mensagens de serviço gratuitas acabaram. Com a janela fechada, o NeuroCRM não envia o seu texto livre; ele envia primeiro um template aprovado e guarda o seu texto na caixa.

Várias pessoas podem responder pelo mesmo número da API?

Sim. As conversas de um número vão para uma caixa de entrada compartilhada no NeuroCRM, e você pode conectar vários números.

Fontes

  • Meta, preços da WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (conferido em 18 de novembro de 2026)
  • Meta, primeiros passos com a Cloud API — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (conferido em 18 de novembro de 2026)
  • Meta, números de telefone — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (conferido em 18 de novembro de 2026)
  • App WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (conferido em 18 de novembro de 2026)

Como este artigo foi feito: escrito pela equipe do NeuroCRM com apoio de IA; as informações sobre o produto foram conferidas no código e na central de ajuda do NeuroCRM; os preços são os da tabela publicada na data da atualização.