Community

import { Client } from 'zaileys'
 
const client = new Client()
 
client.on('connect', async () => {
  const community = await client.community.create('Devs Hub', 'Welcome to the hub')
  console.log('Community created:', community.id)
})

create(subject: string, body: string): Promise<GroupMetadata>

const community = await client.community.create(
  'Devs Hub',
  'A space for developers using zaileys.',
)
 
console.log('Community id:', community.id)
// e.g. "120363000000000001@g.us"

createGroup(subject: string, participants: string[], communityId: string): Promise<GroupMetadata>

const communityId = '120363000000000001@g.us'
 
const group = await client.community.createGroup(
  'Backend Team',
  [
    '628111111111@s.whatsapp.net',
    '628222222222@s.whatsapp.net',
  ],
  communityId,
)
 
console.log('Sub-group created:', group.id)

linkGroup(communityId: string, groupId: string): Promise<void>

const communityId = '120363000000000001@g.us'
const groupId = '120363000000000002@g.us'
 
await client.community.linkGroup(communityId, groupId)
console.log('Group linked.')

unlinkGroup(communityId: string, groupId: string): Promise<void>

await client.community.unlinkGroup(communityId, groupId)
console.log('Group unlinked.')

subGroups(communityId: string): Promise<LinkedGroup[]>

const communityId = '120363000000000001@g.us'
 
const groups = await client.community.subGroups(communityId)
 
for (const g of groups) {
  console.log(g.subject, '—', g.size, 'members')
}

leave(communityId: string): Promise<void>

await client.community.leave('120363000000000001@g.us')

updateSubject(communityId: string, subject: string): Promise<void>

await client.community.updateSubject('120363000000000001@g.us', 'Devs Hub v2')

updateDescription(communityId: string, description?: string): Promise<void>

// Set a new description
await client.community.updateDescription(
  '120363000000000001@g.us',
  'Open community for zaileys developers.',
)
 
// Clear the description
await client.community.updateDescription('120363000000000001@g.us')

inviteCode(communityId: string): Promise<string | undefined>

const code = await client.community.inviteCode('120363000000000001@g.us')
 
if (code) {
  console.log('Invite link: https://chat.whatsapp.com/' + code)
}

revokeInvite(communityId: string): Promise<string | undefined>

const newCode = await client.community.revokeInvite('120363000000000001@g.us')
 
if (newCode) {
  console.log('New invite link: https://chat.whatsapp.com/' + newCode)
}

acceptInvite(code: string): Promise<string | undefined>

// Extract just the code from a full URL if needed
const url = 'https://chat.whatsapp.com/AbCdEfGhIjKlMnOpQrStUv'
const code = url.split('/').pop()!
 
const communityId = await client.community.acceptInvite(code)
console.log('Joined community:', communityId)

metadata(communityId: string): Promise<GroupMetadata>

const meta = await client.community.metadata('120363000000000001@g.us')
console.log(meta.subject, '—', meta.participants.length, 'members')

list(): Promise<GroupMetadata[]>

const communities = await client.community.list()
console.log('You are in', communities.length, 'communities')
 
for (const c of communities) {
  console.log(c.subject, '—', c.id)
}

inviteInfo(code: string): Promise<GroupMetadata>

const info = await client.community.inviteInfo('AbCdEfGhIjKlMnOpQrStUv')
console.log('Community:', info.subject)

toggleEphemeral(communityId: string, seconds: number): Promise<void>

// Enable 7-day disappearing messages by default
await client.community.toggleEphemeral('120363000000000001@g.us', 604800)
 
// Disable
await client.community.toggleEphemeral('120363000000000001@g.us', 0)

setting(communityId: string, setting: 'announcement' | 'not_announcement'): Promise<void>

// Only admins can post
await client.community.setting('120363000000000001@g.us', 'announcement')
 
// Re-open for all members
await client.community.setting('120363000000000001@g.us', 'not_announcement')

memberAddMode(communityId: string, adminsOnly: boolean): Promise<void>

// Only admins can add members
await client.community.memberAddMode('120363000000000001@g.us', true)
 
// Any member can add members
await client.community.memberAddMode('120363000000000001@g.us', false)

joinApproval(communityId: string, enabled: boolean): Promise<void>

// Require admin approval
await client.community.joinApproval('120363000000000001@g.us', true)
 
// Allow direct joins
await client.community.joinApproval('120363000000000001@g.us', false)

import { Client } from 'zaileys'
 
const client = new Client({ sessionId: 'community-bot' })
 
client.on('connect', async () => {
  // 1. Create the community
  const community = await client.community.create(
    'Devs Hub',
    'Central space for all zaileys developers.',
  )
  console.log('Community:', community.id)
 
  // 2. Create sub-groups inside it
  const backend = await client.community.createGroup(
    'Backend',
    ['628111111111@s.whatsapp.net'],
    community.id,
  )
  const frontend = await client.community.createGroup(
    'Frontend',
    ['628222222222@s.whatsapp.net'],
    community.id,
  )
  console.log('Groups created:', backend.id, frontend.id)
 
  // 3. List linked groups
  const groups = await client.community.subGroups(community.id)
  console.log('Sub-groups:', groups.map((g) => g.subject))
 
  // 4. Rename the community
  await client.community.updateSubject(community.id, 'Devs Hub v2')
 
  // 5. Get an invite link
  const code = await client.community.inviteCode(community.id)
  if (code) {
    console.log('Share:', 'https://chat.whatsapp.com/' + code)
  }
})

import { Client, ZaileysDomainError } from 'zaileys'
 
try {
  await client.community.create('Test', 'body')
} catch (err) {
  if (err instanceof ZaileysDomainError && err.code === 'NOT_CONNECTED') {
    console.error('Connect the client first.')
  } else {
    throw err
  }
}