Glossário
Os termos de quem integra o WhatsApp
Webhook, HMAC, JID, LID, nono dígito, aquecimento de número: definições curtas, em português, com o link para a página que explica como usar cada conceito na prática.

Glossário
De A a Z
A
- Aparelho conectado
- Aparelho conectado é um dispositivo extra ligado a uma conta de WhatsApp, como o WhatsApp Web, o aplicativo de desktop ou o servidor de uma API. Ele é pareado pelo celular uma vez e depois envia e recebe mensagens mesmo com o celular desligado.
- API não oficial
- API não oficial do WhatsApp é um serviço que conecta um número comum pelo protocolo do WhatsApp Web, como um aparelho conectado, e expõe envio e recebimento de mensagens por HTTP. Não passa pela Meta: não exige aprovação, mas o número pode ser restringido.
- Aquecimento de número
- Aquecimento de número (ou de chip) é o período depois de conectar um WhatsApp em que os limites de envio começam baixos e sobem aos poucos, para o número ganhar histórico antes de chegar ao volume normal. Na apiwpp, ele dura 14 dias e é aplicado pela fila.
B
- Baileys
- Baileys é uma biblioteca open source em TypeScript que conecta um número ao WhatsApp pelo protocolo do WhatsApp Web, por WebSocket, sem abrir um navegador. É a base de várias APIs não oficiais, mas sozinha não traz API HTTP, fila nem webhooks.
H
- HMAC
- HMAC é um código calculado a partir de uma mensagem e de um segredo compartilhado, com uma função de hash como SHA-256. Quem tem o segredo recalcula o código e confirma que a mensagem veio de quem diz e não foi alterada no caminho.
I
- Idempotência
- Uma operação é idempotente quando repeti-la tem o mesmo efeito que fazê-la uma vez. Em APIs, isso se consegue com uma chave de idempotência: o cliente manda o mesmo identificador em cada tentativa e o servidor reconhece a repetição em vez de executar de novo.
- IP dedicado
- IP dedicado é um endereço IP reservado para um único uso. No WhatsApp conectado por API, é o IP por onde só um número sai para a internet, sem dividir o endereço, e a reputação dele, com outros números.
J
- JID
- JID (Jabber ID) é o endereço interno que o WhatsApp usa para cada conversa: um contato é algo como [email protected], um grupo termina em @g.us e um contato identificado sem telefone termina em @lid.
L
- LID
- LID (linked identity) é um identificador do WhatsApp, como 11122233344455@lid, que representa um contato sem revelar o número de telefone. É estável para o contato, mas não tem relação com o telefone.
N
- Nono dígito
- O nono dígito é o 9 que os celulares brasileiros ganharam na frente do número. Contas de WhatsApp antigas podem continuar registradas sem ele, e uma mensagem enviada ao endereço com o 9 não chega até elas.
P
- Proxy
- Proxy é um servidor intermediário por onde uma conexão passa antes de chegar ao destino. Para o destino, a conexão parece vir do endereço IP do proxy. Num número de WhatsApp conectado por API, esse IP é um dos sinais que o WhatsApp observa.
Q
- QR code de pareamento
- QR code de pareamento é o código que o celular escaneia para ligar o número de WhatsApp a um aparelho conectado, como o WhatsApp Web ou uma API. Ele muda a cada poucos segundos e pode ser trocado por um código de 8 caracteres.
R
- Rate limit
- Rate limit é o número máximo de requisições ou de ações que uma API aceita de um mesmo cliente num intervalo de tempo. Quando o teto é atingido, a API recusa as chamadas seguintes, em geral com o status 429 e o cabeçalho Retry-After.
T
- Template de mensagem
- Template de mensagem é um texto salvo com variáveis, como {{nome}} e {{pedido}}, que o sistema reutiliza em cada envio preenchendo os valores. Na Cloud API da Meta, o template precisa de aprovação; na apiwpp, é uma mensagem salva, sem aprovação.
W
- Webhook
- Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora.
- WhatsApp Cloud API
- WhatsApp Cloud API é a API oficial do WhatsApp para empresas, hospedada pela Meta como parte da WhatsApp Business Platform. Exige conta comercial, usa modelos de mensagem aprovados para iniciar conversas e é cobrada pela Meta por mensagem.
Para que serve este glossário
Integrar o WhatsApp mistura vocabulário de APIs (webhook, idempotência, rate limit) com detalhes do próprio WhatsApp (aparelho conectado, JID, LID). Cada termo tem uma definição de um parágrafo e uma página curta com exemplos.
Quando o termo tem um recurso da apiwpp por trás, a página aponta para ele e para o guia do blog que mostra como usar.
Continue explorando
- Recursos →Tudo que a API faz: conexão, envio, webhooks e fila.
- Casos de uso →Como cada tipo de empresa usa o WhatsApp pela API.
- Integrações →Exemplos em Node.js, PHP, Python e ferramentas no-code.
- Comparativos →API oficial, gerenciada ou self-hosted, lado a lado.
- Blog →Guias, tutoriais e boas práticas.
- Documentação →Guias da API e referência OpenAPI em português.