Skip to main content

Facebook Connector Installation Guide

Raise a support ticket

CREATING A FACEBOOK DEVELOPER ACCOUNT​

A Facebook developer account is required before installing the connector.

  1. Navigate to Facebook Developer and click on the Log in button in the top right corner

  2. 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

  1. Navigate to Facebook Developer

  2. Click on the Create App button

    image.png

  3. Select the Facebook business account and click Next

    2024-08-08_11-20-53.png

  4. Select Other and click on the Next button

    2024-08-08_11-21-23.png

  5. Select Business and click Next

    2024-08-08_11-21-49.png

  6. Provide a name and contact email for the app then click Create app

    2024-08-08_11-22-14.png

  7. Once the application page is loaded, click Basic under App settings

    2024-08-08_11-24-38.png

  8. Supply a Display Name

  9. Enter the FYB Privacy Policy https://www.fyb.com.au/privacy to the Privacy Policy URL

  10. 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

  11. Select Business and pages for the Category

  12. Click Save Changes

    2024-08-08_11-27-24.png

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.

  1. Navigate to https://developers.facebook.com/ and click "Log in" in the top right corner

    2020-08-10_12-21-10.png

  2. Hover over Tools and click Graph API Explorer option

    2020-08-13_9-26-29.png

  3. Select the Facebook App that was created in the SETTING UP THE FACEBOOK APP section

    2020-09-14_10-56-11.png

  4. Click the Generate Access Token button.

    2020-08-25_15-46-29.png

    Note

    You may be prompted to log in during this step

  5. Add the user_photos and user_posts permissions to allow the connector to read the current user's posts and photos

    2020-09-14_10-56-57.png

  6. Click the Generate Access Token button once more to grant the permissions

    2020-09-14_10-56-57.png

  7. A pop-up window will appear

  8. Click Continue as you do not require to submit this app for review

    2020-09-14_10-59-37.png

FACEBOOK PAGE PERMISSIONS​

Note

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
  • pages_read_engagement - required for accessing people reached statistics
  • read_insights - required for accessing people reached statistics
  1. Navigate to https://developers.facebook.com/ and click "Log in" in the top right corner

    2020-08-10_12-21-10.png

  2. Hover over Tools and click Graph API Explorer

    2020-08-13_9-26-29.png

  3. Select the Facebook App that was created in the SETTING UP THE FACEBOOK APP section

    2020-09-14_10-56-11.png

  4. Click Generate Access Token button.

    2020-08-25_15-46-29.png

    Note

    You may be prompted to log in during this step

  5. 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
  1. Click the Generate Access Token button once more to grant permission.

    image.png

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

    2020-09-14_11-06-52.png

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

    2020-10-02_14-11-03.jpg

  4. Ensure that all three options are enabled, and click Done.

    2020-10-02_14-12-20.jpg

    Note

    You do not need to submit your app for review

ACQUIRING A FACEBOOK PAGE ACCESS TOKEN​

Note

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, conversations/mailbox messages or capture the number of people reached a Facebook Page Access Token is required.

  1. Navigate to the Facebook Graph Explorer.

  2. Click the Generate Access Token button and follow the prompts

    2021-01-14_10-27-02.png

    Note

    At this stage, you should have configured all necessary Permissions

  3. Copy the newly generated Temporary Access Token obtained in step 2, and navigate to the Access Token Debugger page.

  4. Paste the Temporary Access Token into the search bar and click the Debug button

    2021-01-08_15-36-27.png

  5. 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

    2021-01-08_15-34-11.png

  6. You have now generated a Long Lived User Access Token.

  7. Click on the debug button and copy the value

    image(1).png

  8. 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.

    image(17).png

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

    image(40).png

  10. 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

    2021-01-08_15-48-12.png image(103).png

  11. Navigate to the Power2CM Administration Console > Connector Settings

  12. Paste the Page Access Token obtained in step 9 into the Facebook Page Access Token field and click the Save button

    image.png

OBTAINING THE APP ID AND APP SECRET​

  1. Navigate to https://developers.facebook.com/apps/

  2. Select the Facebook app that was used in step 3 in the SETTING UP THE FACEBOOK APP section

    2020-09-14_11-02-10.png

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

    2020-08-10_12-40-57.png

  4. Copy the App ID and App Secret. These values will be needed when setting up the Facebook connector

    2020-08-10_12-42-40.png

CONFIGURING COMPLIANCE SETTINGS​

The following settings must be configured to comply with Facebook's connectors API access approval.

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

    2020-08-10_12-40-57.png

  2. Enter the FYB Privacy Policy https://www.fyb.com.au/privacy to the Privacy Policy URL

    image.png

  3. 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

    image.png

  4. For the App Purpose (OPTIONAL) select the Yourself or your own business option.

    image.png

  5. 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.

  1. In Power Automate, Navigate to the left pane menu, click Data, then click Custom connectors

    2020-08-10_11-23-20.png

  2. Click New Custom Connector and click Import an OpenAPI file

    2020-08-10_11-31-03.png

  3. Add a name for the Facebook Connector and click the Import button

    2020-08-10_12-55-51.png

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

    2020-08-10_12-58-52.png

  5. Click on the Continue button

    2020-08-10_13-00-26.png

  6. On the General tab, click on the Upload connector icon option

    2020-09-30_15-10-27.png

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

    2020-09-30_15-12-18.png 2020-09-30_15-14-55.png

  8. Navigate to the Security Tab and enter the App Id and App Secret (see step 7 of creating a Facebook app) into the Client ID and Client Secret fields respectively

    2020-08-10_13-02-49.png

  9. Click on the Create connector button

    2020-08-10_13-07-24.png

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

    2020-09-11_9-12-05.png

  11. Navigate back to your Facebook app, click Facebook Login and click on the Settings button

    2020-08-10_13-13-44.png

  12. Scroll down to Valid OAuth Redirect URIs and paste the URL that was copied in step 8

  13. Click on the Save Changes button

    2020-08-10_13-15-22.png

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