Facebook Connector Installation Guide
CREATING A FACEBOOK DEVELOPER ACCOUNT
A Facebook developer account is required before installing the connector.
-
Navigate to Facebook Developer and click on the Log in button in the top right corner
-
Follow the prompts to set up your developer account
SETTING UP THE FACEBOOK APP
A Facebook app is required to be set up before installing the connector
-
Navigate to Facebook Developer
-
Click on the Create App button

-
Supply a name and contact email and click Next

-
Under Use cases Select Other and click Next

-
Select Business and click Next

-
Under Business Portfolio, select the Facebook business account

-
Click Create app

-
Once the application page is loaded, click Basic under App settings
-
Supply a Display Name
-
Enter the FYB Privacy Policy https://www.fyb.com.au/privacy to the Privacy Policy URL
-
The installation software downloaded from the FYB hub will contain a power2cm-files.zip. Within the zip > icons folder is a Power2CM-App Icon.png file. Upload this file into the app icon section
-
Select Business and pages for the Category
-
Click Save Changes

SETTING UP PERMISSIONS
FACEBOOK USER POST PERMISSIONS
To archive Facebook posts from the currently logged in user, the user_photos and user_posts permissions are required.
-
Navigate to https://developers.facebook.com/ and click "Log in" in the top right corner

-
Hover over Tools and click Graph API Explorer option

-
Under the Meta App section, select the Facebook App that was created in the SETTING UP THE FACEBOOK APP section
-
Click the Generate Access Token button.
NoteYou may be prompted to log in during this step
-
Add the user_photos and user_posts permissions to allow the connector to read the current user's posts and photos

-
Click the Generate Access Token button once more to grant the permissions

-
A pop-up window will appear
-
Click Continue as you do not require to submit this app for review

FACEBOOK PAGE PERMISSIONS
You must be the administrator of the Facebook page to complete this section
The following Facebook Page permissions are required:
- pages_read_user_content
- pages_show_list
- pages_manage_engagement
- business_management
- pages_messaging
- read_page_mailboxes - required for capturing conversations/mailbox messages
-
Navigate to https://developers.facebook.com/ and click "Log in" in the top right corner

-
Hover over Tools and click Graph API Explorer option

-
Under the Meta App section, select the Facebook App that was created in the SETTING UP THE FACEBOOK APP section
-
Click Generate Access Token button.
NoteYou may be prompted to log in during this step
-
Add the following permissions:
- pages_read_user_content
- pages_show_list and pages_manage_engagement.
- business_management
Add the following permissions for archiving Facebook Page Conversations:
- pages_messaging
- read_pages_mailboxes
- read_insights
- pages_manage_engagement
-
Click the Generate Access Token button once more to grant permission.

-
A browser window will open to grant permission for the App. Click the Continue button

-
Select the Facebook Page that you would like to archive posts from and click the Next button

-
Ensure that all three options are enabled, and click Done.
NoteYou do not need to submit your app for review
ACQUIRING A FACEBOOK PAGE ACCESS TOKEN
Facebook Page Access tokens will expire every 90 days (as per Facebook's requirements). When it expires the token will need to be reauthorized by repeating the steps in this section.
In order to archive any paginated data, page posts or conversations/mailbox messages, a Facebook Page Access Token is required.
-
Navigate to the Facebook Graph Explorer.
-
Click the Generate Access Token button and follow the prompts
NoteAt this stage, you should have configured all necessary Permissions
-
Copy the newly generated Temporary Access Token obtained in step 2, and navigate to the Access Token Debugger page.
-
Paste the Temporary Access Token into the search bar and click the Debug button

-
Scroll down to the bottom of the page and click Extend Access Token. If this button is not available, then you have already generated a Long Lived User Access Token

-
You have now generated a Long Lived User Access Token.
-
Click on the debug button and copy the value

-
Navigate back to the Facebook Graph Explorer tool and paste the Long Lived User Access Token obtained in step 5 into the Access Token field. DO NOT click Generate Access Token.

-
Enter me/accounts into the search field and click the Submit button

-
The value of the access_token field is your Page Access Token. You can verify this by copying the Page Access Token and pasting it into the Access Token debugger. The Expires value should be set to Never
-
Navigate to the Power2CM Administration Console > Connector Settings
-
Paste the Page Access Token obtained in step 9 into the Facebook Page Access Token field and click the Save button

OBTAINING THE APP ID AND APP SECRET
-
Navigate to https://developers.facebook.com/apps/
-
Select the Facebook app that was used in step 3 in the SETTING UP THE FACEBOOK APP section

-
In the left menu, expand Settings and click on the Basic option

-
Copy the App ID and App Secret. These values will be needed when setting up the Facebook connector
CONFIGURING COMPLIANCE SETTINGS
The following settings must be configured to comply with Facebook's connectors API access approval.
-
In the left menu, expand Settings and click on the Basic option

-
Enter the FYB Privacy Policy https://www.fyb.com.au/privacy to the Privacy Policy URL
-
The installation software downloaded from the FYB hub will contain a power2cm-files.zip. Within the zip > icons folder is a Power2CM-App Icon.png file. Upload this file into the app icon section
-
For the App Purpose (OPTIONAL) select the Yourself or your own business option.

-
Click on the Save Changes button
DEPLOYING TO POWER AUTOMATE
The section will show you how to set up the Facebook Connector in Power Automate.
-
In Power Automate, Navigate to the left pane menu, click Data, then click Custom connectors

-
Click New Custom Connector and click Import an OpenAPI file

-
Add a name for the Facebook Connector and click the Import button

-
Locate the FYB-Facebook-Connector.swagger.json file included in your power2cm-files.zip and click the Open button

-
Click on the Continue button

-
On the General tab, click on the Upload connector icon option

-
In the power2cm-files.zip > Icons folder, select the Power2CM - Facebook Icon.PNG file and click the Open button

-
Navigate to the Security Tab and enter the App Id and App Secret (see the OBTAINING THE APP ID AND APP SECRET section of this guide) into the Client ID and Client Secret fields respectively

-
Click on the Create connector button

-
Once the connector has been created, in the Security tab, scroll down to and copy the Redirect URL

-
Navigate back to your Facebook app, click Facebook Login and click on the Settings button
-
Scroll down to Valid OAuth Redirect URIs and paste the URL that was copied in step 8
-
Click on the Save Changes button

DATA USE CHECKUP
The Data Use Checkup is an annual requirement by Facebook to verify that the Power2CM connector complies with the Facebook Platform terms and policies.
An email reminder will be sent to the nominated email provided within Facebook's app dashboard.
To complete the Data Use Checkup, follow the steps as outlined here
