Skip to main content
The Facebook Pages toolkit lets agents list Pages the connected user manages, read Page details, and create text/link posts, photo posts, and video posts (including optional scheduling). Authentication is per-user OAuth — each user connects their own Facebook account. Add it on the agent Toolkits tab. The first use prompts the user to connect Facebook if they have not already.

​
Prerequisites

  • A Facebook account that manages the Page(s) the agent should use
  • An agent you can edit
  • Facebook / Meta OAuth configured for your organization (admin)
  • Users who will chat with the agent must complete the Facebook OAuth connect flow when prompted

​
Setup

  1. Confirm an admin has configured the Meta app (App ID, App Secret, redirect URI, and Page scopes).
  2. Open the agent → Toolkits → add Facebook Pages.
  3. Save the agent. In Chat, connect Facebook when prompted and grant Page permissions.
  4. @-mention Facebook Pages tools in the personality prompt for publishing tasks.

​
Available tools

Tools accept an optional page_id; when omitted, the first managed Page is used.

​
Use cases

  • Publish a status update to a company Page from chat
  • Schedule a launch post for a future time
  • Post a product photo or video from a public CDN URL
  • Confirm which Pages the signed-in user can manage

​
Tips

  • Media URLs must be publicly reachable by Meta’s servers.
  • Prefer an explicit page_id when the user manages multiple Pages.
  • Production Meta apps may require App Review for Page publish permissions.
  • Access is limited to Pages the connected Facebook user can manage.

​
Troubleshooting