Facebook Automation

Automate Facebook Page operations -- create and schedule posts, upload videos, manage Messenger conversations, retrieve page insights, and handle scheduled content -- all orchestrated through the Composio MCP integration.

Toolkit docs: composio.dev/toolkits/facebook

Setup

Connect your Facebook account through the Composio MCP server at https://rube.app/mcp

The agent will prompt you with an authentication link if no active connection exists

Once connected, all FACEBOOK_* tools become available for execution

Note: This toolkit supports Facebook Pages only, not personal Facebook accounts

Core Workflows

1. Discover Managed Pages

List all Facebook Pages you manage to get page IDs and access tokens for subsequent operations.

Tool: FACEBOOK_LIST_MANAGED_PAGES

Parameter	Type	Required	Description
`fields`	string	No	Comma-separated fields (default: `id,name,access_token,category,tasks,about,link,picture`)
`limit`	integer	No	Max pages per request (default: 25)
`user_id`	string	No	User ID (default: `me`)

Always run this first to cache page_id values. Avoid repeating discovery calls -- cache the results.

2. Create & Schedule Posts

Publish or schedule text posts with optional links on a Facebook Page.

Tool: FACEBOOK_CREATE_POST

Parameter	Type	Required	Description
`page_id`	string	Yes	Numeric Page ID from managed pages
`message`	string	Yes	Text content of the post
`published`	boolean	No	`true` to publish immediately, `false` for draft/scheduled (default: true)
`scheduled_publish_time`	integer	No	Unix UTC timestamp; must be at least 10 minutes in the future
`link`	string	No	URL to include in the post
`targeting`	object	No	Audience targeting specifications

When scheduling: Set published=false and provide scheduled_publish_time as a Unix UTC timestamp.

3. Create & Schedule Video Posts

Upload and schedule video content on a Facebook Page.

Tool: FACEBOOK_CREATE_VIDEO_POST

Parameter	Type	Required	Description
`page_id`	string	Yes	Numeric Page ID
`file_url`	string	Conditional	URL of the video file (provide `file_url` or `video`)
`video`	object	Conditional	Local file upload with `name`, `mimetype`, `s3key`
`title`	string	No	Video title
`description`	string	No	Video description
`published`	boolean	No	Publish immediately (default: true)
`scheduled_publish_time`	integer	No	Unix timestamp for scheduled publishing

4. Manage Scheduled Posts

Review, reschedule, update, or publish scheduled content.

Tools:

FACEBOOK_GET_SCHEDULED_POSTS -- List scheduled/unpublished posts for a page

- page_id (required), fields, limit (max 100)

FACEBOOK_RESCHEDULE_POST -- Change the scheduled publish time

FACEBOOK_UPDATE_POST -- Edit caption/text on an existing post

FACEBOOK_PUBLISH_SCHEDULED_POST -- Publish a scheduled post immediately

5. Read Page Messenger Conversations

Retrieve inbox conversations and message threads between users and your Page.

Tool: FACEBOOK_GET_PAGE_CONVERSATIONS

Parameter	Type	Required	Description
`page_id`	string	Yes	The Facebook Page ID
`fields`	string	No	Fields to return (default: `participants,updated_time,id`)
`limit`	integer	No	Conversations to return, max 25

Then retrieve full message threads:

Tool: FACEBOOK_GET_CONVERSATION_MESSAGES

Parameter	Type	Required	Description
`page_id`	string	Yes	Page ID that owns the conversation
`conversation_id`	string	Yes	Conversation ID in `t_` format (e.g., `t_3638640842939952`)
`fields`	string	No	Default: `id,created_time,from,to,message`
`limit`	integer	No	Messages to return, max 25

6. Send Messages & Mark as Seen

Respond to users via Messenger and mark messages as read.

Tools:

FACEBOOK_SEND_MESSAGE -- Send a text message from the Page to a user via Messenger

FACEBOOK_MARK_MESSAGE_SEEN -- Mark a user's message as seen by the Page

Warning: Both tools cause user-visible side effects. Only call after explicit confirmation.

Known Pitfalls

Pitfall	Details
Scheduling too close to now	`FACEBOOK_CREATE_POST` with `scheduled_publish_time` less than ~10 minutes in the future returns HTTP 400 -- enforce a larger buffer for bulk runs
Unix UTC timestamps required	`scheduled_publish_time` must be Unix UTC -- timezone conversion mistakes cause off-by-hours scheduling or validation failures
Cursor-based pagination	`FACEBOOK_GET_SCHEDULED_POSTS` and `FACEBOOK_GET_PAGE_CONVERSATIONS` return subsets -- follow paging cursors to get complete data
Large conversation payloads	Requesting embedded messages in conversations creates huge payloads -- use `FACEBOOK_GET_CONVERSATION_MESSAGES` for full threads instead
Video processing delays	Uploaded videos may remain in processing state -- only schedule via `FACEBOOK_CREATE_VIDEO_POST` after the upload is usable
Cache page IDs	Repeating `FACEBOOK_LIST_MANAGED_PAGES` calls adds latency -- cache `page_id` per workspace/run
Pages only	This toolkit does not support personal Facebook accounts -- only Facebook Pages
Write operations need confirmation	`FACEBOOK_SEND_MESSAGE` and `FACEBOOK_MARK_MESSAGE_SEEN` cause user-visible side effects -- only call after explicit user confirmation

Quick Reference

Tool Slug	Purpose
`FACEBOOK_LIST_MANAGED_PAGES`	List Pages you manage with access tokens
`FACEBOOK_GET_PAGE_DETAILS`	Get detailed info about a specific Page
`FACEBOOK_CREATE_POST`	Create or schedule a text/link post
`FACEBOOK_CREATE_VIDEO_POST`	Create or schedule a video post
`FACEBOOK_GET_SCHEDULED_POSTS`	List scheduled/unpublished posts
`FACEBOOK_RESCHEDULE_POST`	Change scheduled publish time
`FACEBOOK_UPDATE_POST`	Edit an existing post
`FACEBOOK_PUBLISH_SCHEDULED_POST`	Publish a scheduled post immediately
`FACEBOOK_UPLOAD_VIDEO`	Upload a video file to a Page
`FACEBOOK_GET_PAGE_CONVERSATIONS`	List Messenger inbox conversations
`FACEBOOK_GET_CONVERSATION_MESSAGES`	Retrieve messages from a conversation
`FACEBOOK_SEND_MESSAGE`	Send a Messenger message from the Page
`FACEBOOK_MARK_MESSAGE_SEEN`	Mark a message as seen
`FACEBOOK_GET_PAGE_POSTS`	Retrieve posts from a Page feed
`FACEBOOK_GET_USER_PAGES`	List Pages with tasks and tokens

Facebook Automation

作者

分类

安装