https://bluekona.ai
Sign inSign up

Connecting Facebook Pages

Step-by-step guide to connecting your Facebook Page to bluekona.ai for analytics and insights.

Connect your Facebook Page to bluekona.ai to analyze page performance, post engagement, and audience insights. This guide walks you through the entire connection process.

Prerequisites

Before connecting your Facebook Page, ensure you have:

Account Requirements

  • Facebook Page (not a personal profile)
  • Admin or Editor access to the Page
  • Active Facebook account in good standing

Important Notes

  • Personal Facebook profiles cannot be connected
  • You must manage or own the Facebook Page
  • The Page must be published (not unpublished/draft)

Connection Process

Step 1: Navigate to Connections

  1. Log in to your bluekona.ai dashboard
  2. Go to Settings > Social Connections or
  3. Click the Connect Platform button on the dashboard
  4. Select Facebook from the list of platforms

Step 2: Authorize with Facebook

When you click Connect Facebook, you'll be redirected to Facebook's official OAuth page.

What happens next:

  1. You'll see Facebook's authorization screen
  2. Log in with your Facebook credentials (if not already logged in)
  3. Facebook will show which account you're connecting with

Step 3: Grant Permissions

Facebook will request the following read-only permissions:

Required Permissions

  • pages_show_list - View your Facebook Pages
  • pages_read_engagement - Read Page engagement data
  • read_insights - Access Page analytics and insights
  • pages_read_user_content - View posts published to your Pages
  • public_profile - Basic public profile information

Instagram Integration (Optional)

If your Facebook Page is linked to an Instagram Business account:

  • instagram_basic - Access Instagram account info
  • instagram_manage_insights - Read Instagram analytics

Why we need these permissions:

  • Retrieve Page performance metrics (views, reach, impressions)
  • Analyze post engagement (likes, comments, shares)
  • Access audience demographics
  • Track follower growth over time

Step 4: Select Your Page

After granting permissions:

  1. Facebook will show all Pages you manage
  2. Select the Page(s) you want to connect
  3. Click Continue or Done

Step 5: Complete Connection

You'll be redirected back to bluekona.ai:

  1. See a success message confirming the connection
  2. Your Facebook Page now appears in your connected accounts
  3. Initial data sync begins automatically

What Data is Collected?

Once connected, bluekona.ai retrieves:

Page Analytics

  • Total page views and reach
  • Page followers and growth trends
  • Post impressions and engagement
  • Page actions (clicks, contact info taps)

Post Performance

  • Individual post metrics (last 14 days by default)
  • Likes, comments, shares, reactions
  • Post reach and impressions
  • Click-through rates

Audience Insights (when available)

  • Age and gender demographics
  • Geographic location data
  • Active times and peak engagement periods

RSS Fallback

If the Facebook API encounters issues, bluekona.ai can use RSS feeds as a backup to retrieve basic post data.

Understanding the Dashboard

After connecting, your Facebook Page appears in the Social Connections area:

Status Indicators

  • Connected (Green) - Active and collecting data
  • Token Expiring Soon (Yellow) - Will need reconnection soon
  • Token Expired (Orange) - Requires reconnection
  • Error (Red) - Connection issue detected

Quick Actions

  • View Analytics - Jump directly to Facebook insights
  • Reconnect - Refresh the OAuth token
  • Disconnect - Remove the connection

Token Expiration

Facebook access tokens expire after 60 days for security.

What Happens When Token Expires?

  • You'll receive a notification
  • Connection status changes to "Expired"
  • New audits cannot be run until reconnected
  • Historical data remains intact

Reconnecting

  1. Click Reconnect next to your Facebook connection
  2. Re-authorize through Facebook OAuth
  3. Your connection is restored immediately
  4. No data is lost

Running Your First Facebook Audit

Once connected:

  1. Go to Dashboard or Analysis
  2. Click Start Single Platform Audit
  3. Select Facebook from the platform list
  4. Confirm and start the audit
  5. Results ready in 2-5 minutes

The AI will analyze:

  • Content performance trends
  • Best performing post types
  • Optimal posting times
  • Engagement patterns
  • Audience behavior
  • Growth opportunities

Troubleshooting

Connection Failed

"Unable to retrieve Pages"

  • Ensure you have admin or editor access
  • Verify the Page is published
  • Try logging out of Facebook and back in
  • Clear browser cache and retry

"Permissions denied"

  • All required permissions must be granted
  • Go back and approve all permission requests
  • Some permissions are mandatory for analytics

"Redirect URI mismatch"

  • This is a configuration issue
  • Contact bluekona.ai support
  • Do not modify OAuth settings

No Data Showing

After successful connection:

  1. Wait 5-10 minutes for initial sync
  2. Ensure your Page has published posts
  3. Check that the Page has recent activity (last 14 days)
  4. Try running a manual audit

If data is still missing:

  • Verify Page permissions haven't changed
  • Check if the Page was recently created (may need time)
  • Review Facebook's API status for outages

Instagram Not Showing

If your Instagram Business account isn't appearing:

  1. Verify Instagram is linked to your Facebook Page
  2. Ensure it's an Instagram Business (not Personal) account
  3. Check that you granted Instagram permissions during OAuth
  4. You may need to reconnect specifically for Instagram

Facebook Page Types

bluekona.ai works with all Facebook Page types:

  • Business Pages
  • Brand Pages
  • Public Figure Pages
  • Community Pages
  • Nonprofit Pages

Multiple Pages

You can connect multiple Facebook Pages:

  1. Each Page is tracked separately
  2. Run individual audits per Page
  3. Compare performance across Pages
  4. Switch between Pages in the dashboard

Note: The number of connected accounts may be limited by your bluekona.ai plan.

Privacy & Data Storage

What We Store

  • Page metadata (name, ID, category)
  • Performance metrics and analytics
  • Post content and engagement data
  • OAuth access tokens (encrypted)

What We Don't Store

  • Personal messages or conversations
  • Personal profile information
  • Payment methods
  • Private posts or drafts

Data Retention

  • Analytics data: Stored per your plan
  • Access tokens: Refreshed every 60 days
  • Historical audits: Available in your account

Disconnecting Facebook

To remove your Facebook Page connection:

  1. Go to Settings > Social Connections
  2. Find your Facebook Page
  3. Click the disconnect or remove option
  4. Confirm the action

What happens:

  • Connection is immediately removed
  • Access token is revoked
  • Historical audit data remains available
  • You can reconnect anytime

Revoking from Facebook

You can also revoke access directly in Facebook:

  1. Go to Facebook Settings & Privacy > Settings
  2. Click Security and Login
  3. Select Apps and Websites
  4. Find bluekona.ai
  5. Click Remove

Best Practices

For Best Results

  • Keep your token active by running regular audits
  • Connect early in the month for comprehensive monthly data
  • Reconnect before token expiration
  • Ensure your Page has consistent posting activity

Audit Frequency

  • Weekly: For active Pages posting daily
  • Bi-weekly: For moderate posting schedules
  • Monthly: For occasional content updates

Next Steps

Need help? Check our troubleshooting guide or contact support.