Send WhatsApp messages and manage conversation history using the whatzap CLI. Use when asked to send a WhatsApp message, notify someone on WhatsApp, message a contact, share information via WhatsApp, watch/record messages from a contact or group, or manage the watch list. Trigger phrases: send WhatsApp, notify on WhatsApp, WhatsApp message, message via WhatsApp, watch contact, add watch, record messages, stop watching.
npm install -g whatzap-cliwhatzap login (one-time QR scan with your phone)whatzap setting set default-country-code <code> (e.g. 55 for Brazil, 1 for USA, 44 for UK) — prompted automatically after first loginResolve the recipient.
+ or is all digits), use it directly.whatzap find-contact <name>
Multi-word names work without quotes (e.g. whatzap find-contact john doe).
Returns a JSON array:
[{ "name": "John Doe", "phones": ["+15551234567"] }]
Send the message:
whatzap send-message <phone> <message>
Expected output: Message sent.
On failure: If the command errors with "Not logged in", instruct the user to run whatzap login and scan the QR code.
whatzap send-group <group name> <message>
Multi-word group names work without quotes. Example: whatzap send-group family group Hello everyone!
When the user asks to watch/record messages from a contact:
find-contact (same logic as sending above).whatzap add-watch <phone>
Expected outputs:
Now watching '<input>' — successfully added'<input>' is already being watched. — already in watch list (not an error)For groups: Pass the group name directly:
whatzap add-watch family group
| Command | Description |
|---|---|
whatzap login | Authenticate via QR code, starts background daemon |
whatzap logout | Log out and remove saved credentials |
whatzap find-contact <query> | Search macOS Contacts by name, returns JSON |
whatzap send-message <phone> <message> | Send a text message (phone number required) |
whatzap send-group <group name> <message> | Send a text message to a group |
whatzap add-watch <phone|group name> | Start recording messages for a contact or group |
whatzap remove-watch <phone|group name> | Stop recording messages for a contact or group |
whatzap list-watch | List all watched contacts and groups |
whatzap setting set default-country-code <code> | Set default country code for phone normalization |
whatzap restart | Restart the background daemon |
whatzap stop | Stop the background daemon |
whatzap find-contact john doe
whatzap send-message +15551234567 Build finished successfully
whatzap send-message 5551234567 Tests passed: 42/42
whatzap send-group dev team Deploy is live
whatzap add-watch +15551234567
whatzap add-watch family group
whatzap list-watch
whatzap remove-watch +15551234567
whatzap setting set default-country-code 55