List all WhatsApp sessions and their statuses

Get detailed info about a specific WhatsApp session

Create a new WhatsApp session

Start a stopped WhatsApp session

Stop a running WhatsApp session

Restart a WhatsApp session

Delete a WhatsApp session permanently

Logout from a WhatsApp session (keeps session but disconnects WhatsApp account)

Get QR code for WhatsApp authentication. Returns the raw QR string value that can be used to generate a scannable QR code.

Request a pairing code for phone number authentication (alternative to QR code). The user will receive a code on their phone to enter in WhatsApp.

Check the authentication status of a WhatsApp session

Send a text message to a WhatsApp chat

Send an image to a WhatsApp chat (from local file OR URL)

Send a video to a WhatsApp chat (from local file OR URL)

Send a voice message to a WhatsApp chat (from local file OR URL)

Send a document/file to a WhatsApp chat (from local file OR URL)

Send a location to a WhatsApp chat

Send contact card(s) (vCard) to a WhatsApp chat

Send a poll to a WhatsApp chat

React to a message with an emoji

Get messages from a WhatsApp chat with optional filters

Delete a message from a WhatsApp chat

Edit a previously sent message

Mark messages in a chat as read (send seen)

Star or unstar a message

Forward a message to another chat

List all chats in a WhatsApp session

Get detailed info about a specific chat

Archive or unarchive a chat

Pin or unpin a chat

Mute or unmute a chat

Delete a chat entirely

Clear all messages in a chat

Get all contacts from a WhatsApp session

Get info about a specific contact

Check if a phone number is registered on WhatsApp

Block or unblock a contact

Get the profile picture URL of a contact or group

Create a new WhatsApp group

List all WhatsApp groups

Get detailed info about a specific group

List all participants in a group

Add participants to a group

Remove participants from a group

Promote participant(s) to group admin

Demote admin(s) to regular participant in a group

Update the name/subject of a group

Update the description of a group

Set the profile picture of a group

Leave a WhatsApp group

Get the invite link/code for a group

Revoke the current invite link and generate a new one

Set your presence status (online/offline)

Get presence status of a contact (online/offline/typing)

Show typing indicator in a chat (simulates real user behavior)

Stop showing typing indicator in a chat

Post a text status/story update

Get all labels/categories in a WhatsApp session

Create a new label

Delete a label

Add a label to a chat

Remove a label from a chat

🤖 IMPORTANT FOR AI ASSISTANTS: Use this tool instead of stopping work when you need user input!

WHEN TO USE:

• You need architectural decisions (REST vs GraphQL, etc.)

• You need missing requirements or specifications

• You need API keys, credentials, or configuration values

• You encounter ANY question that would normally block your progress

• You need user approval or preference for a decision

DO NOT:

• Stop and wait for manual console input

• Ask the user to provide information manually

• Halt progress when this tool can unblock you

HOW IT WORKS:

1. Send your question via WhatsApp

2. This tool WAITS (blocking) for the user's reply

3. Returns the reply text to you

4. You continue working with the answer

EXAMPLE USAGE: const answer = await ask_user_via_whatsapp({ question: "Should I use REST or GraphQL for this API?", chatId: "1234567890@c.us", timeoutMinutes: 30 }); // Parse answer and continue working

USER EXPERIENCE: User gets WhatsApp notification → replies from phone → you continue instantly

This enables truly autonomous AI development!