feat: add WhatsApp Web support

[samuelcorsan]

Summary

Adds a WhatsApp Web adapter (@chat-adapter/whatsapp-web) for the Chat SDK. Uses whatsapp-web.js to connect via WhatsApp Web (Puppeteer) and handle messages, reactions, typing, and history.

Features

• Send/receive text, markdown and files
• Add/remove emoji reactions
• Typing indicator via thread.startTyping()
• Message history via adapter.fetchMessages()
• Cards rendered as text fallback
• DMs and group chats
• Reply to message:
• Media attachments

Limitations

• No message editing (WhatsApp Web API)
• No webhooks; handleWebhook returns status only
• Requires a long-running Node process (not serverless)
• Uses Puppeteer/headless Chrome

Environment Variables

Variable	Required	Description
WHATSAPP_SESSION_PATH	No	Session storage path (default: .wwebjs_auth)

Test Plan

• Unit tests pass for adapter core (thread IDs, isDM, filtering config)
• Unit tests pass for message filtering (blockedNumbers, allowedNumbers, allowedGroups, requireMentionInGroups)
• Unit tests pass for markdown conversion (*bold*, ~strike~, etc.)
• pnpm typecheck passes
• pnpm check passes
• pnpm knip passes
• pnpm test passes
• Manual testing with WhatsApp (QR scan, send/receive messages, media, reply)

[vercel]

@samuelcorsan is attempting to deploy a commit to the Vercel Team on Vercel.

A member of the Team first needs to authorize it.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	qrcode-terminal@​0.12.0
	whatsapp-web.js@​1.34.6

View full report

[samuelcorsan]

I released it as an external package while waiting for the PR to be reviewed: https://www.npmjs.com/package/chat-sdk-whatsapp-web

[bensabic]

Thank you for your contribution, @samuelcorsan. As we now have a WhatsApp adapter, we'll be closing this PR. But please don't hesitate to contribute to other areas of the project, including with other adapters.

Thanks again.