Guides

Hands-on tutorials that walk you through common WhatsApp automation tasks with whatsmeow-node.

Getting Started

Use whatsmeow in Node.js

Install the npm package, connect to WhatsApp, and start using whatsmeow from TypeScript — no Go setup needed.

Build a Bot

Create a WhatsApp bot from scratch — receive messages, handle commands, send replies.

Pair WhatsApp

Link a WhatsApp account via QR code or phone number code.

JIDs, LIDs & Device IDs

Decode JIDs, @lid senders and device suffixes — normalize, compare and build JIDs safely.

Deploy to Production

Run your bot 24/7 with Docker, systemd, or PM2 — persistent sessions, graceful shutdown, health checks, and alerts.

Messaging

Send Messages from TypeScript

Text, replies, mentions, media, polls, and reactions — all with full type safety.

Automate Group Messages

Send to groups, mention members, broadcast to multiple groups, and manage participants.

Send Stickers

Upload and send WebP stickers, download incoming stickers.

Typing Indicators

Show 'typing...' and 'recording audio...' indicators, subscribe to others' presence.

Media

Download Media

Save incoming images, videos, audio, and documents to disk.

Migration

Migrate from Baileys

Side-by-side API comparison and step-by-step migration from Baileys to whatsmeow-node.

Migrate from whatsapp-web.js

Drop Puppeteer, cut memory from 500 MB to 20 MB, and get a typed async API.

AI Integrations

Connect to Claude AI

Build an AI-powered WhatsApp chatbot with Claude and the Anthropic SDK.

Connect to ChatGPT (OpenAI)

Build a WhatsApp chatbot powered by GPT-6 Astra with the OpenAI SDK.

Connect to Google Gemini

Build a WhatsApp chatbot powered by Gemini with the Google GenAI SDK.

Connect to DeepSeek

Build a WhatsApp chatbot with DeepSeek using the OpenAI-compatible API.

Connect to Ollama (Local AI)

Run a local AI model — no API key, no cloud costs, full privacy.

Transcribe Voice Notes

Transcribe incoming voice notes with OpenAI speech-to-text and reply with the transcript.

Triage with Jev

Route, prioritize, and moderate WhatsApp messages with Jev — call an LLM only when a reply is needed.

Automation

Send Notifications

Send alerts, reminders, and updates to WhatsApp from any Node.js app or HTTP endpoint.

Schedule Messages

Delayed sends, recurring reminders, and cron-based scheduling.

Create a Poll Bot

Create polls, decrypt votes, tally results, and announce winners.

Forward Messages

Relay messages between chats — text, media, and any message type.

Archive Chat History

Save chat history and new messages to SQLite with history sync, upserts, and on-demand backfill.

Tool Integrations

Whaticket Integration

Replace whatsapp-web.js in Whaticket — drop Puppeteer, cut memory, get stability.

n8n Integration

Connect whatsmeow-node to n8n for WhatsApp workflow automation.

Chatwoot Integration

Use whatsmeow-node as a WhatsApp channel in Chatwoot — no Cloud API needed.

Typebot Integration

Connect Typebot flows to WhatsApp via whatsmeow-node — replace Evolution API.

Looking for code snippets?

The Examples section has focused, copy-pasteable code for specific features — media, groups, polls, reactions, and more.