Grupos e comunidades

// Todos os grupos a que a conta pertence
const groups = await client.group.queryAllGroups()

// Os metadados de um grupo
const meta = await client.group.queryGroupMetadata('123456@g.us')
console.log(meta.subject, meta.participants.length)

const group = await client.group.createGroup('My group', [
  '5511999999999@s.whatsapp.net',
  '5511888888888@s.whatsapp.net'
])

console.log(group.jid, group.participants.length)

const jids = ['5511999999999@s.whatsapp.net']

const results = await client.group.addParticipants(groupJid, jids)

for (const r of results) {
  if (r.status === 'ok') {
    console.log('adicionado', r.jid)
  } else {
    // Código no estilo HTTP: 403 = bloqueio de privacidade, 408 = não permitido,
    // 409 = já está no grupo, 404 = não está no WhatsApp, ...
    console.warn('falhou', r.jid, r.code)
  }
}

await client.group.removeParticipants(groupJid, jids)
await client.group.promoteParticipants(groupJid, jids) // tornar admin
await client.group.demoteParticipants(groupJid, jids)  // remover admin

await client.group.setSubject(groupJid, 'New name')
await client.group.setDescription(groupJid, 'A description')   // null para limpar
await client.group.setSetting(groupJid, 'announcement', true)  // mensagens só de admins
await client.group.setSetting(groupJid, 'restrict', true)      // editar info só por admins
await client.group.setSetting(groupJid, 'ephemeral', true)     // mensagens temporárias on/off

// Quem pode adicionar novos membros
await client.group.setMemberAddMode(groupJid, 'admin_add')        // só admins
await client.group.setMemberAddMode(groupJid, 'all_member_add')   // qualquer um

// Quem pode compartilhar o link de convite
await client.group.setMemberLinkMode(groupJid, 'admin_link')
await client.group.setMemberLinkMode(groupJid, 'all_member_link')

// Se novos membros veem o histórico anterior
await client.group.setMemberShareGroupHistoryMode(groupJid, 'admin_share')      // esconde histórico
await client.group.setMemberShareGroupHistoryMode(groupJid, 'all_member_share') // expõe backlog

// 24h / 7d / 90d em segundos
await client.group.setEphemeralDuration(groupJid, 86_400)
await client.group.setEphemeralDuration(groupJid, 604_800)
await client.group.setEphemeralDuration(groupJid, 7_776_000)

// Desligar
await client.group.setSetting(groupJid, 'ephemeral', false)

// Preview de um código de convite (o segmento de chat.whatsapp.com/<code>)
const info = await client.group.queryGroupInviteInfo('AbCdEf...')
console.log(info.subject, info.size, info.desc)
// info.participants é uma amostra reduzida — não é o roster completo.
// Chame queryGroupMetadata depois de entrar para ver todos.

// Busca o código de convite atual de um grupo que você administra — NÃO rotaciona.
const code = await client.group.queryInviteCode(groupJid)
console.log('convite atual:', `https://chat.whatsapp.com/${code}`)

// Entrar via código de convite — retorna o metadata do grupo
const joined = await client.group.joinGroupViaInvite('AbCdEf...')
console.log(joined.jid, joined.participants.length)

// Rotacionar o convite — retorna o código recém-emitido
const { code: rotated, affectedParticipants } = await client.group.revokeInvite(groupJid)
console.log('novo convite:', `https://chat.whatsapp.com/${rotated}`)
// affectedParticipants lista quem entrou via o código revogado e que o
// servidor surfou na resposta (tipicamente com code: 404).

await client.group.leaveGroup([groupJid]) // em lote — aceita múltiplos

const requests = await client.group.queryMembershipApprovalRequests(groupJid)

await client.group.approveMembershipRequests(groupJid, [requesterJid])
await client.group.rejectMembershipRequests(groupJid, [requesterJid])

// Cancelar sua própria solicitação pendente
await client.group.cancelMembershipRequests(groupJid, [myJid])

// Criar uma comunidade
const community = await client.group.createCommunity('My community')

// Vincular / desvincular grupos existentes como subgrupos
await client.group.linkSubGroups(community.jid, [subGroupJidA, subGroupJidB])
await client.group.unlinkSubGroups(community.jid, [subGroupJidA], {
  removeOrphanedMembers: true
})

// Listar subgrupos (e o grupo de avisos)
const subs = await client.group.fetchSubGroups(community.jid)

// Entrar em um subgrupo vinculado ao qual você ainda não pertence.
// O resultado do IQ não carrega payload do grupo — chame
// queryGroupMetadata no subgrupo depois para obter o metadata completo.
await client.group.joinLinkedGroup(community.jid, subGroupJid)
const subMeta = await client.group.queryGroupMetadata(subGroupJid)

// Participantes mesclados de toda a comunidade
const everyone = await client.group.queryLinkedGroupsParticipants(community.jid)

client.on('group', (event) => {
  console.log(event.action, 'in', event.groupJid)
})