Spaces

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.

Facebook Answered by your AI agent

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
Spaces
  • facebook
  • Instagram
  • WhatsApp
  • LinkedIn
  • Messenger
Your AI agentSafe limits, one connectionYour chat apps
  1. Step 1

    A customer writes

    On Facebook, any time of day.

  2. Step 2

    Spaces passes it on

    With limits that keep the account safe.

  3. 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. 1

    Connect

    Connect Messenger by signing in to Facebook through a secure link.

  2. 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. 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.

Facebookonline

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

  1. Reply time

    By hand: When someone gets to it, often hours

    With Spaces: Within minutes, day or night

  2. Out of hours

    By hand: Messages wait until morning

    With Spaces: Answered from your brief, the rest waits for you

  3. Repeat questions

    By hand: Typed again every time

    With Spaces: Answered the same way, every time

  4. Follow-ups

    By hand: Easy to forget

    With Spaces: Sent on time, stopped as soon as they reply

  5. Hard conversations

    By hand: Mixed in with everything else

    With Spaces: Handed to a person with the history attached

  6. 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 doesMCP toolREST
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_chatsGET …/chats
The messages in one conversation.list_messaging_messagesGET …/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_eventsGET /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_webhookPOST /v1/events/webhooks
The event webhooks your key has registered and how their deliveries are going.list_event_webhooksGET /v1/events/webhooks
Stop sending events to one of your URLs.delete_event_webhookDELETE /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_attachmentGET …/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}
Reply in a conversation, with text or attachments.reply_in_chatPOST …/chats/{chat_id}/messages
Start a new conversation with someone who expects to hear from you.start_chatPOST …/chats
The tags and the owner of a conversation.get_chat_tagsGET …/chats/{chat_id}/tags
Tag a conversation, such as lead, order or follow up. Sends nothing.set_chat_tagsPUT …/chats/{chat_id}/tags
Give a conversation to someone on your team. Sends nothing.set_chat_ownerPUT …/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_personPUT …/chats/{chat_id}/handover
Hand a conversation back to the agent when the person is done.hand_back_to_agentDELETE …/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_chatsGET /v1/messaging/inbox
Search message text across your accounts, with a snippet around each match. Searches Spaces' copy, never the platform.search_messagesGET /v1/messaging/search
The private notes on a chat.list_chat_notesGET …/chats/{chat_id}/notes
Leave a private note on a chat. Never sent to the other person.add_chat_notePOST …/chats/{chat_id}/notes
Delete a private note.delete_chat_noteDELETE /v1/messaging/notes/{note_id}
Reusable messages you keep.list_saved_repliesGET /v1/messaging/saved-replies
One saved reply, filled in for a contact if you give contact_id.get_saved_replyGET /v1/messaging/saved-replies/{reply_id}
Save a reusable message under a name.create_saved_replyPOST /v1/messaging/saved-replies
Rename or change a saved reply.update_saved_replyPATCH /v1/messaging/saved-replies/{reply_id}
Delete a saved reply.delete_saved_replyDELETE /v1/messaging/saved-replies/{reply_id}
Bring a chat back later: at the time you choose a chat.reminder_due event arrives.set_chat_reminderPOST …/chats/{chat_id}/reminders
Your chat reminders, soonest first.list_chat_remindersGET /v1/messaging/reminders
Cancel a waiting reminder.cancel_chat_reminderDELETE /v1/messaging/reminders/{reminder_id}
Mark a conversation as read.mark_chat_readPOST …/chats/{chat_id}/read
Mark a conversation as unread so a person looks at it again.mark_chat_unreadPOST …/chats/{chat_id}/unread
Star a conversation to find it again with list_messaging_chats starred=true.star_chatPUT …/chats/{chat_id}/star
Remove the star from a conversation.unstar_chatDELETE …/chats/{chat_id}/star
Archive a conversation: it leaves the main inbox (list_messaging_chats archived=false) and shows with archived=true.archive_chatPUT …/chats/{chat_id}/archive
Move an archived conversation back to the main inbox.unarchive_chatDELETE …/chats/{chat_id}/archive
Pin a conversation at the top of the platform inbox.pin_chatPUT …/chats/{chat_id}/pin
Unpin a conversation.unpin_chatDELETE …/chats/{chat_id}/pin
Mute notifications for a conversation on the platform.mute_chatPUT …/chats/{chat_id}/mute
Turn notifications for a conversation back on.unmute_chatDELETE …/chats/{chat_id}/mute
Give a group conversation a new name.rename_chatPATCH …/chats/{chat_id}/name
Show "typing..." to the other person for a few seconds, before a reply.send_typingPOST …/chats/{chat_id}/typing
Show the account as online or offline in chats.set_online_statusPUT …/presence
Delete a conversation from the account.delete_chatDELETE …/chats/{chat_id}
The account's inboxes, such as the main inbox and message requests (pending: true).list_inboxesGET …/inboxes
The people in a conversation, with username, name and picture.list_chat_attendeesGET …/chats/{chat_id}/attendees
Add a person to a group conversation.add_chat_participantPOST …/chats/{chat_id}/attendees
Remove a person from a group conversation.remove_chat_participantDELETE …/chats/{chat_id}/attendees/{user_id}
The picture of a conversation or group.get_chat_pictureGET …/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_presenceGET …/users/{user_id}/presence

Messages

What it doesMCP toolREST
Mark a chat read, mute it, or take another chat action.update_chatPATCH …/chats/{chat_id}
Sync a chat from the start, or read the sync status.sync_chatGET …/chats/{chat_id}/sync
Messages across all conversations, with filters.list_messagesGET …/messages
People the account can message.list_attendeesGET …/attendees
One person you can message.get_attendeeGET …/attendees/{attendee_id}
A person’s profile picture.get_attendee_pictureGET …/attendees/{attendee_id}/picture
1:1 chats with an attendee.list_attendee_chatsGET …/attendees/{attendee_id}/chats
Messages with an attendee.list_attendee_messagesGET …/attendees/{attendee_id}/messages
Sync chats for an attendee.sync_attendeeGET …/attendees/{attendee_id}/sync
Unsend (delete) a message this account sent.delete_messageDELETE …/messages/{message_id}
Change the text of a message this account sent.edit_messagePATCH …/messages/{message_id}
React to a message with one emoji, such as ❤️ or 👍.add_message_reactionPOST …/messages/{message_id}/reaction
Remove the reaction this account put on a message.remove_message_reactionDELETE …/messages/{message_id}/reaction
The emoji reactions on a message and who sent each one.list_message_reactionsGET …/messages/{message_id}/reactions
Send a read receipt for one message from the other person (they may see "Seen").mark_message_readPOST …/messages/{message_id}/read
Pin a message at the top of the chat for everyone in it.pin_messagePUT …/messages/{message_id}/pin
Unpin a pinned message.unpin_messageDELETE …/messages/{message_id}/pin

People

What it doesMCP toolREST
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_profileGET …/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_userGET …/users/{user_id}/chat
The connected account's own profile.get_own_profileGET …/profile
Block a person: they can no longer message or follow the account.block_userPOST …/users/{user_id}/block
Unblock a person.unblock_userDELETE …/users/{user_id}/block

Posts and comments

What it doesMCP toolREST
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_mediaPOST /v1/media/check

Schedules and routines

What it doesMCP toolREST
Send a message at a set local time, inside working hours you choose.schedule_messagePOST /v1/messaging/schedules
Messages waiting to be sent.list_schedulesGET /v1/messaging/schedules
Change a scheduled message.update_schedulePATCH /v1/messaging/schedules/{schedule_id}
Cancel a scheduled message.cancel_scheduleDELETE /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_routinePOST /v1/messaging/routines
Your automations.list_routinesGET /v1/messaging/routines
Change or pause an automation.update_routinePATCH /v1/messaging/routines/{routine_id}
Delete an automation.delete_routineDELETE /v1/messaging/routines/{routine_id}
What an automation did, and when.list_routine_runsGET /v1/messaging/routines/{routine_id}/runs

Contacts and campaigns

What it doesMCP toolREST
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_contactsGET /v1/messaging/contacts
One contact with tags and custom fields.get_contactGET /v1/messaging/contacts/{contact_id}
Add a contact by hand, with tags and your own fields.create_contactPOST /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_contactsPOST /v1/messaging/contacts/import
Change a contact's details, tags or fields, or opt them out.update_contactPATCH /v1/messaging/contacts/{contact_id}
Delete a contact and end their sequences.delete_contactDELETE /v1/messaging/contacts/{contact_id}
Saved audience filters over your contacts.list_segmentsGET /v1/messaging/segments
A segment with how many contacts match right now.get_segmentGET /v1/messaging/segments/{segment_id}
Save a filter on tags and contact fields. Use it for broadcasts and sequence enrolment.create_segmentPOST /v1/messaging/segments
Rename a segment or change its filter.update_segmentPATCH /v1/messaging/segments/{segment_id}
Delete a segment.delete_segmentDELETE /v1/messaging/segments/{segment_id}
Your broadcasts and their status.list_broadcastsGET /v1/messaging/broadcasts
Each person of a broadcast with their status, error category and what to do next.list_broadcast_recipientsGET /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_broadcastPOST /v1/messaging/broadcasts
How many recipients are pending, sent, failed or skipped.get_broadcastGET /v1/messaging/broadcasts/{broadcast_id}
Send a drafted broadcast, paced, through your normal limits. Needs confirm: true.send_broadcastPOST /v1/messaging/broadcasts/{broadcast_id}/send
Stop a broadcast. Anyone still waiting is skipped.cancel_broadcastPOST /v1/messaging/broadcasts/{broadcast_id}/cancel
Your drip sequences.list_sequencesGET /v1/messaging/sequences
A sequence with its steps and how many contacts are in each state.get_sequenceGET /v1/messaging/sequences/{sequence_id}
Who is in a sequence, at which step, and why anyone stopped.list_sequence_enrollmentsGET /v1/messaging/sequences/{sequence_id}/enrollments
A drip of messages with delays. Ends for anyone who replies. Sends nothing until you enrol contacts.create_sequencePOST /v1/messaging/sequences
Pause, resume or edit a sequence.update_sequencePATCH /v1/messaging/sequences/{sequence_id}
Delete a sequence and cancel its waiting steps.delete_sequenceDELETE /v1/messaging/sequences/{sequence_id}
Start a sequence for contacts, by id or by tag.enroll_in_sequencePOST /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_dmPOST /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_dmPOST /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_typesGET /v1/messaging/object-types
One object type with its fields and record count.get_object_typeGET /v1/messaging/object-types/{type_id}
Define a record type with typed fields: text, number, boolean, date or select.create_object_typePOST /v1/messaging/object-types
Rename a type or add fields.update_object_typePATCH /v1/messaging/object-types/{type_id}
Delete a type, and its records with confirm.delete_object_typeDELETE /v1/messaging/object-types/{type_id}
Records of a custom type, by type, contact or field value.list_objectsGET /v1/messaging/objects
One record.get_objectGET /v1/messaging/objects/{object_id}
Add a record, linked to a contact if you like. Checked against the type.create_objectPOST /v1/messaging/objects
Change a record's fields or link it to a contact.update_objectPATCH /v1/messaging/objects/{object_id}
Delete a record.delete_objectDELETE /v1/messaging/objects/{object_id}

Workflows

What it doesMCP toolREST
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_workflowPOST /v1/messaging/workflows
Your workflows, with whether each is on, runs this week and the last run.list_workflowsGET /v1/messaging/workflows
One workflow with its trigger and every step.get_workflowGET /v1/messaging/workflows/{workflow_id}
Save changed steps as a new version, or rename it. Runs already going keep their version.update_workflowPATCH /v1/messaging/workflows/{workflow_id}
Turn a workflow on: it starts for each person who matches its trigger.publish_workflowPOST /v1/messaging/workflows/{workflow_id}/publish
Turn a workflow off. No new runs start; runs already going wait.pause_workflowPOST /v1/messaging/workflows/{workflow_id}/pause
Delete a workflow and its runs.delete_workflowDELETE /v1/messaging/workflows/{workflow_id}
Try a workflow on a sample message and see the path it takes. Sends nothing and counts nothing.test_workflowPOST /v1/messaging/workflows/{workflow_id}/test
Who went through a workflow, the path each run took and why it stopped.list_workflow_runsGET /v1/messaging/workflows/{workflow_id}/runs
One run with its step log. No message text.get_workflow_runGET /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_runPOST /v1/messaging/workflow-runs/{run_id}/resume
Stop one run now.cancel_workflow_runPOST /v1/messaging/workflow-runs/{run_id}/cancel
Every saved version of a workflow.list_workflow_versionsGET /v1/messaging/workflows/{workflow_id}/versions
Bring back an old version as the newest one.restore_workflow_versionPOST /v1/messaging/workflows/{workflow_id}/versions/{version}/restore

Triggers

What it doesMCP toolREST
What can start an agent, with the filters each accepts and a sample of the data.list_trigger_typesGET /v1/messaging/trigger-types
Every trigger, whether a person or an agent made it, with status and when it last fired.list_triggersGET /v1/messaging/triggers
Start an agent on an event: a signed POST to your URL when it happens and matches your filters.create_triggerPOST /v1/messaging/triggers
One trigger with its recent deliveries.get_triggerGET /v1/messaging/triggers/{trigger_id}
Pause, resume or edit a trigger.update_triggerPATCH /v1/messaging/triggers/{trigger_id}
Delete a trigger.delete_triggerDELETE /v1/messaging/triggers/{trigger_id}
Send one signed sample event to the trigger's URL.test_triggerPOST /v1/messaging/triggers/{trigger_id}/test
Recent deliveries for a trigger and what your endpoint answered.list_trigger_deliveriesGET /v1/messaging/triggers/{trigger_id}/deliveries

Firewall

What it doesMCP toolREST
Whether the prompt-injection firewall is on, its mode, and what it caught in the last 7 days.get_firewall_statusGET /v1/messaging/firewall
What the firewall blocked or marked, and why. Never the text itself.list_firewall_eventsGET /v1/messaging/firewall/events
Does this text look like an instruction written for an AI? Logs nothing.check_text_for_injectionPOST /v1/messaging/firewall/check

Team

What it doesMCP toolREST
What the whole team shares: accounts, saved replies, routines, sequences, triggers, budget and who is on the team.get_team_setupGET /v1/workspace/setup
Everyone in the workspace with their role, and open invitations for the owner.list_teamGET /v1/workspace/members
Invite a teammate as a member or viewer. The owner only, with confirmation.invite_team_memberPOST /v1/workspace/members
Make a teammate a member or a viewer. The owner only, with confirmation.change_team_member_rolePATCH /v1/workspace/members/{member_id}
Remove a teammate, or cancel an invitation. The owner only, with confirmation.remove_team_memberDELETE /v1/workspace/members/{id}

Pause and approvals

What it doesMCP toolREST
Stop every message, post, comment, invitation, scheduled message and routine at once. Reading keeps working.pause_all_sendingPOST /v1/messaging/pause
Start sending again after a pause. Waiting scheduled messages and routines carry on.resume_all_sendingPOST /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_approvalsPATCH /v1/messaging/settings
Replies, new chats, posts and comments waiting for you to approve them.list_approvalsGET /v1/messaging/approvals
Send a waiting message or post as it is, or after you edit the text.approvePOST /v1/messaging/approvals/{approval_id}/approve
Turn down a waiting message or post, so it is never sent.rejectPOST /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_agentsGET /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_agentPATCH /v1/agents/{agent_id}
Pause another AI agent. It can read and send nothing until it is resumed.pause_agentPOST /v1/agents/{agent_id}/pause
Let a paused AI agent work again.resume_agentPOST /v1/agents/{agent_id}/resume
Remove an AI agent for good. Its key and sign-in stop working.revoke_agentDELETE /v1/agents/{agent_id}
The last 20 things one AI agent did, newest first. No message text.get_agent_activityGET /v1/agents/{agent_id}/activity

Accounts

What it doesMCP toolREST
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_accountsGET /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_idPATCH …
Whether an account is working, what to do if not, and how much room it has left today.get_account_healthGET …/health
A link to connect a new account, or to reconnect one.create_messaging_connect_linkPOST /v1/messaging/accounts/connect-link
Disconnect an account.disconnect_messaging_accountDELETE …
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_linkPOST /v1/chat-links
Your chat links, with how many people clicked each and how many chats it started.list_chat_linksGET /v1/chat-links
Clicks and chats started from one chat link, day by day.get_chat_link_statsGET /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_limitsGET …/limits
Status of one connected account.get_connected_accountGET …
Start reconnecting an account that needs a sign-in.reconnect_accountPOST …/reconnect
Enter a sign-in or verification code the platform asked for. The code is not stored.solve_checkpointPOST …/checkpoint
Ask the platform to send the verification code again.resend_checkpointPOST …/checkpoint/resend
Restart an account that has stopped syncing.restart_accountPOST …/restart
Fetch an account’s messages again from the platform.resync_accountPOST …/sync

Usage and billing

What it doesMCP toolREST
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_linkPOST /v1/links
Your agent's short links and how many people opened each one.list_tracked_linksGET /v1/links
Report a bug, a missing feature or a docs gap to the Spaces team.send_feedbackPOST /v1/feedback
The product survey Spaces is asking, with its 4 questions, or null. At most every 90 days.get_surveyGET /v1/survey
Answer the 4 questions from your own experience of using Spaces for this business, honestly and specifically, with answered_by.answer_surveyPOST /v1/survey/answers
Messages sent today and this week, and how much room is left on each account.get_messaging_usageGET /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_usageGET /v1/messaging/usage/export
Your plan and billing status.get_messaging_billingGET /v1/messaging/billing
Choose a paid plan. Returns a link where the person adds a card.create_messaging_billing_checkoutPOST /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_capPUT /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_flowPOST /v1/billing/cancel/start
The cancel step this flow is on, and the single offer to show.get_cancel_flowGET /v1/billing/cancel/{flow_id}
Send the owner's answer for the current cancel step. Declining the offer moves to confirm.submit_cancel_stepPOST /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_cancelPOST /v1/billing/cancel/{flow_id}/confirm
The review and optional case study this workspace left with Spaces.get_reviewGET /v1/reviews
Leave a short review of Spaces, and optionally a case study, after the owner agrees.submit_reviewPOST /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_feedbackGET /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_claimPOST /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_statusGET /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_rewardPOST /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_linkGET /v1/referral-link
Friends who joined with the owner's link, how many paid, and months earned or pending.get_referral_statusGET /v1/referral-status

Analytics and logs

What it doesMCP toolREST
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_analyticsGET /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_overviewGET /v1/analytics/overview
Only the metric rows that changed since your last cursor, so an agent can poll cheaply.get_analytics_changesGET /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_logsGET /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_logsGET /v1/logs/posts
When each account was connected, reconnected, signed out by the platform or disconnected by the owner, with a reason.list_connection_logsGET /v1/logs/connections

Setup and business brief

What it doesMCP toolREST
Who is calling: the workspace, this key with its scopes and permissions, who made it and the plan.whoamiGET /v1/me
The workspace's default time zone, used whenever a call passes none.get_workspace_timezoneGET /v1/workspace/timezone
Set the workspace's default time zone for schedules, posts, slots and analytics.set_workspace_timezonePUT /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_startedGET /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_actionsGET /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_briefGET /v1/workspace/brief
Save the whole business brief from your answers.set_business_briefPUT /v1/workspace/brief
Change one part of the brief, such as holiday hours or a new price.update_business_briefPATCH /v1/workspace/brief
Start the setup test: you send one message to your account from another phone.start_setup_testPOST /v1/setup/test
See whether the test message arrived and whether your agent replied.check_setup_testGET /v1/setup/test
Who the workspace is for (a business, just you, or an agency), the goal, and what is still unanswered.get_profile_setupGET /v1/workspace/profile
Save the account type, goal and one detail after the owner says yes (owner_confirmed).set_profilePUT /v1/workspace/profile
The goal your AI agent works towards (sales, time or both) and what counts as a win.get_goalGET /v1/workspace/goal
Save the goal and what counts as a win after the owner says yes (owner_confirmed).set_goalPUT /v1/workspace/goal
Record what came of a chat: booked, order, lead won or resolved, with the amount when there is one.record_outcomePOST /v1/outcomes
Outcomes with totals, including revenue influenced.list_outcomesGET /v1/outcomes

Agencies

What it doesMCP toolREST
An agency's clients with status, accounts, replies this week, people waiting and usage. Other tools then take client_id.list_clientsGET /v1/clients
Add a client, with its own accounts, inbox, brief and goal.create_clientPOST /v1/clients
Archive a client: out of the list, keys read-only. Its accounts stay connected and billed.archive_clientPOST /v1/clients/{client_id}/archive
Bring an archived client back.restore_clientPOST /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_linkPOST /v1/clients/{client_id}/connect-link
Accounts and actions per client for a month.get_client_usageGET /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.

FAQ

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?

Free to start

Live in under 60 seconds

Your Facebook messages are waiting right now.

Let your AI agent answer them on Facebook tonight. Free to start, no card needed.

For youStart free, live in 60 secondsNo card needed. Connect WhatsApp, Instagram, LinkedIn or Messenger.
For your AI agent
Set up Spaces for me by following https://www.spacesos.com/agents
Paste it into Grok, Muse, Claude or ChatGPT. Your agent does the rest.