Glossário da WhatsApp Business API: mais de 50 termos essenciais explicados (2026)

Explorar o universo da WhatsApp Business API pode ser desafiador, especialmente diante da ampla variedade de recursos, termos técnicos e funcionalidades em desenvolvimento. Seja você uma pessoa desenvolvedora, proprietária de uma empresa ou profissional de marketing, entender os principais conceitos é essencial para simplificar essa complexidade e começar a usar essa ferramenta poderosa com eficiência.

Neste artigo, reunimos um glossário de termos da WhatsApp Cloud (Business) API para simplificar a terminologia e ajudar você a entender os conceitos essenciais. De modelos de mensagem e fluxos a limites de envio e mensagens de comércio, este guia será seu recurso de referência para aproveitar todo o potencial da WhatsApp API e oferecer uma comunicação e um engajamento fluidos com os clientes. Vamos começar!

1. WhatsApp Business API

Portfólio empresarial: um portfólio empresarial permite que as organizações reúnam suas Páginas do Facebook, contas do Instagram, contas de anúncios, catálogos e outros ativos comerciais para que você possa gerenciá-los, assim como as pessoas que têm acesso a eles, em um só lugar, usando ferramentas comerciais como Meta Business Suite e Business Manager.

Contas do WhatsApp Business (WABA): uma conta do WhatsApp Business representa uma empresa na plataforma do WhatsApp Business e é composta principalmente por metadados sobre uma empresa específica. A maioria dos outros recursos do WhatsApp, como números de telefone do WhatsApp Business e modelos de mensagem do WhatsApp, está associada a uma WABA.

Números de telefone do WhatsApp Business: um número de telefone do WhatsApp Business (número de telefone comercial) representa um número de telefone real que, depois de registrado para uso com a Cloud API, pode ser usado para enviar e receber mensagens de usuários do WhatsApp por meio da API.

WhatsApp Business API: uma ferramenta para empresas se comunicarem com clientes em grande escala, permitindo o envio automatizado de mensagens e notificações, além do atendimento ao cliente. Conta comercial oficial: uma conta do WhatsApp Business verificada é uma conta oficial. Para obter uma OBA, você precisa de uma conta do Facebook Business Manager, de um número de telefone que nunca tenha sido usado no WhatsApp e passar por um processo de verificação diferente daquele do aplicativo WhatsApp Business.

Verificação da empresa: processo de autenticação da legitimidade de uma empresa para usar a WhatsApp Business API. Ele envolve o envio dos dados e documentos da empresa à Meta para análise, garantindo a conformidade com as políticas do WhatsApp. Empresas verificadas conquistam confiança, recebem um selo de verificação com marca de seleção verde e têm acesso a recursos avançados da API.

ID do número de telefone: identificador único de um número de telefone comercial registrado no WhatsApp.

Perfil do WhatsApp Business: perfil público de empresas que inclui informações como nome da empresa, descrição, endereço e dados de contato. Provedor de soluções do WhatsApp: parceiros oficiais autorizados pelo WhatsApp a fornecer acesso à Business API e serviços relacionados (anteriormente conhecidos como Provedor de Soluções para Empresas ou BSP)

Modelos de mensagem: formatos de mensagem pré-aprovados que as empresas podem usar para enviar notificações ou atualizações aos usuários. Mensagens de sessão: mensagens enviadas dentro de um período de 24 horas após o início de uma conversa pelo usuário. As empresas podem enviar mensagens livres (texto, mídia etc.) sem precisar de modelos pré-aprovados, permitindo uma comunicação bidirecional em tempo real para atendimento ou engajamento do cliente. Mensagens fora da sessão: mensagens enviadas após o período de 24 horas contado da última interação do usuário. Elas exigem modelos de mensagem pré-aprovados e costumam ser usadas para notificações, atualizações ou lembretes. São cobradas e devem seguir as políticas do WhatsApp para evitar spam. Comunicação bidirecional: interação em tempo real entre empresas e usuários, que permite que ambas as partes enviem e recebam mensagens durante uma sessão de 24 horas. Ela possibilita o atendimento ao cliente, o engajamento e conversas personalizadas, proporcionando uma experiência de comunicação fluida e interativa.

Webhooks: callbacks HTTP usados para receber notificações em tempo real sobre eventos (por exemplo, entrega de mensagens e confirmações de leitura). Endpoint da API: URL para onde as solicitações da API são enviadas para interagir com os servidores do WhatsApp.

Provedores de soluções: empresas que oferecem ou querem oferecer serviços de mensagens do WhatsApp para outras empresas.

Parceiros de soluções: os parceiros de soluções são Meta Business Partners que oferecem uma gama completa de serviços da plataforma do WhatsApp Business para outras empresas, como serviços de mensagens, cobrança, suporte à integração e atendimento ao cliente.

Provedores de tecnologia: os provedores de tecnologia são semelhantes aos Parceiros de Soluções, pois também podem oferecer a outras empresas uma gama completa de serviços da WhatsApp Business Platform, seja fornecendo esses serviços por conta própria, seja em parceria com um Parceiro de Soluções que já os ofereça. No entanto, os provedores de tecnologia não têm linhas de crédito.

Parceiros de tecnologia: parceiros de tecnologia são provedores de tecnologia que são, ou estão qualificados para se tornar, Meta Business Partners

Números de telefone comerciais 555: esses números funcionam da mesma forma que os números de telefone comerciais padrão (sujeitos às regras de preços, afetados pelas classificações de qualidade etc.), mas seus nomes de exibição precisam ser aprovados antes que possam ser usados para enviar mensagens. Além disso, os números 555 têm código de chamada do país dos EUA (+1), têm o código de área 555, são verificados automaticamente, não podem ser migrados para outra conta do WhatsApp Business nem usados fora da plataforma WhatsApp Business. Clientes empresariais podem reivindicar até dois números de telefone comerciais 555.

Cloud API: uma versão hospedada da WhatsApp Business API, gerenciada pela Meta, que elimina a necessidade de as empresas hospedarem seus próprios servidores.

Escalonamento automático: a Cloud API, dentro da infraestrutura da Meta, ajusta sua escala automaticamente para lidar com sua carga de trabalho, dentro do seu limite de taxa (volume de mensagens e número de WABAs).

Criptografia: todas as mensagens do WhatsApp continuam protegidas pela criptografia do protocolo Signal, que protege as mensagens antes de saírem do dispositivo. Isso significa que as mensagens com uma WABA são entregues com segurança ao destino escolhido por cada empresa.

Limites de taxa por par: os números de telefone comerciais podem enviar no máximo 1 mensagem a cada 6 segundos para o mesmo número de telefone de um usuário do WhatsApp (0.17 mensagens/segundo). Isso equivale a aproximadamente 10 mensagens por minuto ou 600 mensagens por hora. Se você exceder esse limite, a API retornará o código de erro 131056 até que você volte a ficar dentro do limite.

WhatsApp Manager: o WhatsApp Manager funciona como um acesso de administrador que permite gerenciar manualmente os recursos do WhatsApp, como WABAs, números de telefone comerciais e modelos, além de oferecer uma maneira simples de consultar informações e classificações de qualidade ou limites desses recursos. A maioria das funcionalidades oferecidas pelo WhatsApp Manager também está disponível pela API, com algumas pequenas exceções.

Graph API: a API subjacente usada pela Meta para interagir com o WhatsApp e outros serviços da Meta.

Limites de taxa: número máximo de solicitações à API que uma empresa pode fazer em um período específico (por exemplo, por segundo ou por dia). Isso evita a sobrecarga dos servidores do WhatsApp, garante o uso justo e mantém a estabilidade do sistema. Exceder os limites pode resultar em restrições temporárias ou erros.

2. Recursos de mensagens e modelos

Mensagens de modelo: uma mensagem de modelo é um formato de mensagem estruturado e pré-aprovado que as empresas usam para se comunicar com os clientes, especialmente ao iniciar conversas ou enviar mensagens proativas fora de uma janela de sessão de 24 horas

Categorias de modelos: as categorias de modelos são formatos de mensagem pré-aprovados que as empresas usam para se comunicar com os clientes, organizados em três categorias principais: Marketing, Utilidade e Autenticação.

Aprovação de modelos: a aprovação de modelos é o processo pelo qual as empresas, usando a WhatsApp Business API, enviam formatos de mensagem predefinidos, chamados modelos, para análise e aprovação da Meta, a fim de garantir que sigam as políticas e diretrizes do WhatsApp.

Mensagens de transmissão: refere-se ao recurso que permite enviar uma única mensagem a vários destinatários ao mesmo tempo.

Consentimento (opt-in): o opt-in é basicamente uma solicitação de permissão de uma empresa a um cliente, pedindo seu consentimento para receber mensagens, promocionais ou não, pelo WhatsApp

Cancelamento do consentimento (opt-out): opt-out refere-se à possibilidade de um usuário escolher deixar de receber mensagens, atualizações ou notificações de uma empresa, retirando efetivamente seu consentimento para comunicações futuras.

Mensagens de mídia: mensagens enviadas aos usuários com conteúdo multimídia, como imagens, vídeos, áudios e documentos. Elas aumentam o engajamento e melhoram a comunicação ao permitir o uso de formatos multimídia, tornando as interações mais dinâmicas e informativas. Os arquivos de mídia devem respeitar os limites de tamanho e formato definidos pelo WhatsApp.

WhatsApp Flows: o WhatsApp Flows é uma forma de criar interações estruturadas para mensagens comerciais. Com o Flows, as empresas podem definir, configurar e personalizar mensagens com interações avançadas, oferecendo aos clientes mais estrutura na forma de se comunicar.

Mensagens interativas: as mensagens interativas do WhatsApp são um recurso que permite às empresas oferecer uma experiência mais interativa e simplificada ao cliente, apresentando opções ou botões para que os usuários escolham, em vez de exigir que digitem suas respostas

Mensagens de comércio: mensagens desenvolvidas para ajudar as empresas a facilitar transações, compartilhar catálogos de produtos e enviar atualizações relacionadas a compras. Elas proporcionam uma experiência de compra fluida, permitindo que as pessoas naveguem, tirem dúvidas e concluam compras diretamente no WhatsApp, aumentando o engajamento dos clientes e impulsionando as vendas.

Respostas contextuais: respostas contextuais são uma forma especial de responder a uma mensagem de um usuário do WhatsApp. Ao enviar uma mensagem como resposta contextual, fica mais claro para o usuário a qual mensagem você está respondendo, pois a mensagem anterior é citada em um balão contextual:

Respostas rápidas: respostas rápidas são mensagens ou modelos pré-escritos que as empresas podem usar para responder rapidamente a dúvidas frequentes dos clientes, funcionando como atalhos para respostas usadas com frequência.

Mensagens de reação: as mensagens de reação permitem que as empresas reajam às mensagens dos clientes com um emoji, oferecendo uma forma rápida e pessoal de demonstrar apreço, confirmar o recebimento ou reagir ao feedback do cliente.

Conversas de atendimento: uma conversa de atendimento é aberta quando qualquer mensagem que não seja uma mensagem de modelo é entregue ao seu cliente e não há uma conversa aberta de nenhuma categoria entre você e o cliente.

Conversas de ponto de entrada gratuito: uma conversa de ponto de entrada gratuito é aberta se (1) um cliente que usa um dispositivo com Android ou iOS enviar uma mensagem para você por meio de um anúncio Click to WhatsApp ou de um botão de chamada para ação da Página do Facebook e (2) você responder em até 24 horas. A conversa de ponto de entrada gratuito é aberta assim que sua mensagem é entregue e dura 72 horas.

Limites de mensagens: os limites de mensagens são o número máximo de conversas iniciadas pela empresa (conversas abertas como resultado do envio de um modelo de marketing, utilidade ou autenticação para um usuário do WhatsApp) que um número de telefone comercial pode abrir em um período móvel de 24 horas.

Qualidade das mensagens: a qualidade das mensagens se baseia em como os destinatários receberam as mensagens nos últimos sete dias, com maior peso para as mais recentes. Ela é determinada por uma combinação de sinais de qualidade das conversas entre você e os usuários do WhatsApp.

Modelos de contingência: modelos de mensagem de backup são usados quando o modelo principal falha (por exemplo, devido a um formato ou idioma não compatível). Eles garantem a entrega da mensagem ao oferecer um formato alternativo e mais simples, mantendo a comunicação mesmo que o modelo original não seja entregue.

3. Gestão administrativa e de cobrança

Nome de exibição: o nome de exibição é o nome da empresa que os clientes veem no perfil do WhatsApp Business. Ele aparece acima do número de telefone da empresa na visualização do contato e fica visível mesmo que o cliente não tenha salvado o número nos contatos.

Selos de verificação: os selos de verificação incluem uma marca de seleção verde, que indica uma conta comercial oficial e verificada, e uma marca de seleção azul, que indica uma conta Meta Business verificada.

Bloqueio de usuários: as empresas podem bloquear usuários que tenham enviado mensagens nos últimos 24 horas usando a API Block Users, impedindo que esses usuários entrem em contato ou vejam o status online da empresa, e vice-versa.

Confirmações de entrega de mensagens (DLRs): fornecem atualizações em tempo real sobre a entrega e a leitura das suas mensagens, permitindo acompanhar o progresso e garantir uma comunicação bem-sucedida com seus usuários.

Confirmações de leitura de mensagens: notificações que indicam quando um cliente leu uma mensagem enviada pela empresa permitem acompanhar o engajamento dos clientes e aprimorar a estratégia de mensagens.

Status da mensagem: as notificações de status da mensagem, enviadas por meio de webhooks, informam você sobre o ciclo de vida das suas mensagens, incluindo quando são enviadas, entregues, lidas ou quando a entrega falha.

Análises de conversas: oferecem às empresas insights sobre o desempenho da comunicação no WhatsApp, incluindo métricas como entrega de mensagens, taxas de abertura e engajamento dos clientes, permitindo otimizar as estratégias de mensagens com base em dados.

Códigos de erro: códigos retornados pela API para indicar problemas (por exemplo, limites de solicitações e erros de autenticação).

Mecanismo de novas tentativas: se uma mensagem não for entregue devido a problemas temporários (por exemplo, o dispositivo do destinatário está offline ou há um problema de rede), a API tentará enviá-la novamente em intervalos regulares até que seja entregue com sucesso ou que o prazo de validade da mensagem seja atingido

Preços por conversa: as empresas são cobradas com base no número de conversas de 24 horas que têm com os usuários, e não por mensagens individuais. O custo varia de acordo com a categoria da conversa (marketing, utilidade, autenticação ou serviço) e o país do usuário.

Plano gratuito: o WhatsApp oferece um plano gratuito que inclui 1,000 conversas de serviço gratuitas por mês, abrangendo interações iniciadas pelo usuário e pela empresa, e é renovado mensalmente. A partir de 1st November 2024, todas as conversas de serviço são gratuitas.

Painel de cobrança: uma ferramenta que permite às empresas que usam a WhatsApp Business Platform acompanhar e gerenciar o uso e os custos, oferecendo uma visão geral das conversas, suas categorias e as cobranças correspondentes.

4. Outros recursos avançados

Provedores terceirizados: empresas ou plataformas que oferecem ferramentas, serviços e soluções para simplificar a integração, o gerenciamento e o uso da WhatsApp Business API. Elas ajudam as empresas com a configuração, o envio de mensagens, a automação, as análises e a conformidade, facilitando o uso do WhatsApp na comunicação com os clientes.

URL de callback: um endpoint de webhook (URL) para o qual o WhatsApp envia notificações em tempo real sobre status de mensagens, mensagens recebidas e outros eventos. Ele permite que seu sistema reaja dinamicamente às interações dos usuários e às atualizações, garantindo uma comunicação e automação sem interrupções.

Autenticação: o processo de verificação de solicitações da API usando credenciais seguras, como um token de acesso e um segredo do app. Isso garante que somente usuários ou sistemas autorizados possam interagir com a WhatsApp Business API, protegendo os dados e mantendo uma comunicação segura entre empresas e usuários

Suporte multiagente: o suporte multiagente da WhatsApp API permite que vários agentes atendam às solicitações dos clientes por meio de uma única conta da WhatsApp Business, possibilitando que as empresas ampliem suas equipes de suporte e melhorem os tempos de resposta.

Chatbots: o chatbot do WhatsApp busca oferecer uma experiência interativa e conversacional aos usuários por meio de um canal de mensagens que eles usam diariamente para conversar com familiares e amigos

Prazo de validade da mensagem: o prazo de validade da mensagem é o limite de tempo após o qual não haverá mais tentativas de entregar uma mensagem não entregue. Esse recurso garante que mensagens desatualizadas ou irrelevantes não sejam entregues aos usuários após determinado período. Meta for Developers: a plataforma onde as empresas se cadastram e gerenciam a integração com a WhatsApp Cloud API.

Token de acesso: um token seguro usado para autenticar solicitações da API.

Chave de API: uma chave exclusiva para proteger sua integração com a WhatsApp Cloud API.

Documentação da API: guias oficiais para desenvolvedores implementarem as APIs do WhatsApp.

A solução WhatsApp Business API é dinâmica, com novos recursos e funcionalidades sendo adicionados. Esperamos que esta lista tenha apresentado todos os recursos, ferramentas e funcionalidades mais recentes do ecossistema da Business API. No entanto, se você pretende explorar a WhatsApp Business API para sua empresa, pode se inscrever para uma demonstração do nosso produto Chakra WhatsApp pelo link abaixo.