Glossário da API oficial do WhatsApp

Este glossário da API oficial do WhatsApp reúne, em ordem alfabética, as definições dos principais termos da WhatsApp Business Platform da Meta. Cada verbete explica o conceito em poucas linhas, com base na documentação oficial, e indica o artigo que aprofunda o assunto, de templates e janelas de atendimento a preços, limites e verificação.

Índice de termos

Agente de IA Anúncio de clique para o WhatsApp API não oficial API oficial do WhatsApp Autenticação (categoria) Banimento Botões (mensagem interativa) Cadastro incorporado (Embedded Signup) Categoria de template Cloud API Coexistência Conta Comercial Oficial (selo azul) Conta do WhatsApp Business (WABA) Descadastro (opt-out) Disparo em massa Faixas de volume Faturamento em reais (BRL) Franquia de mensagens de serviço Janela de atendimento de 24 horas Janela gratuita de 72 horas (FEP) Limite de envio (messaging limit) Marketing (categoria) Mensagem de serviço Meta Business Agent Nome de exibição Nota de qualidade On-Premises API Opt-in Portfólio empresarial Solution Partner Tech Provider Template (modelo de mensagem) Transferência para humano Utilidade (categoria) Verificação da empresa Webhook WhatsApp Business (app) WhatsApp Business Platform WhatsApp Flows

A

Agente de IA

Agente de IA é um software baseado em modelo de linguagem que conversa com clientes e executa ações em outros sistemas, como consultar agenda ou atualizar um CRM, por meio de ferramentas. No WhatsApp, a política da Meta permite automação desde que exista um caminho rápido e claro para falar com um humano. Veja mais em agente de IA integrado ao CRM.

Anúncio de clique para o WhatsApp

Anúncio de clique para o WhatsApp é um formato de anúncio da Meta que abre uma conversa com a empresa no WhatsApp. Quando a empresa responde em até 24 horas, abre-se a janela gratuita de 72 horas (FEP), em que todas as mensagens, inclusive templates, são grátis. Veja mais em anúncios de clique para o WhatsApp.

API não oficial

API não oficial é qualquer ferramenta de terceiros que automatiza o WhatsApp sem autorização da Meta, em geral imitando o WhatsApp Web. Os Termos do WhatsApp proíbem esse uso, e a conta pode ser restringida, suspensa ou banida, com risco de a empresa não poder criar outra conta. Veja mais em API não oficial do WhatsApp.

API oficial do WhatsApp

API oficial do WhatsApp é o acesso autorizado pela Meta para empresas enviarem e receberem mensagens em escala por integração com sistemas, dentro da WhatsApp Business Platform. Hoje esse acesso acontece pela Cloud API, direto pela Meta ou por meio de um parceiro. Veja mais em API oficial do WhatsApp: guia completo.

Autenticação (categoria)

Autenticação é a categoria de template usada para verificar a identidade do usuário com um código de acesso único. O texto é fixo, com aviso opcional para não compartilhar o código e validade opcional, e os botões podem ser de copiar código ou de preenchimento com um toque. Veja mais em template do WhatsApp.

B

Banimento

Banimento é a perda do acesso de um número ao WhatsApp por violação dos Termos ou das políticas. A conta pode ser restrita (temporária), banida temporariamente, o que costuma indicar uso de app não oficial, ou banida de forma permanente. Existe um pedido de análise para contestar a decisão. Veja mais em WhatsApp banido.

Botões (mensagem interativa)

Botões são elementos clicáveis de templates e mensagens interativas do WhatsApp. Um template aceita até 10 botões, entre resposta rápida, URL, telefone e copiar código, com rótulo de até 25 caracteres. Com a janela aberta, a empresa também pode enviar botões de resposta e listas. Veja mais em template do WhatsApp.

C

Cadastro incorporado (Embedded Signup)

Cadastro incorporado (Embedded Signup) é o fluxo de cadastro da Meta que abre no site de um parceiro, cria os ativos do WhatsApp da empresa, como WABA e número, e autoriza o app do parceiro. É também o caminho para ativar a coexistência com o app WhatsApp Business. Veja mais em WhatsApp coexistência.

Categoria de template

Categoria de template é a classificação que a Meta dá a cada modelo de mensagem: marketing, utilidade ou autenticação. A categoria define a tarifa cobrada por mensagem entregue. A Meta valida pelo conteúdo, e um template que mistura aviso de pedido com promoção passa a ser marketing. Veja mais em template do WhatsApp.

Cloud API

Cloud API é a versão da API do WhatsApp hospedada pela própria Meta, que permite enviar mensagens e fazer chamadas de forma programática: texto, mídia, mensagens interativas e grupos. Desde o fim da On-Premises API, é a única forma de conectar números à plataforma. Veja mais em WhatsApp Cloud API.

Coexistência

Coexistência é o modo que conecta um número do app WhatsApp Business à Cloud API sem trocar de número. A empresa envia em volume pela API e continua conversando pelo app, com histórico sincronizado dos últimos 180 dias. A ativação só é feita por meio de um parceiro. Veja mais em WhatsApp coexistência.

Conta Comercial Oficial (selo azul)

Conta Comercial Oficial (OBA) é o status que exibe o selo azul no perfil da empresa na API. Exige portfólio verificado, verificação em duas etapas, nome de exibição aprovado e pelo menos 30 dias na plataforma. Se o pedido for negado, é preciso esperar 30 dias para tentar de novo. Veja mais em verificação do WhatsApp Business.

Conta do WhatsApp Business (WABA)

Conta do WhatsApp Business (WABA) é a conta que reúne os números de telefone e os templates de uma empresa na API oficial. Fica dentro do portfólio empresarial, e é nela que a Meta registra a cobrança pelo uso das mensagens. Veja mais em API oficial do WhatsApp: guia completo.

D

Descadastro (opt-out)

Descadastro (opt-out) é o pedido do cliente para deixar de receber mensagens de uma empresa. A política do WhatsApp exige respeitar esse pedido, feito dentro ou fora do WhatsApp. O usuário também pode desligar ofertas de uma empresa no app, e novos envios de marketing falham. Veja mais em opt-in no WhatsApp.

Disparo em massa

Disparo em massa é o envio de uma mesma mensagem para muitos contatos. Na API oficial, ele é feito com templates aprovados, só para quem deu opt-in, e fica sujeito ao limite de envio, à nota de qualidade e ao limite de mensagens de marketing por usuário. Veja mais em disparo em massa no WhatsApp.

F

Faixas de volume

Faixas de volume são níveis de tarifa por quantidade de mensagens entregues, aplicados às categorias utilidade e autenticação. O volume é somado no nível do portfólio empresarial, por mercado e categoria, e zera todo mês. Mensagens de serviço não têm faixas de volume. Veja mais em preços da API oficial.

Faturamento em reais (BRL)

Faturamento em reais (BRL) é a opção de pagar o uso da API em moeda brasileira, com faturamento pela Facebook Brasil, para contas que têm o Brasil como país de faturamento. Essas contas precisam migrar as WABAs para BRL até 30/06/2027. Veja mais em preços da API oficial.

Franquia de mensagens de serviço

Franquia de mensagens de serviço é a cota mensal gratuita de 1.000 mensagens de serviço entregues por número comercial, válida a partir de 01/10/2026. Envios individuais e em grupo dividem a franquia, e o saldo não acumula. Sem meio de pagamento, as mensagens de serviço param de ser entregues depois da cota. Veja mais em preços da API oficial.

J

Janela de atendimento de 24 horas

Janela de atendimento de 24 horas é o período que começa quando o cliente envia uma mensagem ou liga para a empresa. Cada nova mensagem do cliente reinicia o prazo. Com a janela aberta, a empresa pode enviar mensagens livres. Fechada, só templates aprovados. Veja mais em API oficial do WhatsApp: guia completo.

Janela gratuita de 72 horas (FEP)

Janela gratuita de 72 horas (FEP, free entry point) é o período aberto quando a empresa responde em até 24 horas a um contato vindo de anúncio de clique para o WhatsApp ou de CTA do Facebook. Nessas 72 horas, todas as mensagens são grátis, inclusive templates. Veja mais em anúncios de clique para o WhatsApp.

L

Limite de envio (messaging limit)

Limite de envio é o número máximo de destinatários únicos que a empresa pode contatar em 24 horas fora da janela de atendimento. Os níveis são 250, 2.000, 10.000, 100.000 e ilimitado. Desde outubro de 2025, o limite vale para o portfólio empresarial. Veja mais em disparo em massa no WhatsApp.

M

Marketing (categoria)

Marketing é a categoria de template usada para gerar reconhecimento, vendas, retargeting ou relacionamento, como promoções e lembretes de carrinho abandonado. No Brasil, tem a tarifa mais alta entre as categorias, e a Meta limita quantas mensagens de marketing cada pessoa recebe somando todas as empresas. Veja mais em template do WhatsApp.

Mensagem de serviço

Mensagem de serviço é qualquer mensagem livre, fora de template, que a empresa envia com a janela de atendimento aberta. A partir de 01/10/2026, a Meta cobra essas mensagens com a tarifa de utilidade e autenticação do mercado, sem faixas de volume, após a franquia mensal de cada número. Veja mais em preços da API oficial.

Meta Business Agent

Meta Business Agent é o agente de IA da própria Meta para atender clientes de empresas no WhatsApp. Desde 01/08/2026, o uso é cobrado por volume de tokens processados, à parte da tarifa por mensagem entregue. Veja mais em Meta Business Agent.

N

Nome de exibição

Nome de exibição é o nome da empresa que aparece para o cliente no WhatsApp. Precisa ter relação com a empresa, seguir as diretrizes de formatação da Meta e ser aprovado antes de valer. Pode ser trocado até 10 vezes a cada 30 dias. Veja mais em verificação do WhatsApp Business.

Nota de qualidade

Nota de qualidade é a avaliação da Meta, alta, média ou baixa, sobre as mensagens de um número ou template, com base em sinais dos últimos 7 dias, como bloqueios e denúncias. Nota baixa pode pausar templates por algumas horas e, na repetição, desativá-los. Veja mais em nota de qualidade do WhatsApp.

O

On-Premises API

On-Premises API era a versão da API do WhatsApp que a empresa hospedava nos próprios servidores. Foi descontinuada: desde 01/07/2024 números novos só entram na Cloud API, e em 23/10/2025 a última versão expirou e as mensagens deixaram de ser entregues. Veja mais em WhatsApp Cloud API.

Opt-in

Opt-in é a permissão do cliente para receber mensagens da empresa no WhatsApp. A política exige que a pessoa tenha fornecido o número e confirmado que aceita as mensagens, com o nome da empresa claro. Pela LGPD, o ônus de provar o consentimento é da empresa. Veja mais em opt-in no WhatsApp.

P

Portfólio empresarial

Portfólio empresarial, antigo Business Manager, é o cadastro da empresa na Meta que reúne as WABAs, números e permissões. É obrigatório para usar a API oficial, e verificá-lo libera limites maiores, mais números e o pedido de Conta Comercial Oficial. Veja mais em verificação do WhatsApp Business.

S

Solution Partner

Solution Partner (BSP) é o parceiro da Meta que oferece serviço completo na API do WhatsApp: mensagens, cobrança, integração e suporte. É Meta Business Partner e pode estender a própria linha de crédito ao cliente e faturar o uso da API. Veja mais em API oficial do WhatsApp: guia completo.

T

Tech Provider

Tech Provider é o provedor de tecnologia que oferece acesso à API do WhatsApp sem linha de crédito própria. O cliente cadastra o meio de pagamento e paga o uso direto à Meta, e o provedor cobra só os seus serviços. Um Tech Provider que vira Meta Business Partner passa a ser chamado de Tech Partner. Veja mais em API oficial do WhatsApp: guia completo.

Template (modelo de mensagem)

Template é um modelo de mensagem pré-aprovado pela Meta e o único tipo de mensagem que a empresa pode enviar fora da janela de atendimento. Tem corpo obrigatório, pode ter cabeçalho, rodapé, variáveis e botões, e é cobrado conforme a categoria. Veja mais em template do WhatsApp.

Transferência para humano

Transferência para humano é a passagem da conversa de um bot ou agente de IA para um atendente. A política do WhatsApp Business permite automação, mas exige caminhos rápidos, claros e diretos para o cliente chegar a uma pessoa. Veja mais em atendimento humano e IA.

U

Utilidade (categoria)

Utilidade é a categoria de template que dá sequência a uma ação ou pedido do usuário, como confirmação e rastreio de pedido, lembrete de pagamento ou de consulta e alertas de serviço. Não pode conter oferta nem promoção, senão vira marketing. Veja mais em template do WhatsApp.

V

Verificação da empresa

Verificação da empresa é a confirmação, pela Meta, dos dados legais do portfólio empresarial com documentos oficiais. Ela libera o salto do limite de envio para 2.000, mais números e templates, e é requisito para o selo azul e para enviar WhatsApp Flows. Veja mais em verificação do WhatsApp Business.

W

Webhook

Webhook é o endereço do servidor da empresa para onde a Meta envia eventos em tempo real: mensagens recebidas, status de entrega e alertas da conta. Precisa de certificado TLS válido e responder 200; se não responder, a Meta reenvia por até 7 dias. Veja mais em WhatsApp Cloud API.

WhatsApp Business (app)

WhatsApp Business é o aplicativo gratuito da Meta para pequenas empresas, com um número por conta e uso manual no celular. Não foi feito para equipes com muitos atendentes nem para integração com sistemas, o que exige a API oficial. Veja mais em WhatsApp Business.

WhatsApp Business Platform

WhatsApp Business Platform é o conjunto de APIs da Meta para empresas conversarem com clientes em escala. Reúne a Cloud API, a Business Management API, a Marketing Messages API e os webhooks, e funciona sobre a Graph API. Veja mais em API oficial do WhatsApp: guia completo.

WhatsApp Flows

WhatsApp Flows são formulários interativos de várias telas dentro da conversa, usados para agendar horários, gerar leads ou coletar feedback. Podem consultar dados em tempo real por um endpoint e exigem empresa verificada. Não funcionam no WhatsApp Web. Veja mais em WhatsApp Flows.

Perguntas frequentes

Para entender como esses conceitos se encaixam na prática, leia o guia completo da API oficial do WhatsApp. Para estimar quanto a sua operação vai gastar com mensagens, use a calculadora de custo da API do WhatsApp.