SMS Text Messages


This new channel was added in Mautic 1.4.0. It allows Mautic to send text messages from campaigns.

Create a new Text Message

A Text Message can be created/modified only via Campaign Builder.

Before you start to send text messages from your Mautic instance you need to configure the text messages correctly (see Twilio Plugin), then follow these steps:

  1. Go to Campaigns.
  2. Edit an existing campaign or create a new one.
  3. Open the Campaign Builder.
  4. Add a Send Text Message action to the canvas.
  5. Click the New Text Message button. The form in a new browser window will appear.
  6. Fill in the Internal Name, Text Message and if required, change the language. Save it.

The new Text message will be pre-selected so you can save the Send Text Message action as well. You can use the action in your Campaign dripflow.

Tracking Replies and Unsubscribes

Contacts can unsubscribe from your SMS messages by replying with the word "Stop" to your SMS. Once Mautic receives this SMS, the specific contact will be marked as Do Not Contact (DNC) and will not be contacted again via text message.

You can also get SMS replies in your contact's timeline like this screenshot of contact reply in timeline

Configure Twilio Webhooks

In order to make Twilio send back replies to Mautic, you have to follow these steps:

  1. Go to your Twilio dashboard -> Phone Numbers -> Manage Numbers -> Active Numbers, then select the number you are sending from (the same number you configured in the steps above), or follow this link

  2. Go the messaging section, and configure a webhook as shown in the screenshot below. Make sure that you point back to your server like this https://example.com/mautic/sms/twilio/callback where https://example.com/mautic/ is the path to your Mautic instance.

screenshot showing the Twilio webhook configuration

After these configurations, Twilio will notify Mautic of any incoming SMS replies.

Found errors? Think you can improve this documentation? edit this page on Github