Managing Your Social Media Connections

Once you've connected your social media accounts to bluekona.ai, you can easily manage all your connections from one central location. This guide covers viewing connection status, refreshing tokens, reconnecting expired accounts, and disconnecting platforms.

Accessing Your Connections

From the Dashboard

1. Log in to bluekona.ai
2. Navigate to Settings from the main menu
3. Select Social Connections

Or use the quick access:

• Click Connect Platform button from any page
• View connection cards on the main dashboard

Connection Overview Page

The Social Connections page displays:

• All your connected accounts
• Connection status for each platform
• Quick action buttons
• Account information summaries

Understanding Connection Status

Each connected account shows a status indicator:

Connected (Green)

• ✅ Connection is active
• ✅ Token is valid
• ✅ Data is syncing
• ✅ Ready for audits

Action needed: None - everything is working properly.

Token Expiring Soon (Yellow)

• ⚠️ Token will expire within 14 days
• ⚠️ Connection still works
• ⚠️ Action recommended soon

Action needed: Consider reconnecting to refresh the token proactively.

Token Expired (Orange)

• ⛔ Token has expired
• ⛔ Cannot run new audits
• ⛔ Data sync paused

Action needed: Click Reconnect to restore the connection.

Connection Error (Red)

• ❌ Connection issue detected
• ❌ Unable to access platform
• ❌ May indicate revoked permissions

Action needed: Try reconnecting. If the issue persists, check the troubleshooting guide.

Syncing (Blue)

• 🔄 Currently retrieving data
• 🔄 Temporary status

Action needed: Wait for sync to complete (usually 2-5 minutes).

Viewing Connection Details

Account Information Display

For each connected account, you'll see:

Platform Logo and Name

• Visual identification of the platform
• Platform-specific icon

Account Details

• Username or handle (@username)
• Profile picture or page logo
• Follower/subscriber count
• Display name

Connection Metadata

• Date connected
• Last sync timestamp
• Token expiration date (if applicable)
• Current status

Metrics Summary

• Recent performance snapshot
• Key metrics at a glance
• Last audit date

Refreshing Connections

Manual Refresh

To manually update data from a connected platform:

1. Go to Settings > Social Connections
2. Find the account you want to refresh
3. Click Refresh Data or Sync Now
4. Wait for the sync to complete (usually 1-3 minutes)

When to refresh manually:

• After posting new content
• Before running an audit
• When you notice data seems outdated
• After making platform changes

Automatic Refresh

bluekona.ai automatically refreshes data:

• Every 24 hours for connected accounts
• When you run an audit
• When you access analytics pages

Reconnecting Accounts

When to Reconnect

You need to reconnect when:

• Token has expired (after 60 days for most platforms)
• You see "Token Expired" status
• Connection shows an error
• You revoked and want to restore access
• Platform permissions were changed

Reconnection Process

1. Locate the Account

   • Go to Settings > Social Connections
   • Find the expired or error account

2. Click Reconnect

   • Click the Reconnect or Refresh Token button
   • You'll be redirected to the platform's OAuth page

3. Re-Authorize

   • Log in to the platform (if needed)
   • Review permissions
   • Click Authorize or Allow

4. Confirmation

   • Redirected back to bluekona.ai
   • Status changes to "Connected"
   • Data sync resumes automatically

Important: Reconnecting preserves all your historical audit data.

Disconnecting Accounts

When to Disconnect

You might want to disconnect an account when:

• You no longer manage that account
• Switching to a different account
• Account has been deleted
• Testing connection issues
• Account ownership changed

Disconnection Process

From bluekona.ai

1. Navigate to Connections

   • Go to Settings > Social Connections

2. Select Account

   • Find the account to disconnect
   • Click the ... menu or Manage button

3. Choose Disconnect

   • Click Disconnect or Remove
   • Confirmation dialog appears

4. Confirm Action

   • Read the warning
   • Confirm you want to disconnect
   • Account is removed immediately

What happens when you disconnect:

• ✅ Connection removed from bluekona.ai
• ✅ OAuth token revoked
• ✅ Historical audit data preserved
• ✅ Can reconnect anytime
• ❌ No new data collected
• ❌ Cannot run new audits for that account

From the Platform

You can also revoke access from the social media platform directly:

Facebook/Instagram:

1. Facebook Settings > Apps and Websites
2. Find bluekona.ai
3. Remove access

YouTube:

1. Google Account > Security
2. Third-party apps with account access
3. Remove bluekona.ai

X (Twitter):

1. X Settings > Security > Apps and sessions
2. Find bluekona.ai
3. Revoke access

LinkedIn:

1. LinkedIn Settings > Data privacy > Permitted services
2. Find bluekona.ai
3. Revoke access

Threads:

1. Instagram Settings > Apps and Websites
2. Remove bluekona.ai

TikTok:

1. TikTok Settings > Apps and websites
2. Remove bluekona.ai

Managing Multiple Accounts

Multiple Accounts of Same Platform

You can connect multiple accounts from the same platform:

Example scenarios:

• Personal YouTube + Brand YouTube
• Multiple Facebook Pages
• Brand Instagram + Personal Instagram (if both are Business accounts)
• Multiple TikTok Business accounts

How it works:

1. Each account connects separately
2. Switch between accounts in dashboard
3. Run individual audits per account
4. Compare performance across accounts

Account Limits

Free Tier:

• Limited number of connected accounts
• Check your plan for specific limits

Paid Tiers:

• Higher connection limits
• Varies by subscription level

Internal/Super Users:

• Unlimited connections for testing

View your current usage:

• Go to Settings > Social Connections
• See "X of Y connected" counter
• Upgrade plan for more connections

Switching Between Accounts

In the Dashboard

When you have multiple accounts:

1. Account Selector

   • Dropdown menu shows all connected accounts
   • Click to switch active account

2. Filter by Platform

   • Filter connections by platform type
   • View only Facebook accounts, etc.

3. Quick Actions

   • Jump directly to account analytics
   • Run platform-specific audits

In Analysis View

• Select which account's audit to view
• Compare results across accounts
• Cross-platform analysis includes all connected

Connection Health Monitoring

Regular Maintenance

Best practices for maintaining healthy connections:

Weekly:

• Check connection status dashboard
• Review any expiring tokens
• Refresh data if needed

Monthly:

• Verify all accounts still connected
• Reconnect any expired tokens
• Remove unused connections

Before Campaigns:

• Ensure all relevant accounts connected
• Run manual refresh for latest data
• Check token expiration dates

Notifications

bluekona.ai sends notifications for:

• Token expiring within 7 days
• Connection errors detected
• Failed data syncs
• Successful reconnections

Enable notifications:

• Go to Settings > Notifications
• Toggle connection alerts
• Choose email or in-app notifications

Troubleshooting Connection Issues

Common Problems

"Cannot connect account"

• Check account type requirements (Business, Page, etc.)
• Verify admin permissions
• Try different browser
• Clear cache and retry

"Connection keeps expiring"

• This is normal (60-day token lifecycle)
• Reconnect when prompted
• Enable expiration notifications

"Multiple accounts showing same data"

• Verify you selected different accounts during OAuth
• Disconnect and reconnect with correct account
• Check account IDs match

"Account disappeared from list"

• Token may have auto-expired
• Platform may have revoked access
• Check platform's authorized apps list
• Reconnect the account

Getting Help

If you can't resolve connection issues:

1. Check Documentation

   • Platform-specific connection guides
   • Troubleshooting section
   • Token expiration guide

2. Platform Status

   • Verify the social platform is online
   • Check for API outages
   • Review platform's status page

3. Contact Support

   • Describe the specific issue
   • Include platform and account type
   • Share error messages if any

Best Practices

Connection Management

Do:

• ✅ Reconnect tokens before they expire
• ✅ Remove accounts you no longer manage
• ✅ Verify connections before major audits
• ✅ Keep admin access on all connected accounts

Don't:

• ❌ Wait until token expires to reconnect
• ❌ Connect accounts you don't own
• ❌ Share connection credentials
• ❌ Ignore connection error notifications

Security

Protect your connections:

• Use strong passwords for social accounts
• Enable two-factor authentication on platforms
• Regularly review authorized apps
• Revoke access if account is compromised
• Don't share bluekona.ai login

Organization

For agencies or teams:

• Label accounts clearly (Client Name - Platform)
• Document which client owns each account
• Track token expiration dates
• Assign team members to specific accounts

Data After Disconnection

What Remains

When you disconnect an account:

• ✅ Historical audit reports stay accessible
• ✅ Past analytics data preserved
• ✅ Comparison data still available
• ✅ Insights and recommendations saved

What Stops

• ❌ New data collection
• ❌ Automatic refreshes
• ❌ Ability to run new audits
• ❌ Real-time status updates

Reconnecting Later

You can always reconnect:

1. Go to connection page
2. Add the platform again
3. Authorize through OAuth
4. Historical + new data available

Note: Gap periods won't have data (when disconnected).

Next Steps

• Run your first audit with connected accounts
• Learn about specific platform connections
• Understand audit results
• Troubleshoot connection issues

Need help managing your connections? Visit our troubleshooting guide or contact support.