Assinar agora
Como funciona Recursos Planos Dúvidas Blog
Login

API oficial do WhatsApp para grupos: o que a Meta permite

A API de Grupos da Meta existe, mas cria grupos de até 8 pessoas, só por convite. Veja limites, custo por mensagem e por que ela não serve a grupo de ofertas.

Equipe Manda Boa · 7 min de leitura

Existe: a API de Grupos da Meta, para empresas com Conta Comercial Oficial (OBA). Ela cria grupos novos, só por convite, de até 8 participantes. Com esse teto, não serve a um grupo de ofertas grande, e a página oficial não descreve o uso com grupos existentes.

O que a API de Grupos da Meta permite

A API de Grupos permite criar grupos e conversar neles pela WhatsApp Business Platform. A documentação da Meta lista:

  • Gestão: criar e excluir grupos, tratar pedidos de entrada, obter e redefinir o link de convite, remover participantes, consultar informações e atualizar configurações.
  • Mensagens: enviar, receber, fixar e desafixar mensagens no grupo.
  • Tipos aceitos: texto, mídia e modelos de mensagem de texto e de mídia.
  • Não aceitos: ligações, mensagens temporárias, visualização única, autenticação, mensagens de comércio e mensagens interativas. Também não dá para editar nem apagar mensagens enviadas.

Limites da API de Grupos, em tabela

ItemO que a documentação diz
Quem pode usarEmpresas com Conta Comercial Oficial (OBA)
Participantes por grupoNo máximo 8
Grupos por númeroAté 10.000 por número comercial
Como as pessoas entramSó por link de convite que a empresa envia
Número do app WhatsApp BusinessNão está disponível
Empresas por grupo1 empresa com Cloud API
LigaçõesNão são suportadas em grupos

Quanto custa a API de Grupos

O custo é por mensagem entregue a cada pessoa do grupo. A página de preços da Meta diz que a cobrança acontece cada vez que uma mensagem cobrável é entregue a alguém do grupo. O exemplo dela: um modelo de marketing entregue a um grupo de 5 pessoas sai como 5 mensagens ao preço de marketing de cada país de destino.

Alguns pontos do que a página diz:

  • A Groups API usa o mesmo modelo de cobrança por mensagem da Cloud API, que vale desde 1º de julho de 2025 e varia por categoria do modelo e pelo país de quem recebe.
  • Quando alguém do grupo escreve para a empresa, abre-se uma janela de atendimento para o grupo todo. Dentro dela, a página diz que dá para enviar modelos de utilidade e de marketing, ou texto livre, sem custo.
  • Valores em reais: a página do grupo não traz valores, e a tabela geral da Meta os publica em arquivo para baixar. Consulte lá antes de fazer qualquer conta.

Por que ela não serve ao grupo de ofertas que você já tem

Por seis motivos, que valem juntos:

  1. Teto de 8 participantes. Um grupo comum do WhatsApp comporta até 1.024 membros, segundo a Central de Ajuda. Um grupo de ofertas de 300 pessoas não cabe.
  2. Grupos nascem pela API. A documentação descreve criar grupos novos e convidar pelo link. Não descreve ligar um grupo que você já tem.
  3. Entrada só por convite, com o link que a empresa envia.
  4. Exige conta comercial oficial (OBA). Não vale para quem usa o app WhatsApp Business.
  5. Cobrança por pessoa que recebe. Mesmo que houvesse espaço, cada participante a mais seria mais uma mensagem cobrada.
  6. Consentimento. A Política de Mensagens para empresas só permite contatar quem forneceu o número e deu permissão para receber mensagens.

A API de Grupos é pensada para mensagens e colaboração em grupos pequenos, por exemplo, de uma equipe ou de um atendimento. É outro uso.

E canais, comunidades e o app Business?

Canal e comunidade são formatos do app, e o canal não tem limite de seguidores. Na documentação da Meta para desenvolvedores não encontramos API oficial para publicar em canais; confira antes de planejar algo em cima disso. A comunidade, segundo a Central de Ajuda, não pode ser criada no WhatsApp Business. A comparação completa está em canal do WhatsApp ou grupo para promoções.

O que isso significa para quem quer automatizar

Pelo que a documentação da Meta descreve, o caminho oficial do WhatsApp não atende a um grupo de ofertas com muita gente. O que sobra são três opções:

CaminhoÉ oficial?LimiteServe para grupo de ofertas?
API de Grupos da MetaSim8 participantes, OBA, só por conviteNão
Bot API do TelegramSimCanais com assinantes ilimitados, bot como administradorSim, no Telegram
Conexão não oficial com o WhatsApp (como o WhatsApp Web)NãoOs Termos proíbem mensagens automáticas; risco de banimentoÉ o que as ferramentas de automação de grupos de ofertas costumam usar

O Manda Boa, por exemplo, faz parte do terceiro caminho: não usa a API oficial, a conexão é do tipo WhatsApp Web e os Termos dele dizem que o número pode ser banido. Isso vale para qualquer ferramenta desse tipo. Ritmo calmo, número só para divulgação e envio só onde você é administrador reduzem o risco, sem zerá-lo.

O ponto prático: a decisão não é "oficial ou não", e sim quanto risco você aceita para ter o grupo no automático e qual é o seu plano B. Veja o guia de bot de promoções para WhatsApp, o de número banido e o comparativo de ferramentas para automatizar grupos de promoções. Para quem quer partir do zero, leia como automatizar um grupo de ofertas.

Perguntas frequentes

Existe API oficial do WhatsApp para grupos?

Existe. É a API de Grupos da WhatsApp Business Platform, aberta a empresas com Conta Comercial Oficial (OBA). Ela cria grupos novos, só por convite.

Quantas pessoas cabem num grupo criado pela API?

No máximo 8 participantes por grupo. Cada número comercial pode ter até 10.000 grupos.

A API de Grupos serve para grupo de promoções ou de ofertas?

Não para grupos grandes. O teto de 8 participantes e a entrada só por convite não combinam com um grupo aberto de centenas de pessoas, e a documentação não descreve o uso com grupos que já existem.

O WhatsApp Business (app) tem API de grupos?

Não. A documentação diz que os grupos da API não estão disponíveis para números do app WhatsApp Business. É preciso uma conta da plataforma, com OBA.

A API de Grupos é grátis?

Não, em geral. A cobrança é por mensagem entregue a cada pessoa do grupo, com exceções dentro da janela de atendimento. Os valores estão na tabela de preços da Meta.

Dá para publicar no canal do WhatsApp por API?

Não encontramos, na documentação oficial da Meta, uma API para publicar em canais. No Telegram, a Bot API oficial permite publicar em canais.

Fontes

Leia a seguir