Pular para o conteúdo
D-APITestar grátis

Glossário da API de WhatsApp

39 termos que aparecem quando um SaaS integra WhatsApp: da cobrança da Meta aos identificadores de contato. Cada termo tem um link próprio para você citar.

Access token da Meta

Access token da Meta é a credencial da Graph API que autoriza chamadas em nome de uma conta do WhatsApp Business, como enviar mensagens e gerenciar templates. Quem tem o token consegue operar a WABA, então ele deve ficar só no backend, fora de logs, URLs e armazenamento do navegador. Na D-API, o token da conexão de API Oficial volta no resultado do onboarding e também pode ser consultado pelo backend com a API key secreta.

Veja também: WABA (WhatsApp Business Account), Cloud API, Embedded Signup

API key

API key é a chave secreta que identifica e autoriza uma conta ao chamar uma API pelo servidor. Ela dá acesso total aos recursos da conta, por isso fica guardada no backend e nunca vai para o navegador ou para o app do usuário final. Na D-API, a API key é enviada no header Authorization de cada requisição para https://api.d-api.cloud.

Veja também: Publishable key, SDK

API não oficial do WhatsApp

API não oficial do WhatsApp é uma integração que opera um número como dispositivo conectado, do mesmo jeito que o WhatsApp Web, e expõe esse número por uma API HTTP. A conexão é feita lendo um QR code ou digitando um código de pareamento no celular, sem cadastro na Meta e sem aprovação de templates. Na D-API, a sessão é criada com type "unofficial" e inclui fazer e receber ligações de WhatsApp sem custo extra.

Veja também: API Oficial do WhatsApp, Sessão, QR code de pareamento, Código de pareamento

API Oficial do WhatsApp

API Oficial do WhatsApp é a WhatsApp Business Platform, a interface que a Meta disponibiliza para empresas enviarem e receberem mensagens de forma programática. Ela exige uma WABA, um número registrado e templates aprovados para iniciar conversas fora da janela de atendimento, e as mensagens são tarifadas pela Meta por categoria. Na D-API, a API Oficial e a não oficial usam a mesma implementação, e o modo de webhook normalized entrega os dois tipos de conexão no mesmo formato.

Veja também: Cloud API, WABA (WhatsApp Business Account), Template de mensagem, API não oficial do WhatsApp

BSP (Business Solution Provider)

BSP (Business Solution Provider) é a empresa parceira da Meta autorizada a oferecer acesso à WhatsApp Business Platform para outras empresas. O BSP cuida de onboarding, suporte e, em muitos casos, do faturamento das mensagens dos clientes que atende. Para um SaaS, contratar um BSP ou um Tech Provider é o caminho para colocar a API Oficial dentro do produto sem construir a integração com a Meta do zero.

Veja também: Tech Provider, API Oficial do WhatsApp, Embedded Signup

Categoria autenticação

Categoria autenticação é o tipo de template da API Oficial do WhatsApp usado para enviar códigos de uso único, como verificação de login, confirmação de cadastro e recuperação de conta. A Meta restringe o conteúdo dessa categoria ao código e a textos padrão de segurança, e a tarifa é definida por ela conforme o país do destinatário. É a categoria certa para fluxos de 2FA e confirmação de número dentro de um SaaS.

Veja também: Template de mensagem, Categoria utilidade, Categoria marketing

Categoria marketing

Categoria marketing é o tipo de template da API Oficial do WhatsApp para mensagens promocionais, ofertas, novidades, convites e reengajamento. Qualquer template que misture conteúdo promocional com informação transacional tende a ser classificado pela Meta como marketing. O envio depende de opt-in do destinatário e segue a tarifa e as regras de entrega que a Meta define para a categoria.

Veja também: Template de mensagem, Opt-in, Categoria utilidade

Categoria serviço

Categoria serviço é a classificação da Meta para as mensagens de texto livre que a empresa envia em resposta a um usuário, dentro da janela de atendimento de 24 horas. Essas mensagens dispensam template e cobrem o atendimento do dia a dia, como tirar dúvidas e resolver pedidos. Fora da janela, a empresa só consegue falar com o usuário por template aprovado de outra categoria. Desde 1º de outubro de 2026, a Meta cobra essas mensagens, com 1.000 gratuitas por mês para cada número comercial.

Veja também: Janela de atendimento (janela de 24 horas), Template de mensagem, Categoria utilidade

Categoria utilidade

Categoria utilidade é o tipo de template da API Oficial do WhatsApp para mensagens transacionais ligadas a algo que o usuário já fez ou pediu, como confirmação de pedido, atualização de entrega, lembrete de consulta e aviso de cobrança. O conteúdo precisa ser específico daquela transação e livre de promoção, caso contrário a Meta reclassifica o template como marketing. É a categoria mais comum em SaaS de agendamento, delivery e cobrança.

Veja também: Template de mensagem, Categoria marketing, Categoria serviço

Click-to-WhatsApp (anúncio que abre conversa)

Click-to-WhatsApp é o formato de anúncio do Facebook e do Instagram cujo botão abre uma conversa no WhatsApp com a empresa anunciante. O lead chega direto no chat, com a origem do anúncio associada à conversa, o que permite medir campanha por mensagem recebida. Na API Oficial, a conversa iniciada por esse anúncio abre a entrada gratuita via anúncio, e o builder de automação da D-API tem fluxos para responder leads vindos de anúncios da Meta.

Veja também: Entrada gratuita via anúncio (free entry point), Janela de atendimento (janela de 24 horas), API Oficial do WhatsApp

Cloud API

Cloud API é a versão da WhatsApp Business Platform hospedada pela própria Meta e acessada pela Graph API. Ela dispensa servidor próprio para o WhatsApp: a empresa chama os endpoints da Meta e recebe eventos por webhook. Na D-API, cada número da Cloud API vira uma conexão com connectionId, que funciona como sessionId nas mesmas rotas de envio usadas pela API não oficial.

Veja também: API Oficial do WhatsApp, WABA (WhatsApp Business Account), Access token da Meta, Conexão

Código de pareamento

Código de pareamento é uma sequência de caracteres que o usuário digita no celular, em Dispositivos conectados, para vincular o número a um novo dispositivo sem ler QR code. É a alternativa ao QR code quando o usuário não tem como apontar a câmera para a tela, como em onboarding pelo próprio celular. Na D-API, o código é obtido em GET /api/v1/sessions/{sessionId}/pair-code e também chega pelo webhook connection.paircode.

Veja também: QR code de pareamento, Sessão, API não oficial do WhatsApp

Coexistência

Coexistência é o recurso da Meta que permite usar o mesmo número no app WhatsApp Business e na API Oficial ao mesmo tempo. O cliente continua atendendo pelo celular enquanto o SaaS envia e recebe pela API, e o histórico do app é sincronizado. Na D-API, o onboarding em coexistência é iniciado com mode "coexistence", e o cliente escaneia um QR no app WhatsApp Business para concluir.

Veja também: Embedded Signup, API Oficial do WhatsApp, Cloud API

Conexão

Conexão é um número de WhatsApp vinculado a uma plataforma de API e pronto para enviar e receber mensagens. Em SaaS, cada cliente final costuma ter uma ou mais conexões, e o custo de infraestrutura cresce por conexão ativa. Na D-API, a cobrança é por conexão, cada conexão roda isolada com IP dedicado, e o preço por conexão cai com o volume.

Veja também: Sessão, Multi-tenant, API Oficial do WhatsApp, API não oficial do WhatsApp

Disparo de voz

Disparo de voz é o envio automatizado de ligações telefônicas para uma lista de números, com uma mensagem gravada ou sintetizada e, opcionalmente, um menu de opções. É usado para lembretes, confirmações, cobrança e avisos urgentes quando o contato precisa ouvir a mensagem. Na D-API, o disparo em massa de voz é feito por POST /api/v1/voice/bulk, e os eventos de cada ligação chegam no webhook do canal voice.

Veja também: URA (Unidade de Resposta Audível), DTMF, Webhook

DTMF

DTMF (Dual-Tone Multi-Frequency) é o sinal gerado quando a pessoa aperta uma tecla do telefone durante uma ligação. É assim que uma URA sabe qual opção do menu foi escolhida, como "digite 1 para confirmar". Na D-API, cada dígito pressionado numa ligação de voz chega no webhook como evento call.dtmf.

Veja também: URA (Unidade de Resposta Audível), Disparo de voz

Embedded Signup

Embedded Signup é o fluxo da Meta que permite ao cliente de uma plataforma criar ou conectar a WABA e registrar o número da API Oficial sem sair do produto dessa plataforma. O cliente faz login com a conta do Facebook, escolhe a empresa e o número, e a plataforma recebe os dados para operar a conexão. Na D-API, o fluxo roda numa página hospedada aberta como popup pelo SaaS, de modo que o domínio do SaaS dispensa cadastro na Meta.

Veja também: Tech Provider, Publishable key, Coexistência, WABA (WhatsApp Business Account)

Entrada gratuita via anúncio (free entry point)

Entrada gratuita via anúncio é a regra da API Oficial do WhatsApp em que a conversa iniciada pelo usuário a partir de um anúncio Click-to-WhatsApp ou do botão de uma página do Facebook abre um período sem cobrança de mensagens pela Meta, com a duração definida na tabela de preços oficial. Nesse período a empresa pode responder e enviar templates ao usuário. Para um SaaS de marketing, é o que torna viável qualificar e nutrir leads de anúncio pelo WhatsApp.

Veja também: Click-to-WhatsApp (anúncio que abre conversa), Janela de atendimento (janela de 24 horas), Template de mensagem

Fila RabbitMQ

Fila RabbitMQ é uma fila de mensagens do RabbitMQ, um broker de código aberto, usada para entregar eventos a um sistema consumidor de forma assíncrona e durável. Com fila, o consumidor processa no próprio ritmo e não perde eventos quando fica fora do ar por alguns minutos. Na D-API, cada sessão pode publicar seus eventos num RabbitMQ próprio, configurado em POST /api/v1/sessions/{sessionId}/rabbitmq-config, e alguns eventos de histórico chegam apenas por esse canal.

Veja também: Webhook, Sessão

Janela de atendimento (janela de 24 horas)

Janela de atendimento é o período de 24 horas que se abre na API Oficial do WhatsApp sempre que o usuário envia uma mensagem para a empresa. Dentro dela, a empresa responde com mensagens livres de qualquer tipo; fechada a janela, só pode retomar o contato com um template aprovado. Cada nova mensagem do usuário reinicia a contagem das 24 horas.

Veja também: Categoria serviço, Template de mensagem, Entrada gratuita via anúncio (free entry point)

JID (WhatsApp ID)

JID é o identificador de um usuário ou grupo no protocolo do WhatsApp, formado por um número ou código seguido de um domínio, como [email protected] para contatos e @g.us para grupos. Ele é a chave estável para associar mensagens, chats e contatos no banco de dados de uma integração. Nos webhooks da D-API, remetente e destinatário trazem o campo jid.

Veja também: LID (identificador interno do WhatsApp), Webhook

LID (identificador interno do WhatsApp)

LID é um identificador interno que o WhatsApp atribui a cada conta, no formato número@lid, sem expor o telefone do usuário. Ele aparece principalmente em grupos e em contextos de privacidade, e uma integração precisa saber relacioná-lo ao JID para não tratar a mesma pessoa como dois contatos. Nos webhooks de mensagem recebida da D-API, o remetente vem com jid e lid.

Veja também: JID (WhatsApp ID), Webhook

Limite de mensagens

Limite de mensagens é o teto de destinatários únicos que um número pode alcançar com mensagens iniciadas pela empresa num intervalo de tempo. Na API Oficial, a Meta define esse limite por número e o aumenta conforme volume e qualidade das mensagens enviadas. Na D-API, as cotas e restrições de uma sessão podem ser consultadas em GET /api/v1/limits/{sessionId}.

Veja também: Número verificado, Opt-in, Template de mensagem

MCP (Model Context Protocol)

MCP (Model Context Protocol) é um padrão aberto para conectar modelos de IA a ferramentas, dados e sistemas externos por meio de uma interface comum. Um servidor MCP descreve as ações disponíveis, e o agente de IA decide quando chamá-las durante a conversa. A D-API oferece um servidor MCP que dá a agentes de IA acesso às ações de WhatsApp, como enviar mensagens e consultar conversas.

Veja também: SDK, API key

Mensagem interativa

Mensagem interativa é a mensagem de WhatsApp com elementos clicáveis, como botões de resposta, listas de opções, carrossel de cards e botões de link ou ligação. Ela reduz digitação do usuário e deixa a resposta estruturada, o que facilita automação e chatbots. Na D-API, esses formatos são enviados pelas rotas /api/v1/interactive/send/list, carousel, pix, nativeflow e template.

Veja também: Template de mensagem, Janela de atendimento (janela de 24 horas)

Multi-tenant

Multi-tenant é a arquitetura em que uma única instalação de software atende vários clientes (tenants), com dados e configurações isolados entre eles. Num SaaS com WhatsApp, cada tenant tem as próprias conexões, webhooks e permissões, e nenhum evento pode vazar para outro cliente. Na D-API, o campo metadata do onboarding da API Oficial guarda o identificador do tenant e volta intacto no webhook session.created.

Veja também: Conexão, Sessão, Webhook

Número verificado

Número verificado é o número de telefone cuja posse foi confirmada por código enviado por SMS ou ligação durante o registro na API Oficial do WhatsApp. A verificação é etapa obrigatória para o número enviar e receber mensagens pela plataforma da Meta. Ela é independente da verificação da empresa no Gerenciador de Negócios, que confirma a identidade jurídica do negócio.

Veja também: WABA (WhatsApp Business Account), Embedded Signup, API Oficial do WhatsApp

Opt-in

Opt-in é o consentimento explícito do usuário para receber mensagens de uma empresa por um canal, como o WhatsApp. A Meta exige opt-in antes de mensagens iniciadas pela empresa, e o registro desse consentimento também atende à LGPD. Em SaaS, o opt-in costuma ser coletado em formulário, checkout ou na primeira conversa, e precisa ficar guardado com data e origem.

Veja também: Categoria marketing, Template de mensagem, Limite de mensagens

Publishable key

Publishable key é uma chave pública, segura para ficar no frontend, que só permite iniciar um fluxo específico e não dá acesso a dados nem a envio de mensagens. Ela existe para que o navegador do cliente final dispare uma ação sem expor a chave secreta da conta. Na D-API, a publishable key tem o prefixo pk_live_ e serve para abrir o onboarding da API Oficial com o DApiConnect do d-api-sdk.

Veja também: API key, Embedded Signup, SDK

QR code de pareamento

QR code de pareamento é o código exibido na tela que o usuário lê com o celular, em Dispositivos conectados, para vincular o número de WhatsApp a um novo dispositivo. É o método padrão para conectar um número na API não oficial, e o código é renovado a cada poucos segundos até a leitura. Na D-API, o QR é obtido em GET /api/v1/sessions/{sessionId}/qr e também chega pelo webhook connection.qrcode.

Veja também: Código de pareamento, Sessão, API não oficial do WhatsApp

SDK

SDK (Software Development Kit) é uma biblioteca que encapsula as chamadas de uma API em funções tipadas da linguagem do desenvolvedor. Ele reduz código repetido de autenticação, serialização e tratamento de erro. A D-API mantém o SDK Node d-api-sdk, com o cliente DApi para o backend e o DApiConnect para o onboarding da API Oficial no frontend.

Veja também: API key, Publishable key, MCP (Model Context Protocol)

Sessão

Sessão é a instância que representa um número de WhatsApp conectado dentro de uma API, com estado de conexão, configuração de webhooks e histórico próprios. Toda chamada de envio e todo evento recebido referenciam a sessão de origem. Na D-API, a sessão é identificada por sessionId, criada em POST /api/v1/sessions, e nas conexões de API Oficial o connectionId é o próprio sessionId.

Veja também: Conexão, QR code de pareamento, Webhook

SMS

SMS (Short Message Service) é a mensagem de texto enviada pela rede da operadora de telefonia, que chega a qualquer celular sem depender de app ou internet. Em SaaS, é usado como canal de contingência do WhatsApp e para códigos, lembretes e avisos que precisam alcançar todo mundo. Na D-API, o envio avulso é feito em POST /api/v1/sms/send e o envio em massa em POST /api/v1/sms/bulk.

Veja também: Disparo de voz, Webhook

Status de mensagem

Status de mensagem é o estado de entrega de uma mensagem de WhatsApp depois do envio, como enviada, entregue, lida ou apagada. A integração recebe essas mudanças por webhook e atualiza a interface e as métricas do produto, como taxa de leitura de uma campanha. Na D-API, os status chegam nos eventos message.delivered, message.read e message.deleted.

Veja também: Webhook, Sessão

Tech Provider

Tech Provider é a categoria de parceiro da Meta para empresas de tecnologia que oferecem a WhatsApp Business Platform aos próprios clientes por meio do Embedded Signup. Nesse modelo, o cliente final é dono da WABA e paga as mensagens diretamente à Meta, enquanto o parceiro opera a integração. Com a D-API como provedora, o SaaS abre o Embedded Signup numa página hospedada pela D-API, sem cadastrar o próprio domínio na Meta, e a tarifa da Meta fica na WABA do cliente final.

Veja também: BSP (Business Solution Provider), Embedded Signup, WABA (WhatsApp Business Account)

Template de mensagem

Template de mensagem é um modelo de mensagem pré-aprovado pela Meta, obrigatório para a empresa iniciar uma conversa na API Oficial do WhatsApp ou retomá-la fora da janela de atendimento. Cada template tem uma categoria (marketing, utilidade ou autenticação), idioma e variáveis preenchidas no envio. Na D-API, os templates de cada conexão de API Oficial são criados, listados e excluídos pelas rotas /api/v1/connections/cloud-api/{id}/templates.

Veja também: Categoria marketing, Categoria utilidade, Categoria autenticação, Janela de atendimento (janela de 24 horas)

URA (Unidade de Resposta Audível)

URA (Unidade de Resposta Audível) é o sistema de atendimento telefônico automático que toca mensagens de voz e conduz a pessoa por um menu de opções digitadas no teclado. Ela resolve confirmações, triagem e pesquisas sem atendente humano na linha. Na D-API, o ciclo de cada ligação de URA chega no webhook do canal voice pelos eventos call.started, call.answered, call.dtmf e call.ended.

Veja também: DTMF, Disparo de voz, Webhook

WABA (WhatsApp Business Account)

WABA (WhatsApp Business Account) é a conta da Meta que agrupa os números, os templates e o método de pagamento de uma empresa na API Oficial do WhatsApp. Ela fica vinculada a um portfólio empresarial da Meta, e é nela que as mensagens tarifadas são cobradas. Na D-API, as tarifas da Meta são cobradas na WABA do cliente final do SaaS, separadas do preço por conexão.

Veja também: API Oficial do WhatsApp, Cloud API, Embedded Signup, Tech Provider

Webhook

Webhook é uma chamada HTTP que um sistema faz para a URL de outro sempre que acontece um evento, como uma mensagem recebida ou uma mudança de status. Ele evita consultas repetidas à API e entrega os eventos em tempo real ao backend do SaaS, que deve responder rápido e processar em fila. Na D-API, todo webhook de WhatsApp chega com o envelope event, sessionId, data, timestamp e traceId, e falhas são retentadas até 7 vezes com backoff exponencial.

Veja também: Fila RabbitMQ, Status de mensagem, Sessão

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.