How to Set Up the Mautic Facebook Integration, Step-by-Step

This is a step-by-step guide for setting up the Mautic Facebook integration. There’s been a lot of discussion about the Facebook plugin and social media integration in the Mautic community forums recently, so I thought this would be helpful. Please note: this guide does not apply for Mautic Cloud users (free or premium).

Mautic and FacebookThis guide shows you how to get the plugin set up to enable social login with Facebook. “Social login in Mautic is used to sign forms and pre-fill them with matched content, and also to update/create a contact in Mautic with the information gathered from the social profile once the user has been signed in.”

Aside from social login, though, right now there’s not much else you can do with the plugin. You can’t really use it for social monitoring on Facebook, or to get someone’s contact info without them submitting a form.

In this guide, I use the self-hosted version of Mautic (version 2.2.1.). Update: I regularly go through these steps again with new versions of Mautic to keep everything up-to-date. Most recently updated and tested with version 2.12.1.

Looking for more ways to integrate Facebook and Mautic?

Check out these two plugins from the community: Facebook Ads Custom Audiences – sync your Mautic segments with Custom Audiences on Facebook; Facebook Lead Ads – send your Facebook Lead Ads over to Mautic.

As of Mautic 2.10.0, you can also use the Facebook Pixel in your Mautic campaigns to send contact data to Facebook for use in advertising/retargeting.

How to set up the Mautic Facebook integration

  1. You’ll need a Facebook Developer account
    To get started, you need a Facebook Developer account. If don’t have one already, you can go here to sign up for one. Scroll down and then click Create Developer Account button.
  2. Create your new Facebook app
    Once you have a developer account, go to developers.facebook.com/apps. At the top right of the page, click the green button that says Add a New App. In the window that pops up, fill out your app name, email address, and select a category. Click the Create App ID button in the bottom right to proceed.
  3. Configure Facebook Login
    You should now be on the Select a Product page. From here, choose to set up Facebook Login. Don’t use Quickstart – instead, n the left menu, go to Products > Facebook Login > Settings.  Here, make sure “Client OAuth Login” and “Web OAuth Login” are both set to yes. Then under “Valid OAuth redirect URIs”, enter your website. Save changes.
  4. Add your website as a platform
    In the left menu, choose Settings > Basic Settings (for the main app, not the Facebook Login product). Click the wide + Add Platform button at the bottom of the page. In the popup window, choose Website. Enter your website URL in the appropriate field. Make sure you click Save Changes when you’re done!
  5. Add link to your privacy policy
    Add it in the Privacy Policy URL field. This is required if you want to eventually go live with your app and use it for social login. If you’re just testing things out and don’t mind your app staying in development mode, you can skip this.
  6. Enter your app domain
    Add your domain to the App Domains field. This should match the one you used in the Website Site URL field in the previous step. Again, don’t forget to save your changes.
    website-and-app-domains-match
  7. Make your app public
    Go to App Review in the left menu, and at the top of the page, set your app to public. This is required if you plan to use Mautic’s social login feature publicly. If you’re just testing, you can skip this.
  8. Open up your Facebook plugin settings in Mautic
    Now it’s time to log into your Mautic installation. From your dashboard, click the gear icon in the top right to open up your settings. Click Plugins, and then select the Facebook plugin.
  9. Enter your App ID and App Secret from Facebook
    From your Facebook app settings page, copy the App ID. Paste it in your Mautic Facebook plugin settings in the Client ID field. Then copy the App Secret from your Facebook app, and paste that into the Client Secret field in Mautic. Finally, press Authorize App! (In the screenshot below it says “Reauthorize” because I previously had a different Facebook app connected.)
    Mautic Facebook integration settings
  10. Complete authorization with Facebook and map contact fields
    Once you click the Authorize App button, a new Facebook window will open. Follow the prompts to complete app authorization. Back in Mautic Facebook plugin settings, click the Contact Mapping tab to map your contact fields to Facebook fields. Keep in mind that you will only be able to map a select number of public profile fields such as email, first and last name, and time zone. In the Features tab, make sure “Login Button” an “Display public profile…” boxes are checked (they should be by default).
  11. Plugin setup complete! But you’re not done yet….
    Your Mautic Facebook integration is now complete. Make sure the plugin is published (set to Yes). Next, review the Mautic docs for more info about using Mautic’s social login feature – or just continue with this tutorial:

Next: Setting up Facebook Social Login in Mautic Forms (coming soon!)

 

Have feedback or notice a error that should be fixed? Please let me know! I’m @chris0928 in the Mautic community.