---
title: "Criar comunidade de WhatsApp pela API: tutorial"
description: "Tutorial passo a passo para criar e gerenciar uma comunidade de WhatsApp pela API: criar, convidar, atualizar e remover participante, com exemplos em cURL."
url: "https://api-wa.me/blog/tutorial-criar-comunidade-whatsapp-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)/Como criar e gerenciar uma comunidade de WhatsApp pela API

Raphael Serafim· Publicado em 17 de setembro de 2026· 8 min de leitura

Compartilhar

# Como criar e gerenciar uma comunidade de WhatsApp pela API

Tutorial passo a passo para criar e gerenciar uma comunidade de WhatsApp pela API: criar, convidar, atualizar e remover participante, com exemplos em cURL.

Copiar para LLM[Ver como Markdown](https://api-wa.me/blog/tutorial-criar-comunidade-whatsapp-api.md)

**Comunidade no WhatsApp é uma estrutura que agrupa vários grupos sob um mesmo espaço de anúncio — e a API permite criar, atualizar, convidar e remover participante de uma comunidade da mesma forma que já gerencia grupo individual.** Este tutorial mostra o passo a passo de montar e manter uma comunidade por código.

## Comunidade não é "grupo grande"

O erro conceitual mais comum é tratar comunidade como sinônimo de grupo maior. Não é: comunidade é uma camada acima de vários grupos, cada um mantendo sua própria conversa, com um canal de anúncio que atinge todos os grupos vinculados de uma vez.

Um exemplo torna isso concreto: uma escola de idiomas pode ter uma comunidade "Escola XYZ" com um grupo por turma dentro dela. Um aviso de feriado vai para a comunidade e alcança todas as turmas; uma dúvida específica de uma turma fica só no grupo dela. Isso é diferente de [automatizar grupos de WhatsApp pela API](https://api-wa.me/blog/automatizar-grupos-whatsapp-api), que cobre a gestão de um grupo isolado — aqui o foco é a camada que organiza vários grupos juntos.

> Assim como grupos e labels, comunidade é um recurso da camada **não oficial** (QR Code). Veja a diferença completa em [API oficial vs não oficial do WhatsApp](https://api-wa.me/blog/whatsapp-api-oficial-vs-nao-oficial).

## Pré-requisitos

- Instância conectada via QR Code, com a key de acesso.
- Pelo menos um caso de uso definido para os grupos que vão compor a comunidade — turma, região, segmento de cliente.

## Passo a passo

### 1\. Crie a comunidade

sh

Copiar

```
curl -X POST https://us.api-wa.me/{KEY}/community \
  -H "Content-Type: application/json" \
  -d '{"name": "Escola XYZ", "description": "Comunidade oficial de alunos da Escola XYZ"}'
```

A resposta traz o identificador da comunidade, usado em toda chamada seguinte.

### 2\. Consulte as informações da comunidade

sh

Copiar

```
curl https://us.api-wa.me/{KEY}/community/{COMMUNITY_ID}
```

Útil para confirmar nome, descrição e estado atual antes de uma atualização, ou para popular um painel administrativo que exibe todas as comunidades geridas pela sua aplicação.

### 3\. Gere o link de convite

sh

Copiar

```
curl -X POST https://us.api-wa.me/{KEY}/community/{COMMUNITY_ID}/invite
```

O link retornado pode ser distribuído em qualquer canal — site, e-mail, material impresso — e quem clica entra direto na comunidade, sem exigir aprovação manual de cada pedido.

### 4\. Atualize nome e descrição

sh

Copiar

```
curl -X PUT https://us.api-wa.me/{KEY}/community/{COMMUNITY_ID} \
  -H "Content-Type: application/json" \
  -d '{"name": "Escola XYZ — Ano Letivo 2026", "description": "Comunidade oficial. Avisos gerais aqui; dúvidas de turma no grupo específico."}'
```

Reaproveitar essa chamada é o que evita comunidade com nome desatualizado — atualize automaticamente sempre que um dado do seu sistema mudar (novo ano letivo, nova política de uso).

### 5\. Remova participante quando necessário

sh

Copiar

```
curl -X DELETE https://us.api-wa.me/{KEY}/community/{COMMUNITY_ID}/participants \
  -H "Content-Type: application/json" \
  -d '{"participants": ["5511777777777"]}'
```

Um uso direto: quando um aluno tranca a matrícula no seu sistema, o mesmo evento que registra o trancamento chama essa remoção, sem depender de um administrador lembrar de tirar a pessoa manualmente.

### 6\. Saia da comunidade ao encerrar o ciclo

sh

Copiar

```
curl -X DELETE https://us.api-wa.me/{KEY}/community/{COMMUNITY_ID}
```

Reserve esse passo para quando a comunidade inteira perde a razão de existir — fim de um programa, encerramento de uma operação — e não para remover um participante isolado, que é o passo anterior.

## Combinando comunidade com grupos

Uma comunidade só entrega valor quando tem grupos vinculados dentro dela. O fluxo típico de montagem:

1. Criar a comunidade (passo 1 acima);
2. Criar cada grupo separadamente, usando o endpoint de criação de grupo;
3. Vincular o grupo à comunidade — normalmente feito no momento da criação do grupo ou por uma ação de administrador dentro do app, dependendo da versão da API disponível na sua instância.

Automatizar a criação de um grupo por turma dentro da mesma comunidade, no momento em que uma nova turma é aberta no seu sistema, é o que transforma essa estrutura num processo sem trabalho manual recorrente.

## Automatizando o ciclo de vida completo

Numa operação real — um curso online com turmas recorrentes, por exemplo — a comunidade e seus grupos nascem e morrem seguindo o calendário do produto, não a memória de um administrador. Um fluxo automatizado típico:

javascript

Copiar

```
async function abrirNovaTurma(nomeTurma, alunos) {
  // 1. Garante que a comunidade principal já existe (criar uma vez, reutilizar sempre)
  const communityId = await obterOuCriarComunidadePrincipal();

  // 2. Cria o grupo da turma
  const grupo = await fetch(`https://us.api-wa.me/${KEY}/groups`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ name: nomeTurma, participants: alunos }),
  }).then((r) => r.json());

  // 3. Registra o vínculo no seu próprio sistema para rastrear o ciclo de vida
  await registrarGrupoDaTurma(communityId, grupo.id, nomeTurma);

  return grupo;
}
```

No encerramento da turma, o processo inverso — remover participantes ou sair do grupo — segue o mesmo princípio: toda automação que cria também precisa definir como encerra.

## Comunicando um aviso para toda a comunidade

O valor prático mais direto de uma comunidade é o aviso que precisa alcançar todos os grupos vinculados de uma vez — um comunicado institucional, uma mudança de horário, um aviso de manutenção. Antes de automatizar esse tipo de disparo, vale confirmar que o canal de anúncio da comunidade está restrito a quem deveria postar (normalmente só administradores), para o aviso não se perder em meio a conversas paralelas — o mesmo cuidado de fixar o que é prioritário, discutido em [como gerenciar chats pela API](https://api-wa.me/blog/tutorial-gerenciar-chats-whatsapp-api).

## Erros comuns

**Criar uma comunidade para o que deveria ser um grupo só.** Se não existe necessidade real de múltiplos subgrupos com aviso comum, um grupo único é mais simples de manter — comunidade agrega complexidade que só compensa com mais de um grupo vinculado.

**Não ter uma política clara de quem pode postar no canal de anúncio.** Assim como grupo, comunidade sem essa restrição vira canal de conversa dispersa em vez de canal de aviso — vale revisar as configurações de quem pode postar, do mesmo jeito que vale para um grupo isolado.

**Esquecer de remover participante ao encerrar vínculo.** Aluno que tranca matrícula, cliente que cancela plano — se a remoção não é automática, a comunidade acumula gente que não deveria mais estar lá, o que eventualmente vira um problema de privacidade e organização.

## Quando comunidade é a escolha errada

Nem toda operação com múltiplos grupos precisa de uma comunidade formal. Se os grupos não têm nenhuma necessidade real de aviso comum — são públicos completamente diferentes, sem sobreposição de interesse — manter grupos separados, sem uma comunidade os unindo, é mais simples de administrar e evita a complexidade extra de gerenciar uma camada estrutural sem uso real.

Um sinal claro de que vale a pena criar a comunidade: você já se pega copiando e colando o mesmo aviso manualmente em vários grupos separados. Nesse ponto, a comunidade substitui um processo manual repetitivo por um único envio.

## Monitorando a saúde da comunidade

Depois de criada, vale acompanhar periodicamente quantos grupos estão vinculados, quantos participantes cada grupo tem e se o canal de anúncio principal ainda está sendo usado como esperado. Uma comunidade que cresce sem esse acompanhamento tende a acumular grupos abandonados do mesmo jeito que grupos isolados acumulam quando ninguém revisa — o cuidado de encerrar o que não serve mais vale tanto para a estrutura de comunidade quanto para cada grupo dentro dela.

## Próximos passos

Depois de montar a estrutura de comunidade, vale revisar [automatizar grupos de WhatsApp pela API](https://api-wa.me/blog/automatizar-grupos-whatsapp-api) para o detalhe de cada grupo vinculado, e [Labels na API do WhatsApp](https://api-wa.me/blog/labels-api-whatsapp-organizar-conversas-sem-crm) para organizar as conversas individuais que nascem dentro desses grupos.

### 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

Qual a diferença entre comunidade e grupo no WhatsApp?+

Grupo é uma conversa entre um conjunto de participantes. Comunidade é uma estrutura que reúne vários grupos sob um mesmo guarda-chuva, com um espaço de anúncios que alcança todos os grupos vinculados de uma vez — pense em comunidade como organização de grupos, não como um grupo maior.

Dá para criar uma comunidade de WhatsApp pela API?+

Sim, um POST no endpoint de comunidade cria a estrutura com nome e descrição, retornando um identificador usado nas chamadas seguintes — atualizar, convidar e remover participante.

Comunidade de WhatsApp funciona na API oficial (Cloud API)?+

Não. Comunidades são um recurso da camada não oficial, a mesma que expõe grupos e labels — a conexão por QR Code que enxerga o WhatsApp como um aparelho conectado. A Cloud API da Meta não trata esse recurso.

Como as pessoas entram numa comunidade criada pela API?+

Pelo link de convite gerado via API, ou sendo adicionadas diretamente a um dos grupos vinculados à comunidade. Não existe um endpoint de "adicionar direto à comunidade" sem passar por um grupo ou pelo link.

Para que serve uma comunidade em vez de só grupos separados?+

Para operações com múltiplos subgrupos que precisam de um canal de aviso comum — por exemplo, uma escola com uma comunidade e um grupo por turma, ou uma empresa com um grupo por região e um aviso institucional que alcança todos de uma vez.

## Continue lendo

[### Coexistência e a nova cobrança do WhatsApp: o que muda para quem atende pelo celular e pela API

Quem usa Coexistência (API oficial + celular) sente a nova cobrança de agosto e outubro de 2026 de um jeito específico. Veja o que é cobrado e o que continua grátis.](https://api-wa.me/blog/coexistencia-nova-cobranca-whatsapp-2026)[### Como simular o custo da nova cobrança do WhatsApp antes de outubro de 2026

Passo a passo para medir, via webhook e API de analytics da Meta, quantas mensagens de serviço e de Business Agent seu número gera hoje — antes da cobrança começar.](https://api-wa.me/blog/simular-custo-mensagem-servico-whatsapp-2026)[### Automatizar grupos de WhatsApp pela API: guia completo

Como automatizar grupos de WhatsApp pela API: criar, adicionar participante, moderar entrada e enviar aviso automático, com exemplos práticos em cURL.](https://api-wa.me/blog/automatizar-grupos-whatsapp-api)

[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 e Messenger",
  "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 e Messenger 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, 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": "Como criar e gerenciar uma comunidade de WhatsApp pela API",
  "description": "Tutorial passo a passo para criar e gerenciar uma comunidade de WhatsApp pela API: criar, convidar, atualizar e remover participante, com exemplos em cURL.",
  "image": "https://api-wa.me/blog/tutorial-criar-comunidade-whatsapp-api/opengraph-image",
  "datePublished": "2026-09-17",
  "dateModified": "2026-09-17",
  "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/tutorial-criar-comunidade-whatsapp-api"
  },
  "keywords": "criar comunidade whatsapp api, comunidade whatsapp business api, gerenciar comunidade whatsapp pela api, api whatsapp comunidades, convite comunidade whatsapp api",
  "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": "Como criar e gerenciar uma comunidade de WhatsApp pela API",
      "item": "https://api-wa.me/blog/tutorial-criar-comunidade-whatsapp-api"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Qual a diferença entre comunidade e grupo no WhatsApp?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Grupo é uma conversa entre um conjunto de participantes. Comunidade é uma estrutura que reúne vários grupos sob um mesmo guarda-chuva, com um espaço de anúncios que alcança todos os grupos vinculados de uma vez — pense em comunidade como organização de grupos, não como um grupo maior."
      }
    },
    {
      "@type": "Question",
      "name": "Dá para criar uma comunidade de WhatsApp pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sim, um POST no endpoint de comunidade cria a estrutura com nome e descrição, retornando um identificador usado nas chamadas seguintes — atualizar, convidar e remover participante."
      }
    },
    {
      "@type": "Question",
      "name": "Comunidade de WhatsApp funciona na API oficial (Cloud API)?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Não. Comunidades são um recurso da camada não oficial, a mesma que expõe grupos e labels — a conexão por QR Code que enxerga o WhatsApp como um aparelho conectado. A Cloud API da Meta não trata esse recurso."
      }
    },
    {
      "@type": "Question",
      "name": "Como as pessoas entram numa comunidade criada pela API?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Pelo link de convite gerado via API, ou sendo adicionadas diretamente a um dos grupos vinculados à comunidade. Não existe um endpoint de \"adicionar direto à comunidade\" sem passar por um grupo ou pelo link."
      }
    },
    {
      "@type": "Question",
      "name": "Para que serve uma comunidade em vez de só grupos separados?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Para operações com múltiplos subgrupos que precisam de um canal de aviso comum — por exemplo, uma escola com uma comunidade e um grupo por turma, ou uma empresa com um grupo por região e um aviso institucional que alcança todos de uma vez."
      }
    }
  ]
}
```