Pular para o conteúdo
apiwpp
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.

Ilustração: fichas de termos técnicos com definições curtas
Glossário

De A a Z

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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.