HubEngine adapter: Facebook Lead Ads

Via the HubEngine, leads generated via the “Facebook Lead Ads” can be synchronised very easily and directly into other systems. Other systems can be, for example, “Sales Clouds” or “Marketing Automation Applications”. In the sales clouds, the leads are processed directly and in the marketing solutions they are usually transferred into nurturing campaigns.

You can find a full list of integration plans here: HubEngine Integration Plans for Facebook.

Setting up a sync plan takes just a few clicks via HubEngine. You can find a guide to plan configuration here: How to configure an integration plan in HubEngine

In order to obtain the Facebook API key (Access Token), which you need to establish the connection between Facebook and HubEngine, the following steps must be completed.

Request Facebook Access Token

1. Set up Facebook Developer Account

Generally, a Facebook for Developers account developers.facebook.com is required. This can be easily created from an existing Facebook profile. The Facebook for Developers user also needs access to the page from which the leads are generated.

2. Set up Facebook App and generate Token

1. First, open “My Apps” in Facebook for Developers developers.facebook.com/apps/.
2. Then select “Create App” (“To manage business integration”).
3. Afterwards, data such as “Name of the app” and “Purpose of the app” must be added; the optional question is not relevant.
4. After the creation you have to go into the app and via the side navigation to Settings -> General
5. App ID and app secret code must be copied and saved. The secret code is generated via “Show” and a new password entry. The data is needed to set up synchronisation.
6. Then go to the “Graph API Explorer” via Tools and select “Add permissions”.
7. In the Permissions section, the following permissions must be added (selectable via the search):
   • pages_show_list
   • ads_management
   • ads_read
   • leads_retrieval
   • pages_read_engagement
   • pages_manage_metadata
   • pages_manage_ads
8. Then select “Generate Access Token” again. In the window that opens, you must tick all permissions. If you manage several pages, you must also select the pages for which the permissions apply (you can also select more than one).
9. Select the corresponding Facebook page via User or Page (one page is sufficient if multiple pages were selected in the previous step) and then click “Generate Access Token” again.
10. Repeat this step once more. You can then copy the Access Token from the bar above and save it as well.

3. Extend expire date of the Access Tokens

By default, the Facebook Access Token expires after one hour and must therefore be extended. The following steps are necessary after setting up the app:

1. Open the Access Token Debugger via Tools.
2. Enter the Access Token and select “Troubleshoot”.
3. Scroll to the end and click on “Extend Access Key”.
4. Then select Debug and copy and save the new Access Token.

The new code is then valid for two months (Facebook regulation). You should put a reminder in your calendar and renew the code again after two months. If this does not work immediately, the process must be repeated from step 9 onwards.

Configure HubEngine Plan

If you want to use the Facebook Leads Adapter, you must enter the following information during authentication in HubEngine:

• App ID
• App secret key
• Access Token
• Form ID

In principle, all fields that were configured in the Facebook Lead form can be synchronised in the connected systems via the mapping of the HubEngine.