Os termos de rede e de protocolo são os mínimos para ler a documentação. Quando um termo tem um guia só dele, o link leva até lá.
A
Aprovação humana. Modo em que a mensagem de um bot ou de um assistente de IA fica pendente até uma pessoa liberar. Veja aprovação humana.
API não oficial. Programa que fala com o WhatsApp do mesmo jeito que um aparelho conectado, sem passar pela API da Meta. Não tem selo, não tem modelos aprovados e o WhatsApp pode bloquear qualquer número. Veja a página do produto.
API oficial. A API comercial da Meta, com empresa verificada, modelos de mensagem aprovados e cobrança por conversa. É outro produto. Comparativo: API oficial ou não oficial.
Aparelho conectado. Dispositivo ligado a uma conta de WhatsApp por QR ou código. A instância aparece para o celular como um aparelho a mais.
Aviso automático. Ver webhook.
apikey. Cabeçalho HTTP que leva a chave da instância em toda chamada. Também vale Authorization: Bearer.
B
Bot. Programa ligado à instância que responde mensagens sozinho. Veja bots.
Botão. Opção tocável numa mensagem (resposta, link, copiar, ligar), provada em aparelho real em 12/11/2026. Lista (menu) e carrossel não funcionam hoje. Veja botões.
Buffer (agrupar mensagens). Espera de alguns segundos para reunir mensagens seguidas em um aviso message.batch. Veja agrupar mensagens.
Base64. Forma de escrever um arquivo como texto, para caber dentro de um JSON. Cresce cerca de um terço. Usada em media.base64. Veja enviar mídia.
Beta (em beta). Rota que ainda não foi provada em número real e pode mudar. As provadas aparecem como stable. Aparece como status: "beta" em GET /instance. Veja o histórico de versões.
C
Chave da instância. Texto secreto no formato pbwa_… que abre uma instância. Não existe chave de conta. Se vazar, gere outra no painel; a anterior para na hora.
Código de pareamento. Código de 8 caracteres que o painel ou POST /instance/pair-code mostram para você digitar no celular, no lugar de ler o QR. Vale poucos minutos. Veja conectar.
Contato novo. Telefone com quem o seu número nunca conversou (nem recebeu, nem enviou) nos últimos 60 dias. Importa na trava de contato novo.
D
daily_limit. Erro 429 do teto diário de mensagens (500 no padrão). O retry_after diz em quantos segundos o dia vira.
deaf ("surda"). Estado em que a instância aparece conectada, mas não recebe resposta do WhatsApp. GET /health informa. O vigia tenta reconectar sozinho.
E
Etiqueta. Marca própria da ProxyBox para organizar conversas; não aparece no aplicativo do WhatsApp. Veja etiquetas.
expires_in. Dois significados: em GET /instance/qr, os segundos que o QR ainda vale; em um envio, a duração da mensagem temporária (86400, 604800 ou 7776000 segundos).
F
Figurinha. Imagem pequena (sticker). Aceita webp, png, jpg ou gif até 1 MB.
G
@g.us. Final do identificador de um grupo: [email protected]. Vai em to para enviar ao grupo. Veja grupos.
H
HMAC-SHA256. Assinatura calculada com um segredo e o corpo da mensagem. Prova que o aviso veio da ProxyBox e não foi alterado. Veja aviso automático.
I
IPs permitidos (allowlist). Lista de até 20 IPs ou faixas que podem usar a chave. Veja IPs permitidos.
Idempotência (Idempotency-Key). Cabeçalho que torna um envio repetível: a mesma chave em até 24 horas devolve a resposta original sem enviar de novo. Até 64 caracteres.
Instância. Um número de WhatsApp conectado à API, com chave, histórico, ritmo e (no plano com IP) endereço de saída próprios. Uma instância por número.
J
JID. Identificador completo de uma conta ou grupo no WhatsApp, como [email protected]. Veja número e identidade.
L
Long-poll (espera longa). Consulta que fica aberta até aparecer um aviso novo, no máximo 25 segundos. Veja receber por consulta.
@lid. Identificador interno de uma pessoa que não mostra o telefone. Pode aparecer no lugar do telefone em grupos e com a privacidade ligada. Não é um telefone.
M
MCP. Padrão que liga assistentes de IA (Claude, Cursor) a ferramentas. O conector da ProxyBox expõe a API de WhatsApp com confirmação em cada envio. Veja Claude e Cursor.
N
Nono dígito. O "9" que foi acrescentado aos celulares do Brasil. Algumas contas existem só sem ele. A API resolve no envio.
Não perturbe (opt-out). Lista de telefones que pediram para parar. Envio a eles devolve 409 opted_out. Veja não perturbe.
O
OpenAPI. Arquivo que descreve todas as rotas de uma API em formato legível por máquina. Veja especificação e status.
P
Pull e push. No push, a ProxyBox chama o seu endereço com cada aviso; no pull, o seu sistema consulta GET /events. Veja receber por consulta.
Passkey (chave de acesso). Confirmação por biometria ou senha do aparelho que o WhatsApp pode pedir ao conectar. GET /instance informa em passkey.
PTT. "Push to talk": a mensagem de voz do WhatsApp, a bolinha com a onda. Em POST /messages/audio, é o voice.
Q
QR. Imagem que o celular lê em Aparelhos conectados. Vale poucos segundos.
R
rate_limited. Erro 429 do ritmo por minuto. O retry_after diz quantos segundos esperar.
Restrição 463 / 475. Bloqueio temporário de contatos novos aplicado pelo WhatsApp. Veja restrição 463.
Ritmo. Quantas mensagens por minuto e por dia a instância envia, e a pausa entre elas. O cliente só pode deixar mais devagar.
S
S3. Armazenamento de arquivos compatível com a API da Amazon (também R2, Backblaze, MinIO), onde a ProxyBox pode guardar a mídia recebida. Veja mídia no S3.
Sandbox. Instância de teste grátis que nunca envia ao WhatsApp. Veja sandbox.
Status (stories). Publicação que vai para todos os contatos do número; vem desligada. Veja status.
schedule. Campo de envio que marca uma hora futura. Uma mensagem por vez, sem repetição. Veja agendar.
Slug. Nome curto da instância no endereço, como atendimento-da-loja. Na base no estilo da Evolution, ocupa o lugar de {instance}.
signal (sinal). Resumo da saúde do número em GET /instance: ok, warn (restrito para contato novo) ou bad (sem resposta).
T
Trava de contato novo. Proteção da API que, depois de uma restrição 463/475, envia só a telefones vistos nos últimos 60 dias, por cerca de 6 horas.
U
uid. Identificador único de um aviso automático. O mesmo fato reenviado leva o mesmo uid; use-o para não processar duas vezes.
V
Vigia. Verificação a cada 5 minutos que confere se a instância conectada responde de verdade ao WhatsApp.
Visualização única (view_once). Imagem ou vídeo que a pessoa só abre uma vez.
W
Webhook (aviso automático). Chamada que a ProxyBox faz ao seu sistema quando algo acontece. Exige https, responde em até 10 segundos com 2xx e tem nova tentativa em 1 minuto, 5 minutos, 15 minutos, 1 hora e 6 horas.
Veja também
- Enviar a 1ª mensagem pela API de WhatsApp
- Webhook da API de WhatsApp: eventos e assinatura
- Referência da API de WhatsApp v1.2: rotas
- Erros e limites da API de WhatsApp
Índice completo: todos os guias.
Autoria: equipe técnica da ProxyBox. Revisado em 11/11/2026 contra a versão 1.1 da API. Faltou um termo? Fale com o suporte.