← All guides
Playbook guide · Free

Send WhatsApp Messages and Read Chats Through Z-API and Your Muse

Verified 2026-11-14

Through a custom connector, your muse can work with a WhatsApp number linked through Z-API, reading chats and contacts, and sending text, image, and document messages.

What it does

The connector adds 11 tools. It checks whether the instance is linked to a WhatsApp account and whether the phone is online, reads the instance name, payment status, and expiration date, and reads the linked phone and whether it is a WhatsApp Business account. It checks whether a number has WhatsApp at all. It lists the chats of the linked number, people and groups, with unread counts and last message times, opens one chat's details, and lists contacts known to the number, including people from shared groups. It lists messages waiting in the send queue. With your yes first, it sends a text, an image by public web address with an optional caption, or a document such as a PDF, to a person or a group.

How to use it

  1. In the Z-API panel, open Instances, create or pick an instance, and copy its instance ID and instance token.
  2. Open the Security tab, set up the account security token, copy it, and activate it.
  3. Link the phone: scan the instance QR code with WhatsApp under Linked devices. Until the number is linked, every send fails.
  4. Start an AnythingMCP account and add the Z-API connector with the three values, then ask for a status check.
  5. In Muse, open Settings, then Connectors, and add a custom connector with the address AnythingMCP gives you. Sign in and approve.

What you need

  • A Muse account that can add custom connectors
  • An AnythingMCP account with the Z-API connector added
  • A Z-API instance, its ID and tokens, and a WhatsApp number linked by QR code

What to watch for

  • Z-API is a third-party gateway that runs a WhatsApp Web session for your number. It is not the official WhatsApp Business service, and WhatsApp may restrict numbers that send in bulk.
  • The send tools write real messages. Confirm the recipient and the text before a send, and never retry a send that already returned a message ID.
  • Phone numbers are digits only, with the country and area code and no plus sign, spaces, or dashes.
  • If the phone shows as not connected, scan the QR code again. If the phone is offline, bring it back online.
  • This is a custom connector, and Meta does not review custom connectors. You can disconnect it in Settings at any time. The muse prepares, you decide.

Tried this guide?

Tell the town how it went, or ask for help getting it working.

Talk about this on MuseFM →

Playbook Pro

Want to skip the lessons?

Help your agent learn everything at once. 1,015 skills, one pass, $49 for 90 days.

Get the Pro Pass
More guides →