InícioBlogAPI Oficial

API Oficial

A API Oficial faz grupo, sim — de oito pessoas, e você não adiciona ninguém

Metade do mercado jura que a API Oficial não suporta grupo. A outra metade vende disparo em grupo. A documentação da Meta desmente as duas: existe Groups API, e os limites dela mudam o que faz sentido fazer.

Existem duas afirmações opostas circulando sobre grupos no WhatsApp comercial, e as duas estão erradas.

A primeira: “a API Oficial não suporta grupos”. Era verdade, deixou de ser. A Meta documenta uma Groups API.

A segunda: “agora dá para disparar em grupos pela API”. Também não. O limite documentado é de oito participantes por grupo — e não existe forma de adicionar alguém.

Entre as duas, tem um recurso real e útil, para um uso específico que quase ninguém está discutindo. Vale conhecer os números antes de decidir qualquer coisa.

Ficha técnica dos grupos na API Oficial: oito participantes por grupo, dez mil grupos por número, uma empresa por grupo, exigência de Conta Comercial Oficial, entrada apenas por link de convite, e a lista do que dá e do que não dá para enviar
Oito participantes e nenhum endpoint para adicionar: isso não é canal de disparo

A ficha técnica, direto da documentação

Quem pode usar. A Groups API está aberta às empresas que tenham uma Conta Comercial Oficial (OBA) — aquela do selo. Não funciona no aplicativo do WhatsApp Business. Se você não sabe a diferença entre o selo e a verificação de negócio, os dois são coisas distintas e explicamos em os dois selos do WhatsApp.

Esse já é um filtro grande: a maior parte das empresas que sonha com grupos não tem OBA.

Quantas pessoas. “Max group participants: 8”. Oito.

Quantos grupos. Até 10.000 por número comercial.

Quantas empresas no mesmo grupo. “Max Cloud API businesses per group: 1”. Uma. Duas empresas não operam no mesmo grupo pela API.

Como alguém entra. Esta é a frase que decide o uso:

“Groups are an invite-only experience where participants join using a group invite link”

Apenas por convite. Você não adiciona ninguém — a pessoa entra pelo link. As operações documentadas são criar e apagar grupo, habilitar solicitações de entrada, obter e redefinir o link de convite, enviar o link por template, remover participantes, consultar informações do grupo, listar grupos ativos e atualizar configurações.

Repare no conjunto: dá para tirar gente, dá para convidar, não dá para colocar.

O que dá para enviar. Texto, mídia, templates de texto e templates com mídia.

O que não dá. Mensagens interativas (os botões e listas), mensagens de comércio (catálogo e carrinho), templates de autenticação, chamadas, mensagens temporárias e visualização única.

Quanto custa. A Groups API usa cobrança por mensagem, igual ao resto da plataforma. Não existe desconto por ser grupo.

Por que isso não é o canal de disparo que estão vendendo

Junte os números e o desenho fica claro.

Para alcançar 800 pessoas em grupos, você precisaria de 100 grupos, cada um montado com pessoas que aceitaram um convite. Cada mensagem enviada continua sendo cobrada por destinatário. Não há ganho de custo, não há ganho de alcance, e há um custo operacional novo — gerenciar cem grupos.

Comparado com o que já existe: um template de marketing enviado para uma base com opt-in atinge as mesmas 800 pessoas com um disparo, com relatório por destinatário e sem ninguém precisar aceitar convite nenhum.

Ou seja, quem quer volume continua no caminho de sempre, com as regras de sempre — que estão em disparo em massa no WhatsApp é permitido? e campanhas no WhatsApp.

E vale o alerta que interessa a quem já usa grupos hoje de forma não oficial: grupo de divulgação montado por ferramenta não autorizada não virou legal porque a Meta lançou uma Groups API. Continua sendo o que era, com o risco que já tratamos em banimento por API não oficial.

Para que serve, então

Oito pessoas, entrada por convite, uma empresa por grupo. Isso não descreve um canal de mídia. Descreve um caso atendido por várias pessoas ao mesmo tempo.

E aí faz muito sentido:

Obra, projeto ou instalação. Cliente, engenheiro, arquiteto e o responsável da empresa no mesmo grupo, com histórico ficando na conta da empresa em vez de no celular de alguém.

Contrato com mais de um decisor. Duas ou três pessoas do lado do cliente acompanhando a mesma negociação, sem ninguém precisar repassar informação.

Família em torno de um paciente ou de um aluno. Um caso, várias pessoas responsáveis, uma conversa só — em vez de a recepção repetir a mesma coisa três vezes.

Suporte a uma conta corporativa. O time do cliente e o seu, tratando de um chamado específico.

Corretagem e locação. Comprador, vendedor e corretor num grupo por negócio — cada negócio com o seu, e a empresa dona do histórico de todos.

Repare no padrão: em todos os casos o grupo é pequeno por natureza, existe por causa de um caso e morre quando o caso termina. Oito participantes deixa de ser limitação e passa a ser o tamanho certo.

O que muda na sua operação

Três coisas práticas antes de sair criando grupo:

1. Sem botão e sem lista. Se o seu fluxo depende de menu com botões, ele não roda em grupo. Em grupo é texto e template — o que, aliás, é mais adequado a uma conversa com várias pessoas falando.

2. Sem catálogo e sem carrinho. Grupo não é canal de venda com vitrine. Venda estruturada continua na conversa individual.

3. A conta continua sendo por mensagem. Um grupo de oito com uma conversa animada gera muita mensagem cobrada — e, a partir de 1º de outubro de 2026, mensagens de serviço deixam de ser gratuitas, o que faz grupo movimentado virar linha de custo. O contexto está em a Meta vai cobrar mensagens de serviço.

Como decidir se vale para você

Uma pergunta resolve: as pessoas que você quer no grupo têm motivo para estarem juntas?

Se a resposta for “elas compraram o mesmo produto” ou “estão na mesma lista”, não é grupo — é campanha, e o caminho é template com opt-in.

Se for “elas estão resolvendo a mesma coisa”, é grupo, e a Groups API foi feita exatamente para isso.

Onde a gente entra

O AtendeChat é parceiro oficial da Meta e trabalha na API Oficial, que é onde esses recursos existem — e onde eles chegam sem você precisar acompanhar changelog de documentação.

O que a gente entrega em volta: vários atendentes no mesmo número, fila de distribuição, histórico centralizado na empresa, funil em kanban, relatórios e integração com os seus sistemas. É a diferença entre uma conversa que pertence à empresa e uma conversa que pertence ao aparelho de quem atendeu — e, num grupo com o cliente e mais três pessoas do lado dele, essa diferença fica bem visível no dia em que alguém sai da equipe.

Se hoje a sua operação vive de grupos montados na mão, fale com a gente. Dá para separar o que é caso — e deve virar grupo oficial — do que é campanha, que deve virar template com opt-in e relatório.

Fontes

  1. Meta — Groups API: exigência de Official Business Account, limite de 8 participantes, 10.000 grupos por número, 1 empresa por grupo e cobrança por mensagem
  2. Meta — Group messaging: tipos de mensagem suportados e não suportados em grupos
  3. Meta — Pricing on the WhatsApp Business Platform: modelo de cobrança por mensagem

Rode seu WhatsApp na API Oficial da Meta

O AtendeChat é parceiro oficial da Meta: multiatendimento, Kanban, campanhas e IA — dentro das regras.

Leia também