WhatsApp API for AI agents
Give your AI agent your business WhatsApp: it reads every chat, replies with text, photos and files, starts conversations with people who expect to hear from you, and schedules messages, on the number your customers already know.
What your agent can do on WhatsApp
- Read and answer every chat, with photos, voice notes and files
- Start a chat with a customer who expects to hear from you
- React to, edit, forward or delete messages
- Schedule a message for a set time, inside your working hours
Three steps
- Start a trial and connect WhatsApp. You scan a QR code with the phone that has the number, the same way you would link WhatsApp on a computer.
- Add Spaces to your AI agent with one URL,
https://api.spacesos.com/mcp/whatsapp, or use the REST API athttps://api.spacesos.com/v1. Steps for each AI client. - Your agent reads and answers. Spaces paces every message inside the limits that keep the account safe.
Or paste this into your agent and let it set things up with you:
Set up Spaces for me by following https://www.spacesos.com/agentsThe core tools
| What it does | MCP tool | REST |
|---|---|---|
| Your conversations, newest first. Filter to unread. | list_messaging_chats | GET …/chats |
| The messages in one conversation. | list_messaging_messages | GET …/chats/{chat_id}/messages |
| An image, file, voice note or video from a message. | get_messaging_attachment | GET …/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id} |
| Reply in a conversation, with text or attachments. | reply_in_chat | POST …/chats/{chat_id}/messages |
| Start a new conversation with someone who expects to hear from you. | start_chat | POST …/chats |
| Send a message at a set local time, inside working hours you choose. | schedule_message | POST /v1/messaging/schedules |
Only on WhatsApp
| What it does | MCP tool | REST |
|---|---|---|
| Forward a message. WhatsApp only. | forward_message | POST …/messages/{message_id}/forward |
| Delete a chat. WhatsApp and LinkedIn. | delete_chat | DELETE …/chats/{chat_id} |
| Delete a message. WhatsApp and LinkedIn. LinkedIn only within about an hour. | delete_message | DELETE …/messages/{message_id} |
| Edit a message. WhatsApp and LinkedIn Classic. | edit_message | PATCH …/messages/{message_id} |
Every WhatsApp tool · WhatsApp MCP guide · Full reference
Limits that keep the account safe
Up to 200 messages a day per account, at least 15 seconds apart, with 10 new chats a day at most and a four-week warm-up for new accounts. WhatsApp limits in full · How accounts are kept safe.
FAQ
Is this the WhatsApp Business Platform (Cloud API)?
No. Spaces connects the WhatsApp number you already use by scanning a QR code, the way you link WhatsApp to a computer. There is no Meta approval, no message templates and no Meta message fees, and the number keeps working on your phone. The WhatsApp Business Platform suits large template broadcasts; Spaces suits answering the people who message you.
Can my AI agent send WhatsApp messages through an API?
Yes. Your agent replies in a chat or starts a new one through the REST API or the MCP server, and Spaces paces every message inside WhatsApp’s safe limits.
Can I use WhatsApp Business or a normal WhatsApp account?
Either. You connect the account you already have.
How many WhatsApp messages can I send a day?
Up to 200 a day per account, with stricter limits on new chats while a new account warms up. Replies to customers who message you are not held back.
How much does the WhatsApp API cost?
Plans from $19 a month for one connected account, with a trial. You pay per connected account, not per message or per contact.