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).
This 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.
How to set up the Mautic Facebook integration
- 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.
- 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.
- 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.
- 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!
- 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.
- 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.
- 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.
- 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.)
- 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).
- 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.