Grupo VIP pago no WhatsApp: entrada e saída automáticas pelo pagamento

Para automatizar um grupo VIP pago no WhatsApp, conecte o gateway de pagamento ao seu sistema e use a API não oficial da WAME para duas ações: quando o pagamento é aprovado, liberar a entrada (convite + aprovação do pedido); quando a assinatura é cancelada ou vence, remover o número com DELETE /{key}/groups/{id}/participants. O grupo passa a refletir sozinho quem está em dia, sem planilha e sem ninguém conferindo comprovante.

Grupo VIP é um dos formatos mais comuns de produto recorrente no Brasil: mentoria, sinais de mercado, comunidade de alunos, clube de ofertas, conteúdo exclusivo. E quase todos sofrem do mesmo problema operacional — entrar é fácil, sair ninguém tira. Seis meses depois, metade do grupo parou de pagar e continua lá dentro.

Por que fazer isso pela API não oficial

Grupos comuns do WhatsApp — com link de convite, aprovação de entrada, remoção de membros e modo só-administradores — são gerenciados pela API não oficial, que conecta o número como um aparelho. É o mesmo grupo que você já usa no celular; a diferença é que agora um sistema também é administrador dele.

Outras vantagens que pesam nesse caso:

• Sem aprovação da Meta e sem template. As mensagens para o cliente (boas-vindas, aviso de vencimento) são texto livre.
• Custo fixo por instância, sem cobrança por mensagem — importante quando o grupo tem centenas de membros.
• Hospedada e gerenciada: 99,9% de uptime e suporte 24/7 em português, sem você manter servidor de sessão.

A arquitetura em uma frase

O pagamento é a fonte da verdade; o grupo é só um reflexo dele. Seu sistema guarda, para cada cliente, o número de WhatsApp e o status da assinatura. Todo evento do gateway (aprovado, renovado, cancelado, vencido) atualiza esse status e dispara a ação correspondente no grupo.

Gateway de pagamento ──webhook──▶ Seu sistema ──API WAME──▶ Grupo VIP
                                    (status)

Preparar o grupo

Três configurações antes de automatizar:

1. O número da instância é administrador do grupo. Sem isso, nenhuma ação de gestão funciona.
2. Aprovação de entrada ativada (em "Aprovar novos participantes", nas configurações do grupo no app). Todo pedido feito pelo link fica pendente até alguém aprovar — e esse alguém será o seu sistema.
3. Informações travadas, para que só administradores editem nome, foto e descrição:

curl -X PATCH "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO?setting=locked"

Se o grupo for de avisos (só você publica), ative também o modo anúncio:

curl -X PATCH "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO?setting=announcement"

Entrada: convite em vez de adicionar direto

O caminho óbvio seria adicionar o cliente direto:

curl -X POST "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/participants" \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5511999999999"] }'

Funciona, mas tem dois problemas. Primeiro, muita gente configura a privacidade para que só contatos a adicionem em grupos, e aí a adição falha. Segundo — e mais importante —, adicionar em volume pessoas que nunca conversaram com o seu número é um sinal ruim para o WhatsApp. É exatamente o padrão de quem monta grupo para spam.

O fluxo recomendado é o inverso: o cliente pede para entrar, o sistema aprova.

1. Pagamento aprovado → seu sistema envia uma mensagem privada com o link do grupo.
2. O cliente toca no link e pede para entrar.
3. O pedido fica pendente; seu sistema confere se aquele número tem assinatura ativa.
4. Se tiver, aprova. Se não, rejeita.

Buscar o link de convite:

curl "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/invite"

A mensagem de liberação, como o cliente acabou de pagar e está esperando o acesso, é o contato mais bem-vindo que existe:

curl -X POST "https://us.api-wa.me/SUA_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "5511999999999",
    "text": "Pagamento confirmado! 🎉 Toque no link para entrar no grupo VIP: LINK_DO_GRUPO\nSua entrada é liberada automaticamente."
  }'

Aprovar só quem pagou

Periodicamente (ou quando o webhook avisar sobre um novo pedido de entrada), liste os pendentes:

curl "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/request_participants_list"

E decida em lote:

# Aprovar quem tem assinatura ativa
curl -X PUT "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/request_participants_list" \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5511999999999"], "action": "approve" }'

# Rejeitar quem não tem
curl -X PUT "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/request_participants_list" \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5521988888888"], "action": "reject" }'

Em Node.js, a rotina de conciliação fica assim:

const BASE = 'https://us.api-wa.me/SUA_KEY';

async function conciliarPedidos(grupoId, pendentes) {
  // `pendentes`: números extraídos da resposta de request_participants_list
  // (formato da resposta em /docs).
  const aprovar = [];
  const rejeitar = [];

  for (const numero of pendentes) {
    const ativo = await assinaturaAtiva(numero); // consulta o SEU banco
    (ativo ? aprovar : rejeitar).push(numero);
  }

  const decidir = (participants, action) =>
    participants.length &&
    fetch(`${BASE}/groups/${encodeURIComponent(grupoId)}/request_participants_list`, {
      method: 'PUT',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ participants, action }),
    });

  await decidir(aprovar, 'approve');
  await decidir(rejeitar, 'reject');
}

Com a aprovação de entrada ativa, o link pode vazar à vontade: quem não pagou fica pendente e é rejeitado. É isso que torna o convite seguro.

Saída: remover quem cancelou ou venceu

Quando o gateway avisar cancelamento, estorno ou falta de renovação, remova:

curl -X DELETE "https://us.api-wa.me/SUA_KEY/groups/ID_DO_GRUPO/participants" \
  -H "Content-Type: application/json" \
  -d '{ "participants": ["5511999999999"] }'

Três cuidados que evitam reclamação:

• Carência. Cartão recusado nem sempre é cancelamento. Dê alguns dias entre "pagamento falhou" e "remover", com um aviso no meio.
• Aviso antes, não depois. Uma mensagem privada dias antes do vencimento ("sua assinatura vence sexta — renove por aqui") recupera parte dos clientes. Se você cobra por Pix, veja como cobrar por Pix no WhatsApp.
• Remoção espaçada. Se a virada do mês vence 80 assinaturas de uma vez, não remova as 80 no mesmo segundo. Processe em fila, com intervalo — o guia de fila, rate limit e retry mostra o padrão.

Um job diário de consistência

Webhook falha. Gateway atrasa. Alguém da equipe adiciona um amigo manualmente. Por isso, além de reagir a eventos, rode uma conciliação diária:

1. Liste os membros do grupo: GET /{key}/groups/{id}/members.
2. Compare com a lista de assinaturas ativas no seu banco.
3. Quem está no grupo sem assinatura (e não é da equipe) entra na fila de remoção.
4. Quem tem assinatura ativa e não está no grupo recebe de novo o link.

Esse job é o que garante que, mesmo com eventos perdidos, o grupo converge para o estado correto. Trate os webhooks do gateway e da WAME com idempotência e reentrega — um "pagamento aprovado" processado duas vezes não pode mandar dois links.

Vários grupos: use comunidade

Se o produto tem níveis (básico, premium) ou turmas, uma comunidade organiza os grupos sob um mesmo guarda-chuva, com um canal de avisos para todos. Os endpoints de comunidade permitem criar grupos dentro dela, gerenciar pedidos de entrada e definir quem pode adicionar membros. O passo a passo está em como criar e gerenciar uma comunidade pela API.

Risco de bloqueio e uso responsável

Este fluxo é, por desenho, de baixo risco: as mensagens vão para quem acabou de pagar, a entrada é por escolha do cliente e as remoções saem espaçadas. É o tipo de uso em que a taxa de bloqueio da API não oficial fica muito baixa. A WAME reforça isso por trás de cada instância, com identidade de dispositivo própria e coerente com o país do número, ritmo de envio humano, limites de volume e aquecimento automático de conversa antes de mensagens interativas.

O que não combina com a WAME é usar a mesma automação para encher grupos com números comprados ou divulgar em massa — isso é spam e a plataforma não apoia. Lembrando também que a camada não oficial não é afiliada nem endossada pelo WhatsApp ou pela Meta, e o uso é de responsabilidade de quem opera o número.

Para interação dentro do grupo (comandos, regras, boas-vindas), veja o bot de comandos para grupo. Para a parte de moderação, o guia de automação de grupos.

Conclusão

Um grupo VIP pago só escala quando o acesso segue o pagamento sem intervenção manual. Com a API não oficial da WAME, a receita é: aprovação de entrada ligada, convite enviado ao cliente que pagou, pedidos aprovados ou rejeitados pelo seu sistema com request_participants_list, remoção com DELETE /{key}/groups/{id}/participants quando a assinatura cai e uma conciliação diária para fechar as frestas. Convite em vez de adição direta, remoções espaçadas e mensagens só para quem é cliente mantêm o número saudável. Os detalhes de cada endpoint estão na documentação.