Skip to content

feat: add support for sending sticker packs#3614

Open
sergiooak wants to merge 6 commits intopedroslopez:mainfrom
sergiooak:main
Open

feat: add support for sending sticker packs#3614
sergiooak wants to merge 6 commits intopedroslopez:mainfrom
sergiooak:main

Conversation

@sergiooak
Copy link

@sergiooak sergiooak commented Jun 27, 2025

PR Details

Summary:
Adds support for sending sticker packs, updates typings, and provides usage examples.

Description

  • Introduced sendMediaAsStickerPack option to the API and typings.
  • Implemented logic for creating and sending sticker packs.
  • Updated example.js with new commands for sticker and sticker pack sending.
  • Added required dependencies: archiver, sharp.
  • Improved type definitions and internal documentation.

Motivation and Context

This change allows users to send multiple stickers as a pack, improving feature parity with WhatsApp’s native functionality and expanding bot/media capabilities.

How Has This Been Tested

  • Manual testing using the updated example.js bot commands (!sticker, !pack).
  • Verified sticker and sticker pack sending in group and private chats.

Environment

  • Machine OS: Windows 11
  • Phone OS: Android 14
  • Library Version: 2.3000.1024258380
  • WhatsApp Web Version: 2.3000.1024258380
  • Puppeteer Version: 18.2.1
  • Browser Type and Version: Chrome 138
  • Node Version: v22.15.0

Types of changes

  • Dependency change
  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist

  • My code follows the code style of this project.
  • I have updated the documentation accordingly (index.d.ts).
  • I have updated the usage example accordingly (example.js)

sergiooak added 2 commits June 27, 2025 13:09
@sergiooak
feat(sticker-packs): add support for sending sticker packs
4744f77 
- Added sendMediaAsStickerPack option to API and typings
- Implemented sticker pack creation and sending logic
- Updated example.js with !sticker and !pack commands
- Added required dependencies: archiver, sharp
- Improved type definitions and
@sergiooak
feat(sticker-pack): add support for custom sticker pack thumbnails
db3f336
@sergiooak
Copy link
Author

sergiooak commented Jun 27, 2025 •
edited
Loading

Sticker Packs in Chat:

Sticker Pack on Whatsapp Sticker Seach

Including custom Thumbnail

@sergiooak
Copy link
Author

sergiooak commented Jun 27, 2025 •
edited
Loading

Known Bug:

The stickers previews don't load automatically, it just happens after you open the sticker pack for the first time
image

@alechkos alechkos added the dependencies Pull requests that update a dependency file label Jun 27, 2025
@sergiooak
Copy link
Author

sergiooak commented Jun 28, 2025

@alechkos About the introduced dependencies, it uses the before optionals archiver and unzipper, and the sharp is used to generate the pack thumbnail.
I guess we can keep the deps as optionals, like the approach on url preview generation, and avoid sharp using another way of generating the png, what do you think:

alechkos
alechkos suggested changes Jun 28, 2025
View reviewed changes
Copy link
Contributor

@alechkos alechkos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please don't use sharp.

@sergiooak
Copy link
Author

sergiooak commented Jun 28, 2025

Yeah, I figured out why already haha, tomorrow I'll rework to get rid of sharp

@sergiooak sergiooak changed the title feat(sticker-pack): add support for sending sticker packs feat: add support for sending sticker packs Jun 29, 2025
sergiooak added 2 commits June 29, 2025 17:32
@sergiooak
refactor: replace sharp with browser-side cropAndResizeImage for stic…
0a2b602 
…ker pack thumbnails
@sergiooak
chore(package): rollback package versions to match base repo state
235f151 
- Downgraded 'archiver' from ^7.0.1 to ^5.3.1
- Rolled back 'unzipper' from ^0.10.14 to ^0.10.11
- Reverted other version changes introduced in the PR
@sergiooak
Copy link
Author

sergiooak commented Jun 29, 2025 •
edited
Loading

@alechkos I've removed Sharp from the stack and now use window.WWebJS.cropAndResizeImage to generate the 64x64px PNG for the sticker-pack thumbnail

Also, to ease my OCD, could you approve the PR: wwebjs/wwebjs.dev#97

@sergiooak sergiooak requested a review from alechkos June 29, 2025 20:43
@alechkos alechkos removed the dependencies Pull requests that update a dependency file label Jun 30, 2025
@sergiooak
Copy link
Author

sergiooak commented Jul 9, 2025

@alechkos and @tuyuribr I need to do anything to be able to merge this?

alechkos
alechkos reviewed Aug 6, 2025
View reviewed changes
Copy link
Contributor

@alechkos alechkos left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi @sergiooak, I tested and it seems that there is no difference between sending a regular pack and one with a custom thumbnail.

@alechkos
Copy link
Contributor

alechkos commented Aug 6, 2025

Also, you can't add a sticker pack to your stickers, it responds in Failed to download sticker pack message.

@purpshell purpshell requested a review from tuyuribr November 20, 2025 11:36
@lindionez
Copy link

lindionez commented Nov 20, 2025

The idea is great, I hope this functionality will be added one day.

@BenyFilho BenyFilho added the help wanted Extra attention is needed label Jan 30, 2026
@BenyFilho
Copy link
Collaborator

BenyFilho commented Jan 31, 2026

@sergiooak Review your PR with the recent changes

@hellhound20236-blip
Copy link

hellhound20236-blip commented Feb 2, 2026

working in last version? @sergiooak

@sergiooak
Copy link
Author

sergiooak commented Feb 2, 2026

@BenyFilho and @hellhound20236-blip I don't work on this feature in a long time, I'll try to update and test this week

@hellhound20236-blip
Copy link

hellhound20236-blip commented Feb 3, 2026

@BenyFilho and @hellhound20236-blip I don't work on this feature in a long time, I'll try to update and test this week

Thanks youuu :)

@josearg770bis
Copy link

josearg770bis commented Feb 13, 2026

work ? @sergiooak

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@purpshell purpshell purpshell approved these changes

@tuyuribr tuyuribr Awaiting requested review from tuyuribr

+2 more reviewers

@alechkos alechkos alechkos requested changes

@lindionez lindionez lindionez approved these changes

Reviewers whose approvals may not affect merge requirements

At least 2 approving reviews are required to merge this pull request.

Assignees

No one assigned

Labels

help wanted Extra attention is needed

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

7 participants

@sergiooak @alechkos @lindionez @BenyFilho @hellhound20236-blip @josearg770bis @purpshell