Skip to main content
Auth: TokenAccount ou TokenInstance em todas as rotas. Cada chamada valida a ownership da instância. Comunidades são “parent groups” do WhatsApp que agrupam outros grupos como subgrupos. Esta seção cobre as rotas /api/community/* para criar, vincular, desvincular e listar subgrupos. Para grupos comuns, veja Grupos.

Endpoints

Como funciona

Uma comunidade no WhatsApp é composta por:
  • Grupo-pai (a comunidade em si), onde você gerencia tudo
  • Grupo de Anúncios, criado automaticamente. Apenas admins postam, mas todos os membros de subgrupos recebem
  • Subgrupos, grupos comuns vinculados à comunidade
Cada grupo pertence a no máximo uma comunidade por vez. Para mover um grupo de uma comunidade para outra, desvincule primeiro e depois vincule no destino.

Identifiers

  • A maioria das rotas espera JIDs @g.us em communityJid e groupJid.
  • GET /listSubGroups exige ?communityJid= na query string.

Modelos de resposta

Resposta de /create

No endpoint de /unlink, o campo se chama linked mas contém os JIDs desvinculados com sucesso (DTO compartilhado). Use a message ("Unlinked N of M ...") para desambiguar.

Resposta de /listSubGroups

isDefaultSubGroup=true indica o Grupo de Anúncios padrão da comunidade.

Envelope de erro

Próximo

Criar comunidade

Cria o grupo-pai e vincula subgrupos iniciais.

Listar subgrupos

Retorna os grupos vinculados.