Comunidades (§13.3)

7.X Comunidades (§13.3)#

Comunidades do WhatsApp (recurso 2022+): um grupo "pai" (announcement hub) que agrupa sub-grupos. Criar uma comunidade faz o servidor auto-criar o grupo de avisos (announcement) — enviar pra ele transmite pra TODA a comunidade. Native whatsmeow, render-safe. Validado E2E 2026-05-25.

Método Rota Corpo / efeito
GET /v1/instances/{id}/communities Lista as comunidades (grupos "pai") em que a instância está. { "communities": [{jid, name, description, is_community:true, participants}] }. Filtra GetJoinedGroups por is_parent.
POST /v1/instances/{id}/communities { "name": "Minha Comunidade", "description": "..." } → cria a comunidade. Retorna 201 {jid, name, description, announcement_jid}. announcement_jid é o grupo de avisos auto-criado — envie texto/mídia pra esse JID (qualquer endpoint de send normal) pra fazer broadcast pra toda a comunidade. name 1..100.
GET /v1/instances/{id}/communities/{communityId}/groups Lista os sub-grupos vinculados. { "sub_groups": [{jid, name, is_announcement}] }. is_announcement:true marca o grupo de avisos (alvo do broadcast).
POST /v1/instances/{id}/communities/{communityId}/groups/{groupId} Vincula um grupo EXISTENTE como sub-grupo da comunidade. 200 {community_jid, group_jid, linked:true}.
DELETE /v1/instances/{id}/communities/{communityId}/groups/{groupId} Desvincula o sub-grupo. 200 {..., linked:false}.

Detalhe da comunidade: use GET /v1/instances/{id}/groups/{communityId} — o group info traz is_community:true no pai e linked_parent_jid nos sub-grupos.

Eventos emitidos (everything-is-an-event): community.created_sent, community.group_linked_sent, community.group_unlinked_sent.

Broadcast = enviar pro announcement_jid via qualquer POST .../messages/*. Não há endpoint dedicado de "announce" — é um send normal pro JID do grupo de avisos. Deferido: criar sub-grupo já-vinculado num único call, PATCH de nome/descrição/foto da comunidade, invite-link/admins/deactivate da comunidade (reusam ops de grupo). Deletar uma comunidade não tem endpoint dedicado — é uma ação destrutiva do dono pelo app WhatsApp (o "leave" do criador não dissolve a comunidade).