--- title: "Glossário da API do WhatsApp: oficial e não oficial" description: "WABA, BSP, Cloud API, template, janela de 24h, mensagem de serviço, JID, LID, código de pareamento: os termos da API do WhatsApp explicados em 1 a 3 frases." url: "https://api-wa.me/blog/glossario-api-whatsapp-oficial-nao-oficial" language: "pt-BR" og:type: "article" og:site_name: "WAME API" --- [Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Glossário da API do WhatsApp: oficial e não oficial em linguagem direta Raphael Serafim· Publicado em 28 de setembro de 2026· 11 min de leitura Compartilhar # Glossário da API do WhatsApp: oficial e não oficial em linguagem direta WABA, BSP, Cloud API, template, janela de 24h, mensagem de serviço, JID, LID, código de pareamento: os termos da API do WhatsApp explicados em 1 a 3 frases. Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/glossario-api-whatsapp-oficial-nao-oficial.md) **Este glossário explica, em uma a três frases cada, os termos que aparecem quando você trabalha com a API do WhatsApp — oficial (Cloud API da Meta) e não oficial (conexão como aparelho conectado). Ele foi escrito para quem está avaliando migrar da oficial depois da nova cobrança de outubro de 2026 e precisa entender o vocabulário sem ler a documentação inteira.** Os termos estão em ordem alfabética; onde houver um guia completo no blog da WAME (api-wa.me), há link. ## Por que um glossário da API do WhatsApp? Porque a mesma coisa tem nomes diferentes dependendo de quem fala. "Número" pode ser telefone, `wa_id`, JID ou LID. "Conversa" pode ser janela de 24h, chat ou categoria de cobrança. Entender o termo certo evita erro de integração e de orçamento. A comparação completa entre os dois mundos está em [API oficial vs não oficial](https://api-wa.me/blog/whatsapp-api-oficial-vs-nao-oficial). ## Quais são os termos, de A a Z? ### 429 Código HTTP de "muitas requisições". Na conexão não oficial da WAME, a API responde `429` quando a instância fala com gente nova demais por minuto ou envia o mesmo texto para muitos números em poucos minutos — um freio contra comportamento de disparo. ### Aparelho conectado Dispositivo vinculado a uma conta do WhatsApp além do celular principal, como o WhatsApp Web. A conexão não oficial funciona como um aparelho conectado; ele aparece em **Aparelhos conectados** no app. ### API não oficial Conexão ao WhatsApp que não usa a Cloud API da Meta: o número é vinculado como aparelho conectado, por QR Code ou código de pareamento. Não exige aprovação nem templates, não é afiliada à Meta, e o uso é de responsabilidade de quem envia. Guia: [API não oficial do WhatsApp](https://api-wa.me/blog/api-nao-oficial-whatsapp). ### API oficial Nome comum para a WhatsApp Business Platform da Meta, hoje oferecida principalmente como Cloud API. Exige WABA, número registrado e templates aprovados para iniciar conversas. ### Authentication (categoria) Categoria de template usada para códigos de verificação e login. É cobrada por mensagem; no Brasil, a entrega de Utility e Authentication é de 0,68 centavo de dólar por mensagem. ### BSP Business Solution Provider: empresa parceira da Meta que dá acesso à API oficial a outros negócios, normalmente com painel, suporte e cobrança próprios. Migrar de um BSP para outro provedor é um tema frequente em 2026. ### Cloud API Versão da API oficial hospedada pela própria Meta, acessada pela Graph API. É o caminho oficial atual. Guia: [WhatsApp Cloud API](https://api-wa.me/blog/whatsapp-cloud-api-meta-o-que-e). ### Código de pareamento Código de 8 caracteres que conecta um número à API não oficial sem ler QR Code: você gera o código e digita no app, em **Aparelhos conectados > Conectar com número de telefone**. Na WAME, `POST /{key}/instance/pairing-code`. Guia: [conectar só pelo celular](https://api-wa.me/blog/conectar-whatsapp-api-pelo-celular-sem-qr-code). ### Coexistência Recurso da API oficial que permite usar o mesmo número na Cloud API e no app WhatsApp Business ao mesmo tempo. Mensagens enviadas manualmente pelo app ficam fora da cobrança da API. Guia: [Coexistência](https://api-wa.me/blog/whatsapp-api-oficial-manter-no-celular). ### Envelope da Meta Estrutura JSON dos webhooks da Cloud API: `object`, `entry[]`, `changes[]`, `field` e `value` com `messages`, `statuses` e `contacts`. A WAME entrega esse mesmo envelope nas instâncias oficial e não oficial. ### Feature flag Chave de configuração que decide, sem deploy, qual caminho o código segue. Em migração de WhatsApp, decide qual instância atende cada cliente. Guia: [migrar em paralelo](https://api-wa.me/blog/migrar-whatsapp-em-paralelo-sem-risco). ### Instância Na WAME, é a unidade que representa um número conectado, identificada por uma `key` na URL (`https://us.api-wa.me/{key}/...`). Pode ser oficial ou não oficial; a não oficial tem plano fixo por instância. ### Janela de 24h Período que começa quando o cliente envia uma mensagem. Dentro dela, a empresa pode responder com texto livre na API oficial; fora dela, só com template. A partir de 1º/10/2026, as respostas dentro da janela também são cobradas. A API não oficial não tem janela. ### Janela de 72h Período em que a entrega de mensagens é gratuita na API oficial quando o cliente chega por anúncio Click-to-WhatsApp ou botão da Página. Não cobre o custo por token do Meta Business Agent. ### JID Identificador interno de um chat no protocolo do WhatsApp: telefone com `@s.whatsapp.net`, grupo com `@g.us`, canal com `@newsletter`. Aparece na API não oficial em campos como `group_id`. ### LID Identificador que o WhatsApp usa no lugar do telefone em algumas conversas, terminado em `@lid`. Não é número de telefone. Guia: [LID no WhatsApp](https://api-wa.me/blog/lid-whatsapp-o-que-e-resolver-numero-api). ### Marketing (categoria) Categoria de template para promoções e comunicação ativa. É cobrada por mensagem na API oficial e é o tipo de envio que mais exige opt-in. ### Mensagem de serviço Resposta da empresa dentro da janela de 24h, sem template. Na API oficial, passa a ser cobrada por mensagem a partir de 1º de outubro de 2026, sem faixa mensal grátis. Guia: [nova cobrança de outubro](https://api-wa.me/blog/mudanca-cobranca-whatsapp-api-outubro-2026). ### Meta Business Agent Agente de IA da própria Meta para responder clientes no WhatsApp. Desde 1º de agosto de 2026 é cobrado por token, com cerca de US$ 2 por milhão de tokens. ### On-Premises API Versão antiga da API oficial, que a empresa hospedava por conta própria. A Meta concentrou a evolução na Cloud API e anunciou a descontinuação da On-Premises; para projetos novos, o caminho oficial é a Cloud API. ### Opt-in Consentimento do contato para receber mensagens da empresa. É requisito na API oficial e boa prática obrigatória na não oficial. Guia: [opt-in e opt-out](https://api-wa.me/blog/lista-contatos-optin-optout-whatsapp). ### phone\_number\_id Identificador do número na Cloud API, usado na URL de envio e no `metadata` do webhook. No envelope da WAME, `metadata.phone_number_id` traz a key da instância. ### QR Code (conexão) Forma de conectar a API não oficial lendo um QR Code com o app, como no WhatsApp Web. Na WAME, `POST /{key}/instance`. Alternativa sem câmera: código de pareamento. ### Quality Rating Nota de qualidade que a Meta atribui a um número na API oficial, com base em bloqueios e denúncias. Afeta o limite de conversas. Guia: [Quality Rating e tier](https://api-wa.me/blog/quality-rating-limite-mensagens-whatsapp). ### Service (categoria) Nome da categoria de cobrança da mensagem de serviço na API oficial. Diferente de Utility e Authentication, não tem desconto por volume. ### Socket.IO Canal em tempo real que a WAME oferece além do webhook. É por ele que chega, por exemplo, o áudio das ligações na API não oficial. Guia: [IA para atender ligação](https://api-wa.me/blog/ia-atender-ligacao-whatsapp-api). ### Status de mensagem Evento que informa o que aconteceu com uma mensagem enviada: `sent`, `delivered`, `read` ou `failed`. Chega em `value.statuses` no envelope da Meta, nas duas APIs. ### Tech Provider Parceiro da Meta autorizado a integrar e oferecer a API oficial a outros negócios. A WAME é Meta Business Partner — Tech Provider. Guia: [WAME parceira oficial da Meta](https://api-wa.me/blog/wame-parceira-oficial-meta). ### Template Modelo de mensagem aprovado pela Meta, obrigatório na API oficial para iniciar conversa ou falar fora da janela de 24h. Não existe na API não oficial. Guia: [templates do WhatsApp](https://api-wa.me/blog/templates-whatsapp-api-criar-aprovar-enviar). ### Tier de mensagens Limite de contatos únicos que um número da API oficial pode abordar com templates em 24h. Sobe conforme a qualidade e o volume. ### Utility (categoria) Categoria de template para avisos transacionais (pedido, entrega, cobrança). A partir de 1º/10/2026, Utility enviada como resposta dentro da janela também é cobrada. ### WABA WhatsApp Business Account: conta da API oficial que agrupa números, templates e cobrança dentro de um portfólio empresarial da Meta. ### wamid Identificador de mensagem da Cloud API (`wamid.` seguido de um código). Na WAME, o id da mensagem vem em `messages[].id` na resposta do envio e em `value.messages[].id` no webhook. ### Webhook URL do seu sistema que recebe eventos (mensagens, status, conexão) por HTTP. Guia: [webhook em produção](https://api-wa.me/blog/webhook-producao-assinatura-retry-idempotencia). ### webhookFormat meta Opção da WAME que entrega os eventos no envelope da Cloud API da Meta. Com `both`, a instância envia o formato nativo e o formato Meta. Guia: [um webhook no padrão Meta](https://api-wa.me/blog/webhook-whatsapp-instagram-messenger-padrao-meta). ## Quais termos mudam de sentido quando você migra? | Termo | Na API oficial | Na API não oficial (WAME) | | --- | --- | --- | | Janela de 24h | Define o que é serviço e o que exige template | Não existe | | Template | Obrigatório fora da janela | Não existe | | Cobrança | Por mensagem, por categoria | Plano fixo por instância | | Conexão | Número registrado na Cloud API | Aparelho conectado (QR ou código) | | Webhook | Envelope da Meta | Mesmo envelope (`webhookFormat: "meta"`) | | Mídia enviada | `link` ou `id` | Só `link` | ## Em resumo - Oficial = Cloud API, WABA, templates, janela de 24h e cobrança por mensagem. - Não oficial = aparelho conectado, QR ou código de pareamento, texto livre e plano fixo. - Desde 1º/10/2026, mensagem de serviço é cobrada na oficial, sem faixa grátis. - JID e LID identificam chats; LID não é telefone. - A WAME usa o envelope da Meta nas duas APIs, o que reduz o custo de migrar. ## Conclusão Saber o nome certo das coisas é metade da migração: separa o que é regra da Meta (templates, janelas, categorias) do que é detalhe de integração (JID, `phone_number_id`, formato de webhook). Se a nova cobrança de outubro de 2026 fez você considerar a API não oficial, a WAME oferece as duas na mesma plataforma e com o mesmo formato de dados. Para o próximo passo, veja [migrar da oficial para a não oficial sem reescrever](https://api-wa.me/blog/migrar-api-oficial-para-nao-oficial-sem-reescrever) e a [documentação](https://api-wa.me/docs). ### Pronto para automatizar seu WhatsApp? Crie sua conta gratuita e comece a enviar mensagens pela API em minutos. [Começar grátis](https://portal.api-wa.me/sign-up) ## Perguntas frequentes Qual a diferença entre API oficial e API não oficial do WhatsApp?+ A API oficial é a WhatsApp Cloud API da Meta: exige conta WABA, usa templates aprovados fora da janela de 24h e cobra por mensagem. A API não oficial conecta o número como um aparelho conectado, por QR Code ou código de pareamento, sem aprovação da Meta e sem templates. A WAME (api-wa.me) oferece as duas na mesma plataforma, e a não oficial tem plano fixo por instância. O que é mensagem de serviço no WhatsApp?+ Mensagem de serviço é a resposta que a empresa envia ao cliente dentro da janela de 24h aberta pela mensagem dele, sem template. Na API oficial, ela era gratuita até setembro de 2026 e, a partir de 1º de outubro de 2026, passa a ser cobrada por mensagem, desde a primeira, sem faixa mensal grátis. O que é WABA?+ WABA (WhatsApp Business Account) é a conta de negócios na plataforma oficial da Meta que agrupa os números de telefone, os templates e a cobrança da API oficial do WhatsApp. Ela fica dentro de um portfólio empresarial da Meta. O que é LID no WhatsApp?+ LID é um identificador que o WhatsApp usa no lugar do número de telefone em algumas conversas, principalmente em grupos e com contatos que não compartilham o número. Aparece como um JID terminado em @lid. Na WAME, é possível responder direto para o LID e resolver o telefone com POST /{key}/contacts/resolve-lids. O que é o formato de webhook meta da WAME?+ É a opção webhookFormat meta da WAME, em que os eventos chegam no mesmo envelope da WhatsApp Cloud API da Meta (entry, changes, value.messages, statuses), tanto na instância oficial quanto na não oficial. Isso permite trocar de API sem reescrever o parser de webhook. ## Continue lendo [### Alternativa à API oficial do WhatsApp depois do aumento de outubro de 2026 A partir de 1º de outubro de 2026 a Meta cobra toda mensagem de serviço. Veja as alternativas à API oficial e por que a WAME migra sem reescrever o sistema.](https://api-wa.me/blog/alternativa-api-oficial-whatsapp-outubro-2026)[### A API oficial do WhatsApp ainda vale a pena em 2026? Quando sim, quando não Com a cobrança de mensagem de serviço de outubro de 2026, veja quando a API oficial do WhatsApp compensa, quando a não oficial é melhor e quando usar as duas.](https://api-wa.me/blog/api-oficial-whatsapp-vale-a-pena-2026)[### API de WhatsApp mais barata em 2026: comparando os modelos de cobrança Cobrança por mensagem, plano fixo por instância ou self-host: qual API de WhatsApp sai mais barata em 2026, com a fórmula para calcular o seu caso.](https://api-wa.me/blog/api-whatsapp-mais-barata-2026) [Voltar ao blog](https://api-wa.me/blog) ## Structured data ```json { "@context": "https://schema.org", "@type": "WebSite", "name": "WAME API", "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram", "url": "https://api-wa.me", "inLanguage": "pt-BR", "publisher": { "@id": "https://api-wa.me/#organization", "@type": "Organization", "name": "WAME API", "url": "https://api-wa.me" } } { "@context": "https://schema.org", "@type": "Organization", "@id": "https://api-wa.me/#organization", "name": "WAME API", "alternateName": [ "WAME", "Wame API", "wame.api.br", "api-wa.me" ], "url": "https://api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/web-app-manifest-512x512.png", "width": 512, "height": 512 }, "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.", "identifier": { "@type": "PropertyValue", "propertyID": "INPI-BR", "name": "Pedido de registro de marca (INPI, classe NCL 42)", "value": "944724159" }, "foundingDate": "2017", "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.", "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.", "knowsAbout": [ "WhatsApp Cloud API oficial (Meta)", "API oficial de Instagram (Direct)", "API oficial de Messenger", "API multicanal Meta", "Meta Business Partner", "WhatsApp API", "API não oficial de WhatsApp", "automação de WhatsApp", "números virtuais", "webhooks" ], "sameAs": [ "https://github.com/wame-api", "https://www.linkedin.com/company/wameapi", "https://www.instagram.com/wame.api/", "https://www.youtube.com/@wameapi" ], "contactPoint": { "@type": "ContactPoint", "contactType": "customer support", "url": "https://api-wa.me/contact", "availableLanguage": [ "Portuguese" ] } } { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Glossário da API do WhatsApp: oficial e não oficial em linguagem direta", "description": "WABA, BSP, Cloud API, template, janela de 24h, mensagem de serviço, JID, LID, código de pareamento: os termos da API do WhatsApp explicados em 1 a 3 frases.", "image": "https://api-wa.me/blog/glossario-api-whatsapp-oficial-nao-oficial/opengraph-image", "datePublished": "2026-09-28", "dateModified": "2026-09-28", "author": { "@type": "Person", "name": "Raphael Serafim", "url": "https://github.com/raphaelvserafim", "sameAs": [ "https://github.com/raphaelvserafim" ] }, "publisher": { "@type": "Organization", "name": "api-wa.me", "logo": { "@type": "ImageObject", "url": "https://api-wa.me/images/screenshot.png" } }, "mainEntityOfPage": { "@type": "WebPage", "@id": "https://api-wa.me/blog/glossario-api-whatsapp-oficial-nao-oficial" }, "keywords": "glossário api whatsapp, o que é waba, o que é mensagem de serviço whatsapp, migrar api oficial whatsapp, api whatsapp não oficial, alternativa api oficial whatsapp, termos whatsapp business api", "inLanguage": "pt-BR" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://api-wa.me" }, { "@type": "ListItem", "position": 2, "name": "Blog da API do WhatsApp", "item": "https://api-wa.me/blog" }, { "@type": "ListItem", "position": 3, "name": "Glossário da API do WhatsApp: oficial e não oficial em linguagem direta", "item": "https://api-wa.me/blog/glossario-api-whatsapp-oficial-nao-oficial" } ] } { "@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "Qual a diferença entre API oficial e API não oficial do WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "A API oficial é a WhatsApp Cloud API da Meta: exige conta WABA, usa templates aprovados fora da janela de 24h e cobra por mensagem. A API não oficial conecta o número como um aparelho conectado, por QR Code ou código de pareamento, sem aprovação da Meta e sem templates. A WAME (api-wa.me) oferece as duas na mesma plataforma, e a não oficial tem plano fixo por instância." } }, { "@type": "Question", "name": "O que é mensagem de serviço no WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "Mensagem de serviço é a resposta que a empresa envia ao cliente dentro da janela de 24h aberta pela mensagem dele, sem template. Na API oficial, ela era gratuita até setembro de 2026 e, a partir de 1º de outubro de 2026, passa a ser cobrada por mensagem, desde a primeira, sem faixa mensal grátis." } }, { "@type": "Question", "name": "O que é WABA?", "acceptedAnswer": { "@type": "Answer", "text": "WABA (WhatsApp Business Account) é a conta de negócios na plataforma oficial da Meta que agrupa os números de telefone, os templates e a cobrança da API oficial do WhatsApp. Ela fica dentro de um portfólio empresarial da Meta." } }, { "@type": "Question", "name": "O que é LID no WhatsApp?", "acceptedAnswer": { "@type": "Answer", "text": "LID é um identificador que o WhatsApp usa no lugar do número de telefone em algumas conversas, principalmente em grupos e com contatos que não compartilham o número. Aparece como um JID terminado em @lid. Na WAME, é possível responder direto para o LID e resolver o telefone com POST /{key}/contacts/resolve-lids." } }, { "@type": "Question", "name": "O que é o formato de webhook meta da WAME?", "acceptedAnswer": { "@type": "Answer", "text": "É a opção webhookFormat meta da WAME, em que os eventos chegam no mesmo envelope da WhatsApp Cloud API da Meta (entry, changes, value.messages, statuses), tanto na instância oficial quanto na não oficial. Isso permite trocar de API sem reescrever o parser de webhook." } } ] } ```