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

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.

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

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 [email protected], 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):

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.

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.

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, e para moderação, anti-link e anti-spam em grupo.

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.