Grupos de lançamento no WhatsApp: automação com rotação de grupos pela API

Um grupo de lançamento automatizado pela API não oficial do WhatsApp funciona assim: seu sistema cria os grupos em sequência, guarda o link de convite de cada um e publica um link único que sempre leva ao grupo com vaga. Durante o aquecimento os grupos ficam em modo anúncio, no dia do carrinho a conversa abre por código, e as mensagens saem em todos os grupos com espaçamento. Nada disso exige alguém com o celular na mão às três da manhã.

Quem já fez lançamento na mão conhece o roteiro: criar grupo a grupo, copiar link, trocar o link da página quando enche, colar a mesma mensagem em vinte conversas, esquecer de fechar uma. Este guia mostra como transformar esse roteiro em código.

A camada não oficial da WAME é independente e não é afiliada, endossada ou suportada pelo WhatsApp ou pela Meta. O uso é de responsabilidade de quem envia.

A regra que vem antes de qualquer código

Grupo de lançamento só funciona com gente que se inscreveu. A pessoa deixou o e-mail na página, recebeu o link e clicou para entrar. Essa escolha é o que faz o grupo ter engajamento — e é o que mantém o número seguro.

O atalho de pegar uma lista e adicionar todo mundo direto no grupo é exatamente o comportamento que gera denúncia em massa. A WAME não apoia esse uso. Neste guia, toda entrada acontece pelo link de convite, e a API faz o trabalho chato em volta dele.

Para o panorama de tudo o que dá para fazer com grupos, veja automatizar grupos de WhatsApp pela API. Aqui o foco é o formato específico de lançamento.

A arquitetura em quatro peças

1. Criador de grupos: cria os grupos da campanha, já em modo anúncio, e guarda ID e link de convite.
2. Link único com rotação: um endereço seu (por exemplo, seusite.com/entrar) que redireciona para o grupo com vaga.
3. Agenda de mensagens: envia a mesma comunicação em todos os grupos, um por vez.
4. Chaves de conversa: abre e fecha os grupos nos horários da campanha.

Tudo gira em torno de uma tabela simples: grupos(id, nome, link, ordem, status).

Criar os grupos em sequência

POST /{key}/groups cria o grupo e a resposta já traz duas coisas úteis: o grupo em data (com o data.id, o JID terminado em @g.us) e o link de convite pronto em groupLink.

curl -X POST "https://us.api-wa.me/SUA_KEY/groups" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Lançamento Curso X #01", "participants": ["5511988887777"] }'

O participante inicial é o seu time (um admin de apoio, por exemplo), não um inscrito. Em código, criando os grupos da campanha com calma:

const BASE = 'https://us.api-wa.me/SUA_KEY';
const esperar = (ms) => new Promise((r) => setTimeout(r, ms));

async function api(metodo, caminho, corpo) {
  const r = await fetch(`${BASE}${caminho}`, {
    method: metodo,
    headers: { 'Content-Type': 'application/json' },
    body: corpo ? JSON.stringify(corpo) : undefined,
  });
  return r.json();
}

async function criarGrupos(campanha, quantidade, apoio) {
  const grupos = [];
  for (let i = 1; i <= quantidade; i++) {
    const nome = `${campanha} #${String(i).padStart(2, '0')}`;
    const r = await api('POST', '/groups', { name: nome, participants: [apoio] });

    const id = r.data.id;
    await api('PATCH', `/groups/${id}?setting=announcement`);   // só admins falam
    await api('PUT', `/groups/${id}`, {
      name: nome,
      description: 'Grupo oficial do lançamento. Avisos por aqui; dúvidas no privado.',
    });

    grupos.push({ id, nome, link: r.groupLink, ordem: i, status: 'ativo' });
    await esperar(20000); // um grupo a cada ~20s: ninguém cria 30 grupos num segundo
  }
  return grupos; // grave no seu banco
}

Duas decisões importam aqui. Primeiro, não crie todos de uma vez: comece com alguns e crie o próximo quando o atual estiver perto de encher. Segundo, espaçe as criações. Um número que cria dezenas de grupos no mesmo minuto não se parece com nenhuma pessoa real.

O link único com rotação

A página de captura mostra um link só. Ele aponta para um endpoint seu, que decide o destino na hora do clique:

// GET /entrar — redireciona para o primeiro grupo com vaga
app.get('/entrar', async (req, res) => {
  const grupos = await db.grupos.ativosPorOrdem();

  for (const g of grupos) {
    const membros = await contarMembros(g.id);
    if (membros < LIMITE_POR_GRUPO) return res.redirect(302, g.link);
    await db.grupos.marcarCheio(g.id);
  }

  res.redirect(302, '/lista-de-espera'); // acabaram as vagas: avise e crie o próximo
});

async function contarMembros(id) {
  // /members devolve a lista de participantes em `data`.
  const r = await api('GET', `/groups/${id}/members`);
  return (r.data ?? []).length;
}

Consultar os membros a cada clique funciona em campanha pequena. Em campanha grande, guarde a contagem em cache por alguns segundos, ou mantenha o contador pelo webhook de participantes (veja abaixo). Assim o redirect fica instantâneo e você não consulta a API mil vezes por minuto.

O LIMITE_POR_GRUPO é decisão sua. O limite atual do WhatsApp por grupo já passou de mil participantes, mas lançamento costuma trabalhar bem abaixo disso, deixando folga para o time e para quem entra atrasado.

Contador em tempo real pelo webhook

Toda entrada e saída gera um evento no webhook de grupos (configurado em webhookGroup via PUT /{key}/instance). No formato meta, ele chega com field: "groups":

app.post('/webhook/grupos', (req, res) => {
  res.sendStatus(200);
  const change = req.body?.entry?.[0]?.changes?.[0];
  if (change?.field !== 'groups') return;

  const { event, id, action, participants } = change.value.groups;
  if (event !== 'participants_updated') return;

  const delta = action === 'add' ? participants.length
              : action === 'remove' ? -participants.length : 0;
  if (delta) db.grupos.ajustarContagem(id, delta);
});

O action vem como add, remove, promote ou demote; para contar vaga, some em add e subtraia em remove. Com isso, o redirect lê o número do seu banco. A consulta a /members fica para uma conciliação periódica, caso algum evento se perca.

Mensagens programadas em todos os grupos

Durante o aquecimento, você manda conteúdo: aula, lembrete, contagem regressiva. A mesma mensagem vai para todos os grupos — e é aqui que muita automação erra, disparando tudo no mesmo segundo.

async function publicarEmTodos(texto) {
  const grupos = await db.grupos.ativos();
  for (const g of grupos) {
    const r = await fetch(`${BASE}/message/text`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ to: g.id, text: texto }),
    });

    if (r.status === 429) {
      // A API pediu calma. Espere e continue de onde parou.
      await esperar(5 * 60 * 1000);
      continue;
    }
    await esperar(8000 + Math.random() * 7000); // 8 a 15s entre grupos
  }
}

A própria API tem freios: ela responde 429 quando o mesmo texto vai para destinos demais em pouco tempo. Não trate isso como erro a ser repetido em loop — é um sinal para desacelerar. Com espaçamento de alguns segundos entre grupos, uma campanha de dezenas de grupos termina em poucos minutos sem forçar nada.

Duas dicas de conteúdo que também ajudam o número: varie levemente o texto entre publicações ao longo dos dias e prefira mídia com legenda a blocos longos de texto idêntico. Para fixar o aviso principal no topo de cada grupo, veja fixar mensagem pela API.

O dia do carrinho: abrir e fechar a conversa

Modo anúncio (announcement) deixa só admins falando. No aquecimento é o ideal: o grupo vira canal limpo. No dia da abertura, você pode liberar a conversa para gerar prova social — e fechar de novo no encerramento.

# Abrir a conversa para todos
curl -X PATCH "https://us.api-wa.me/SUA_KEY/groups/[email protected]?setting=not_announcement"

# Fechar de novo (só admins)
curl -X PATCH "https://us.api-wa.me/SUA_KEY/groups/[email protected]?setting=announcement"

Aproveite também o locked, que impede membros de mudar nome, foto e descrição do grupo. Em grupo grande aberto, isso evita que alguém troque o nome do grupo no meio da campanha.

Com a conversa aberta, tenha moderação pronta: grupo de lançamento é alvo de gente divulgando outro produto. O guia de anti-link e anti-spam em grupo mostra como montar esse filtro.

Agenda da campanha em uma tabela

Organize o lançamento como uma lista de ações com horário, e deixe um job executar:

Uma agenda assim é fácil de revisar antes da campanha e evita o clássico "esqueci de fechar o grupo 7".

Encerrar o lançamento

Depois do fechamento, decida o destino dos grupos:

• Reaproveitar como grupo de alunos: troque nome e descrição com PUT /{key}/groups/{id} e mantenha.
• Encerrar: deixe em modo anúncio, atualize a descrição avisando que acabou e saia com DELETE /{key}/groups/{id}.

Antes de sair, guarde o que vai servir para a próxima campanha: entradas por grupo, horário de pico, taxa de saída. O guia de métricas de grupo mostra o que medir. Se o lançamento usa muitos grupos ao longo do ano, o inventário e a limpeza em lote estão em gerenciar centenas de grupos.

Por que isso é seguro para o número

O formato acima tem baixo risco por desenho: as pessoas entram porque clicaram, o grupo é majoritariamente de avisos, as mensagens saem espaçadas e ninguém é adicionado sem pedir. A WAME cuida do resto da camada técnica — identidade de dispositivo própria por instância, envios com tempo humano, reconexão espalhada e o alerta de saúde no webhook de conexão. Para quem usa assim, a taxa de bloqueio é muito baixa.

O que derruba número em lançamento é o oposto: adicionar lista comprada, criar dezenas de grupos no mesmo minuto, disparar a mesma mensagem em todos ao mesmo tempo, insistir quando a API pede calma. Os detalhes estão em o que realmente derruba um número.

Conclusão

Grupo de lançamento é um processo repetitivo com hora marcada — o tipo de trabalho que código faz melhor que gente. Com a API não oficial da WAME, você cria os grupos em sequência já em modo anúncio, publica um link único que gira para o grupo com vaga, programa o conteúdo em todos os grupos com espaçamento, abre e fecha a conversa no horário do carrinho e encerra tudo sem deixar grupo esquecido. Mantenha a entrada pelo link de convite, só para quem se inscreveu, e respeite os freios da API. Os endpoints completos estão na documentação.