From 7c052c6621f8150b0caf2d5776ac948f8cf282ea Mon Sep 17 00:00:00 2001 From: Rajeh Taher Date: Thu, 6 Mar 2025 04:39:08 +0200 Subject: [PATCH] readme update --- LICENSE | 2 +- Media/logo.png | Bin 0 -> 108875 bytes README.md | 1300 ++---------------------------------------------- 3 files changed, 34 insertions(+), 1268 deletions(-) create mode 100644 Media/logo.png diff --git a/LICENSE b/LICENSE index 542a2c7..bb2580d 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2023 WhiskeySockets +Copyright (c) 2023 Rajeh Taher/WhiskeySockets Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/Media/logo.png b/Media/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..6ce8cbd445631951bb7896149068714ad402faf6 GIT binary patch literal 108875 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%0D}} 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 literal 0 HcmV?d00001 diff --git a/README.md b/README.md index b4c7f48..196f494 100644 --- a/README.md +++ b/README.md @@ -1,1276 +1,42 @@ -#
Baileys - Typescript/Javascript WhatsApp Web API
- +

Baileys

- -![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/whiskeysockets/baileys/total) ![NPM Downloads](https://img.shields.io/npm/dw/%40whiskeysockets%2Fbaileys?label=npm&color=%23CB3837) ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/whiskeysockets/baileys) -![GitHub License](https://img.shields.io/github/license/whiskeysockets/baileys) ![Discord](https://img.shields.io/discord/725839806084546610?label=discord&color=%235865F2) -![GitHub Repo stars](https://img.shields.io/github/stars/whiskeysockets/baileys) -![GitHub forks](https://img.shields.io/github/forks/whiskeysockets/baileys) -
-### Important Note +A Websockets-based TypeScript library for interacting with the WhatsApp Web API. -This library was originally a project for **CS-2362 at Ashoka University** and is in no way affiliated with or endorsed by WhatsApp. Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage. +## Usage +All major documentation is hosted at the guide https://guide.whiskeysockets.io, TypeDoc available at https://baileys.whiskeysockets.io + +# 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. -#### Liability and License Notice -Baileys and its maintainers cannot be held liable for misuse of this application, as stated in the [MIT license](https://github.com/WhiskeySockets/Baileys/blob/master/LICENSE). The maintainers of Baileys 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. -## - -- Baileys does not require Selenium or any other browser to be interface with WhatsApp Web, it does so directly using a **WebSocket**. -- Not running Selenium or Chromimum saves you like **half a gig** of ram :/ -- Baileys supports interacting with the multi-device & web versions of WhatsApp. -- Thank you to [@pokearaujo](https://github.com/pokearaujo/multidevice) for writing his observations on the workings of WhatsApp Multi-Device. Also, thank you to [@Sigalor](https://github.com/sigalor/whatsapp-web-reveng) for writing his observations on the workings of WhatsApp Web and thanks to [@Rhymen](https://github.com/Rhymen/go-whatsapp/) for the __go__ implementation. - -> [!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. -> **Join the Discord [here](https://discord.gg/WeJM5FP9GG)** - -## Example - -Do check out & run [example.ts](Example/example.ts) to see an example usage of the library. -The script covers most common use cases. -To run the example script, download or clone the repo and then type the following in a terminal: -1. ``` cd path/to/Baileys ``` -2. ``` yarn ``` -3. ``` yarn example ``` - -## Install - -Use the stable version: -``` -yarn add baileys -``` - -Use the edge version (no guarantee of stability, but latest fixes + features) -``` -yarn add github:WhiskeySockets/Baileys -``` - -Then import the default function in your code: -```ts -import makeWASocket from 'baileys' -``` - -# Links - -- [Discord](https://discord.gg/WeJM5FP9GG) -- [Docs](https://guide.whiskeysockets.io/) - -# Index - -- [Connecting Account](#connecting-account) - - [Connect with QR-CODE](#starting-socket-with-qr-code) - - [Connect with Pairing Code](#starting-socket-with-pairing-code) - - [Receive Full History](#receive-full-history) -- [Important Notes About Socket Config](#important-notes-about-socket-config) - - [Caching Group Metadata (Recommended)](#caching-group-metadata-recommended) - - [Improve Retry System & Decrypt Poll Votes](#improve-retry-system--decrypt-poll-votes) - - [Receive Notifications in Whatsapp App](#receive-notifications-in-whatsapp-app) - -- [Save Auth Info](#saving--restoring-sessions) -- [Handling Events](#handling-events) - - [Example to Start](#example-to-start) - - [Decrypt Poll Votes](#decrypt-poll-votes) - - [Summary of Events on First Connection](#summary-of-events-on-first-connection) -- [Implementing a Data Store](#implementing-a-data-store) -- [Whatsapp IDs Explain](#whatsapp-ids-explain) -- [Utility Functions](#utility-functions) -- [Sending Messages](#sending-messages) - - [Non-Media Messages](#non-media-messages) - - [Text Message](#text-message) - - [Quote Message](#quote-message-works-with-all-types) - - [Mention User](#mention-user-works-with-most-types) - - [Forward Messages](#forward-messages) - - [Location Message](#location-message) - - [Contact Message](#contact-message) - - [Reaction Message](#reaction-message) - - [Pin Message](#pin-message) - - [Poll Message](#poll-message) - - [Sending with Link Preview](#sending-messages-with-link-previews) - - [Media Messages](#media-messages) - - [Gif Message](#gif-message) - - [Video Message](#video-message) - - [Audio Message](#audio-message) - - [Image Message](#image-message) - - [ViewOnce Message](#view-once-message) -- [Modify Messages](#modify-messages) - - [Delete Messages (for everyone)](#deleting-messages-for-everyone) - - [Edit Messages](#editing-messages) -- [Manipulating Media Messages](#manipulating-media-messages) - - [Thumbnail in Media Messages](#thumbnail-in-media-messages) - - [Downloading Media Messages](#downloading-media-messages) - - [Re-upload Media Message to Whatsapp](#re-upload-media-message-to-whatsapp) -- [Reject Call](#reject-call) -- [Send States in Chat](#send-states-in-chat) - - [Reading Messages](#reading-messages) - - [Update Presence](#update-presence) -- [Modifying Chats](#modifying-chats) - - [Archive a Chat](#archive-a-chat) - - [Mute/Unmute a Chat](#muteunmute-a-chat) - - [Mark a Chat Read/Unread](#mark-a-chat-readunread) - - [Delete a Message for Me](#delete-a-message-for-me) - - [Delete a Chat](#delete-a-chat) - - [Star/Unstar a Message](#starunstar-a-message) - - [Disappearing Messages](#disappearing-messages) -- [User Querys](#user-querys) - - [Check If ID Exists in Whatsapp](#check-if-id-exists-in-whatsapp) - - [Query Chat History (groups too)](#query-chat-history-groups-too) - - [Fetch Status](#fetch-status) - - [Fetch Profile Picture (groups too)](#fetch-profile-picture-groups-too) - - [Fetch Bussines Profile (such as description or category)](#fetch-bussines-profile-such-as-description-or-category) - - [Fetch Someone's Presence (if they're typing or online)](#fetch-someones-presence-if-theyre-typing-or-online) -- [Change Profile](#change-profile) - - [Change Profile Status](#change-profile-status) - - [Change Profile Name](#change-profile-name) - - [Change Display Picture (groups too)](#change-display-picture-groups-too) - - [Remove display picture (groups too)](#remove-display-picture-groups-too) -- [Groups](#groups) - - [Create a Group](#create-a-group) - - [Add/Remove or Demote/Promote](#addremove-or-demotepromote) - - [Change Subject (name)](#change-subject-name) - - [Change Description](#change-description) - - [Change Settings](#change-settings) - - [Leave a Group](#leave-a-group) - - [Get Invite Code](#get-invite-code) - - [Revoke Invite Code](#revoke-invite-code) - - [Join Using Invitation Code](#join-using-invitation-code) - - [Get Group Info by Invite Code](#get-group-info-by-invite-code) - - [Query Metadata (participants, name, description...)](#query-metadata-participants-name-description) - - [Join using groupInviteMessage](#join-using-groupinvitemessage) - - [Get Request Join List](#get-request-join-list) - - [Approve/Reject Request Join](#approvereject-request-join) - - [Get All Participating Groups Metadata](#get-all-participating-groups-metadata) - - [Toggle Ephemeral](#toggle-ephemeral) - - [Change Add Mode](#change-add-mode) -- [Privacy](#privacy) - - [Block/Unblock User](#blockunblock-user) - - [Get Privacy Settings](#get-privacy-settings) - - [Get BlockList](#get-blocklist) - - [Update LastSeen Privacy](#update-lastseen-privacy) - - [Update Online Privacy](#update-online-privacy) - - [Update Profile Picture Privacy](#update-profile-picture-privacy) - - [Update Status Privacy](#update-status-privacy) - - [Update Read Receipts Privacy](#update-read-receipts-privacy) - - [Update Groups Add Privacy](#update-groups-add-privacy) - - [Update Default Disappearing Mode](#update-default-disappearing-mode) -- [Broadcast Lists & Stories](#broadcast-lists--stories) - - [Send Broadcast & Stories](#send-broadcast--stories) - - [Query a Broadcast List's Recipients & Name](#query-a-broadcast-lists-recipients--name) -- [Writing Custom Functionality](#writing-custom-functionality) - - [Enabling Debug Level in Baileys Logs](#enabling-debug-level-in-baileys-logs) - - [How Whatsapp Communicate With Us](#how-whatsapp-communicate-with-us) - - [Register a Callback for Websocket Events](#register-a-callback-for-websocket-events) - -## Connecting Account - -WhatsApp provides a multi-device API that allows Baileys to be authenticated as a second WhatsApp client by scanning a **QR code** or **Pairing Code** with WhatsApp on your phone. - -> [!NOTE] -> **[Here](#example-to-start) is a simple example of event handling** - -> [!TIP] -> **You can see all supported socket configs [here](https://baileys.whiskeysockets.io/types/SocketConfig.html) (Recommended)** - -### Starting socket with **QR-CODE** - -> [!TIP] -> You can customize browser name if you connect with **QR-CODE**, with `Browser` constant, we have some browsers config, **see [here](https://baileys.whiskeysockets.io/types/BrowsersMap.html)** - -```ts -import makeWASocket from 'baileys' - -const sock = makeWASocket({ - // can provide additional config here - browser: Browsers.ubuntu('My App'), - printQRInTerminal: true -}) -``` - -If the connection is successful, you will see a QR code printed on your terminal screen, scan it with WhatsApp on your phone and you'll be logged in! - -### Starting socket with **Pairing Code** - - -> [!IMPORTANT] -> Pairing Code isn't Mobile API, it's a method to connect Whatsapp Web without QR-CODE, you can connect only with one device, see [here](https://faq.whatsapp.com/1324084875126592/?cms_platform=web) - -The phone number can't have `+` or `()` or `-`, only numbers, you must provide country code - -```ts -import makeWASocket from 'baileys' - -const sock = makeWASocket({ - // can provide additional config here - printQRInTerminal: false //need to be false -}) -// NOTE: WAIT TILL QR EVENT BEFORE REQUESTING THE PAIRING CODE -if (!sock.authState.creds.registered) { - const number = 'XXXXXXXXXXX' - const code = await sock.requestPairingCode(number) - console.log(code) -} -``` - -### Receive Full History - -1. Set `syncFullHistory` as `true` -2. Baileys, by default, use chrome browser config - - If you'd like to emulate a desktop connection (and receive more message history), this browser setting to your Socket config: - -```ts -const sock = makeWASocket({ - ...otherOpts, - // can use Windows, Ubuntu here too - browser: Browsers.macOS('Desktop'), - syncFullHistory: true -}) -``` - -## Important Notes About Socket Config - -### Caching Group Metadata (Recommended) -- If you use baileys for groups, we recommend you to set `cachedGroupMetadata` in socket config, you need to implement a cache like this: - - ```ts - const groupCache = new NodeCache({stdTTL: 5 * 60, useClones: false}) - - const sock = makeWASocket({ - cachedGroupMetadata: async (jid) => groupCache.get(jid) - }) - - sock.ev.on('groups.update', async ([event]) => { - const metadata = await sock.groupMetadata(event.id) - groupCache.set(event.id, metadata) - }) - - sock.ev.on('group-participants.update', async (event) => { - const metadata = await sock.groupMetadata(event.id) - groupCache.set(event.id, metadata) - }) - ``` - -### Improve Retry System & Decrypt Poll Votes -- If you want to improve sending message, retrying when error occurs and decrypt poll votes, you need to have a store and set `getMessage` config in socket like this: - ```ts - const sock = makeWASocket({ - getMessage: async (key) => await getMessageFromStore(key) - }) - ``` - -### Receive Notifications in Whatsapp App -- If you want to receive notifications in whatsapp app, set `markOnlineOnConnect` to `false` - ```ts - const sock = makeWASocket({ - markOnlineOnConnect: false - }) - ``` -## Saving & Restoring Sessions - -You obviously don't want to keep scanning the QR code every time you want to connect. - -So, you can load the credentials to log back in: -```ts -import makeWASocket, { useMultiFileAuthState } from 'baileys' - -const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys') - -// will use the given state to connect -// so if valid credentials are available -- it'll connect without QR -const sock = makeWASocket({ auth: state }) - -// this will be called as soon as the credentials are updated -sock.ev.on('creds.update', saveCreds) -``` - -> [!IMPORTANT] -> `useMultiFileAuthState` is a utility function to help save the auth state in a single folder, this function serves as a good guide to help write auth & key states for SQL/no-SQL databases, which I would recommend in any production grade system. - -> [!NOTE] -> When a message is received/sent, due to signal sessions needing updating, the auth keys (`authState.keys`) will update. Whenever that happens, you must save the updated keys (`authState.keys.set()` is called). Not doing so will prevent your messages from reaching the recipient & cause other unexpected consequences. The `useMultiFileAuthState` function automatically takes care of that, but for any other serious implementation -- you will need to be very careful with the key state management. - -## Handling Events - -- Baileys uses the EventEmitter syntax for events. -They're all nicely typed up, so you shouldn't have any issues with an Intellisense editor like VS Code. - -> [!IMPORTANT] -> **The events are [these](https://baileys.whiskeysockets.io/types/BaileysEventMap.html)**, it's important you see all events - -You can listen to these events like this: -```ts -const sock = makeWASocket() -sock.ev.on('messages.upsert', ({ messages }) => { - console.log('got messages', messages) -}) -``` - -### Example to Start - -> [!NOTE] -> This example includes basic auth storage too - -```ts -import makeWASocket, { DisconnectReason, useMultiFileAuthState } from 'baileys' -import { Boom } from '@hapi/boom' - -async function connectToWhatsApp () { - const { state, saveCreds } = await useMultiFileAuthState('auth_info_baileys') - const sock = makeWASocket({ - // can provide additional config here - auth: state, - printQRInTerminal: true - }) - sock.ev.on('connection.update', (update) => { - const { connection, lastDisconnect } = update - if(connection === 'close') { - const shouldReconnect = (lastDisconnect.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut - console.log('connection closed due to ', lastDisconnect.error, ', reconnecting ', shouldReconnect) - // reconnect if not logged out - if(shouldReconnect) { - connectToWhatsApp() - } - } else if(connection === 'open') { - console.log('opened connection') - } - }) - sock.ev.on('messages.upsert', event => { - for (const m of event.messages) { - console.log(JSON.stringify(m, undefined, 2)) - - console.log('replying to', m.key.remoteJid) - await sock.sendMessage(m.key.remoteJid!, { text: 'Hello Word' }) - } - }) - - // to storage creds (session info) when it updates - sock.ev.on('creds.update', saveCreds) -} -// run in main file -connectToWhatsApp() -``` - -> [!IMPORTANT] -> In `messages.upsert` it's recommended to use a loop like `for (const message of event.messages)` to handle all messages in array - -### Decrypt Poll Votes - -- By default poll votes are encrypted and handled in `messages.update` -- That's a simple example -```ts -sock.ev.on('messages.update', event => { - for(const { key, update } of event) { - if(update.pollUpdates) { - const pollCreation = await getMessage(key) - if(pollCreation) { - console.log( - 'got poll update, aggregation: ', - getAggregateVotesInPollMessage({ - message: pollCreation, - pollUpdates: update.pollUpdates, - }) - ) - } - } - } -}) -``` - -- `getMessage` is a [store](#implementing-a-data-store) implementation (in your end) - -### Summary of Events on First Connection - -1. When you connect first time, `connection.update` will be fired requesting you to restart sock -2. Then, history messages will be received in `messaging-history.set` - -## Implementing a Data Store - -- Baileys does not come with a defacto storage for chats, contacts, or messages. However, a simple in-memory implementation has been provided. The store listens for chat updates, new messages, message updates, etc., to always have an up-to-date version of the data. - -> [!IMPORTANT] -> I highly recommend building your own data store, as storing someone's entire chat history in memory is a terrible waste of RAM. - -It can be used as follows: - -```ts -import makeWASocket, { makeInMemoryStore } from 'baileys' -// the store maintains the data of the WA connection in memory -// can be written out to a file & read from it -const store = makeInMemoryStore({ }) -// can be read from a file -store.readFromFile('./baileys_store.json') -// saves the state to a file every 10s -setInterval(() => { - store.writeToFile('./baileys_store.json') -}, 10_000) - -const sock = makeWASocket({ }) -// will listen from this socket -// the store can listen from a new socket once the current socket outlives its lifetime -store.bind(sock.ev) - -sock.ev.on('chats.upsert', () => { - // can use 'store.chats' however you want, even after the socket dies out - // 'chats' => a KeyedDB instance - console.log('got chats', store.chats.all()) -}) - -sock.ev.on('contacts.upsert', () => { - console.log('got contacts', Object.values(store.contacts)) -}) - -``` - -The store also provides some simple functions such as `loadMessages` that utilize the store to speed up data retrieval. - -## Whatsapp IDs Explain - -- `id` is the WhatsApp ID, called `jid` too, of the person or group you're sending the message to. - - It must be in the format ```[country code][phone number]@s.whatsapp.net``` - - Example for people: ```+19999999999@s.whatsapp.net```. - - For groups, it must be in the format ``` 123456789-123345@g.us ```. - - For broadcast lists, it's `[timestamp of creation]@broadcast`. - - For stories, the ID is `status@broadcast`. - -## Utility Functions - -- `getContentType`, returns the content type for any message -- `getDevice`, returns the device from message -- `makeCacheableSignalKeyStore`, make auth store more fast -- `downloadContentFromMessage`, download content from any message - -## Sending Messages - -- Send all types of messages with a single function - - **[Here](https://baileys.whiskeysockets.io/types/AnyMessageContent.html) you can see all message contents supported, like text message** - - **[Here](https://baileys.whiskeysockets.io/types/MiscMessageGenerationOptions.html) you can see all options supported, like quote message** - - ```ts - const jid: string - const content: AnyMessageContent - const options: MiscMessageGenerationOptions - - sock.sendMessage(jid, content, options) - ``` - -### Non-Media Messages - -#### Text Message -```ts -await sock.sendMessage(jid, { text: 'hello word' }) -``` - -#### Quote Message (works with all types) -```ts -await sock.sendMessage(jid, { text: 'hello word' }, { quoted: message }) -``` - -#### Mention User (works with most types) -- @number is to mention in text, it's optional -```ts -await sock.sendMessage( - jid, - { - text: '@12345678901', - mentions: ['12345678901@s.whatsapp.net'] - } -) -``` - -#### Forward Messages -- You need to have message object, can be retrieved from [store](#implementing-a-data-store) or use a [message](https://baileys.whiskeysockets.io/types/WAMessage.html) object -```ts -const msg = getMessageFromStore() // implement this on your end -await sock.sendMessage(jid, { forward: msg }) // WA forward the message! -``` - -#### Location Message -```ts -await sock.sendMessage( - jid, - { - location: { - degreesLatitude: 24.121231, - degreesLongitude: 55.1121221 - } - } -) -``` -#### Contact Message -```ts -const vcard = 'BEGIN:VCARD\n' // metadata of the contact card - + 'VERSION:3.0\n' - + 'FN:Jeff Singh\n' // full name - + 'ORG:Ashoka Uni;\n' // the organization of the contact - + 'TEL;type=CELL;type=VOICE;waid=911234567890:+91 12345 67890\n' // WhatsApp ID + phone number - + 'END:VCARD' - -await sock.sendMessage( - id, - { - contacts: { - displayName: 'Jeff', - contacts: [{ vcard }] - } - } -) -``` - -#### Reaction Message -- You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object -```ts -await sock.sendMessage( - jid, - { - react: { - text: '💖', // use an empty string to remove the reaction - key: message.key - } - } -) -``` - -#### Pin Message -- You need to pass the key of message, you can retrieve from [store](#implementing-a-data-store) or use a [key](https://baileys.whiskeysockets.io/types/WAMessageKey.html) object - -- Time can be: - -| Time | Seconds | -|-------|----------------| -| 24h | 86.400 | -| 7d | 604.800 | -| 30d | 2.592.000 | - -```ts -await sock.sendMessage( - jid, - { - pin: { - type: 1, // 0 to remove - time: 86400 - key: message.key - } - } -) -``` - -#### Poll Message -```ts -await sock.sendMessage( - jid, - { - poll: { - name: 'My Poll', - values: ['Option 1', 'Option 2', ...], - selectableCount: 1, - toAnnouncementGroup: false // or true - } - } -) -``` - -### Sending Messages with Link Previews - -1. By default, wa does not have link generation when sent from the web -2. Baileys has a function to generate the content for these link previews -3. To enable this function's usage, add `link-preview-js` as a dependency to your project with `yarn add link-preview-js` -4. Send a link: -```ts -await sock.sendMessage( - jid, - { - text: 'Hi, this was sent using https://github.com/whiskeysockets/baileys' - } -) -``` - -### Media Messages - -Sending media (video, stickers, images) is easier & more efficient than ever. - -> [!NOTE] -> In media messages, you can pass `{ stream: Stream }` or `{ url: Url }` or `Buffer` directly, you can see more [here](https://baileys.whiskeysockets.io/types/WAMediaUpload.html) - -- When specifying a media url, Baileys never loads the entire buffer into memory; it even encrypts the media as a readable stream. - -> [!TIP] -> It's recommended to use Stream or Url to save memory - -#### Gif Message -- Whatsapp doesn't support `.gif` files, that's why we send gifs as common `.mp4` video with `gifPlayback` flag -```ts -await sock.sendMessage( - jid, - { - video: fs.readFileSync('Media/ma_gif.mp4'), - caption: 'hello word', - gifPlayback: true - } -) -``` - -#### Video Message -```ts -await sock.sendMessage( - id, - { - video: { - url: './Media/ma_gif.mp4' - }, - caption: 'hello word', - ptv: false // if set to true, will send as a `video note` - } -) -``` - -#### Audio Message -- To audio message work in all devices you need to convert with some tool like `ffmpeg` with this flags: - ```bash - codec: libopus //ogg file - ac: 1 //one channel - avoid_negative_ts - make_zero - ``` - - Example: - ```bash - ffmpeg -i input.mp4 -avoid_negative_ts make_zero -ac 1 output.ogg - ``` -```ts -await sock.sendMessage( - jid, - { - audio: { - url: './Media/audio.mp3' - }, - mimetype: 'audio/mp4' - } -) -``` - -#### Image Message -```ts -await sock.sendMessage( - id, - { - image: { - url: './Media/ma_img.png' - }, - caption: 'hello word' - } -) -``` - -#### View Once Message - -- You can send all messages above as `viewOnce`, you only need to pass `viewOnce: true` in content object - -```ts -await sock.sendMessage( - id, - { - image: { - url: './Media/ma_img.png' - }, - viewOnce: true, //works with video, audio too - caption: 'hello word' - } -) -``` - -## Modify Messages - -### Deleting Messages (for everyone) - -```ts -const msg = await sock.sendMessage(jid, { text: 'hello word' }) -await sock.sendMessage(jid, { delete: msg.key }) -``` - -**Note:** deleting for oneself is supported via `chatModify`, see in [this section](#modifying-chats) - -### Editing Messages - -- You can pass all editable contents here -```ts -await sock.sendMessage(jid, { - text: 'updated text goes here', - edit: response.key, - }); -``` - -## Manipulating Media Messages - -### Thumbnail in Media Messages -- For media messages, the thumbnail can be generated automatically for images & stickers provided you add `jimp` or `sharp` as a dependency in your project using `yarn add jimp` or `yarn add sharp`. -- Thumbnails for videos can also be generated automatically, though, you need to have `ffmpeg` installed on your system. - -### Downloading Media Messages - -If you want to save the media you received -```ts -import { createWriteStream } from 'fs' -import { downloadMediaMessage, getContentType } from 'baileys' - -sock.ev.on('messages.upsert', async ({ [m] }) => { - if (!m.message) return // if there is no text or media message - const messageType = getContentType(m) // get what type of message it is (text, image, video...) - - // if the message is an image - if (messageType === 'imageMessage') { - // download the message - const stream = await downloadMediaMessage( - m, - 'stream', // can be 'buffer' too - { }, - { - logger, - // pass this so that baileys can request a reupload of media - // that has been deleted - reuploadRequest: sock.updateMediaMessage - } - ) - // save to file - const writeStream = createWriteStream('./my-download.jpeg') - stream.pipe(writeStream) - } -} -``` - -### Re-upload Media Message to Whatsapp - -- WhatsApp automatically removes old media from their servers. For the device to access said media -- a re-upload is required by another device that has it. This can be accomplished using: -```ts -await sock.updateMediaMessage(msg) -``` - -## Reject Call - -- You can obtain `callId` and `callFrom` from `call` event - -```ts -await sock.rejectCall(callId, callFrom) -``` - -## Send States in Chat - -### Reading Messages -- A set of message [keys](https://baileys.whiskeysockets.io/types/WAMessageKey.html) must be explicitly marked read now. -- You cannot mark an entire 'chat' read as it were with Baileys Web. -This means you have to keep track of unread messages. - -```ts -const key: WAMessageKey -// can pass multiple keys to read multiple messages as well -await sock.readMessages([key]) -``` - -The message ID is the unique identifier of the message that you are marking as read. -On a `WAMessage`, the `messageID` can be accessed using ```messageID = message.key.id```. - -### Update Presence - -- ``` presence ``` can be one of [these](https://baileys.whiskeysockets.io/types/WAPresence.html) -- The presence expires after about 10 seconds. -- This lets the person/group with `jid` know whether you're online, offline, typing etc. - -```ts -await sock.sendPresenceUpdate('available', jid) -``` - -> [!NOTE] -> If a desktop client is active, WA doesn't send push notifications to the device. If you would like to receive said notifications -- mark your Baileys client offline using `sock.sendPresenceUpdate('unavailable')` - -## Modifying Chats - -WA uses an encrypted form of communication to send chat/app updates. This has been implemented mostly and you can send the following updates: - -> [!IMPORTANT] -> If you mess up one of your updates, WA can log you out of all your devices and you'll have to log in again. - -### Archive a Chat -```ts -const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end -await sock.chatModify({ archive: true, lastMessages: [lastMsgInChat] }, jid) -``` -### Mute/Unmute a Chat - -- Supported times: - -| Time | Miliseconds | -|-------|-----------------| -| Remove | null | -| 8h | 86.400.000 | -| 7d | 604.800.000 | - -```ts -// mute for 8 hours -await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid) -// unmute -await sock.chatModify({ mute: null }, jid) -``` -### Mark a Chat Read/Unread -```ts -const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end -// mark it unread -await sock.chatModify({ markRead: false, lastMessages: [lastMsgInChat] }, jid) -``` - -### Delete a Message for Me -```ts -await sock.chatModify( - { - clear: { - messages: [ - { - id: 'ATWYHDNNWU81732J', - fromMe: true, - timestamp: '1654823909' - } - ] - } - }, - jid -) - -``` -### Delete a Chat -```ts -const lastMsgInChat = await getLastMessageInChat(jid) // implement this on your end -await sock.chatModify({ - delete: true, - lastMessages: [ - { - key: lastMsgInChat.key, - messageTimestamp: lastMsgInChat.messageTimestamp - } - ] - }, - jid -) -``` -### Pin/Unpin a Chat -```ts -await sock.chatModify({ - pin: true // or `false` to unpin - }, - jid -) -``` -### Star/Unstar a Message -```ts -await sock.chatModify({ - star: { - messages: [ - { - id: 'messageID', - fromMe: true // or `false` - } - ], - star: true // - true: Star Message; false: Unstar Message - } - }, - jid -) -``` - -### Disappearing Messages - -- Ephemeral can be: - -| Time | Seconds | -|-------|----------------| -| Remove | 0 | -| 24h | 86.400 | -| 7d | 604.800 | -| 90d | 7.776.000 | - -- You need to pass in **Seconds**, default is 7 days - -```ts -// turn on disappearing messages -await sock.sendMessage( - jid, - // this is 1 week in seconds -- how long you want messages to appear for - { disappearingMessagesInChat: WA_DEFAULT_EPHEMERAL } -) - -// will send as a disappearing message -await sock.sendMessage(jid, { text: 'hello' }, { ephemeralExpiration: WA_DEFAULT_EPHEMERAL }) - -// turn off disappearing messages -await sock.sendMessage( - jid, - { disappearingMessagesInChat: false } -) -``` - -## User Querys - -### Check If ID Exists in Whatsapp -```ts -const [result] = await sock.onWhatsApp(jid) -if (result.exists) console.log (`${jid} exists on WhatsApp, as jid: ${result.jid}`) -``` - -### Query Chat History (groups too) - -- You need to have oldest message in chat -```ts -const msg = await getOldestMessageInChat(jid) -await sock.fetchMessageHistory( - 50, //quantity (max: 50 per query) - msg.key, - msg.messageTimestamp -) -``` -- Messages will be received in `messaging-history.set` event - -### Fetch Status -```ts -const status = await sock.fetchStatus(jid) -console.log('status: ' + status) -``` - -### Fetch Profile Picture (groups too) -- To get the display picture of some person/group -```ts -// for low res picture -const ppUrl = await sock.profilePictureUrl(jid) -console.log(ppUrl) - -// for high res picture -const ppUrl = await sock.profilePictureUrl(jid, 'image') -``` - -### Fetch Bussines Profile (such as description or category) -```ts -const profile = await sock.getBusinessProfile(jid) -console.log('business description: ' + profile.description + ', category: ' + profile.category) -``` - -### Fetch Someone's Presence (if they're typing or online) -```ts -// the presence update is fetched and called here -sock.ev.on('presence.update', console.log) - -// request updates for a chat -await sock.presenceSubscribe(jid) -``` - -## Change Profile - -### Change Profile Status -```ts -await sock.updateProfileStatus('Hello World!') -``` -### Change Profile Name -```ts -await sock.updateProfileName('My name') -``` -### Change Display Picture (groups too) -- To change your display picture or a group's - -> [!NOTE] -> Like media messages, you can pass `{ stream: Stream }` or `{ url: Url }` or `Buffer` directly, you can see more [here](https://baileys.whiskeysockets.io/types/WAMediaUpload.html) - -```ts -await sock.updateProfilePicture(jid, { url: './new-profile-picture.jpeg' }) -``` -### Remove display picture (groups too) -```ts -await sock.removeProfilePicture(jid) -``` - -## Groups - -- To change group properties you need to be admin - -### Create a Group -```ts -// title & participants -const group = await sock.groupCreate('My Fab Group', ['1234@s.whatsapp.net', '4564@s.whatsapp.net']) -console.log('created group with id: ' + group.gid) -await sock.sendMessage(group.id, { text: 'hello there' }) // say hello to everyone on the group -``` -### Add/Remove or Demote/Promote -```ts -// id & people to add to the group (will throw error if it fails) -await sock.groupParticipantsUpdate( - jid, - ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'], - 'add' // replace this parameter with 'remove' or 'demote' or 'promote' -) -``` -### Change Subject (name) -```ts -await sock.groupUpdateSubject(jid, 'New Subject!') -``` -### Change Description -```ts -await sock.groupUpdateDescription(jid, 'New Description!') -``` -### Change Settings -```ts -// only allow admins to send messages -await sock.groupSettingUpdate(jid, 'announcement') -// allow everyone to send messages -await sock.groupSettingUpdate(jid, 'not_announcement') -// allow everyone to modify the group's settings -- like display picture etc. -await sock.groupSettingUpdate(jid, 'unlocked') -// only allow admins to modify the group's settings -await sock.groupSettingUpdate(jid, 'locked') -``` -### Leave a Group -```ts -// will throw error if it fails -await sock.groupLeave(jid) -``` -### Get Invite Code -- To create link with code use `'https://chat.whatsapp.com/' + code` -```ts -const code = await sock.groupInviteCode(jid) -console.log('group code: ' + code) -``` -### Revoke Invite Code -```ts -const code = await sock.groupRevokeInvite(jid) -console.log('New group code: ' + code) -``` -### Join Using Invitation Code -- Code can't have `https://chat.whatsapp.com/`, only code -```ts -const response = await sock.groupAcceptInvite(code) -console.log('joined to: ' + response) -``` -### Get Group Info by Invite Code -```ts -const response = await sock.groupGetInviteInfo(code) -console.log('group information: ' + response) -``` -### Query Metadata (participants, name, description...) -```ts -const metadata = await sock.groupMetadata(jid) -console.log(metadata.id + ', title: ' + metadata.subject + ', description: ' + metadata.desc) -``` -### Join using `groupInviteMessage` -```ts -const response = await sock.groupAcceptInviteV4(jid, groupInviteMessage) -console.log('joined to: ' + response) -``` -### Get Request Join List -```ts -const response = await sock.groupRequestParticipantsList(jid) -console.log(response) -``` -### Approve/Reject Request Join -```ts -const response = await sock.groupRequestParticipantsUpdate( - jid, // group id - ['abcd@s.whatsapp.net', 'efgh@s.whatsapp.net'], - 'approve' // or 'reject' -) -console.log(response) -``` -### Get All Participating Groups Metadata -```ts -const response = await sock.groupFetchAllParticipating() -console.log(response) -``` -### Toggle Ephemeral - -- Ephemeral can be: - -| Time | Seconds | -|-------|----------------| -| Remove | 0 | -| 24h | 86.400 | -| 7d | 604.800 | -| 90d | 7.776.000 | - -```ts -await sock.groupToggleEphemeral(jid, 86400) -``` - -### Change Add Mode -```ts -await sock.groupMemberAddMode( - jid, - 'all_member_add' // or 'admin_add' -) -``` - -## Privacy - -### Block/Unblock User -```ts -await sock.updateBlockStatus(jid, 'block') // Block user -await sock.updateBlockStatus(jid, 'unblock') // Unblock user -``` -### Get Privacy Settings -```ts -const privacySettings = await sock.fetchPrivacySettings(true) -console.log('privacy settings: ' + privacySettings) -``` -### Get BlockList -```ts -const response = await sock.fetchBlocklist() -console.log(response) -``` -### Update LastSeen Privacy -```ts -const value = 'all' // 'contacts' | 'contact_blacklist' | 'none' -await sock.updateLastSeenPrivacy(value) -``` -### Update Online Privacy -```ts -const value = 'all' // 'match_last_seen' -await sock.updateOnlinePrivacy(value) -``` -### Update Profile Picture Privacy -```ts -const value = 'all' // 'contacts' | 'contact_blacklist' | 'none' -await sock.updateProfilePicturePrivacy(value) -``` -### Update Status Privacy -```ts -const value = 'all' // 'contacts' | 'contact_blacklist' | 'none' -await sock.updateStatusPrivacy(value) -``` -### Update Read Receipts Privacy -```ts -const value = 'all' // 'none' -await sock.updateReadReceiptsPrivacy(value) -``` -### Update Groups Add Privacy -```ts -const value = 'all' // 'contacts' | 'contact_blacklist' -await sock.updateGroupsAddPrivacy(value) -``` -### Update Default Disappearing Mode - -- Like [this](#disappearing-messages), ephemeral can be: - -| Time | Seconds | -|-------|----------------| -| Remove | 0 | -| 24h | 86.400 | -| 7d | 604.800 | -| 90d | 7.776.000 | - -```ts -const ephemeral = 86400 -await sock.updateDefaultDisappearingMode(ephemeral) -``` - -## Broadcast Lists & Stories - -### Send Broadcast & Stories -- Messages can be sent to broadcasts & stories. You need to add the following message options in sendMessage, like this: -```ts -await sock.sendMessage( - jid, - { - image: { - url: url - }, - caption: caption - }, - { - backgroundColor: backgroundColor, - font: font, - statusJidList: statusJidList, - broadcast: true - } -) -``` -- Message body can be a `extendedTextMessage` or `imageMessage` or `videoMessage` or `voiceMessage`, see [here](https://baileys.whiskeysockets.io/types/AnyRegularMessageContent.html) -- You can add `backgroundColor` and other options in the message options, see [here](https://baileys.whiskeysockets.io/types/MiscMessageGenerationOptions.html) -- `broadcast: true` enables broadcast mode -- `statusJidList`: a list of people that you can get which you need to provide, which are the people who will get this status message. - -- You can send messages to broadcast lists the same way you send messages to groups & individual chats. -- Right now, WA Web does not support creating broadcast lists, but you can still delete them. -- Broadcast IDs are in the format `12345678@broadcast` -### Query a Broadcast List's Recipients & Name -```ts -const bList = await sock.getBroadcastListInfo('1234@broadcast') -console.log (`list name: ${bList.name}, recps: ${bList.recipients}`) -``` - -## Writing Custom Functionality -Baileys is written with custom functionality in mind. Instead of forking the project & re-writing the internals, you can simply write your own extensions. - -### Enabling Debug Level in Baileys Logs -First, enable the logging of unhandled messages from WhatsApp by setting: -```ts -const sock = makeWASocket({ - logger: P({ level: 'debug' }), -}) -``` -This will enable you to see all sorts of messages WhatsApp sends in the console. - -### How Whatsapp Communicate With Us - -> [!TIP] -> If you want to learn whatsapp protocol, we recommend to study about Libsignal Protocol and Noise Protocol - -- **Example:** Functionality to track the battery percentage of your phone. You enable logging and you'll see a message about your battery pop up in the console: - ``` - { - "level": 10, - "fromMe": false, - "frame": { - "tag": "ib", - "attrs": { - "from": "@s.whatsapp.net" - }, - "content": [ - { - "tag": "edge_routing", - "attrs": {}, - "content": [ - { - "tag": "routing_info", - "attrs": {}, - "content": { - "type": "Buffer", - "data": [8,2,8,5] - } - } - ] - } - ] - }, - "msg":"communication" - } - ``` - -The `'frame'` is what the message received is, it has three components: -- `tag` -- what this frame is about (eg. message will have 'message') -- `attrs` -- a string key-value pair with some metadata (contains ID of the message usually) -- `content` -- the actual data (eg. a message node will have the actual message content in it) -- read more about this format [here](/src/WABinary/readme.md) - -### Register a Callback for Websocket Events - -> [!TIP] -> Recommended to see `onMessageReceived` function in `socket.ts` file to understand how websockets events are fired - -```ts -// for any message with tag 'edge_routing' -sock.ws.on('CB:edge_routing', (node: BinaryNode) => { }) - -// for any message with tag 'edge_routing' and id attribute = abcd -sock.ws.on('CB:edge_routing,id:abcd', (node: BinaryNode) => { }) - -// for any message with tag 'edge_routing', id attribute = abcd & first content node routing_info -sock.ws.on('CB:edge_routing,id:abcd,routing_info', (node: BinaryNode) => { }) -``` - -> [!NOTE] -> Also, this repo is now licenced under GPL 3 since it uses [libsignal-node](https://git.questbook.io/backend/service-coderunner/-/merge_requests/1) +Use at your own discretion. Do not spam people with this. We discourage any stalkerware, bulk or automated messaging usage. + +# License +Copyright (c) 2023 Rajeh Taher/WhiskeySockets + +Licensed under the MIT License: +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +Thus, the maintainers of the project can't be held liable for any potential misuse of this project.