Skip to main content
POST
Desvincular grupos
Auth: TokenAccount ou TokenInstanceRate-limit: Global (100/min) • Idempotente: não

Descrição

Desvincula grupos de uma comunidade. Os grupos não são deletados, apenas voltam a ser independentes (sem linkedParentJid). Mesmo body e response do /link (DTO compartilhado).
O campo linked na resposta contém os JIDs desvinculados com sucesso (devido ao reuso do DTO CommunityLinkResponse). A message ("Unlinked N of M ...") confirma a semântica.

Exemplos

Desvincular grupos

Remove 2 subgrupos da comunidade 120363406289005073@g.us. Os grupos voltam a ser independentes (sem linkedParentJid) mas continuam existindo com seus membros.

Resposta de sucesso

Confirma a desvinculação devolvendo a contagem em message (formato "Unlinked N of M groups from community"). Por reuso do DTO compartilhado com /link, o array linked contém aqui os JIDs desvinculados com sucesso e failed os que falharam. success é true quando ao menos um grupo foi desvinculado, mesmo em sucesso parcial, sempre cheque failed[] para detectar erros por grupo.
200 OK

Parâmetros de rota

string
obrigatório
Nome da instância.

Headers

string
obrigatório
TokenAccount ou TokenInstance.
string
obrigatório
application/json

Request body

string
obrigatório
JID @g.us da comunidade.
string[]
obrigatório
JIDs dos grupos a desvincular. Pelo menos 1 item.

Notas

  • O Grupo de Anúncios da comunidade não pode ser desvinculado, para excluir o announcement, é preciso deletar a comunidade inteira (não exposto nesta API).
  • Os membros dos grupos continuam onde estavam, apenas a relação pai-filho é removida.
  • Para mover um grupo entre comunidades, desvincule daqui e use /link na nova.

Erros

Envelope:

Próximo

Vincular grupos

Reconectar a outra comunidade.

Listar subgrupos

Confirmar que o grupo foi removido.