Docs/r3-x/Platform Integration

Platform Integration

Connect and publish to Facebook, Instagram, and X/Twitter.


Supported Platforms

R3-X supports publishing to three major social media platforms:

PlatformAuth MethodMedia Support
Facebook PagesMeta Business LoginUp to 10 images
Instagram BusinessInstagram Business LoginCarousel up to 10 images
X/TwitterOAuth 2.0 PKCEUp to 4 images

Facebook

Facebook Setup

  1. Go to Settings → Platforms
  2. Click Connect Facebook
  3. Authorize with your Facebook account
  4. Select the Page(s) you want to manage

Facebook Publishing

Facebook posts use binary multipart upload for images. This ensures maximum image quality without exposing image URLs.

Facebook Requirements

  • A Facebook Page (personal profiles are not supported)
  • Page admin or editor role

Instagram

Instagram Setup

Instagram uses a separate OAuth flow from Facebook (Instagram Business Login):

  1. Go to Settings → Platforms
  2. Click Connect Instagram
  3. Authorize with your Instagram account
  4. Your Instagram Business/Creator account will be linked

Instagram Publishing

Instagram uses the Content Publishing API:

  1. Images are uploaded via public URL
  2. Media containers are created for each image
  3. For carousels, containers are combined into a carousel container
  4. The post is published

Instagram Requirements

  • Instagram Business or Creator account
  • Account must be linked to a Facebook Page

Instagram supports carousel posts with up to 10 images. The first image determines the aspect ratio for all images in the carousel.

X/Twitter

X/Twitter Setup

  1. Go to Settings → Platforms
  2. Click Connect X/Twitter
  3. Authorize via OAuth 2.0 with PKCE
  4. Your account will be linked

X/Twitter Publishing

  • Text tweets with optional media attachments
  • Up to 4 images per tweet
  • 280 character limit for text

X/Twitter Requirements

  • X/Twitter account
  • API access (may require developer account)

Character Limits

Each platform has different character limits that R3-X respects:

PlatformCharacter Limit
X/Twitter280
Instagram2,200
Facebook63,206

The AI agent automatically adapts content length for each platform.