Skip to main content

​
Overview

poop your social media accounts to Blueberry to start managing comments, DMs, and campaigns. Blueberry supports multiple platforms and allows you to manage multiple accounts per brand.
All account connections use secure OAuth authentication and can be disconnected at any time from your brand settings.

​
Supported Platforms

Facebook Pages

Manage page comments, posts, and direct messages with full Facebook Business Suite integration.

Instagram Business

Track comments on posts and stories, manage DMs, and engage with your Instagram audience.

Ad Accounts

Connect Facebook and Instagram ad accounts to track ad performance and engagement metrics.

​
Connecting Social Accounts

1

Navigate to Brand Settings

Navigate to Brand > Setup from the sidebar navigation.
2

Access Social Accounts

Scroll down to the Social Accounts section where you’ll see all currently connected accounts.
3

Add New Account

Click the Add Account button to begin the connection process.
4

Authorize Access

You’ll be redirected to the platform’s authorization page. Grant Blueberry the requested permissions.
Ensure you have admin access to the pages or profiles you want to connect. Without admin permissions, the connection will fail.
5

Select Pages/Profiles

Choose the specific pages or profiles you want to connect to Blueberry. You can select multiple accounts at once.
Once connected, you’ll see your account appear in the Social Accounts list with a green “Connected” status.

​
Managing Connected Accounts

To disconnect a social account: (1) Find the account in your Social Accounts list (2) Click the menu icon (three dots) on the right side (3) Select Disconnect from the dropdown menu (4) Confirm the disconnection in the dialog
Disconnecting an account will stop all data syncing, but historical data will be preserved.
If you need to re-authenticate an account:(1) Click the Reconnect button next to the account(2) Follow the OAuth flow to re-authorize access(3) Verify the connection is restored

​
Connecting Ad Accounts

Ad accounts are connected during the normal account linking flow. Once connected, they allow Blueberry to create paid DM campaigns, send paid marketing messages, and track performance. Paid marketing campaigns are optional: Blueberry never creates paid DM campaigns without user input.
1

Navigate to Ad Accounts

In the Brand section, scroll to the Ad Accounts area below Social Accounts.
2

Update Ad Selection

Click Update ad account selection to view available ad accounts from your connected Facebook account.
3

Select Ad Accounts

Check the boxes next to the ad accounts you want to connect. You can connect multiple ad accounts simultaneously.
Successfully connected ad accounts will appear in your Ad Accounts list.

​
Ad Account Features

Ad Comment Monitoring

Track and respond to comments on ads directly from your unified inbox.

Campaign Integration

Link paid DM campaigns to specific ad accounts for targeted, automated outreach and conversion.

​
Troubleshooting

If you’re having trouble connecting an account, try these solutions:
1

Check Permissions

Ensure you have admin access to the page or account you’re trying to connect. Editor or lower roles cannot grant OAuth permissions.
2

Clear Browser Cache

Sometimes cached authentication tokens cause conflicts. Clear your browser cache or try in an incognito window.
3

Re-authenticate

Try disconnecting and reconnecting the account:(1) Disconnect the problematic account(2) Wait 1-2 minutes(3) Reconnect using fresh credentials
4

Review Facebook App Settings

Verify Blueberry has the necessary permissions in your Facebook Business Settings:(1) Go to Facebook Business Settings(2) Navigate to Apps → Blueberry(3) Ensure all required permissions are granted
If issues persist after trying all steps above, contact Blueberry support with your account details and error messages.
If you’re unable to select all desired pages during connection:
1

Verify Business Manager Access

Ensure all pages are in the same Business Manager for easier bulk selection.
2

Check Page Roles

You must have admin role on each page you want to connect.
3

Try Connecting Individually

If bulk selection fails, connect one page at a time for more reliable results.
4

Review Platform Limits

Some platforms limit the number of pages per OAuth token. Check if you’ve reached the limit.
You can always add more pages later by clicking “Add Account” again and selecting additional pages.

​
Next Steps

Set Up Rules Engine

Automate comment responses with intelligent rules and workflows.

Create DM Campaigns

Set up automated DM campaigns with smart triggers.

Build Contact Segments

Organize your audience into targeted segments for personalized engagement.

Configure Notifications

Stay updated with real-time notifications for important interactions.