Quem começa a automatizar o WhatsApp esbarra num vocabulário que mistura o protocolo do WhatsApp Web, as regras da API oficial da Meta e o mundo dos agentes de IA. Este glossário explica cada termo do jeito que ele aparece na prática: definição curta, onde você vai encontrar e o erro mais comum.
Conexão e identidade
GuiaBaileys: o que é a biblioteca de WhatsApp em TypeScript
Baileys é uma biblioteca de código aberto em TypeScript que conecta ao WhatsApp como um aparelho conectado, sem navegador. O que ela faz, onde aparece e o erro mais comum.
GuiaAparelhos conectados (multidispositivo) no WhatsApp
Aparelhos conectados é o recurso multidispositivo do WhatsApp: até quatro aparelhos usam a mesma conta sem o celular estar online. Como funciona, o limite de 14 dias e onde as automações entram.
GuiaQR code de pareamento do WhatsApp: como conectar um aparelho
O QR code de pareamento conecta um aparelho novo (WhatsApp Web, Desktop ou uma automação) à sua conta. Como funciona, por que ele troca a cada poucos segundos e a alternativa por código.
GuiaJID no WhatsApp: o endereço de cada conversa
JID é o identificador interno de cada conta, grupo ou canal no WhatsApp. Os formatos que você vai ver numa integração e o erro que faz mensagem não chegar.
GuiaLID no WhatsApp: o identificador que esconde o número
LID é um identificador do WhatsApp que não revela o telefone da pessoa. Por que ele aparece em grupos e DMs, e como evitar contato duplicado na sua integração.
API oficial e regras da Meta
ComparativoAPI oficial vs não oficial do WhatsApp: a diferença que importa
API oficial é a Cloud API da Meta, paga e com regras de template; não oficial conecta pelo protocolo do WhatsApp Web, sem custo por mensagem e com risco de banimento. Quando usar cada uma.
GuiaJanela de 24 horas do WhatsApp: quando você pode mandar mensagem livre
Na API oficial do WhatsApp, a janela de 24 horas abre quando o cliente manda mensagem; dentro dela a empresa responde livre, fora dela só com template aprovado. Como funciona e o erro comum.
GuiaMensagem de template (HSM) no WhatsApp: o que é e quando precisa
Mensagem de template, antes chamada de HSM, é o modelo aprovado pela Meta que a API oficial exige para iniciar conversa fora da janela de 24 horas. Categorias, aprovação e erros comuns.
GuiaNúmero banido no WhatsApp: por que acontece e como evitar
Número banido é a conta que o WhatsApp suspende por violar os termos, de forma temporária ou definitiva. As causas mais comuns em automação e o que reduz o risco.
Integração e agentes
GuiaWebhook do WhatsApp: como sua aplicação fica sabendo de mensagem nova
Webhook é a chamada HTTP que avisa sua aplicação quando chega mensagem ou muda o status de um envio no WhatsApp. Como funciona na API oficial e nas não oficiais.
GuiaMCP (Model Context Protocol): o que é, no contexto do WhatsApp
MCP é um protocolo aberto que deixa um agente de IA usar ferramentas externas. Com um servidor MCP de WhatsApp, o Claude Code, o Codex ou o Cursor leem e respondem suas conversas.
ComparativoGrupo vs comunidade no WhatsApp: qual usar com clientes
Grupo é uma conversa entre vários participantes; comunidade reúne vários grupos sob um mesmo guarda-chuva, com um grupo de avisos. As diferenças e o que muda para quem atende clientes.
Perguntas frequentes
Qual a diferença entre JID e LID? JID é o endereço de qualquer conversa no protocolo; LID é um tipo de JID que identifica a pessoa sem mostrar o telefone.
Preciso da API oficial para automatizar? Não para atender quem já fala com você no seu número. A oficial é o caminho para notificação em escala; a comparação está em API oficial vs não oficial.
Onde o WACrew entra nisso? O WACrew é um painel e um servidor MCP de código aberto que conecta ao seu número como aparelho conectado (via Baileys) e deixa a IA atender no seu ritmo. Começo em servidor MCP de WhatsApp.
Em inglês: WhatsApp glossary.