Equipe Periskope
Este ano, a Meta abriu a API de grupos do WhatsApp para todas as Contas Comerciais Oficiais (OBA). Foi essa mudança que deixou tanta empresa confusa sobre o que uma API de grupos do WhatsApp faz e o que ela não faz.
Até então, "grupo de WhatsApp" era uma coisa só: o recurso de conversa em grupo do próprio app. Agora existem dois sistemas com o mesmo nome, feitos para funções diferentes e com regras muito diferentes.
Se você quer saber se a API de grupos pode substituir os grupos que você já tem com a equipe, os clientes ou a sua comunidade, a resposta curta é: provavelmente não, e nem é essa a proposta.
A seguir, mostramos exatamente onde os dois se cruzam e onde não. E qual é o melhor jeito de gerenciar os grupos do WhatsApp que você já tem com o Periskope.
Resumo rápido: grupos comuns do WhatsApp vs API de grupos
O que são os grupos comuns do WhatsApp?
Os grupos comuns do WhatsApp são as conversas em grupo padrão, criadas e gerenciadas direto no app. Servem para várias pessoas conversarem no mesmo lugar, com admins cuidando dos membros, das permissões e das configurações do grupo.
O admin pode adicionar ou remover membros, compartilhar o link de convite, aprovar quem quer entrar e definir quem pode enviar mensagens ou editar os dados do grupo.
Os grupos comuns também têm todos os recursos nativos do WhatsApp, como envio de mídia, mensagens temporárias e chamadas em grupo.
Nas empresas, eles costumam ser usados para comunidades de clientes, grupos de vendas e de revendedores, equipes internas, coordenação de projetos e outras conversas contínuas com várias pessoas.
Try Periskope
Gerencie grupos, conversas e números do WhatsApp em escala
O que é a API de grupos do WhatsApp?
A API de grupos do WhatsApp é um conjunto de endpoints que a Meta adicionou à Cloud API da WhatsApp Business Platform. Com ela, um número comercial cria e gerencia grupos via código, sem passar pelo app.
Segundo a Meta, a API de grupos "agora está aberta a todas as empresas com uma Conta Comercial Oficial (OBA)" e permite que a empresa "crie grupos via programação para mensagens e colaboração".
Para se qualificar, o número comercial precisa ter:
Pelo menos 30 dias na WhatsApp Business Platform
A verificação da empresa no Meta concluída
A confirmação em duas etapas ativada
Um nome de exibição aprovado
Reconhecimento como marca relevante e conhecida
A maioria das pequenas empresas não passa nesse último ponto sem uma análise.
Os grupos criados pela API funcionam só por convite. A empresa gera um link de convite, envia para a pessoa e ela decide se quer entrar.
Quando alguém entra, um webhook é disparado e a empresa já pode mandar mensagens no grupo usando o mesmo endpoint POST /messages que usa nas conversas individuais, só que com recipient_type definido como group.
Grupos do WhatsApp vs API de grupos: comparação completa
A diferença começa na forma como o grupo é criado e gerenciado.
Recurso | Grupos comuns do WhatsApp | API de grupos do WhatsApp |
Criação do grupo | Criado direto no app do WhatsApp | Criado via código pela WhatsApp Business Platform; exige Conta Comercial Oficial |
Grupos que já existem | Funcionam normalmente | Não foi feita para importar nem converter grupos do WhatsApp que já existem |
Máximo de participantes | Até 1.024 | Até 8 |
Como adicionar participantes | O admin adiciona direto ou compartilha um convite | Só por link de convite, sem endpoint de adição direta |
Gestão do grupo | Feita dentro do app do WhatsApp | Feita por chamadas de API e sistemas da empresa conectados |
Automação | Manual, sem automação nativa | Feita para fluxos via código, com API e webhooks |
Recursos disponíveis | Todos: chamadas, mensagens interativas, mensagens temporárias, mídia de visualização única, mensagens de comércio | Sem suporte: chamadas, mensagens interativas, mensagens temporárias, mídia de visualização única, mensagens de comércio |
Integrações | Não fazem parte do grupo | Conecta a softwares da empresa (CRM, tickets etc.) pela API |
Eventos do grupo | Acompanhados na mão dentro do WhatsApp | Disponíveis por eventos de API e webhook (entrada, saída, criação) |
Preço | Grátis | Por mensagem, igual à Cloud API |
Mais indicado para | Comunidades que já existem, equipes e conversas em grupos maiores | Fluxos empresariais pequenos, controlados e verificados |
1. Criação do grupo
Qualquer pessoa com WhatsApp cria um grupo comum em segundos. A API de grupos só funciona para números que já têm status de OBA, ou seja, a empresa precisa passar pela verificação e pela análise de relevância da Meta antes de criar um único grupo.
Exemplo: uma rede de varejo que já faz disparos com OBA aprovada consegue criar um grupo pela API na hora, mas o número de uma franquia da mesma marca que não passou pela própria aprovação de OBA não consegue.
2. Participantes e entrada no grupo
Em um grupo comum, o admin adiciona um contato direto e a entrada vale na hora, a não ser que as configurações de privacidade do contato impeçam. A API de grupos não tem nada parecido.
Não existe endpoint para adicionar participantes, então o único jeito de trazer alguém é gerar um link de convite e esperar a pessoa aceitar.
A empresa pode convidar, mas não pode adicionar ninguém por conta própria. O controle de admin segue a mesma lógica. Nos grupos comuns, o admin silencia, remove ou renomeia à vontade, enquanto a API limita até ações básicas, como ocultar a lista de participantes.
3. Tamanho do grupo
Aqui está a diferença mais clara entre os dois. Os grupos comuns vão até 1.024 membros; a API de grupos, até 8.
Essa distância descarta a maioria dos usos que as pessoas imaginam para a API. Ela não foi feita para tocar uma comunidade de clientes ou um canal da equipe; serve para algo mais próximo de uma sala de negociação com meia dúzia de envolvidos.
4. Automações e integrações
Os grupos comuns não têm automação nenhuma. Toda ação, de adicionar um membro a postar um aviso, é um toque manual no app.
A API de grupos muda isso. Ela oferece webhooks de ciclo de vida para a criação do grupo e para a entrada ou saída de participantes, e permite que a empresa mande mensagens no grupo pelo mesmo endpoint POST /messages que já usa nas conversas individuais da Cloud API.
Se o fluxo precisa que um sistema, e não uma pessoa, atualize o grupo automaticamente, a API é a única opção entre as duas.
5. Recursos de mensagem
Os grupos comuns do WhatsApp têm todos os recursos nativos de mensagem, como chamadas, mensagens temporárias, mídia de visualização única, comércio e edição ou exclusão de mensagens enviadas.
A API de grupos permite mensagens de texto e mídia, mas vários recursos nativos ficam de fora: chamadas, mensagens temporárias, mídia de visualização única, mensagens interativas e comércio.
As mensagens enviadas pela API também não podem ser editadas nem apagadas.
6. Preço
Os grupos comuns do WhatsApp são grátis. Não há taxa para criar um grupo nem para conversar nele.
As mensagens pela API de grupos seguem os preços da WhatsApp Business Platform. Dependendo da categoria da mensagem e das regras de preço atuais da Meta, a empresa pode ser cobrada pelas mensagens entregues aos participantes do grupo. A partir de 1º de outubro de 2026, até as mensagens de atendimento passam a ser cobradas quando o número comercial ultrapassa as 1.000 gratuitas do mês.
Por isso, o custo precisa entrar na conta à parte quando você planeja um fluxo de grupos pela API.
Quais são as limitações da API de grupos do WhatsApp?
A API de grupos é útil para um tipo específico de fluxo empresarial, mas tem várias restrições que você precisa conferir antes de desenvolver em cima dela.
1. O limite de 8 participantes
Cada grupo da API de grupos aceita no máximo 8 participantes, contando o número da empresa.
Só para comparar, os grupos comuns do WhatsApp vão até 1.024 membros.
Por isso, a API de grupos não serve para grandes comunidades, turmas de clientes, redes de revendedores ou qualquer caso em que dezenas ou centenas de pessoas precisam estar no mesmo grupo.
2. Sem adição direta, só link de convite
A API de grupos da Meta não tem endpoint para adicionar um participante diretamente.
O único caminho é o link de convite
Quem recebe precisa aceitar por vontade própria
Não há como forçar nem automatizar a entrada
Se o seu fluxo depende de colocar o cliente no grupo automaticamente, leve essa limitação em conta.
3. Exigência de Conta Comercial Oficial
Hoje a API de grupos é restrita a empresas com Conta Comercial Oficial (OBA). Ter uma conta do WhatsApp Business ou usar a WhatsApp Business Platform não significa que a empresa pode usar a API de grupos.
Esse requisito pode descartar a API antes mesmo de começar qualquer integração técnica.
4. Vários recursos do WhatsApp não estão disponíveis
Os grupos da API não têm todos os recursos dos grupos comuns do WhatsApp. Ficam de fora:
Chamadas
Mensagens temporárias
Mídia de visualização única
Templates de autenticação
Mensagens de comércio
Mensagens interativas
Ocultar a lista de participantes
Editar uma mensagem enviada
Apagar uma mensagem enviada
Marcar uma mensagem como lida
Os relatórios de desempenho de templates também são mais limitados nas mensagens em grupo do que nas conversas individuais.
Essas restrições pesam porque a empresa pode já usar, nos grupos comuns, recursos que deixam de existir quando o fluxo passa para a API de grupos.
5. Grupos que já existem não podem simplesmente ir para a API
Vale repetir, porque essa é uma das maiores fontes de confusão.
A API de grupos não é uma ferramenta de migração para grupos comuns do WhatsApp. Ela traz um modelo de grupo separado, baseado em API.
Então, se a sua empresa já tem grupos ativos no WhatsApp, a API de grupos não oferece um jeito direto de importar esses grupos e continuar gerenciando tudo pela Cloud API.
Essa diferença é decisiva na hora de escolher entre as duas abordagens.
Quando usar cada um?
✅ Escolha os grupos comuns do WhatsApp quando:
O grupo tem tamanho de comunidade ou mais de 8 pessoas
Você precisa de controle total de admin (silenciar, remover, ocultar a lista de participantes)
Os membros devem ser adicionados direto, e não entrar por um link
Exemplos: o grupo interno da equipe de vendas, uma comunidade de clientes, um grupo de ex-alunos
✅ Escolha a API de grupos do WhatsApp quando:
O grupo precisa ficar com 8 pessoas ou menos
Quem posta as atualizações é um sistema, não uma pessoa
A entrada é verificada e por convite, por definição
Exemplos: uma sala de negociação com meia dúzia de envolvidos, um fluxo de escalonamento de suporte, um grupo de status disparado por webhook para uma única transação
✅ Onde os dois deixam a desejar:
Uma empresa que precisa de mais de 8 pessoas em um grupo automatizado, sem desenvolver e manter a própria integração dependente de OBA, não tem uma boa opção em nenhum dos dois.
É para isso que o Periskope existe: gerenciar grupos do WhatsApp e conversas a partir do número da própria empresa, com automação, sem o limite de 8 pessoas e sem o trabalho manual de admin que os dois sistemas exigem.
Como o Periskope ajuda você a gerenciar grupos do WhatsApp além dos limites da API
O Periskope se conecta ao número de WhatsApp da própria empresa, pessoal ou Business.
Ele dá conta de toda a operação, vendas e atendimento pelos grupos que a empresa já tem, sem bater no limite de 8 pessoas da API e sem abrir mão da automação de que uma equipe em crescimento precisa.
Até 1.024 membros por grupo. Funciona com os grupos do WhatsApp que você já tem, no tamanho completo, bem acima do limite de 8 pessoas da API.
Sem aprovação de OBA. Roda no número de WhatsApp que a empresa já tem, sem análise de relevância da Meta e sem esperar 30 dias.
Acesso da equipe sem colocar ninguém no grupo. Dê aos atendentes visibilidade e permissões no painel do Periskope para responderem ao grupo sem precisar entrar nele, sem ver todo o histórico e sem lotar o próprio celular.
Automação que vai além dos webhooks da API. Transforme mensagens importantes em tickets automaticamente, atribua cada um a um atendente, acompanhe SLAs e tempo de primeira resposta e dispare regras personalizadas com IA, tudo dentro dos grupos que você já tem.
Disparo em massa para grupos, agendado e enviado em um clique, sem cobrança por mensagem da API.
Integração direta com CRMs como HubSpot e Zoho CRM, ferramentas de tickets como Zoho Desk e Freshdesk, e Google Sheets. Para o resto, conecta por APIs, webhooks e Zapier.
Agende uma demonstração e mostramos como funciona na sua operação de WhatsApp, ou faça um teste grátis e explore a plataforma por conta própria.
Perguntas frequentes sobre grupos do WhatsApp e API de grupos
1. Qual a diferença entre grupos do WhatsApp e a API de grupos do WhatsApp?
Um grupo comum do WhatsApp é o recurso de conversa em grupo do próprio app, aberto a qualquer usuário, com limite de 1.024 membros e sem automação.
A API de grupos do WhatsApp é um conjunto de endpoints que permite a uma Conta Comercial Oficial criar e gerenciar grupos via código, com limite de 8 membros e sem como adicionar participantes diretamente.
2. Dá para adicionar participantes a um grupo do WhatsApp pela API?
Não. A API de grupos não tem endpoint para adicionar participantes. O único jeito de trazer alguém para um grupo criado pela API é enviar um link de convite e a pessoa aceitar.
3. Quantos membros cabem em um grupo da API de grupos do WhatsApp?
Até 8 participantes. É um limite fixo definido pela Meta e vale para qualquer plano ou tipo de conta.
4. A API de grupos do WhatsApp é gratuita?
Não. As mensagens da API de grupos têm cobrança por mensagem, e a Meta cobra por cada participante que recebe a mensagem. As mensagens de atendimento têm uma faixa gratuita de 1.000 por número comercial por mês (a partir de 1º de outubro de 2026), e o que passar disso é cobrado pela tarifa de utilidade do mercado.
5. Preciso de uma conta do WhatsApp Business para usar a API de grupos?
Você precisa de mais do que uma conta Business comum. A API de grupos só está disponível para números com status de Conta Comercial Oficial (OBA), que exige verificação da empresa no Meta, 30 dias na WhatsApp Business Platform, confirmação em duas etapas e reconhecimento como marca relevante.
6. Por que não consigo adicionar um membro a um grupo do WhatsApp pela API?
A Meta criou a API de grupos em torno da entrada com consentimento. Em vez de um endpoint para adicionar participantes, ela só aceita links de convite, para que cada membro escolha entrar, e não seja colocado pela empresa.
7. Qual o tamanho máximo de um grupo do WhatsApp?
Em um grupo comum do WhatsApp, 1.024 membros. Em um grupo criado pela API de grupos, 8.
8. A API de grupos do WhatsApp aceita mensagens interativas?
Não. Mensagens interativas, assim como chamadas, mensagens temporárias, mídia de visualização única e mensagens de comércio, não funcionam em grupos criados pela API de grupos.
9. A API de grupos do WhatsApp funciona com o app WhatsApp Business?
Não. A API de grupos só funciona para números na WhatsApp Business Platform (Cloud API) com status de OBA. Ela não está disponível para números que usam o app WhatsApp Business.
10. Qual o melhor jeito de gerenciar os grupos do WhatsApp que a empresa já tem?
O Periskope se conecta ao número de WhatsApp que você já usa por QR code, como o WhatsApp Web, e adiciona caixa de entrada compartilhada, tickets e automação sem exigir aprovação de OBA nem recriar grupos do zero.
11. Dá para automatizar grupos do WhatsApp sem usar a API de grupos?
Sim. Plataformas como o Periskope automatizam os fluxos dos grupos (sinalizar mensagens, atribuir tarefas, disparar atualizações em massa) em cima de um número comum do WhatsApp, sem passar pela análise de OBA da Meta e sem o limite de 8 pessoas da API de grupos.
Funciona com os grupos que você já tem, porque nada precisa ser recriado nem migrado.
