---
title: "Grupos de lançamento no WhatsApp: rotação pela API"
description: "Como automatizar grupos de lançamento no WhatsApp pela API não oficial: criar grupos em sequência, link único com rotação, modo anúncio e dia do carrinho."
url: "https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api"
language: "pt-BR"
og:type: "article"
og:site_name: "WAME API"
---

[Início](https://api-wa.me/)/[Blog da API do WhatsApp](https://api-wa.me/blog)/Grupos de lançamento no WhatsApp: automação com rotação de grupos pela API

Raphael Serafim· Publicado em 28 de setembro de 2026· 9 min de leitura

Compartilhar

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

Como automatizar grupos de lançamento no WhatsApp pela API não oficial: criar grupos em sequência, link único com rotação, modo anúncio e dia do carrinho.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api.md)

**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](https://api-wa.me/blog/automatizar-grupos-whatsapp-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`.

bash

Copiar

```
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:

javascript

Copiar

```
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:

javascript

Copiar

```
// 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"`:

javascript

Copiar

```
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.

javascript

Copiar

```
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](https://api-wa.me/blog/fixar-mensagem-whatsapp-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.

bash

Copiar

```
# 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](https://api-wa.me/blog/moderacao-anti-link-grupo-whatsapp-bot) 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:

| Quando | Ação | Endpoint |
| --- | --- | --- |
| D-10 | Criar primeiros grupos em modo anúncio | `POST /groups` + `PATCH ?setting=announcement` |
| D-10 a D-1 | Conteúdo diário em todos os grupos | `POST /message/text`, mídia |
| D-1 | Aviso fixado com data e horário | `POST /message/pin` |
| D-0, abertura | Liberar conversa | `PATCH ?setting=not_announcement` |
| D-0, abertura | Link do carrinho em todos | `POST /message/text` |
| D+3, fechamento | Fechar conversa | `PATCH ?setting=announcement` |
| D+4 | Descrição final e saída | `PUT /groups/{id}`, `DELETE /groups/{id}` |

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](https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento) 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](https://api-wa.me/blog/gerenciar-centenas-grupos-whatsapp-api).

## 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](https://api-wa.me/blog/api-whatsapp-nao-oficial-bane-o-que-derruba-numero).

## 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](https://api-wa.me/docs).

### Pronto para automatizar seu WhatsApp?

Crie sua conta gratuita e comece a enviar mensagens pela API em minutos.

[Começar grátis](https://portal.api-wa.me/sign-up)

## Perguntas frequentes

O que é rotação de grupos de lançamento no WhatsApp?+

É usar um único link de entrada que sempre aponta para o grupo que ainda tem vaga. Quando um grupo enche, o link passa a levar para o próximo. Pela API, seu sistema cria os grupos, guarda o link de convite de cada um e decide para qual redirecionar consultando a quantidade de membros.

Posso adicionar os inscritos direto no grupo pela API?+

Não é o recomendado. Adicionar pessoas que não pediram para entrar gera denúncia e é um dos comportamentos que mais derrubam número. O caminho seguro é o link de convite: a pessoa se inscreve, clica e entra por vontade própria.

Como mando a mesma mensagem em todos os grupos do lançamento?+

Envie para cada grupo com to igual ao ID terminado em @g.us, um de cada vez, com alguns segundos entre os envios. Disparar tudo no mesmo segundo parece automação e pode esbarrar nos freios da própria API, que responde 429 quando detecta o mesmo texto indo para muitos destinos.

Como abrir a conversa no grupo só no dia do carrinho?+

Deixe os grupos em modo anúncio (PATCH /{key}/groups/{id}?setting=announcement) durante o aquecimento e troque para not\_announcement no horário de abertura. No encerramento, volte para announcement. Tudo pode ser agendado no seu sistema.

O que fazer com os grupos depois do lançamento?+

Feche a conversa, atualize a descrição avisando que o lançamento terminou e, se não for reaproveitar, saia dos grupos com DELETE /{key}/groups/{id}. Guarde antes o que precisar de métricas e da lista de membros para a próxima campanha, respeitando quem pediu para sair.

## Continue lendo

[### Como gerenciar centenas de grupos de WhatsApp pela API (em lote)

Inventário, padronização em lote, auditoria de admins e limpeza de grupos mortos: como gerenciar centenas de grupos de WhatsApp com a API não oficial.](https://api-wa.me/blog/gerenciar-centenas-grupos-whatsapp-api)[### IA que responde dúvidas no grupo de WhatsApp (só quando chamada)

IA para responder dúvidas em grupo de WhatsApp pela API não oficial: gatilho por menção, base de conhecimento, resposta citada e escalar para admin.](https://api-wa.me/blog/ia-responder-duvidas-grupo-whatsapp)[### Métricas de grupo no WhatsApp: entradas, saídas e engajamento pela API

Como medir entradas, saídas, churn e engajamento de grupos de WhatsApp com a API não oficial: eventos de participantes, mensagens por membro e painel SQL.](https://api-wa.me/blog/metricas-grupo-whatsapp-entradas-saidas-engajamento)

[Voltar ao blog](https://api-wa.me/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial e Não Oficial de WhatsApp, Instagram, Messenger e Telegram",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Parceira Oficial da Meta — WhatsApp, Instagram, Messenger e Telegram numa instância só. Desde 2017.",
  "description": "Plataforma brasileira e Parceira Oficial da Meta (Meta Business Partner) para as APIs oficiais de WhatsApp (Cloud API), Instagram Direct e Messenger — os três numa única instância, com os mesmos endpoints e um único formato de webhook. Também oferece a API não oficial via QR Code e o Telegram, na mesma plataforma. No mercado desde 2017, com mais de 50 mil instâncias criadas, 99,9% de uptime e suporte humano 24/7 em português. SDKs oficiais para Node.js/TypeScript e PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Grupos de lançamento no WhatsApp: automação com rotação de grupos pela API",
  "description": "Como automatizar grupos de lançamento no WhatsApp pela API não oficial: criar grupos em sequência, link único com rotação, modo anúncio e dia do carrinho.",
  "image": "https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api/opengraph-image",
  "datePublished": "2026-09-28",
  "dateModified": "2026-09-28",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api"
  },
  "keywords": "api whatsapp não oficial, api não oficial whatsapp, gerenciar grupos whatsapp api, grupo de lançamento whatsapp, rotação de grupos whatsapp, link único grupo whatsapp, automação lançamento whatsapp",
  "inLanguage": "pt-BR"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog da API do WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Grupos de lançamento no WhatsApp: automação com rotação de grupos pela API",
      "item": "https://api-wa.me/blog/grupos-lancamento-whatsapp-automacao-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "O que é rotação de grupos de lançamento no WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "É usar um único link de entrada que sempre aponta para o grupo que ainda tem vaga. Quando um grupo enche, o link passa a levar para o próximo. Pela API, seu sistema cria os grupos, guarda o link de convite de cada um e decide para qual redirecionar consultando a quantidade de membros."
      }
    },
    {
      "@type": "Question",
      "name": "Posso adicionar os inscritos direto no grupo pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Não é o recomendado. Adicionar pessoas que não pediram para entrar gera denúncia e é um dos comportamentos que mais derrubam número. O caminho seguro é o link de convite: a pessoa se inscreve, clica e entra por vontade própria."
      }
    },
    {
      "@type": "Question",
      "name": "Como mando a mesma mensagem em todos os grupos do lançamento?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Envie para cada grupo com to igual ao ID terminado em @g.us, um de cada vez, com alguns segundos entre os envios. Disparar tudo no mesmo segundo parece automação e pode esbarrar nos freios da própria API, que responde 429 quando detecta o mesmo texto indo para muitos destinos."
      }
    },
    {
      "@type": "Question",
      "name": "Como abrir a conversa no grupo só no dia do carrinho?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Deixe os grupos em modo anúncio (PATCH /{key}/groups/{id}?setting=announcement) durante o aquecimento e troque para not_announcement no horário de abertura. No encerramento, volte para announcement. Tudo pode ser agendado no seu sistema."
      }
    },
    {
      "@type": "Question",
      "name": "O que fazer com os grupos depois do lançamento?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Feche a conversa, atualize a descrição avisando que o lançamento terminou e, se não for reaproveitar, saia dos grupos com DELETE /{key}/groups/{id}. Guarde antes o que precisar de métricas e da lista de membros para a próxima campanha, respeitando quem pediu para sair."
      }
    }
  ]
}
```