Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Macaly’s WhatsApp connection lets you chat with the Macaly agent from your phone. Send a message in WhatsApp, get a reply, keep working on your projects without opening the web app.
Available on the Pro and Enterprise plans

​
What you can do

The WhatsApp agent works on the same projects you build in the web app. Anything you’d normally ask the agent to do, you can ask from WhatsApp:
  • Start a new project. Describe what you want to build and the agent gets to work, just like in the web app.
  • Edit your existing projects. Ask for changes, fixes, or new sections. If you have several projects and don’t say which one, the agent will ask.
  • Publish and manage. Publish a project, change its subdomain, or check what’s live.
  • Ask quick questions. Get help, ideas, or status updates without breaking your flow.
When the agent makes changes, it sends you a preview link so you can check the result without leaving WhatsApp.

​
What you can send

The agent works with whatever you send over WhatsApp:
  • Text messages. Just type and send.
  • Voice messages. Macaly transcribes them and replies. Useful when typing isn’t practical.
  • Images. Send screenshots, mockups, or references the agent should look at.
  • Files. PDFs and documents the agent can read and use.
Videos aren’t supported. Replies come back as plain text without markdown formatting or rich previews, since WhatsApp doesn’t support them.

​
How to set it up

1

Open the Connections settings

In Macaly, go to Settings → Connections and click Connect on the WhatsApp card.Settings Connections WhatsApp card
2

Open WhatsApp

Macaly shows a QR code and a connection link. Scan the QR code with your phone, or click Open WhatsApp to launch it on your computer or phone with the connection message pre-filled.
3

Send the connection message

Send the pre-filled start [CODE] message to Macaly. If you scanned the QR code, type and send it from your phone.
4

Start chatting

Macaly confirms the connection and shows the account it’s linked to. You can now message the agent any time from WhatsApp.
The connection code is valid for 15 minutes. If it expires, generate a new one from the Connections settings.

​
Bot commands

Send any of these in your WhatsApp chat with Macaly:
CommandWhat it does
/newStart a new conversation thread with the agent.
/statusCheck the status of your connection and current chat.
/unlinkDisconnect WhatsApp from your Macaly workspace.
/helpList the available commands.

​
Disconnecting

To disconnect, either send /unlink from WhatsApp, or open Settings → Connections in the app and remove the connected number. Either way works. The connection stops immediately and is cleared.

​
Good to know

  • No setup with Meta required. You don’t need a WhatsApp Business account or any API keys. Just connect from Settings and start chatting.
  • Credits work the same as in the web app. The agent’s work uses credits at the same rate as in the web app, plus a small extra amount when you send voice messages (for transcription).
  • One workspace per phone number. Your WhatsApp number can only be linked to one Macaly workspace at a time, but each workspace member can connect their own number. To use your number with a different workspace, disconnect first.
  • Voice message size limit. Voice messages can be up to 10 MB. Longer recordings won’t go through.