Requirements
If you are trying to connect assets from a business page, you will need to be the facebook business account owner, or a facebook business account invited member with full control. You will also need to have an account with App and Integrations permissions enabled.
If you are neither of these, please read our companion guide on adding an account to the facebook business manager with the necessary permissions.
The business account you wish to connect will also have had to be verified by Meta. While creating your OAuth app you may be prompted to do so. The process will ask you to confirm business address, contact details and website. The two processes you will need to go through are to:
Verify legal business name
Verify address or phone number
Setting up OAuth for Facebook
If you have already set up a Meta developer account after following our Instagram integration guide, please skip to Step 2. The video tutorial below starts at Step 2.
Step 1: Create a Facebook App
From the "Facebook Developers" page click on "Get Started." or 'Log in' in the top right of the page.
If you have not registered for a developer account you can do so now. Enter your preferred email, contact information, and which of the following roles best suites you.
You will now be on the 'Meta Apps' page. Click on the 'Create App' in the middle of the page.
Click on "Other" from the list of what you want your app to do.
Click on "Business" from the list of app types.
Fill in the requested details, such as your custom app's name (Such as 'Medialake'), email, and click "Create App ID." Under 'Business Account' ensure you select your business manager account from the list of options.
Click on 'Create', where you will be taken to the next page.
Step 2: Configure Facebook Login for Business
In your app's dashboard, click "Set Up" for the "Facebook Login for Business" card.
Click on the Settings panel for the "Facebook Log In" app you have just made.
In the "Valid OAuth Redirect URIs" section please add your Medialake domain with the Facebook redirect at the end, so it looks something like:
https://'YOUR_DOMAIN'/facebook-redirectMake sure to click the "Save Changes" button at the bottom of the page.
Step 3: Product configurations
Under the 'Facebook Login for Business' tab on the left hand side navigation bar, click on the 'Configurations; tab.
Click on 'Create configuration' in the middle of the screen, and add a name for the app configuration.
Click on the 'General' for the 'Choose login variation' section, and then 'User access token' for the 'Create a configuration' section on the next page.
In the choose permissions section, select the following options from the dropdown list:
pages_show_list,
pages_read_engagement,
pages_read_user_content,
instagram_basic,
business_management
You will be given a Configuration ID. Please make a note of this as it will need to be entered into your Facebook settings on the Medialake platform.
Step 4: Adding an App domain / App ID and App Secret
On the navigation bar on the left hand side of the page, click on the "App Settings" section. Make sure you click on the "Basic" tab that just appeared on the navigation bar on the left side of the screen.
In the "App domains" section, please enter your Medialake domain to the text box.
Make sure to click the "Save Changes" button at the bottom of the page.
At the top of the the page, please make a note of the App ID and App Secret.
Enter the App ID, App Secret, and configuration ID into the settings page for the Facebook integration on the medialake.ai website.
Important Considerations
Make sure to follow security best practices, especially when handling client secrets.
After making your OAuth app, and when trying to connect the Facebook integration through the Medialake catalogues page, please ensure that you are either already signed into the account you created the OAuth app with, or are signed out entirely which will then prompt you to sign in with the correct account.