---
title: "Grupos pela API não oficial do WhatsApp: o que o motor da WAME faz por você"
description: "Criar grupo, adicionar e promover participantes, aprovar pedidos de entrada, convite e comunidade pela API não oficial da WAME, e como o motor mantém tudo sincronizado."
url: "https://wame.api.br/blog/grupos-api-nao-oficial-por-dentro-do-motor"
language: "pt-BR"
og:type: "article"
published_time: "2026-11-07"
modified_time: "2026-11-07"
author: "Raphael Serafim"
keywords: "motor wame, api não oficial whatsapp segura, grupo whatsapp api, gerenciar grupos whatsapp api, automatizar grupos whatsapp"
reading_time: "7 min de leitura"
---

# Grupos pela API não oficial do WhatsApp: o que o motor da WAME faz por você

> Criar grupo, adicionar e promover participantes, aprovar pedidos de entrada, convite e comunidade pela API não oficial da WAME, e como o motor mantém tudo sincronizado.

Gerenciar grupo é um dos usos mais comuns da API não oficial, e um dos mais tranquilos: boas-vindas, regras, moderação, avisos e entrada aprovada. Este artigo mostra os endpoints e o que o motor da WAME faz por trás. O resumo do produto está na página da [API não oficial da WAME](/nao-oficial).

## O que o motor mantém sincronizado

Um grupo no WhatsApp tem estado: nome, foto, descrição, quem participa, quem é admin, quem pediu para entrar. O motor acompanha esse estado com o WhatsApp e avisa seu sistema quando muda. Você não precisa ficar consultando: entradas, saídas e promoções chegam pelo webhook.

Todos os exemplos usam a base `https://server.wame.api.br/SUA_KEY/`. A key na URL autentica a instância.

## Criar o grupo

```bash
curl -X POST "https://server.wame.api.br/SUA_KEY/groups" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Turma de Novembro", "participants": ["5566997145103"] }'
```

A resposta traz o ID do grupo, no formato `ID@g.us`, que você usa em todas as chamadas seguintes e também como `to` para enviar mensagem no grupo.

## Participantes e admins

Adicionar participantes (para remover, o mesmo endpoint com `DELETE`):

```bash
curl -X POST "https://server.wame.api.br/SUA_KEY/groups/ID_DO_GRUPO/participants" \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5566997145103"] }'
```

Promover a admin ou rebaixar é o endpoint `/groups/ID_DO_GRUPO/role`. Foto do grupo, em `/groups/ID_DO_GRUPO/picture`.

## Entrada com aprovação e convite

Grupo aberto por link enche de gente que ninguém conhece. O melhor é ligar a aprovação de entrada e deixar o seu sistema decidir:

- `/groups/ID_DO_GRUPO/request_participants_list` lista quem pediu para entrar (`GET`) e aprova ou recusa (`PUT`);
- `/groups/ID_DO_GRUPO/invite` devolve o link de convite do grupo.

É assim que funcionam os grupos VIP pagos: o pagamento confirma, o sistema aprova a entrada. Veja [grupo VIP pago com entrada e saída automáticas](/blog/grupo-vip-pago-whatsapp-automatizar-api).

## Comunidades

Uma comunidade junta vários grupos sob um aviso comum. Pela API dá para criar a comunidade e ligar grupos a ela em `/community/ID/group`. O passo a passo está em [como criar e gerenciar uma comunidade pela API](/blog/tutorial-criar-comunidade-whatsapp-api).

## O cuidado que evita problema

Administrar grupo é uso normal. Dois comportamentos fogem disso:

- **adicionar em massa gente que nunca pediu**, que é o equivalente em grupo à lista fria;
- **mandar a mesma mensagem em dezenas de grupos ao mesmo tempo**, sem que ninguém tenha interagido.

Prefira link de convite e aprovação. Para escalas grandes, veja [como gerenciar centenas de grupos em lote](/blog/gerenciar-centenas-grupos-whatsapp-api), e para moderação, [anti-link e anti-spam em grupo](/blog/moderacao-anti-link-grupo-whatsapp-bot).

## Conclusão

Pela API não oficial da WAME você cria grupos, cuida de participantes e admins, aprova entradas, compartilha o convite e organiza comunidades, enquanto o motor mantém tudo sincronizado e manda as mudanças pelo webhook. Usado para administrar, e não para empurrar gente para dentro, é um dos usos mais seguros da não oficial. Veja a página da [API não oficial](/nao-oficial).

## Perguntas frequentes

### Dá para gerenciar grupos pela API oficial?

Os recursos de grupo completos (criar, adicionar, promover, aprovar entrada, convite, comunidade) são da API não oficial. É um dos motivos pelos quais quem administra grupos escolhe a não oficial.

### Gerenciar grupo pela API dá bloqueio?

Administrar grupo (boas-vindas, regras, moderação, avisos) é uso normal. O que dá problema é adicionar em massa gente que nunca pediu para entrar.

### Recebo pelo webhook quem entrou e saiu?

Sim. O motor acompanha as mudanças do grupo e envia os eventos de entrada, saída, promoção e alteração pelo webhook da instância.