Connect your Matrix assistant to WhatsApp and use it wherever you are, with guidance on setup, messages, privacy, and connected workflows.
Maintained by the Matrix OS team. Product instructions are updated with the supported workflow.
Talk to your own Matrix assistant from WhatsApp. Plan your day, turn a rough idea into a draft, or ask about a connected calendar without opening your computer.
Early access
WhatsApp is currently available by invitation to approved accounts in the European Economic Area (EEA). Use the Matrix chat link in your invitation. If you have not received an invitation, contact Matrix support about availability.
Before you connect
Make sure you can open your Matrix account and send a message to your assistant there. Your Matrix computer needs to be running, with an AI account or Matrix AI access ready to use.
Use your everyday WhatsApp account. You do not need a separate business account or any developer setup.
Connect WhatsApp to Matrix
- Open the Matrix WhatsApp chat from your invitation and send Hey Matrix.
- Tap the connection link in Matrix's reply.
- Sign in to the Matrix account you want to use.
- Choose Send me a connection code.
- Find the code in WhatsApp and enter it on the Matrix connection page.
- Review the permissions and choose Connect my agent.
- Return to WhatsApp. After the connection confirmation, send a new message to start a conversation.
Keep your link and code private. If either expires, send Matrix another message to get a fresh link.
Find your WhatsApp connection
Open Settings โ Messaging in Matrix to check your connection or return to WhatsApp. On a phone, open Settings and tap Messaging; use Back to return to the Settings list.
Connected means WhatsApp is linked to your Matrix account. Your main computer and AI account must also be ready before the assistant can reply. After returning from the connection page, Matrix checks your connection again.
App update required
These Settings and app-opening improvements are being prepared for a Matrix update. If you do not see Messaging yet, use your invitation and the browser connection page. Installing the app alone does not make WhatsApp available outside early access.
With the updated Matrix release, new conversations use Matrix AI Gateway. Check its readiness under Agents & providers. An existing WhatsApp Chat keeps its selected agent and history; Open Matrix Chat lets you review that conversation. If an older agent is unavailable, contact support to move your WhatsApp connection to a fresh Matrix AI conversation while keeping your earlier history. Matrix needs an available AI connection before it can answer.
Try your first conversation
Start with something simple:
Hey Matrix, help me plan a focused afternoon. I have two hours and need to finish a proposal.
Then add a follow-up:
Break that into three steps, with a short break in between.
Matrix keeps the conversation, so you can keep refining the answer in the same chat.
Draft a message
Help me write a warm, short reply saying I can join the meeting tomorrow, but I need to leave by 3.
Ask for a draft first. You can edit and send it yourself.
Turn notes into a plan
Turn these notes into a checklist: finish the proposal, ask Sam for feedback, and book time to review it on Friday.
Paste the notes into your message. You can ask Matrix to shorten, reorganize, or explain its answer afterward.
Check your calendar
What's on my calendar today?
Connect Google Calendar in Matrix's Connect Apps first, and make sure your assistant has permission to use it. See Connect Apps for the connection steps. WhatsApp uses the connections available to your Matrix assistant; linking WhatsApp alone does not connect your calendar or email.
Continue in Matrix
Open Chat in Web Desktop or Electron Desktop and select Matrix ยท WhatsApp to see the conversation and continue there. Tap the Matrix link in WhatsApp whenever your assistant needs your approval or asks a question that must be answered there.
With the updated Matrix iPhone app installed, the link opens that Chat in the app. Otherwise, choose Continue in browser. Sign in if asked. WhatsApp uses your main Matrix computer, even if you were previously testing a preview computer. Android users can choose Open Matrix app on the link page with an updated app.
You can also use Slack to reach your personal assistant. Slack and WhatsApp currently keep separate conversation histories.
What can I send?
Early access supports text messages and follow-up questions. Photos, files, voice notes, WhatsApp groups, and automatic updates are not supported yet. Open Matrix to read a long answer in full.
This connection only handles messages you send to Matrix. It does not import the rest of your WhatsApp inbox. To bring other messaging conversations into Matrix, see Messages.
If something goes wrong
The connection link or code expired
Send Matrix a new message and use the new link. Sign in with the Matrix account you want to connect.
I connected, but there is no reply
Open Matrix and check that your main computer and Matrix AI Gateway are available. If an older WhatsApp Chat uses a separately installed agent such as Hermes, reconnect that agent's own account under Agents & providers, or contact support to move the connection to Matrix AI. Signing in to another agent does not change an existing Chat's agent. Once your assistant can answer, send a fresh WhatsApp message. You do not need to reconnect if your account is still linked.
A ๐ reaction means Matrix has started processing; wait for the actual reply. โ means the reply was delivered. โ means the request needs attention: open the Chat in Matrix. A reaction can occasionally remain unchanged after a delivery interruption, so check the conversation in Matrix too.
Matrix cannot see my calendar or another app
Open Connect Apps in the Matrix account you linked. Check the connection and your assistant's permissions. If the app is already connected, check access before connecting it again. Different Matrix test computers can have different connections.
A task needs my approval
Open the WhatsApp conversation in Matrix to review it. Approvals are not accepted through WhatsApp. Queued replies expire 24 hours after your incoming message. If a delayed reply no longer arrives in WhatsApp, check Matrix and send a new message to continue.
Send HELP in WhatsApp for connection guidance and a link to human support.
Your privacy and control
Your conversation is connected to your own Matrix account. Other people messaging the same Matrix number have their own assistants and cannot see your Chat. Your private WhatsApp conversation is not added to a company's shared knowledge.
Your assistant uses its existing Matrix permissions. Protect access to your WhatsApp account, because anyone using it can message your linked assistant. WhatsApp messages also pass through Meta's service.
Send STOP or /disconnect to disconnect. You can also choose Disconnect WhatsApp on the Matrix connection page while signed in. Disconnecting stops future WhatsApp access and pending delivery. Your Matrix conversation remains available, and work already running may continue there; open Matrix to inspect or cancel it.
To reconnect later, send Matrix a new message and follow the connection steps again.
How is this guide?