What Spaces does on Facebook
Connect Messenger by signing in to Facebook through a secure link. Then your AI agent works on Facebook for you, inside the limits that keep the account safe.
Hi, my parcel came today but the mug inside is broken.
I am sorry, Priya. Could you send a photo of the mug and the box, so we can sort it out quickly?
(sends two photos) Here you go.
Thank you. I have passed this to Daniel on our team with your photos and order number. He will reply here today.
- Grokbot
- Muse
- Claude
- ChatGPT
- Claude Duet
- Messenger
- Step 1
A customer writes
On Facebook, any time of day.
- Step 2
Spaces passes it on
With limits that keep the account safe.
- Step 3
Your AI agent replies
In the same chat, in your words. Hard ones go to you.
- tools your agent can use on Facebook
- s
- to connect your account
- /7
- answers, day and night
- lines of code to write
Everything Spaces does on Facebook
Answer every Messenger chat
Your agent reads each message people send you on Messenger and replies in the same chat, day or night.
Photos, videos and files
Your agent reads and sends photos, videos, voice notes and files in the chat.
React, edit and pin
Your agent can react with an emoji, edit or delete what it sent, pin a message and send a read receipt.
Contacts and tags
Every person who writes becomes a contact you can tag, so follow-ups reach the right people.
Scheduled messages
A message written now and sent later, inside the hours you choose.
Hand a chat to a person
Your agent passes a chat to someone on your team and stays out of it until it is handed back.
Chat links and QR codes
A link and QR code that open a chat with your Facebook account, with clicks counted.
Webhooks for new messages
A signed notice to your own address each time a message arrives, for agents that run on a server.
Coming soonPage posts
Publish, edit, pin and delete posts on your Facebook Page, now or at a set time, after you approve them.
Coming soonReels and video
Post Page videos and Reels with a cover, a first comment and subtitles.
Coming sooncomments and private replies
Reply to, like, hide or delete Page comments, and answer a commenter privately in Messenger.
Coming sooncomment-to-DM
Someone comments a keyword on a Page post and gets one private message, once per person.
Go live on Facebook in three steps
- 1
Connect
Connect Messenger by signing in to Facebook through a secure link.
- 2
Teach your agent
Write a short brief: what you sell, prices, hours and what always goes to a person. Plain words are enough.
- 3
Go live
Your agent works in the same chats. Keep replies as drafts to approve at first, then let it answer on its own.
Use Facebook for
Customer support
Your AI agent answers the questions customers ask every day, in the chat they started, and hands complaints, refunds and anything personal to a person.
Lead qualification
Your AI agent asks your qualifying questions in the chat, scores and tags every lead, and passes the ready ones to a person with a short summary.
Meta ads
People who tap your Facebook or Instagram ad get an answer in seconds, from the AI agent you already use. In early access, the same agent can build paused ads and report what they cost.
FAQ automation
Your AI agent answers the questions you get every day from your brief and saved replies, uses keyword routines for the simplest ones, and hands the rest to a person.
Complaint management
Your AI agent replies to a complaint straight away, gathers the order number and photos, and hands the chat to a person with a clear note. It never argues.
Order tracking
Your AI agent answers “where is my order?” in the chat, from your order details, with the tracking link, and passes delays and lost parcels to a person.
Hi, how much is a kitchen renovation?
Hi Omar, it depends on the size and finish. Roughly how big is the kitchen, and when would you like the work to start?
About 12 square metres, and ideally in March. We have a budget of around 20,000.
That fits the kind of work we do. Lena plans our kitchens and can call you this week. Is Wednesday at 6 or Thursday…
Facebook by hand, and with Spaces
- Reply time
By hand: When someone gets to it, often hours
With Spaces: Within minutes, day or night
- Out of hours
By hand: Messages wait until morning
With Spaces: Answered from your brief, the rest waits for you
- Repeat questions
By hand: Typed again every time
With Spaces: Answered the same way, every time
- Follow-ups
By hand: Easy to forget
With Spaces: Sent on time, stopped as soon as they reply
- Hard conversations
By hand: Mixed in with everything else
With Spaces: Handed to a person with the history attached
- Account safety
By hand: Up to whoever is sending
With Spaces: Daily limits, pacing and warm-up on every account
For developers: every Facebook tool
Some tools work on every channel where the platform supports them. If Facebook does not support an action, Spaces returns an error and nothing is sent. Writes need an Idempotency-Key, so a retry never sends twice.
Conversations
| What it does | MCP tool | REST |
|---|---|---|
| Your conversations, newest first, with their tags, owner, star and whether a person has taken them over. Filter to unread, unanswered, starred, archived, message requests, handed over, a tag or an owner. | list_messaging_chats | GET …/chats |
| The messages in one conversation. | list_messaging_messages | GET …/chats/{chat_id}/messages |
| Wait for the next new message, comment, reaction, invitation or account change, and get it the moment it arrives. It never touches the platform, so it is the safe way to check for news. | wait_for_events | GET /v1/events |
| Have each new event sent to your own URL as a signed request, for an agent that runs on a server. | create_event_webhook | POST /v1/events/webhooks |
| The event webhooks your key has registered and how their deliveries are going. | list_event_webhooks | GET /v1/events/webhooks |
| Stop sending events to one of your URLs. | delete_event_webhook | DELETE /v1/events/webhooks/{webhook_id} |
| A photo, video, voice note, GIF, sticker or file from a message, or a private link to it that works for ten minutes. | 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 |
| The tags and the owner of a conversation. | get_chat_tags | GET …/chats/{chat_id}/tags |
| Tag a conversation, such as lead, order or follow up. Sends nothing. | set_chat_tags | PUT …/chats/{chat_id}/tags |
| Give a conversation to someone on your team. Sends nothing. | set_chat_owner | PUT …/chats/{chat_id}/owner |
| Hand a conversation to a person on your team. The agent stays out of it, with no replies, scheduled messages or routines there, until it is handed back. | hand_to_person | PUT …/chats/{chat_id}/handover |
| Hand a conversation back to the agent when the person is done. | hand_back_to_agent | DELETE …/chats/{chat_id}/handover |
| Every chat across all your accounts in one list, from Spaces' own copy. Filter by channel, unread, unanswered, tag, owner, reminder or name. | list_all_chats | GET /v1/messaging/inbox |
| Search message text across your accounts, with a snippet around each match. Searches Spaces' copy, never the platform. | search_messages | GET /v1/messaging/search |
| The private notes on a chat. | list_chat_notes | GET …/chats/{chat_id}/notes |
| Leave a private note on a chat. Never sent to the other person. | add_chat_note | POST …/chats/{chat_id}/notes |
| Delete a private note. | delete_chat_note | DELETE /v1/messaging/notes/{note_id} |
| Reusable messages you keep. | list_saved_replies | GET /v1/messaging/saved-replies |
| One saved reply, filled in for a contact if you give contact_id. | get_saved_reply | GET /v1/messaging/saved-replies/{reply_id} |
| Save a reusable message under a name. | create_saved_reply | POST /v1/messaging/saved-replies |
| Rename or change a saved reply. | update_saved_reply | PATCH /v1/messaging/saved-replies/{reply_id} |
| Delete a saved reply. | delete_saved_reply | DELETE /v1/messaging/saved-replies/{reply_id} |
| Bring a chat back later: at the time you choose a chat.reminder_due event arrives. | set_chat_reminder | POST …/chats/{chat_id}/reminders |
| Your chat reminders, soonest first. | list_chat_reminders | GET /v1/messaging/reminders |
| Cancel a waiting reminder. | cancel_chat_reminder | DELETE /v1/messaging/reminders/{reminder_id} |
| Mark a conversation as read. | mark_chat_read | POST …/chats/{chat_id}/read |
| Mark a conversation as unread so a person looks at it again. | mark_chat_unread | POST …/chats/{chat_id}/unread |
| Star a conversation to find it again with list_messaging_chats starred=true. | star_chat | PUT …/chats/{chat_id}/star |
| Remove the star from a conversation. | unstar_chat | DELETE …/chats/{chat_id}/star |
| Archive a conversation: it leaves the main inbox (list_messaging_chats archived=false) and shows with archived=true. | archive_chat | PUT …/chats/{chat_id}/archive |
| Move an archived conversation back to the main inbox. | unarchive_chat | DELETE …/chats/{chat_id}/archive |
| Pin a conversation at the top of the platform inbox. | pin_chat | PUT …/chats/{chat_id}/pin |
| Unpin a conversation. | unpin_chat | DELETE …/chats/{chat_id}/pin |
| Mute notifications for a conversation on the platform. | mute_chat | PUT …/chats/{chat_id}/mute |
| Turn notifications for a conversation back on. | unmute_chat | DELETE …/chats/{chat_id}/mute |
| Give a group conversation a new name. | rename_chat | PATCH …/chats/{chat_id}/name |
| Show "typing..." to the other person for a few seconds, before a reply. | send_typing | POST …/chats/{chat_id}/typing |
| Show the account as online or offline in chats. | set_online_status | PUT …/presence |
| Delete a conversation from the account. | delete_chat | DELETE …/chats/{chat_id} |
| The account's inboxes, such as the main inbox and message requests (pending: true). | list_inboxes | GET …/inboxes |
| The people in a conversation, with username, name and picture. | list_chat_attendees | GET …/chats/{chat_id}/attendees |
| Add a person to a group conversation. | add_chat_participant | POST …/chats/{chat_id}/attendees |
| Remove a person from a group conversation. | remove_chat_participant | DELETE …/chats/{chat_id}/attendees/{user_id} |
| The picture of a conversation or group. | get_chat_picture | GET …/chats/{chat_id}/picture |
| Whether a person is online now, and when they were last seen, where the platform shows it (online null when hidden). | get_user_presence | GET …/users/{user_id}/presence |
Messages
| What it does | MCP tool | REST |
|---|---|---|
| Mark a chat read, mute it, or take another chat action. | update_chat | PATCH …/chats/{chat_id} |
| Sync a chat from the start, or read the sync status. | sync_chat | GET …/chats/{chat_id}/sync |
| Messages across all conversations, with filters. | list_messages | GET …/messages |
| People the account can message. | list_attendees | GET …/attendees |
| One person you can message. | get_attendee | GET …/attendees/{attendee_id} |
| A person’s profile picture. | get_attendee_picture | GET …/attendees/{attendee_id}/picture |
| 1:1 chats with an attendee. | list_attendee_chats | GET …/attendees/{attendee_id}/chats |
| Messages with an attendee. | list_attendee_messages | GET …/attendees/{attendee_id}/messages |
| Sync chats for an attendee. | sync_attendee | GET …/attendees/{attendee_id}/sync |
| Unsend (delete) a message this account sent. | delete_message | DELETE …/messages/{message_id} |
| Change the text of a message this account sent. | edit_message | PATCH …/messages/{message_id} |
| React to a message with one emoji, such as ❤️ or 👍. | add_message_reaction | POST …/messages/{message_id}/reaction |
| Remove the reaction this account put on a message. | remove_message_reaction | DELETE …/messages/{message_id}/reaction |
| The emoji reactions on a message and who sent each one. | list_message_reactions | GET …/messages/{message_id}/reactions |
| Send a read receipt for one message from the other person (they may see "Seen"). | mark_message_read | POST …/messages/{message_id}/read |
| Pin a message at the top of the chat for everyone in it. | pin_message | PUT …/messages/{message_id}/pin |
| Unpin a pinned message. | unpin_message | DELETE …/messages/{message_id}/pin |
People
| What it does | MCP tool | REST |
|---|---|---|
| A person’s profile, with picture_url (and picture_url_large) when the platform sends one; platform picture links expire, so save the image if you need it later. On LinkedIn also how you are connected, shared connections, whether you can send an InMail, and on request their about text, experience, education, skills and contact details. | get_profile | GET …/users/{identifier} |
| The existing one-to-one conversation with a person, if there is one (chat_id null when there is none: use start_chat). | find_chat_with_user | GET …/users/{user_id}/chat |
| The connected account's own profile. | get_own_profile | GET …/profile |
| Block a person: they can no longer message or follow the account. | block_user | POST …/users/{user_id}/block |
| Unblock a person. | unblock_user | DELETE …/users/{user_id}/block |
Posts and comments
| What it does | MCP tool | REST |
|---|---|---|
| Check a photo or video link against each platform's limits (format, size, dimensions, aspect ratio, video length) and see what would be changed or refused. Posts nothing. | check_media | POST /v1/media/check |
Schedules and routines
| What it does | MCP tool | REST |
|---|---|---|
| Send a message at a set local time, inside working hours you choose. | schedule_message | POST /v1/messaging/schedules |
| Messages waiting to be sent. | list_schedules | GET /v1/messaging/schedules |
| Change a scheduled message. | update_schedule | PATCH /v1/messaging/schedules/{schedule_id} |
| Cancel a scheduled message. | cancel_schedule | DELETE /v1/messaging/schedules/{schedule_id} |
| An automation: answer from your notes, reply to comments and message the commenter once, tag chats, call a webhook or email the owner a summary notification (an owner notification, not an email channel), on a schedule or when a message or comment arrives. | create_routine | POST /v1/messaging/routines |
| Your automations. | list_routines | GET /v1/messaging/routines |
| Change or pause an automation. | update_routine | PATCH /v1/messaging/routines/{routine_id} |
| Delete an automation. | delete_routine | DELETE /v1/messaging/routines/{routine_id} |
| What an automation did, and when. | list_routine_runs | GET /v1/messaging/routines/{routine_id}/runs |
Contacts and campaigns
| What it does | MCP tool | REST |
|---|---|---|
| People you have talked to, created automatically from every DM and comment. Filter by tag, search, opted out, or a tracked link they opened. | list_contacts | GET /v1/messaging/contacts |
| One contact with tags and custom fields. | get_contact | GET /v1/messaging/contacts/{contact_id} |
| Add a contact by hand, with tags and your own fields. | create_contact | POST /v1/messaging/contacts |
| Import up to 5,000 contacts of one account at once, from rows or CSV. Updates the ones that exist, reports each row, has a dry run, and messages nobody. | import_contacts | POST /v1/messaging/contacts/import |
| Change a contact's details, tags or fields, or opt them out. | update_contact | PATCH /v1/messaging/contacts/{contact_id} |
| Delete a contact and end their sequences. | delete_contact | DELETE /v1/messaging/contacts/{contact_id} |
| Saved audience filters over your contacts. | list_segments | GET /v1/messaging/segments |
| A segment with how many contacts match right now. | get_segment | GET /v1/messaging/segments/{segment_id} |
| Save a filter on tags and contact fields. Use it for broadcasts and sequence enrolment. | create_segment | POST /v1/messaging/segments |
| Rename a segment or change its filter. | update_segment | PATCH /v1/messaging/segments/{segment_id} |
| Delete a segment. | delete_segment | DELETE /v1/messaging/segments/{segment_id} |
| Your broadcasts and their status. | list_broadcasts | GET /v1/messaging/broadcasts |
| Each person of a broadcast with their status, error category and what to do next. | list_broadcast_recipients | GET /v1/messaging/broadcasts/{broadcast_id}/recipients |
| Draft one message to many contacts, chosen by tag. Sends nothing and returns how many people it would reach. | create_broadcast | POST /v1/messaging/broadcasts |
| How many recipients are pending, sent, failed or skipped. | get_broadcast | GET /v1/messaging/broadcasts/{broadcast_id} |
| Send a drafted broadcast, paced, through your normal limits. Needs confirm: true. | send_broadcast | POST /v1/messaging/broadcasts/{broadcast_id}/send |
| Stop a broadcast. Anyone still waiting is skipped. | cancel_broadcast | POST /v1/messaging/broadcasts/{broadcast_id}/cancel |
| Your drip sequences. | list_sequences | GET /v1/messaging/sequences |
| A sequence with its steps and how many contacts are in each state. | get_sequence | GET /v1/messaging/sequences/{sequence_id} |
| Who is in a sequence, at which step, and why anyone stopped. | list_sequence_enrollments | GET /v1/messaging/sequences/{sequence_id}/enrollments |
| A drip of messages with delays. Ends for anyone who replies. Sends nothing until you enrol contacts. | create_sequence | POST /v1/messaging/sequences |
| Pause, resume or edit a sequence. | update_sequence | PATCH /v1/messaging/sequences/{sequence_id} |
| Delete a sequence and cancel its waiting steps. | delete_sequence | DELETE /v1/messaging/sequences/{sequence_id} |
| Start a sequence for contacts, by id or by tag. | enroll_in_sequence | POST /v1/messaging/sequences/{sequence_id}/enroll |
| Instagram: someone comments a keyword, replies to your story with it or DMs it, and gets a DM once. Choose the posts (or all of them), the words, and words that never trigger. A follow gate can ask people to follow first. | create_comment_to_dm | POST /v1/messaging/comment-triggers |
| Facebook Pages: someone comments a keyword on a Page post and gets one private Messenger reply, once per person. Choose the posts (or all of them), the words, and words that never trigger. | create_facebook_comment_to_dm | POST /v1/integrations/{account_id}/facebook/pages/{page_id}/comment-to-dm |
| Record types you defined yourself (orders, leads, properties, anything), with their fields. | list_object_types | GET /v1/messaging/object-types |
| One object type with its fields and record count. | get_object_type | GET /v1/messaging/object-types/{type_id} |
| Define a record type with typed fields: text, number, boolean, date or select. | create_object_type | POST /v1/messaging/object-types |
| Rename a type or add fields. | update_object_type | PATCH /v1/messaging/object-types/{type_id} |
| Delete a type, and its records with confirm. | delete_object_type | DELETE /v1/messaging/object-types/{type_id} |
| Records of a custom type, by type, contact or field value. | list_objects | GET /v1/messaging/objects |
| One record. | get_object | GET /v1/messaging/objects/{object_id} |
| Add a record, linked to a contact if you like. Checked against the type. | create_object | POST /v1/messaging/objects |
| Change a record's fields or link it to a contact. | update_object | PATCH /v1/messaging/objects/{object_id} |
| Delete a record. | delete_object | DELETE /v1/messaging/objects/{object_id} |
Workflows
| What it does | MCP tool | REST |
|---|---|---|
| A workflow on one account: a trigger and steps (send, wait for a reply, if/else, save the answer, delay, tag, webhook, A/B split, sequence, hand to a person, ask your AI agent). Saved as a draft unless you publish it. | create_workflow | POST /v1/messaging/workflows |
| Your workflows, with whether each is on, runs this week and the last run. | list_workflows | GET /v1/messaging/workflows |
| One workflow with its trigger and every step. | get_workflow | GET /v1/messaging/workflows/{workflow_id} |
| Save changed steps as a new version, or rename it. Runs already going keep their version. | update_workflow | PATCH /v1/messaging/workflows/{workflow_id} |
| Turn a workflow on: it starts for each person who matches its trigger. | publish_workflow | POST /v1/messaging/workflows/{workflow_id}/publish |
| Turn a workflow off. No new runs start; runs already going wait. | pause_workflow | POST /v1/messaging/workflows/{workflow_id}/pause |
| Delete a workflow and its runs. | delete_workflow | DELETE /v1/messaging/workflows/{workflow_id} |
| Try a workflow on a sample message and see the path it takes. Sends nothing and counts nothing. | test_workflow | POST /v1/messaging/workflows/{workflow_id}/test |
| Who went through a workflow, the path each run took and why it stopped. | list_workflow_runs | GET /v1/messaging/workflows/{workflow_id}/runs |
| One run with its step log. No message text. | get_workflow_run | GET /v1/messaging/workflow-runs/{run_id} |
| Answer a workflow that asked your AI agent, with a reply or a branch, so it carries on. | resume_workflow_run | POST /v1/messaging/workflow-runs/{run_id}/resume |
| Stop one run now. | cancel_workflow_run | POST /v1/messaging/workflow-runs/{run_id}/cancel |
| Every saved version of a workflow. | list_workflow_versions | GET /v1/messaging/workflows/{workflow_id}/versions |
| Bring back an old version as the newest one. | restore_workflow_version | POST /v1/messaging/workflows/{workflow_id}/versions/{version}/restore |
Triggers
| What it does | MCP tool | REST |
|---|---|---|
| What can start an agent, with the filters each accepts and a sample of the data. | list_trigger_types | GET /v1/messaging/trigger-types |
| Every trigger, whether a person or an agent made it, with status and when it last fired. | list_triggers | GET /v1/messaging/triggers |
| Start an agent on an event: a signed POST to your URL when it happens and matches your filters. | create_trigger | POST /v1/messaging/triggers |
| One trigger with its recent deliveries. | get_trigger | GET /v1/messaging/triggers/{trigger_id} |
| Pause, resume or edit a trigger. | update_trigger | PATCH /v1/messaging/triggers/{trigger_id} |
| Delete a trigger. | delete_trigger | DELETE /v1/messaging/triggers/{trigger_id} |
| Send one signed sample event to the trigger's URL. | test_trigger | POST /v1/messaging/triggers/{trigger_id}/test |
| Recent deliveries for a trigger and what your endpoint answered. | list_trigger_deliveries | GET /v1/messaging/triggers/{trigger_id}/deliveries |
Firewall
| What it does | MCP tool | REST |
|---|---|---|
| Whether the prompt-injection firewall is on, its mode, and what it caught in the last 7 days. | get_firewall_status | GET /v1/messaging/firewall |
| What the firewall blocked or marked, and why. Never the text itself. | list_firewall_events | GET /v1/messaging/firewall/events |
| Does this text look like an instruction written for an AI? Logs nothing. | check_text_for_injection | POST /v1/messaging/firewall/check |
Team
| What it does | MCP tool | REST |
|---|---|---|
| What the whole team shares: accounts, saved replies, routines, sequences, triggers, budget and who is on the team. | get_team_setup | GET /v1/workspace/setup |
| Everyone in the workspace with their role, and open invitations for the owner. | list_team | GET /v1/workspace/members |
| Invite a teammate as a member or viewer. The owner only, with confirmation. | invite_team_member | POST /v1/workspace/members |
| Make a teammate a member or a viewer. The owner only, with confirmation. | change_team_member_role | PATCH /v1/workspace/members/{member_id} |
| Remove a teammate, or cancel an invitation. The owner only, with confirmation. | remove_team_member | DELETE /v1/workspace/members/{id} |
Pause and approvals
| What it does | MCP tool | REST |
|---|---|---|
| Stop every message, post, comment, invitation, scheduled message and routine at once. Reading keeps working. | pause_all_sending | POST /v1/messaging/pause |
| Start sending again after a pause. Waiting scheduled messages and routines carry on. | resume_all_sending | POST /v1/messaging/resume |
| Ask your AI agent to hold replies, new chats, posts and comments as drafts until you approve them, only posts and comments, or nothing. | set_approvals | PATCH /v1/messaging/settings |
| Replies, new chats, posts and comments waiting for you to approve them. | list_approvals | GET /v1/messaging/approvals |
| Send a waiting message or post as it is, or after you edit the text. | approve | POST /v1/messaging/approvals/{approval_id}/approve |
| Turn down a waiting message or post, so it is never sent. | reject | POST /v1/messaging/approvals/{approval_id}/reject |
| Every AI agent with access to your Spaces, with what each may do, the accounts it may use and its daily share. Needs the "Manage other agents" permission, which you give in the dashboard. | list_agents | GET /v1/agents |
| Change what another AI agent may do, which accounts it may use and its daily share. The account limits always apply on top. | update_agent | PATCH /v1/agents/{agent_id} |
| Pause another AI agent. It can read and send nothing until it is resumed. | pause_agent | POST /v1/agents/{agent_id}/pause |
| Let a paused AI agent work again. | resume_agent | POST /v1/agents/{agent_id}/resume |
| Remove an AI agent for good. Its key and sign-in stop working. | revoke_agent | DELETE /v1/agents/{agent_id} |
| The last 20 things one AI agent did, newest first. No message text. | get_agent_activity | GET /v1/agents/{agent_id}/activity |
Accounts
| What it does | MCP tool | REST |
|---|---|---|
| The accounts you have connected, with their status and when each last had activity. Search by name, filter by channel or status, sort and page. | list_messaging_accounts | GET /v1/messaging/accounts |
| Tag an account with your own id, such as the client it belongs to, and find it again by that id. | set_account_external_id | PATCH … |
| Whether an account is working, what to do if not, and how much room it has left today. | get_account_health | GET …/health |
| A link to connect a new account, or to reconnect one. | create_messaging_connect_link | POST /v1/messaging/accounts/connect-link |
| Disconnect an account. | disconnect_messaging_account | DELETE … |
| A link and QR code that open a chat with one of your accounts, with an optional typed message on WhatsApp and a source, such as qr-shop-window, so you see which place brings in chats. | create_chat_link | POST /v1/chat-links |
| Your chat links, with how many people clicked each and how many chats it started. | list_chat_links | GET /v1/chat-links |
| Clicks and chats started from one chat link, day by day. | get_chat_link_stats | GET /v1/chat-links/{link_id}/stats |
| How much each account has used today and this week of every limit, such as “This week: 45 of 100 invitations”. | get_account_limits | GET …/limits |
| Status of one connected account. | get_connected_account | GET … |
| Start reconnecting an account that needs a sign-in. | reconnect_account | POST …/reconnect |
| Enter a sign-in or verification code the platform asked for. The code is not stored. | solve_checkpoint | POST …/checkpoint |
| Ask the platform to send the verification code again. | resend_checkpoint | POST …/checkpoint/resend |
| Restart an account that has stopped syncing. | restart_account | POST …/restart |
| Fetch an account’s messages again from the platform. | resync_account | POST …/sync |
Usage and billing
| What it does | MCP tool | REST |
|---|---|---|
| Turn a booking, payment or menu link into a short link, so you can see how many people your AI agent sent there. | create_tracked_link | POST /v1/links |
| Your agent's short links and how many people opened each one. | list_tracked_links | GET /v1/links |
| Report a bug, a missing feature or a docs gap to the Spaces team. | send_feedback | POST /v1/feedback |
| The product survey Spaces is asking, with its 4 questions, or null. At most every 90 days. | get_survey | GET /v1/survey |
| Answer the 4 questions from your own experience of using Spaces for this business, honestly and specifically, with answered_by. | answer_survey | POST /v1/survey/answers |
| Messages sent today and this week, and how much room is left on each account. | get_messaging_usage | GET /v1/messaging/usage |
| Usage by day for each account, as a spreadsheet or JSON: messages sent, new conversations and other actions. No message text. | export_messaging_usage | GET /v1/messaging/usage/export |
| Your plan and billing status. | get_messaging_billing | GET /v1/messaging/billing |
| Choose a paid plan. Returns a link where the person adds a card. | create_messaging_billing_checkout | POST /v1/messaging/billing/checkout |
| Change the monthly limit for usage on Pay as you go, or remove it, after the owner says yes (owner_confirmed). | set_spend_cap | PUT /v1/messaging/billing/spend-cap |
| Start cancelling. Three steps: the reason with the one offer that fits, decline, then confirm. There is no one-step cancel. | start_cancel_flow | POST /v1/billing/cancel/start |
| The cancel step this flow is on, and the single offer to show. | get_cancel_flow | GET /v1/billing/cancel/{flow_id} |
| Send the owner's answer for the current cancel step. Declining the offer moves to confirm. | submit_cancel_step | POST /v1/billing/cancel/{flow_id}/step |
| Cancel at the end of the paid period, after the offer was declined. Accounts stay connected and it can be undone until then. | confirm_cancel | POST /v1/billing/cancel/{flow_id}/confirm |
| The review and optional case study this workspace left with Spaces. | get_review | GET /v1/reviews |
| Leave a short review of Spaces, and optionally a case study, after the owner agrees. | submit_review | POST /v1/reviews |
| Get a month on us for an honest review on G2: what to ask the owner, the G2 link and the disclosure. The owner writes and submits the review on G2 themselves. Contacts nobody. | request_review_feedback | GET /v1/review-reward |
| After the owner has submitted their G2 review, send its link and a screenshot for the month on us. Posts nothing on G2. | submit_review_reward_claim | POST /v1/review-reward/claims |
| Get a month on us when the owner posts about Spaces on their own LinkedIn, Instagram, X, Facebook, TikTok or Threads account: whether it is available, the latest claim and the rules. Contacts nobody. | get_share_reward_status | GET /v1/share-reward |
| After the owner has posted about Spaces themselves, send the post link and a screenshot for the month on us. Posts nothing anywhere. | submit_share_reward | POST /v1/share-reward/claims |
| The owner's personal link to give a friend a month free; the owner gets a month free when the friend pays. Give it to the owner only: the agent never messages contacts or customers about referrals. | get_referral_link | GET /v1/referral-link |
| Friends who joined with the owner's link, how many paid, and months earned or pending. | get_referral_status | GET /v1/referral-status |
Analytics and logs
| What it does | MCP tool | REST |
|---|---|---|
| Conversations by day and hour, median first-response time for your AI agent and for people, the share your AI agent handled and who is still waiting. Untracked numbers are null. | get_inbox_analytics | GET /v1/analytics/inbox |
| Replies, conversations, new contacts, posts, link clicks, actions used and outcomes by day or week, with totals and a timeline per post. Only what Spaces records: untracked metrics are null, never 0. | get_analytics_overview | GET /v1/analytics/overview |
| Only the metric rows that changed since your last cursor, so an agent can poll cheaply. | get_analytics_changes | GET /v1/analytics/changes |
| Your key's own API and MCP calls of the last 14 days: method, route, tool, status, error code and duration. No message text or tokens. | list_request_logs | GET /v1/logs/requests |
| Every attempt to publish a post and how it ended: published, held for approval, failed or skipped, with the reason. | list_post_logs | GET /v1/logs/posts |
| When each account was connected, reconnected, signed out by the platform or disconnected by the owner, with a reason. | list_connection_logs | GET /v1/logs/connections |
Setup and business brief
| What it does | MCP tool | REST |
|---|---|---|
| Who is calling: the workspace, this key with its scopes and permissions, who made it and the plan. | whoami | GET /v1/me |
| The workspace's default time zone, used whenever a call passes none. | get_workspace_timezone | GET /v1/workspace/timezone |
| Set the workspace's default time zone for schedules, posts, slots and analytics. | set_workspace_timezone | PUT /v1/workspace/timezone |
| The next setup step, in plain words: business brief, channels, setup test, then live. An agent keeps calling it until everything is live. | get_started | GET /v1/setup/next |
| Two or three things the agent could offer the owner now, from the connected channels and the number of unread conversations. Counts only, and the platform is not asked. review_request, when present: Spaces asked the owner for an honest G2 review for a month free; mention it once with its link, and never write or submit the review for them. | suggest_next_actions | GET /v1/suggestions |
| What your agent should know before replying: your hours, prices, common questions, tone and when to hand a chat to you. | get_business_brief | GET /v1/workspace/brief |
| Save the whole business brief from your answers. | set_business_brief | PUT /v1/workspace/brief |
| Change one part of the brief, such as holiday hours or a new price. | update_business_brief | PATCH /v1/workspace/brief |
| Start the setup test: you send one message to your account from another phone. | start_setup_test | POST /v1/setup/test |
| See whether the test message arrived and whether your agent replied. | check_setup_test | GET /v1/setup/test |
| Who the workspace is for (a business, just you, or an agency), the goal, and what is still unanswered. | get_profile_setup | GET /v1/workspace/profile |
| Save the account type, goal and one detail after the owner says yes (owner_confirmed). | set_profile | PUT /v1/workspace/profile |
| The goal your AI agent works towards (sales, time or both) and what counts as a win. | get_goal | GET /v1/workspace/goal |
| Save the goal and what counts as a win after the owner says yes (owner_confirmed). | set_goal | PUT /v1/workspace/goal |
| Record what came of a chat: booked, order, lead won or resolved, with the amount when there is one. | record_outcome | POST /v1/outcomes |
| Outcomes with totals, including revenue influenced. | list_outcomes | GET /v1/outcomes |
Agencies
| What it does | MCP tool | REST |
|---|---|---|
| An agency's clients with status, accounts, replies this week, people waiting and usage. Other tools then take client_id. | list_clients | GET /v1/clients |
| Add a client, with its own accounts, inbox, brief and goal. | create_client | POST /v1/clients |
| Archive a client: out of the list, keys read-only. Its accounts stay connected and billed. | archive_client | POST /v1/clients/{client_id}/archive |
| Bring an archived client back. | restore_client | POST /v1/clients/{client_id}/restore |
| A link with the agency's name for a client to connect their own account, with no Spaces login. | create_client_connect_link | POST /v1/clients/{client_id}/connect-link |
| Accounts and actions per client for a month. | get_client_usage | GET /v1/clients/usage |
Use https://api.spacesos.com/mcp/messenger for an MCP server with only the Facebook tools, or https://api.spacesos.com/mcp for every channel. Setup steps for each AI client. Limits: Facebook limits.
Other channels: Instagram, WhatsApp, LinkedIn, Messenger, TikTok, Telegram.
Questions, answered.
01What can my AI agent do on Facebook with Spaces?
It can read the messages people send your connected Facebook account and reply in the same chat, using the information you give it. Spaces gives your agent 222 tools for Facebook, listed below on this page.
02Can my AI agent message people on Facebook who have not written to me?
No. Spaces is for conversations people start with you, and for people who know you and expect to hear from you. It is not for messages to strangers.
03Does Facebook limit how much my agent can send?
Yes. Every account has its own limits, and Spaces keeps each one inside them, so a busy account never uses up another account's allowance. See the limits for Facebook at /limits/messenger.
04What does it cost?
Your Facebook messages are waiting right now.
Let your AI agent answer them on Facebook tonight. Free to start, no card needed.
Set up Spaces for me by following https://www.spacesos.com/agents