How to Set Up the Mautic Twitter Integration for Social Monitoring

This is a step-by-step guide for beginners on how to set up the Mautic Twitter integration. With Mautic’s Twitter plugin, you’ll be able to use Mautic’s Social Monitoring features to build your contact lists based on Twitter hashtags.

Setting up Social Monitoring does not mean you will be able to get the email addresses from the Twitter users you collect as contacts. For that, you need to use the social login feature of Mautic (adding it to your forms). Take a look at this forum post for a little more detail.

Please note: in this guide we’re using the self-hosted version of Mautic, downloaded from mautic.org. (Version 2.2.1.) Update: we tested this process with version 2.6.1 and it works great.

Step-by-step: setting up the Mautic Twitter integration

  1. Create your Twitter app
    To get started, you’ll need to create your own Twitter app that can connect to Mautic. Make sure you’re signed in to Twitter, then go to https://apps.twitter.com/. Click the “Create New App” button, and fill in the app name, description, and website. Don’t create your application quite yet.
  2. Get your callback URL from Mautic
    From your Mautic dashboard, click the settings (gear) icon in the top right, and then click on Plugins. Click on the Twitter plugin icon. In the box that pops up, copy the callback URL.
  3. Finish creating your Twitter app
    Switch back to creating your Twitter app, and paste the callback URL into the appropriate field. Click “Create your Twitter application” to create your app.
    Creating a Twitter app for Mautic Twitter integration
  4. Get your Twitter API key and secret
    Now that you’ve created the app, click on the “Keys and Access Tokens” tab. Copy the Consumer Key and Consumer Secret and paste them into your plugin settings in Mautic.
    Getting the Twitter API key and secret for Mautic Twitter integration
  5. Complete the integration
    To complete the integration, click “Authorize App”. A popup will appear, asking you to authorize the connection to Twitter. Allow it to authorize, and you’re done! Don’t forget to set the the integration’s Published setting in Mautic to Yes. Take a look at the Features and Contact Mapping options!
  6. Don’t forget the social monitoring cron job
    With the connection between Twitter and Mautic in place, the final step is to make sure you have the social monitoring cron job running. If you already have a working Mautic install, you probably know how to add a new cron job. If not, check with your hosting company (or just ask the Google machine).
  7. Done!
    You’re now ready to create social monitors!

If you found this guide, helpful, please share it! Click to tweet!