Facebook & Instagram Integration
Connect your Facebook Pages and Instagram Business accounts to Iverton AI for social media publishing, engagement tracking, message management, and audience insights.
Overview
The Facebook integration uses OAuth 2.0 to securely connect your accounts. Once connected, you can:
- Schedule and publish posts to Facebook Pages and Instagram
- Monitor comments, messages, and mentions
- Track engagement metrics and audience growth
- Manage multiple pages and accounts from one dashboard
- Set up automated responses and alerts
Instagram Business accounts must be connected to a Facebook Page. You'll connect Instagram through the Facebook integration.
Connecting Facebook Pages
Prerequisites
Before connecting, ensure you have:
- Admin or Editor role on the Facebook Page(s) you want to connect
- A personal Facebook account linked to those pages
- Pages must be published (not unpublished/draft)
Step-by-Step Connection
- Go to Integrations in the main sidebar
- Find Facebook in the Social Media category
- Click Connect
- A Facebook login popup will appear
- Log in with your personal Facebook account
- Review the permissions Iverton AI is requesting
- Select which Pages you want to connect
- Click Done to complete the authorization
Permissions Requested
Iverton AI requests these Facebook permissions:
| Permission | What It Allows | Required |
|---|---|---|
pages_manage_posts | Create, edit, and delete posts on your pages | Yes |
pages_read_engagement | View comments, reactions, and shares | Yes |
pages_manage_engagement | Respond to comments and messages | Yes |
pages_read_user_content | See posts from your audience | Yes |
pages_show_list | See which pages you manage | Yes |
business_management | Access business asset permissions | Yes |
You can review exactly what each permission allows before approving.
Selecting Pages
After authorization, you'll see a list of all Facebook Pages you have access to. For each page, you can:
- Connect: Enable the page for use in Iverton AI
- Skip: Don't connect this page (you can add it later)
Select all pages you want to manage, then click Save.
Connecting Instagram Business
Instagram connects through Facebook. Your Instagram Business or Creator account must be linked to a Facebook Page.
Prerequisites
- Instagram Business or Creator account (not a personal account)
- The Instagram account must be connected to a Facebook Page
- You must have admin access to the linked Facebook Page
Converting to Business Account
If you have a personal Instagram account:
- Open the Instagram app
- Go to Settings → Account
- Tap Switch to Professional Account
- Choose Business or Creator
- Follow the prompts to connect to a Facebook Page
Connecting Instagram
- First, connect your Facebook account (see above)
- During the Facebook authorization, Instagram accounts linked to your selected Pages will appear
- Select the Instagram accounts you want to connect
- Complete the authorization
Or, if Facebook is already connected:
- Go to Integrations → Facebook
- Click Add Instagram Account
- Select from the Instagram accounts linked to your connected Pages
Instagram Permissions
| Permission | What It Allows | Required |
|---|---|---|
instagram_basic | Read profile info and media | Yes |
instagram_content_publish | Publish posts and stories | Yes |
instagram_manage_comments | Read and respond to comments | Yes |
instagram_manage_insights | View performance metrics | Yes |
Features
Post Scheduling
Schedule posts to Facebook Pages and Instagram from a unified interface.
Supported Content Types
| Content | ||
|---|---|---|
| Text posts | Yes | Yes (with image) |
| Single image | Yes | Yes |
| Multiple images (carousel) | Yes | Yes (up to 10) |
| Video | Yes | Yes (up to 60 min) |
| Stories | Limited | Yes |
| Reels | No | Coming soon |
| Links with preview | Yes | No (link in bio) |
Scheduling Options
- Post immediately
- Schedule for a specific date and time
- Add to content queue (posts at optimal times)
- Draft for later review
Best Practices
- Instagram requires at least one image or video
- Square images (1:1) work best on Instagram
- Include alt text for accessibility
- Use hashtags strategically (Instagram allows up to 30)
Engagement Monitoring
Track how your audience interacts with your content.
Available Metrics
For Facebook Pages:
- Post reach and impressions
- Reactions (like, love, haha, wow, sad, angry)
- Comments and shares
- Link clicks
- Video views and watch time
- Page followers gained/lost
For Instagram:
- Post reach and impressions
- Likes and comments
- Saves and shares
- Profile visits from posts
- Follower growth
- Story views and interactions
Message Management
View and respond to messages from a unified inbox.
Facebook Messenger
- See incoming messages from your Page
- Reply directly from Iverton AI
- Mark messages as read/unread
- Assign conversations to team members
Instagram Direct
- View DMs sent to your business account
- Respond to inquiries
- Manage message requests
Social Listening
Monitor mentions and conversations about your brand.
Tracked Items
- Comments on your posts
- @mentions of your page
- Posts where you're tagged
- Reviews on Facebook
Alerts
- Get notified of new mentions
- Set up keyword alerts
- Prioritize messages requiring urgent response
Automated Responses
Set up automatic replies for common scenarios.
Auto-Reply Options
- Instant reply when someone messages your Page
- Away messages for outside business hours
- FAQ responses for common questions
Configure automated responses in Settings → Social Media → Auto Responses.
Data Syncing
Sync Frequency
Iverton AI syncs data from Facebook/Instagram on this schedule:
| Data Type | Sync Frequency |
|---|---|
| New posts | Real-time (via webhooks) |
| Engagement metrics | Every 15 minutes |
| Messages | Real-time (via webhooks) |
| Follower counts | Every hour |
| Full analytics | Daily |
Manual Sync
To force an immediate data sync:
- Go to Integrations → Facebook
- Click Sync Now
- Wait for the sync to complete
Token Management
Token Expiration
Facebook access tokens have different lifespans:
- Short-lived tokens: 1-2 hours (used during initial auth)
- Long-lived tokens: ~60 days (what Iverton AI stores)
- Page tokens: Do not expire if derived from long-lived user tokens
Iverton AI automatically:
- Exchanges short-lived tokens for long-lived tokens
- Refreshes tokens before they expire
- Notifies you if manual re-authorization is needed
Re-Authorization
If your connection expires or you see a warning:
- Go to Integrations → Facebook
- Click Reconnect
- Complete the Facebook authorization flow
- Select the pages you want to reconnect
Re-authorization is typically needed when:
- Your Facebook password changed
- You revoked Iverton AI's access in Facebook settings
- Facebook's security policies required re-verification
- The token expired and couldn't be refreshed
Troubleshooting
Common Issues
"Page not appearing in selection list"
- Verify you have Admin or Editor role on the Page
- Check that the Page is published, not in draft mode
- Try disconnecting and reconnecting your Facebook account
"Instagram account not showing"
- Confirm it's a Business or Creator account, not personal
- Verify the Instagram account is linked to a Facebook Page
- Ensure you selected that Facebook Page during authorization
"Posts not publishing"
- Check that the connected Page token is still valid
- Verify you have
pages_manage_postspermission - Ensure the content meets Facebook/Instagram guidelines
- Check for content policy violations in the error message
"Engagement data not updating"
- Data may take 15-30 minutes to sync
- Try a manual sync from the integration settings
- Verify the
pages_read_engagementpermission is granted
"Messages not appearing"
- Check that Messenger is enabled for your Page
- Verify the
pages_manage_engagementpermission - Some message types may be filtered by Facebook
Facebook App Review
If you see limited functionality, it may be because some permissions require Facebook App Review. Iverton AI has completed App Review for standard business use. If you're using advanced features or high-volume APIs, contact support.
Rate Limits
Facebook enforces API rate limits:
| Limit Type | Threshold | Reset |
|---|---|---|
| Calls per hour | 200 per user per hour | Hourly |
| Pages per app | 4800 calls per day | Daily |
| Instagram content publishing | 25 posts per day | Daily |
If you hit rate limits:
- Wait for the reset period
- Reduce posting frequency
- Contact support for enterprise limits
Disconnecting
To remove the Facebook/Instagram integration:
- Go to Integrations → Facebook
- Click Disconnect
- Confirm the disconnection
This removes Iverton AI's access to your Pages and Instagram accounts. Your data in Iverton AI is retained, but no new data will sync.
To fully revoke access, also remove Iverton AI from:
- Facebook: Settings → Security and Login → Apps and Websites → Remove
- Instagram: Settings → Security → Apps and Websites → Remove
API Endpoints Reference
For developers integrating with the social media API:
GET /api/oauth/facebook - Initiate Facebook OAuth
GET /api/oauth/facebook/callback - OAuth callback handler
GET /api/social-accounts - List connected accounts
DELETE /api/social-accounts/facebook/:id - Disconnect account
POST /api/oauth/refresh/facebook/:id - Refresh access token
GET /api/oauth/status/facebook/:id - Check connection status
Environment Variables
For self-hosted deployments:
# Facebook App credentials
FACEBOOK_APP_ID=your-app-id
FACEBOOK_APP_SECRET=your-app-secret
# Webhook verification (for real-time updates)
FACEBOOK_VERIFY_TOKEN=your-verify-token
# Optional: Default access token for testing
FACEBOOK_ACCESS_TOKEN=your-access-token
Next: LinkedIn Integration