Glossário
Glossário de WhatsApp API e automação: 40 termos explicados
Aqui estão os termos que aparecem quando você integra ou automatiza o WhatsApp, cada um com uma definição curta e correta: instância, webhook, template, janela de 24 horas, BSP, QR code, aquecimento e outros. Use o índice, vá direto ao termo e siga os links para o guia completo.
Equipe ZapZap API · Publicado em
Conceitos básicos
Instância
- Número de WhatsApp conectado a uma API, com sessão, ID, credenciais e webhook próprios. Cada número ativo é uma instância, e cada uma tem sessão própria.O que é uma instância de WhatsApp
QR code
- Código que você lê com o celular para parear um número com a instância, igual ao login no WhatsApp Web. Se a conexão cair, pode ser preciso ler de novo.Início rápido
Sessão
- Conexão ativa entre o número e o servidor depois do pareamento. Enquanto a sessão estiver aberta, a instância envia e recebe mensagens; quando ela cai, o status passa a desconectado.
API não oficial
- Serviço que expõe por API uma sessão do WhatsApp Web, sem passar pela plataforma da Meta. É mais flexível e rápida de começar, mas não é canal homologado e o número pode ser restringido.Guia honesto da API não oficial
Número virtual
- Número de telefone sem chip físico dedicado, normalmente fornecido por um serviço de telefonia. Pode receber o código de verificação do WhatsApp, mas vale entender como o número foi obtido antes de usá-lo.Número virtual para WhatsApp
Grupo
- Conversa com vários participantes. Pela API é possível ler eventos de grupo e enviar mensagens para ele.Módulos de grupos
Hospedagem própria (self-hosted)
- Modelo em que você instala e opera o software no seu servidor, como o WAHA ou a Evolution API. Você controla o ambiente e assume atualização, backup e disponibilidade.ZapZap vs WAHA
Status de entrega
- Estado de uma mensagem enviada: enviada, entregue ou lida. A API informa essas mudanças por eventos, o que permite acompanhar o que chegou ao destinatário.
API oficial da Meta
API oficial (WhatsApp Business Platform)
- Plataforma da Meta para empresas. Exige verificação do negócio, usa templates aprovados para iniciar conversas e é cobrada por mensagem de template entregue desde 1º de julho de 2025, segundo a documentação da Meta.WhatsApp Business API
Cloud API
- Versão da API oficial hospedada pela própria Meta, acessada por HTTP. Pode ser usada direto ou por meio de um parceiro (BSP).
BSP (parceiro de soluções)
- Business Solution Provider: empresa parceira da Meta que dá acesso e suporte à API oficial, normalmente cobrando uma taxa própria além do preço da Meta.ZapZap vs 360dialog
Template (modelo de mensagem)
- Mensagem pré-aprovada pela Meta, obrigatória para a empresa iniciar uma conversa ou escrever fora da janela de 24 horas na API oficial. Pode ter variáveis, como nome e data.
Categorias de template
- Classificação da Meta para templates: marketing, utilidade e autenticação. A categoria influencia a regra de uso e o preço por mensagem na API oficial.
Janela de 24 horas
- Prazo que começa quando o cliente envia uma mensagem. Dentro dele, a empresa pode responder com texto livre na API oficial; fora dele, só é possível enviar template aprovado.
Verificação do negócio
- Processo da Meta para confirmar a identidade da empresa, exigido para usar a API oficial em escala. Leva tempo e pede documentos, o que a via não oficial não exige.
Mensagem interativa (botões e listas)
- Mensagem com botões de resposta ou lista de opções. Facilita a escolha do cliente e organiza o atendimento, e o suporte varia conforme o tipo de API.Botões e listas no WhatsApp
Risco e boas práticas de envio
Aquecimento
- Uso gradual e natural de um número novo antes de colocá-lo em volume, para o histórico parecer o de uma pessoa. Reduz o risco de restrição, mas não o elimina.Aquecimento de chip
Bloqueio (banimento)
- Restrição aplicada pelo WhatsApp a um número, temporária ou definitiva. Os Termos do WhatsApp proíbem mensagens em massa e automáticas, e nenhum fornecedor pode garantir que isso não aconteça.Anti-bloqueio
Opt-in
- Consentimento prévio da pessoa para receber mensagens da empresa. Registrar quando e como ele foi dado é uma boa prática e protege você.
Opt-out
- Saída: a forma de a pessoa pedir para não receber mais mensagens. Deixar o caminho fácil e respeitar o pedido reduz denúncias e problemas legais.
LGPD
- Lei Geral de Proteção de Dados (Lei 13.709/2018), que regula o tratamento de dados pessoais no Brasil. O consentimento é uma das bases legais, e a lei prevê outras.Disparo em massa e LGPD
Disparo em massa
- Envio da mesma mensagem, ou de variações dela, para muitos contatos. É a prática de maior risco para o número e a que mais exige consentimento, texto variado e ritmo controlado.Disparo em massa
Lista de transmissão
- Recurso do app do WhatsApp para enviar uma mensagem a vários contatos, que a recebem como conversa individual. Só chega a quem salvou o seu número nos contatos.
Follow-up
- Mensagem de acompanhamento depois de um primeiro contato, para retomar a conversa. Funciona melhor com intervalo respeitoso, valor real e uma saída fácil.Como fazer follow-up
Integração e desenvolvimento
Webhook
- URL do seu sistema que recebe um aviso (requisição HTTP) sempre que algo acontece, como uma mensagem recebida. Evita ficar consultando a API de tempos em tempos.Webhooks
Evento
- Aviso enviado pela API quando algo muda: mensagem recebida, mudança de status de entrega, instância conectada ou desconectada. Chega ao seu webhook.
Endpoint
- Endereço de uma operação da API, como o de enviar texto. Cada endpoint tem método HTTP, parâmetros e resposta definidos.Referência da API
API REST
- Estilo de API em que você faz requisições HTTP (GET, POST e outras) a endereços e recebe respostas em JSON. É o formato usado pela maioria das APIs de WhatsApp.
Payload
- Corpo de dados de uma requisição ou de um evento, normalmente em JSON. No envio de mensagem, leva o número e o texto.Enviar mensagem
Chave e segredo de API
- Par de credenciais que identifica a sua conta em cada requisição. O segredo deve ficar só no seu servidor, nunca em código de navegador ou aplicativo.Autenticação
Formato E.164 (DDI)
- Padrão internacional de número: código do país seguido do DDD e do número, só dígitos e com até 15 no total. No Brasil, 55 + DDD + número, como 5511999999999.
Limite de requisições (rate limit)
- Teto de chamadas à API em um intervalo. Ao passar dele, o servidor costuma responder com o código 429, e o certo é esperar e tentar de novo mais devagar.
Idempotência
- Propriedade de repetir a mesma operação sem efeito duplicado. É importante para não enviar duas vezes a mesma mensagem quando uma requisição é repetida por falha de rede.
Código de status HTTP
- Número da resposta que diz o resultado da chamada: 2xx é sucesso, 4xx é erro de quem chamou (como 401, sem autorização) e 5xx é erro do servidor.
Automação e vendas
Chatbot
- Programa que responde mensagens de forma automática, por regras ou por IA. Funciona melhor quando sabe passar a conversa para uma pessoa na hora certa.Chatbot de WhatsApp com IA
Agente de IA
- Chatbot que usa inteligência artificial para entender o contexto e responder em linguagem natural, seguindo instruções definidas por você, como tom de voz e limites.Resposta automática com IA
Fluxo (flow)
- Sequência de passos de uma automação: gatilho, condições e ações, como esperar, perguntar e enviar mídia. Em ferramentas visuais é montado arrastando blocos.Flow Builder
Funil de vendas
- Etapas pelas quais um contato passa até comprar, como novo, em conversa, proposta e fechado. No WhatsApp, cada conversa é organizada na etapa em que está.Funil de vendas no WhatsApp
CRM
- Sistema que guarda contatos, histórico e oportunidades de venda. Integrado ao WhatsApp, registra as conversas e dispara mensagens a partir das etapas do funil.Integrações com CRM
Automação no-code
- Ferramenta que liga sistemas sem programar, como n8n, Make e Zapier. Recebe o evento do WhatsApp por webhook e dispara ações em planilhas, CRMs e outros apps.Integração com n8n
Perguntas frequentes
O que é uma instância de WhatsApp?
É um número de WhatsApp conectado a uma API, com sessão, ID, credenciais e webhook próprios. Cada número ativo é uma instância.
Qual a diferença entre API oficial e não oficial?
A oficial é a plataforma da Meta, com verificação do negócio, templates aprovados e cobrança por mensagem. A não oficial conecta o seu número por uma sessão do WhatsApp Web, aceita texto livre e não é homologada, então o número pode ser restringido.
Para que serve um webhook?
Para o seu sistema receber um aviso na hora em que algo acontece, como uma mensagem recebida, sem precisar consultar a API de tempos em tempos.
O que é a janela de 24 horas?
É o prazo, a partir da mensagem do cliente, em que a empresa pode responder com texto livre na API oficial. Fora dele, só template aprovado.
Pronto para colocar os termos em prática?
Crie a conta, verifique o telefone e receba o crédito de boas-vindas, sem depositar (um por telefone, sujeito à campanha vigente). Conecte uma instância por QR code e rode o primeiro envio hoje.