[!CAUTION] NOTICE OF BREAKING CHANGE.

As of this fork, multiple changes and additions have been introduced on top of the original Baileys v7.0.0-rc13 codebase.

Disclaimer

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at whatsapp.com. "WhatsApp" as well as related names, marks, emblems and images are registered trademarks of their respective owners.

The maintainers of this project do not in any way condone the use of this application in practices that violate the Terms of Service of WhatsApp. The maintainers of this application call upon the personal responsibility of its users to use this application in a fair way, as it is intended to be used. Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage.

[!IMPORTANT] The original repository had to be removed by the original author — we now continue development in this repository here. This is the only official repository and is maintained by the community. Official Channel: WhatsApp Channel

Installation

npm install github:Arslan-MD/baileys

Or clone for development:

git clone https://github.com/Arslan-MD/baileys
cd baileys
npm install

This fork is ESM-only. Ensure your package.json contains "type": "module".

Quick Start

import makeWASocket, {
  useMultiFileAuthState,
  DisconnectReason,
  Browsers
} from 'baileys';
import pino from 'pino';

const logger = pino({ level: 'silent' });

async function startBot() {
  const { state, saveCreds } = await useMultiFileAuthState('./session');

  const sock = makeWASocket({
    auth: state,
    logger,
    browser: Browsers.ubuntu('Chrome'),
    syncFullHistory: false
  });

  sock.ev.on('creds.update', saveCreds);
  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
    if (qr) console.log('QR:', qr);
    if (connection === 'close') {
      const shouldReconnect =
        lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut;
      if (shouldReconnect) startBot();
    }
    if (connection === 'open') console.log('Connected!');
  });

  sock.ev.on('messages.upsert', async ({ messages }) => {
    const msg = messages[0];
    if (!msg?.message || msg.key.fromMe) return;
    const text = msg.message.conversation || msg.message.extendedTextMessage?.text || '';
    if (text === '.ping') {
      await sock.sendMessage(msg.key.remoteJid, { text: 'Pong!' });
    }
  });
}

startBot();

Standard Messages

Basic message types supported via sock.sendMessage(jid, content, options).

Text

await sock.sendMessage(jid, { text: 'Hello World!' });

Text with Mention

await sock.sendMessage(jid, {
  text: 'Hello @628xxx!',
  mentions: ['[email protected]']
});

Image

await sock.sendMessage(jid, {
  image: { url: './photo.jpg' },
  caption: 'A photo'
});

Video

await sock.sendMessage(jid, {
  video: { url: './video.mp4' },
  caption: 'A video',
  gifPlayback: false
});

Audio / Voice Note

await sock.sendMessage(jid, {
  audio: { url: './audio.ogg' },
  mimetype: 'audio/ogg; codecs=opus',
  ptt: true
});

Sticker

await sock.sendMessage(jid, {
  sticker: { url: './sticker.webp' }
});

Document

await sock.sendMessage(jid, {
  document: { url: './file.pdf' },
  fileName: 'document.pdf',
  mimetype: 'application/pdf'
});

Location

await sock.sendMessage(jid, {
  location: {
    degreesLatitude: -6.2,
    degreesLongitude: 106.8,
    name: 'Jakarta'
  }
});

Contact

await sock.sendMessage(jid, {
  contacts: {
    displayName: 'John Doe',
    contacts: [{
      vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:John Doe\nTEL:+628xxx\nEND:VCARD'
    }]
  }
});

Reaction

await sock.sendMessage(jid, {
  react: { key: msg.key, text: '\u2764\uFE0F' }
});

Poll

await sock.sendMessage(jid, {
  poll: {
    name: 'Favorite Language?',
    values: ['JavaScript', 'Python', 'Go'],
    selectableCount: 1
  }
});

Forward Message

await sock.sendMessage(jid, {
  forward: msg,
  forwardingScore: 1,
  isForwarded: true
});

Delete Message

await sock.sendMessage(jid, { delete: msg.key });

Edit Message

await sock.sendMessage(jid, {
  text: 'Edited content',
  edit: msg.key
});

Disappearing Messages

await sock.sendMessage(jid, { disappearingMessagesInChat: 86400 });

Advanced Messages

These message types are auto-detected and processed by the internal MessageBuilders system when passed through sendMessage().

Native Flow Buttons

await sock.sendMessage(jid, {
  interactiveMessage: {
    title: 'Welcome!',
    footer: 'Powered by Arslan-MD',
    buttons: [
      {
        name: 'quick_reply',
        buttonParamsJson: JSON.stringify({
          display_text: 'Menu',
          id: '.menu'
        })
      },
      {
        name: 'cta_url',
        buttonParamsJson: JSON.stringify({
          display_text: 'Website',
          url: 'https://example.com'
        })
      },
      {
        name: 'cta_copy',
        buttonParamsJson: JSON.stringify({
          display_text: 'Copy Code',
          copy_code: 'YELIB2024'
        })
      }
    ],
    header: 'Choose an option',
    image: { url: 'https://example.com/banner.jpg' }
  }
});

Button Types Reference

| name | buttonParamsJson fields | Description | | ---- | ----------------------- | ----------- | | quick_reply | display_text, id | Sends the id back as a message | | cta_url | display_text, url | Opens a URL when tapped | | cta_copy | display_text, copy_code | Copies text to clipboard | | single_select | title, sections | Shows a list/select menu | | call_permission_request | display_text, id | Requests call permission |

Button Features

| Feature | Field | Description | | ------- | ----- | ----------- | | Limited Time Offer | limited_time_offer_seconds | Shows countdown timer on button | | Bottom Sheet | bottom_sheet | Renders options as a bottom sheet | | Tap Target Config | tap_target_configuration | Custom tap target behavior |

List Menu (single_select)

await sock.sendMessage(jid, {
  interactiveMessage: {
    title: 'Select Category',
    footer: 'Powered by Arslan-MD',
    buttons: [
      {
        name: 'single_select',
        buttonParamsJson: JSON.stringify({
          title: 'Menu',
          sections: [
            {
              title: 'Games',
              rows: [
                { title: 'Quiz', id: '.quiz' },
                { title: 'Guess', id: '.guess' }
              ]
            },
            {
              title: 'Tools',
              rows: [
                { title: 'Sticker', id: '.sticker' },
                { title: 'TTS', id: '.tts' }
              ]
            }
          ]
        })
      }
    ],
    header: 'Bot Menu'
  }
});

Carousel Message

await sock.sendMessage(jid, {
  interactiveMessage: {
    title: 'Our Products',
    footer: 'Powered by Arslan-MD',
    carouselMessage: {
      cards: [
        {
          body: { text: 'Product A - Rp50,000' },
          footer: { text: '10% off' },
          header: { title: 'Product A' },
          nativeFlowMessage: {
            buttons: [{
              name: 'quick_reply',
              buttonParamsJson: JSON.stringify({ display_text: 'Buy', id: '.buy_a' })
            }]
          }
        },
        {
          body: { text: 'Product B - Rp75,000' },
          footer: { text: '15% off' },
          header: { title: 'Product B' },
          nativeFlowMessage: {
            buttons: [{
              name: 'quick_reply',
              buttonParamsJson: JSON.stringify({ display_text: 'Buy', id: '.buy_b' })
            }]
          }
        }
      ],
      messageVersion: 1
    }
  }
});

Album Message

Send multiple images/videos as a grouped album:

await sock.sendMessage(jid, {
  albumMessage: [
    { image: { url: './photo1.jpg' }, caption: 'Photo 1' },
    { image: { url: './photo2.jpg' }, caption: 'Photo 2' },
    { video: { url: './video.mp4' }, caption: 'Video' }
  ]
});

Event Message

await sock.sendMessage(jid, {
  eventMessage: {
    name: 'Community Meetup',
    description: 'Join us for the monthly meetup!',
    startTime: Date.now() + 86400000,
    location: { degreesLatitude: -6.2, degreesLongitude: 106.8, name: 'Jakarta' }
  }
});

Poll Result

await sock.sendMessage(jid, {
  pollResultMessage: {
    name: 'Favorite Language?',
    pollVotes: [
      { optionName: 'JavaScript', optionVoteCount: 42 },
      { optionName: 'Python', optionVoteCount: 38 },
      { optionName: 'Go', optionVoteCount: 15 }
    ]
  }
});

Product Message

const { imageMessage } = await prepareWAMessageMedia(
  { image: { url: 'https://example.com/product.jpg' } },
  { upload: sock.waUploadToServer }
);

await sock.sendMessage(jid, {
  productMessage: {
    title: 'Product Name',
    description: 'Product description',
    thumbnail: { url: 'https://example.com/product.jpg' },
    productId: 'P001',
    retailerId: 'YELIB',
    url: 'https://example.com/product',
    body: 'Latest product!',
    footer: 'Arslan-MD store',
    buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Buy Now', id: '.buy' }) }],
    priceAmount1000: 50000000,
    currencyCode: 'IDR'
  }
});

Payment Request

await sock.sendMessage(jid, {
  requestPaymentMessage: {
    expiryTimestamp: Math.floor(Date.now() / 1000) + 86400,
    amount1000: 50000,
    currencyCodeIso4217: 'IDR',
    requestFrom: '[email protected]',
    noteMessage: {
      extendedTextMessage: { text: 'Payment for order #123' }
    },
    background: { id: 'DEFAULT', placeholderArgb: 0xfff0f0f0 }
  }
});

Group Status Message

await sock.sendMessage(jid, {
  groupStatusMessage: {
    image: { url: './photo.jpg' },
    caption: 'Group status update!'
  }
});

Interactive Buttons (via interactiveButtons)

await sock.sendMessage(jid, {
  interactiveButtons: [{
    name: 'quick_reply',
    buttonParamsJson: { display_text: 'Yes', id: '.yes' }
  }],
  text: 'Do you agree?',
  footer: 'Arslan-MD',
  title: 'Confirmation'
});

Status WhatsApp

Send status updates with mentions:

await sock.messageBuilders.sendStatusWhatsApp(
  { text: 'Hello Status!', backgroundColor: '#FF5733', font: 1 },
  ['[email protected]']
);

With media:

await sock.messageBuilders.sendStatusWhatsApp(
  { image: { url: './photo.jpg' }, caption: 'My story' },
  ['[email protected]', '[email protected]']
);

MessageBuilder v4.5 (Chainable API)

Class-based builder system for interactive messages (Button, ButtonV2, Carousel) and AI Rich Response (AIRich). Available as top-level exports.

import { Button, ButtonV2, Carousel, AIRich, BUILDER_VERSION } from 'baileys';

Button (Native Flow)

await new Button(sock)
  .setTitle('Welcome')
  .setSubtitle('Choose an option')
  .setBody('Pick one below')
  .setFooter('Arslan-MD')
  .setImage('https://example.com/banner.jpg')
  .addReply('Menu', '.menu')
  .addUrl('Website', 'https://example.com')
  .addCopy('Copy Code', 'YELIB2026')
  .send(m.chat);

List/select menu:

await new Button(sock)
  .setBody('Bot Menu')
  .setFooter('Arslan-MD')
  .addSelection('Menu')
  .makeSection('Games')
  .makeRow('', 'Quiz', 'Trivia game', '.quiz')
  .makeRow('', 'Guess', 'Word guess', '.guess')
  .makeSection('Tools')
  .makeRow('', 'Sticker', 'Make sticker', '.sticker')
  .makeRow('', 'TTS', 'Text to speech', '.tts')
  .send(m.chat);

ButtonV2 (Classic Buttons)

await new ButtonV2(sock)
  .setBody('Do you agree?')
  .setFooter('Arslan-MD')
  .setTitle('Confirmation')
  .setSubtitle('Tap one')
  .setThumbnail('https://example.com/banner.jpg')
  .addButton('Yes', '.yes')
  .addButton('No', '.no')
  .send(m.chat);

Carousel

await new Carousel(sock)
  .setBody('Our Products')
  .setFooter('Arslan-MD')
  .addCard([
    {
      body: { text: 'Product A - Rp50,000' },
      footer: { text: '10% off' },
      header: { title: 'Product A', hasMediaAttachment: true, imageMessage: { url: 'https://example.com/a.jpg' } },
      nativeFlowMessage: {
        buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Buy', id: '.buy_a' }) }]
      }
    },
    {
      body: { text: 'Product B - Rp75,000' },
      footer: { text: '15% off' },
      header: { title: 'Product B', hasMediaAttachment: true, imageMessage: { url: 'https://example.com/b.jpg' } },
      nativeFlowMessage: {
        buttons: [{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Buy', id: '.buy_b' }) }]
      }
    }
  ])
  .send(m.chat);

AIRich (AI Rich Response)

Chainable builder that produces a botForwardedMessage styled like Meta AI replies. Sections are layouts of GenAI primitives encoded into unifiedResponse.data (base64 JSON).

Helpers

new AIRich(sock)
  .addText('Hello [link](https://example.com)')   // markdown links, citations, latex
  .addCode('console.log("hi")', 'javascript')
  .addTable([['Name', 'Value'], ['A', '1'], ['B', '2']])
  .addImage('https://example.com/x.png')
  .addVideo('https://example.com/x.mp4|12')        // url|duration
  .addReels([{ username: 'foo', thumbnail: '...', url: '...' }])
  .addPost({ title: 'Post', thumbnail: '...', url: '...' })
  .addSuggest(['Follow up A', 'Follow up B'])
  .addTip('Helpful hint')
  .addSource([{ url: '...', title: '...' }])
  .setFooter('Powered by Arslan-MD')
  .send(m.chat);

Low-level layout (AIRich.newLayout)

AIRich.newLayout(name, data) builds a GenAI{name}LayoutViewModel. Use Single for one primitive (object), HScroll / ActionRow for an array of primitives.

Animate video primitive (GenAIImaginePrimitive, ANIMATE):

await new AIRich(conn)
  .addSection(AIRich.newLayout('Single', {
    media: {
      url: 'https://mmg.whatsapp.net/v/t62.7161-24/....enc?ccb=11-4&...&mms3=true',
      mime_type: 'video/mp4',
      width: 464,
      height: 832,
      file_length: 3841724,
      duration: 12
    },
    imagine_type: 'ANIMATE',
    status: { status: 'READY' },
    thumbnail: {
      raw_media: Buffer.from(await m.quoted.download()).toString('base64') // wajib base64, max 4kb
    },
    __typename: 'GenAIImaginePrimitive'
  }))
  .send(m.chat);

Image primitive (GenAIImaginePrimitive, IMAGE):

await new AIRich(conn)
  .addSection(AIRich.newLayout('Single', {
    media: {
      url: 'https://example.com/image.png',
      mime_type: 'image/png'
    },
    imagine_type: 'IMAGE',
    status: { status: 'READY' },
    __typename: 'GenAIImaginePrimitive'
  }))
  .send(m.chat);

Product carousel (GenAIProductItemCardPrimitive in ActionRow grid):

await new AIRich(conn)
  .addSection(Array(3).fill(
    AIRich.newLayout('ActionRow', Array(3).fill({
      title: 'Fiora Sylvie',
      brand: 'Nixel',
      price: 'Rp 1.000',
      sale_price: 'Rp 0',
      product_url: 'https://wa.me/6285188349341',
      image: { url: 'https://cdn.example.com/fiora.jpg' },
      additional_images: [],
      __typename: 'GenAIProductItemCardPrimitive'
    }))
  ))
  .send(m.chat);

AIRich Static Helpers

| Helper | Description | | ------ | ----------- | | AIRich.newLayout(name, data) | Build a GenAI{name}LayoutViewModel (Single / HScroll / ActionRow) | | AIRich.tokenizer(code, lang) | Tokenize code for unified_codeBlock / codeBlock | | AIRich.toTableMetadata(arr) | Convert a nested string array into table metadata (title, rows, unified_rows) |

GenAI Primitive Reference

| __typename | Layout | Notes | | ------------ | ------ | ----- | | GenAIMarkdownTextUXPrimitive | Single | Markdown text with inline entities | | GenAICodeUXPrimitive | Single | Code block with language + code_blocks | | GenATableUXPrimitive | Single | Table rendered from rows | | GenAIImaginePrimitive | Single | Image (IMAGE) or animated video (ANIMATE) | | GenAIProductItemCardPrimitive | Single / HScroll / ActionRow | Product card with image, price, sale_price | | GenAIReelPrimitive | HScroll | Reels-style horizontal scroll | | GenAIPostPrimitive | HScroll | Social-media style post card | | GenAIFollowUpSuggestionPillPrimitive | ActionRow | Suggested reply pills | | GenAIMetadataTextPrimitive | Single | Small metadata text (footer/tip) | | GenAISearchResultPrimitive | Single | Search result with sources + favicon | | GenAIInlineLinkItem | inline_entities | Markdown link entity | | GenAISearchCitationItem | inline_entities | Citation reference entity | | GenAILatexItem | inline_entities | LaTeX expression entity |

Chainable Setters

| Method | Description | | ------ | ----------- | | .setTitle(s) | Bot disclaimer text | | .setBody(s) | Body text | | .setFooter(s) | Appended as a GenAIMetadataTextPrimitive section | | .setContextInfo(obj) | Custom contextInfo | | .addPayload(obj) | Extra fields merged at root level | | .addSubmessage(obj) | Append a raw submessage | | .addSection(layout) | Append a layout produced by newLayout | | .send(jid, opts) | Build + relay message. Accepts { forwarded, includesUnifiedResponse, includesSubmessages, quoted } |

AI Rich Response Messages

Send messages styled like Meta AI -- tables, code blocks, rich text, and links.

Table V1

await sock.sendTable(
  jid,
  'Language Comparison',
  ['Feature', 'Java', 'JavaScript'],
  [
    ['Type', 'Compiled', 'Interpreted'],
    ['Typing', 'Static', 'Dynamic'],
    ['Main Use', 'Enterprise', 'Web/Full-stack']
  ],
  quoted,
  { headerText: 'Comparison:', footer: 'Reference' }
);

Table V2 (Unified Response)

await sock.sendTableV2(
  jid,
  [
    'Language Comparison',
    'Feature | Java | JavaScript',
    'Type | Compiled | Interpreted;;Typing | Static | Dynamic'
  ],
  quoted,
  { headerText: 'Comparison:', text: 'See below:', footer: 'Reference' }
);

List

await sock.sendList(
  jid,
  'Bot Info',
  [
    ['Name', 'Arslan-MD'],
    ['Version', '1.1.0'],
    ['Based on', 'Baileys v7.0.0-rc13']
  ],
  quoted,
  { footer: 'Arslan-MD' }
);

Code Block V1

await sock.sendCodeBlock(
  jid,
  `function hello(name) {
  return "Hello " + name
}
hello("World")`,
  quoted,
  { language: 'javascript', title: 'Example Code', footer: 'Arslan-MD' }
);

Code Block V2 (Unified Response)

Supports syntax highlighting for JavaScript, TypeScript, Python, Go, Lua, Bash.

await sock.sendCodeBlockV2(
  jid,
  `package main
import "fmt"
func main() {
    fmt.Println("Hello, World!")
}`,
  quoted,
  { language: 'go', title: 'Go Example', text: 'A simple Go program:', footer: 'Arslan-MD' }
);

Code Highlight Types

| Code | Name | Description | | ---- | ---- | ----------- | | 0 | DEFAULT | Normal text, whitespace, operators | | 1 | KEYWORD | Language keywords (const, func, if, etc.) | | 2 | METHOD | Function/method calls (identifier followed by () | | 3 | STRING | String literals ("...", '...', `...`) | | 4 | NUMBER | Numeric values (int, float, hex, binary, octal) | | 5 | COMMENT | Comments (//, /* */, #) |

Link Message

await sock.sendLink(
  jid,
  'Results:\nLink 1: {{IE_0}}click here{{/IE_0}}\nLink 2: {{IE_1}}click here{{/IE_1}}',
  ['https://example.com/1', 'https://example.com/2'],
  quoted,
  {
    headerText: 'Search Results',
    footer: 'Arslan-MD',
    citations: [
      { sourceTitle: 'Source 1', citationNumber: 1 },
      { sourceTitle: 'Source 2', citationNumber: 2 }
    ]
  }
);

SubMessage Types Reference

| messageType | Name | Payload Field | Description | | ----------- | ---- | ------------- | ----------- | | 0 | UNKNOWN | -- | Unknown/empty submessage | | 1 | GRID_IMAGE | gridImageMetadata | Grid layout of images | | 2 | TEXT | messageText | Plain text content | | 3 | INLINE_IMAGE | imageMetadata | Inline image with URL and alignment | | 4 | TABLE | tableMetadata | Table with rows and headings | | 5 | CODE | codeMetadata | Code block with syntax highlighting | | 6 | DYNAMIC | dynamicMetadata | Dynamic/loading content | | 7 | MAP | mapMetadata | Map with annotations | | 8 | LATEX | latexMetadata | LaTeX math expressions | | 9 | CONTENT_ITEMS | contentItemsMetadata | Content items/cards |

Rich Message (Custom Submessages)

await sock.sendRichMessage(
  jid,
  [
    { messageType: 2, messageText: 'Header text' },
    {
      messageType: 4,
      tableMetadata: {
        title: 'Stats',
        rows: [
          { items: ['Metric', 'Value'], isHeading: true },
          { items: ['Users', '1000'] },
          { items: ['Uptime', '99.9%'] }
        ]
      }
    },
    {
      messageType: 5,
      codeMetadata: {
        codeLanguage: 'javascript',
        codeBlocks: [
          { highlightType: 1, codeContent: 'const ' },
          { highlightType: 0, codeContent: 'msg = ' },
          { highlightType: 3, codeContent: '"hello"' },
          { highlightType: 0, codeContent: ';' }
        ]
      }
    },
    { messageType: 2, messageText: 'Footer text' }
  ],
  quoted
);

Capture & Resend Unified Response

const captured = sock.captureUnifiedResponse(msg);
if (captured) {
  await sock.sendUnifiedResponse(jid, quoted, captured);
}

Newsletter API

Full newsletter management via MEX GraphQL queries and direct protocol nodes. All methods are available on the socket object.

Management

Create Newsletter:

const result = await sock.newsletterCreate('My Channel', 'Channel description');
// { id, name, creation_time, description, invite, subscribers, verification, picture, mute_state }

Get Metadata:

// By invite code
const meta = await sock.newsletterMetadata('invite', 'abc123');
// By newsletter ID
const meta = await sock.newsletterMetadata('id', '1234567890@newsletter');

Get Subscribers Count:

const count = await sock.newsletterSubscribers('1234567890@newsletter');

Delete Newsletter:

await sock.newsletterDelete('1234567890@newsletter');

Follow / Unfollow / Mute

await sock.newsletterFollow('1234567890@newsletter');
await sock.newsletterUnfollow('1234567890@newsletter');
await sock.newsletterMute('1234567890@newsletter');
await sock.newsletterUnmute('1234567890@newsletter');

Settings

await sock.newsletterUpdateName('1234567890@newsletter', 'New Name');
await sock.newsletterUpdateDescription('1234567890@newsletter', 'New description');
await sock.newsletterUpdatePicture('1234567890@newsletter', { url: './photo.jpg' });
await sock.newsletterRemovePicture('1234567890@newsletter');

Messaging

Send Message:

await sock.sendMessage('1234567890@newsletter', { text: 'Hello subscribers!' });

React to Message:

await sock.newsletterReactMessage('1234567890@newsletter', serverId, '\u2764\uFE0F');
await sock.newsletterReactMessage('1234567890@newsletter', serverId, null); // remove reaction

Fetch Messages:

const messages = await sock.newsletterFetchMessages('1234567890@newsletter', 10);
const older = await sock.newsletterFetchMessages('1234567890@newsletter', 10, sinceTimestamp);
const after = await sock.newsletterFetchMessages('1234567890@newsletter', 10, undefined, afterServerId);

Subscribe to Live Updates:

const result = await sock.subscribeNewsletterUpdates('1234567890@newsletter');
// { duration } or null

Admin

const count = await sock.newsletterAdminCount('1234567890@newsletter');
await sock.newsletterChangeOwner('1234567890@newsletter', '[email protected]');
await sock.newsletterDemote('1234567890@newsletter', '[email protected]');

Events

| Event | Payload | Description | |-------|---------|-------------| | newsletter.reaction | { id, server_id, reaction: { code, count } } | Newsletter message reaction | | newsletter.view | { id, server_id, count } | Newsletter view count | | newsletter-settings.update | { id, update: { name?, description? } } | Newsletter settings changed | | newsletter-participants.update | { id, author, user, action, new_role } | Admin promote/demote |

Community API

Create Community

const community = await sock.communityCreate('My Community', { description: '...' });

Create Sub-group in Community

const group = await sock.communityCreateGroup(communityId, 'Sub Group');

Link / Unlink Sub-group

await sock.communityLinkSubGroup(communityId, subgroupJid);
await sock.communityUnlinkSubGroup(communityId, subgroupJid);

Leave Community

await sock.communityLeave(communityId);

Membership Approval

await sock.communityAcceptRequest(communityId, requesterJid);
await sock.communityRejectRequest(communityId, requesterJid);

Invite Codes

const code = await sock.communityInviteCode(communityId);
await sock.communityRevokeInviteCode(communityId);

Socket Architecture

Each socket layer extends the previous via composition:

makeSocket -> WebSocket + Noise protocol + pre-key management
  makeChatsSocket -> App state sync + chat modifications + profile
    makeGroupsSocket -> Group CRUD + participant management
      makeNewsletterSocket -> Newsletter follow/unfollow/metadata
        makeMessagesSendSocket -> Message sending + relay + MessageBuilders
          makeMessagesRecvSocket -> Message receiving + decryption + retry
            makeBusinessSocket -> Product catalog + business profile
              makeCommunitiesSocket -> Community CRUD + sub-groups
                makeWASocket <- Top-level export

Differences from Official Baileys

Feature comparison between Arslan-MD/baileys and Official Baileys (@whiskeysockets/baileys v7).

All features below were verified from the source code.

| # | Feature | Official | Arslan-MD | Source Reference | |---|---------|:-------:|:-----:|------------------| | 1 | Text / Image / Video / Audio / Sticker / Document | Yes | Yes | Standard message types | | 2 | Location / Contact / Reaction / Poll | Yes | Yes | Standard message types | | 3 | Edit / Delete / Forward Message | Yes | Yes | Standard message types | | 4 | Group CRUD + Participant Management | Yes | Yes | Socket/groups.js | | 5 | Community CRUD + Sub-groups | Yes | Yes | Socket/communities.js | | 6 | Newsletter Follow / Unfollow / Metadata | Yes | Yes | Socket/newsletter.js | | 7 | Business Profile & Product Catalog | Yes | Yes | Socket/business.js | | 8 | App State Sync + Chat Modifications | Yes | Yes | Socket/chats.js | | 9 | WebSocket + Noise Protocol + Pre-key | Yes | Yes | Socket/socket.js | | 10 | Native Flow Buttons (interactiveMessage) | No | Yes | Socket/messages-send.js:1155 | | 11 | List Menu (single_select) | No | Yes | Socket/messages-send.js:1155 | | 12 | Carousel Message | No | Yes | Socket/messages-send.js:1155 | | 13 | Album Message (multi media) | No | Yes | Utils/messages.js:465-470 | | 14 | AI Rich Response -- Table V1 / V2 | No | Yes | Utils/rich-messages.js:158-227 | | 15 | AI Rich Response -- Code Block V1 / V2 | No | Yes | Utils/rich-messages.js:180-244 | | 16 | AI Rich Response -- Link Message | No | Yes | Utils/rich-messages.js:246-300 | | 17 | AI Rich Response -- List Info | No | Yes | Utils/rich-messages.js:169-178 | | 18 | AI Rich Response -- Rich Message (Custom Submessages) | No | Yes | Utils/rich-messages.js:190-193 | | 19 | Latex Rendering (RichSubMessageType) | No | Yes | Utils/rich-messages.js:35 | | 20 | Event Message + Encrypted Response | No | Yes | Utils/messages.js:410-429, Utils/process-message.js:362-408 | | 21 | Poll Result Message | No | Yes | Socket/message-builders.js | | 22 | Poll Creation V3 (single-select) | No | Yes | Utils/messages.js:455-462 | | 23 | Product Message (viewOnce + interactive) | No | Yes | Socket/message-builders.js | | 24 | Payment Request | No | Yes | Socket/message-builders.js | | 25 | Group Status Message / V2 | No | Yes | Utils/messages.js:657-658, Socket/message-builders.js | | 26 | Status Mentions (proto field) | No | Yes | WAProto/WAProto.proto:5222 | | 27 | Button Features (limited time offer, bottom sheet, tap target) | No | Yes | Socket/messages-send.js:16-22 | | 28 | Business Metadata Nodes for Buttons (ported from ourin-baileys) | No | Yes | WABinary/generic-utils.js:137-190, Socket/messages-send.js:24-35,944-948 | | 29 | Capture & Resend Unified Response | No | Yes | Utils/rich-messages.js:302-313 | | 30 | Forwarded AI Bot Info (Meta AI style) | No | Yes | Utils/rich-messages.js:142-150 | | 31 | Full LID <-> PN Mapping System | No | Yes | Signal/lid-mapping.js, WAUSync/Protocols/UsyncLIDProtocol.js | | 32 | LID Session Migration | No | Yes | Signal/libsignal.js:237-351 | | 33 | LID/PN Dual Addressing | No | Yes | Utils/decode-wa-message.js:60-78 | | 34 | MessageRetryManager (base key collision detection) | No | Yes | Utils/message-retry-manager.js | | 35 | Newsletter Create + Delete via MEX GraphQL | No | Yes | Socket/newsletter.js, Socket/mex.js | | 36 | Newsletter Admin (Change Owner, Demote, Admin Count) | No | Yes | Socket/newsletter.js | | 37 | Newsletter Settings (Name, Description, Picture, Mute) | No | Yes | Socket/newsletter.js | | 38 | Newsletter React + Fetch Messages | No | Yes | Socket/newsletter.js:106 | | 39 | Newsletter Live Updates Subscription | No | Yes | Socket/newsletter.js:151 | | 40 | Newsletter Subscribers Count | No | Yes | Socket/newsletter.js:65 | | 41 | Newsletter Media (Image/Video/Audio) | No | Yes | Utils/messages-media.js:648, Utils/messages.js:132-181, Socket/messages-send.js:647-649 | | 42 | Group Member Labeling | No | Yes | Socket/messages-send.js:135-156 | | 43 | On-demand History Sync | No | Yes | Socket/messages-recv.js:47-64 | | 44 | Media Re-upload (updateMediaMessage) | No | Yes | Socket/messages-send.js:1104-1150 | | 45 | Peer Data Operation Messages | No | Yes | Socket/messages-send.js:374-402 | | 46 | Reporting Token System | No | Yes | Utils/reporting-utils.js | | 47 | TC Token System (Trusted Contact) | No | Yes | Utils/tc-token-utils.js | | 48 | Privacy Token Handling | No | Yes | Socket/messages-recv.js:1084-1104 | | 49 | Reachout Timelock Enforcement | No | Yes | Types/State.js:10-29, Socket/messages-recv.js:175-211 | | 50 | Message Capping System | No | Yes | Socket/messages-recv.js:213-223 | | 51 | Identity Change Handler | No | Yes | Utils/identity-change-handler.js | | 52 | WAM Analytics/Metrics Encoding | No | Yes | WAM/ (BinaryInfo, encode, constants) | | 53 | Bot Profile USync Protocol | No | Yes | WAUSync/Protocols/UsyncBotProfileProtocol.js | | 54 | Status WhatsApp with Mentions | No | Yes | Socket/message-builders.js | | 55 | MessageBuilders System (auto type routing) | No | Yes | Socket/message-builders.js | | 56 | Chainable MessageBuilder v4.5 (Button / ButtonV2 / Carousel / AIRich) | No | Yes | Builders/index.js | | 57 | AIRich GenAI Primitives (Imagine ANIMATE/IMAGE, Product, Reel, Post, etc.) | No | Yes | Builders/index.js | | 58 | Spoofed self-only protocolMessage drop (rc12 security patch) | rc12+ | Yes | Utils/process-message.js | | 59 | Peer-routed self stanza fromMe detection (rc13 fix) | rc13+ | Yes | Utils/decode-wa-message.js | | 60 | Native fetch dispatcher guard (rc13 fix) | rc13+ | Yes | Utils/messages-media.js | | 61 | Group online count (presence) | rc11+ | Yes | Socket/chats.js, Types/Chat.js |

[!IMPORTANT] Official Baileys refers to the original @whiskeysockets/baileys v7. Arslan-MD/baileys is a fork that extends the original with 40+ additional features including interactive messages, album messages, AI rich response system, full LID mapping, event messages, payment support, newsletter GraphQL API, retry manager, MessageBuilders system, business metadata nodes for buttons (ported from ourin-baileys), the v4.5 chainable MessageBuilder (Button/ButtonV2/Carousel/AIRich), and various security/privacy systems. All features listed above are verified from the source code.

v1.1.0 (rc13 upgrade): Codebase synced with upstream @whiskeysockets/baileys v7.0.0-rc13. Includes the rc12 security patch (self-only protocolMessage drop for spoofed HISTORY_SYNC_NOTIFICATION / APP_STATE_SYNC_KEY_SHARE / LID_MIGRATION_MAPPING_SYNC / PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE), rc13 fromMe detection for peer-routed self stanzas, and rc13 native-fetch dispatcher guard. libsignal is now pulled from npm (^6.0.0) instead of the GitHub mirror, matching upstream rc13.

v1.1.0 (MessageBuilder v4.5): Adds class-based chainable builders — Button, ButtonV2, Carousel, AIRich — with the full set of GenAI primitives (Imagine ANIMATE/IMAGE, Product, Reel, Post, FollowUpSuggestion, Metadata, SearchResult, Markdown, Table, Code). AIRich.newLayout(name, data) lets you craft GenAISingleLayoutViewModel, GenAIHScrollLayoutViewModel, or GenAIActionRowLayoutViewModel payloads directly. Payloads are encoded into botForwardedMessage.message.richResponseMessage.unifiedResponse.data as base64 JSON.

Newsletter Media Fix: Image, video, and audio messages to newsletters now work correctly. Media uploads use the proper WhatsApp newsletter path (/newsletter/newsletter- instead of /mms/), include required mediatype attributes in the protocol node, and generate necessary metadata (thumbnails, duration, waveforms). Edit/delete operations on newsletters also use the correct edit values.