MMS Campaigns

Note: This feature is currently in BETA version.

MMS campaigns allow you to create even more personalized campaigns through multimedia messages. Adding images or videos to your campaigns might be useful when you want to increase the user engagement and build brand awareness.

You can access MMS campaigns via the MMS action node in Scenarios. The message and media to be sent can be typed within a user-friendly editor with an option to include Jinja personalization. Similarly to SMS, the editor also displays a ‘characters counter’ and automatic highlighting of special characters within the UI, as well as the option to define fallback SMS with limiting automatic message splitting. You can preview your final MMS message or fallback SMS too before the actual sending it or you can test it for the selected group of your customers.

🚧

Currently, MMS are handled only through the third-party provider Sinch. Sinch provides support only in the US, Canada and Australia. Note that due to regulatory requirements, service to Canada is fairly limited.

Building MMS campaigns

  1. Click on the MMS node in your Scenario.
  2. After that, enter Sender of the MMS. It can be short-coded (in the US), a toll-free number (in the US and Canada), 10DLC number (in the US and Canada) or a long number (In Canada and Australia).
  3. Then fill-out Subject of the MMS.
  4. Then write your MMS text.
  5. You can insert the media URL. There are 3 supported media types:
    • Image (GIF/JPG/PNG)
    • Video (3GP, MP4, MPEG, MPG, AVI, WMV)
    • vCard - VCR
      You can read more about best practises later in this section of the article.
  6. Configure SMS fallback where you enter the fallback message and enable automatic message splitting.
  7. You can add Jinja personalization by accessing the user-friendly copy-and-paste personalization editor.
  8. Lastly, you can preview how the rendered message will appear to a specified customer for both MMS or fallback SMS.

🚧

Limitations

  • Subject can have up to 80 characters and should not contain emojis or Unicode characters.
  • Maximum allowed size of the message text is 1600 characters per message.
  • The maximum recommended size of the media is 1MB.
  • In case of the fallback message, the single message can consist of 160 characters, longer messages will be split into multiple messages.
  • MMS messages are sent using the customer attribute phone. It is required to have the customer attribute phone set to a phone number in an international format (either starting with "00" or with "+"). Please note that for Two-way SMS messaging and Keywords Auto Responses, only the international format with double zeroes is supported, e.g. "00421905123456".

MMS Best Practices for Images and Videos

There are several recommended practices regarding sizes, files and design considerations of media:

  • Recommended file formats are .jpg for images, .gif for animations and .mp4 for videos.
  • It is not recommended to use any transparency in your designs as the actual colors of images would be unpredictable.
  • We recommend testing your MMS to ensure the images/animations/videos are displayed correctly.
  • Regarding the sizes of various media and other recommendations, please read this article by Sinch.

Testing

You can test your MMS message through the editor clicking on the Send test MMS. Here, you have 2 options:

  1. You can send it to a specific provided phone number (e.g. you can send it to yourself).
  2. You can send it to the previewed customer.

Settings

Within the settings tab you can configure:

MMS Project Settings

You can access MMS Project settings under Project Settings -> Channels -> SMS/MMS. Here you can set up:

  • The default MMS Provider
    • The selected MMS integration will be used for sending messages in all new and existing campaigns. That means when the default integration is changed (and settings are saved), all MMS nodes from all existing scenarios will automatically change the integration that is used for sending the messages.
  • Two-way SMS/MMS messaging
    • You can configure how the system handles the incoming MMS messages. You can read more about it in this article.

MMS Integration

You have to configure the integration with the provider so the MMS campaigns would work. At the moment we offer one MMS provider - Sinch MMS. This is commonly set up by the CSM.

To do the integration, follow these steps:

  1. Go to Data & Assets -> Integrations -> Sinch MMS.
  2. Select Sinch as your MMS provider. Here, add your Service plan to your project. Remember that each service plan comes with a rate limit and gets its own message queue. The integration includes tracking of enqueued messages.
  3. Set up a Service Plan ID that is provided by Sinch.
  4. Set up the API Authentication Token that is provided with each service plan.
  5. Choose your endpoint region based on your data protection requirements. Currently, it is available only in the US.

SMS Fallback (Sinch)

Sinch converts the MMS into a fallback SMS for the scenarios listed below:

  • If MMS submitted is a greater size than the destination mobile network operator.
  • If the Content-type submitted is not supported by the end carrier MMSC.
  • If the Sinch Platform determines that the end-user device is not MMS compatible for the content to be delivered. For example, Android Devices does not support PDF and ICS file formats.

If any of these scenarios are met, the Sinch MMSC Platform sends the fallback SMS instead of the MMS message. . Fallback SMS is charged and priced as an SMS.

📘

Important notes

  • SMS fallback is only triggered in the case where any of the above listed criteria are met.
  • For carriers not supported by Sinch or where Sinch does not have MMS reach, SMS fallback does not happen.
  • Sinch is able to obtain handset type information from delivery receipts and store the record in a handset cache for later use.
  • Sinch has a database of attributes which we manually match to every new handset in the cache so we can adapt the content during MMS delivery.
  • SMS fallback is currently supported in the US (United States) on Short Codes.

MMS Tracking

By default MMS campaigns tracks campaign event with action_type = "mms". Events can be mapped to a different event name in Project settings -> Campaigns -> Mapping -> Campaign events.

Send to provider tracking

When Exponea is sending a message to the MMS provider it immediately tracks the response of the attempt. Either MMS provider accepts the message for delivery, or rejects it, Exponea tracks campaign event with these properties and standard campaign event properties:

event property

value

description

action_type

mms

Engagement action type

status

"enqueued"
"enqueue_failed"

Describes if a message was or was not successfully forwarded to the SMS provider for delivery

action_id

12

Unique ID number of the scenario action node. The number rises proportionally with the order in which you created the nodes in the scenarios. The action_id of the first action is 1, for the second action it is 2 etc.

action_name

e.g mms_1

Name you gave to the specific action node within the scenario.

campaign_id

E.g. 5c584sa5729971a4f992sj9

Automatically-generated ID of the campaign.

campaign_name

e.g . Summer sale

Name you gave to the campaign.

campaign_policy

default

Name of the frequency policy used with the campaign.

consent_category

General consent

Name of the consent category used with the campaign.

status_code

e.g. E111

Reason HTTP code for failed requests. Sinch's MMS status codes

error

e.g. "Invalid shortcode"

Reason error code for failed requests. Sinch's MMS status codes

Delivery reports tracking

Provider calls Exponea callback with delivery reports as statuses delivered or failed, when the recipient's operator responds back about the delivery. The delivery and their content may change based on the provider. At the moment we only support Sinch as an MMS provider.

Successful delivery

Delivered message tracks status=delivered with attribute type=mms/sms defining whether the message was delivered as MMS or fallback SMS.

event property

value

description

action_type

mms

Engagement action type

status

"delivered"

The message was successfully delivered to the recipient's handset

type

“mms/sms”

Type of delivery as mms or fallback sms

number_of_message_parts

number

Count of message parts in case of fallback sms

Failed delivery

Undelivered messages track status failed with attribute type=mms/sms defining whether the message was failed as MMS or fallback SMS.

event property

value

description

action_type

mms

Engagement action type

status

"failed"

Message failed.

status_code

e.g. E101

Reason HTTP code for failed requests. Sinch's MMS status codes

error

e.g. "Error fetching dynamic content"

Reason error code for failed requests. Sinch's MMS status codes

number_of_message_parts

number, e.g. 2

Count of message parts

Two-way Messaging and Keyword Auto Response

MMS campaigns include support for Two-way messaging and keywords auto responses. In case an user replies to your MMS in the form of an MMS, we will process the messages and scan them for keywords. However, it will be more common that a user will reply to an MMS in the form of an SMS.

An MMS mobile originated message from an user to your short code/number can also contain images or multiple text parts. Any text part of the MMS will be checked for keywords at the beginning of the message. If you want to know more, read here.

Usage Dashboard

You are able to view the overview of all outgoing MMS messages on account or project level within the usage dashboard. In the Communications section, you can see the number of sent MMS communications under ‘MMS’ or fallback SMS under ‘Fallback SMS’.

Updated about a month ago

MMS Campaigns


Note: This feature is currently in BETA version.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.


We rely on cookies

to optimize our communication and to enhance your customer experience. By clicking on the Accept and Close button, you agree to the collection of cookies. You can also adjust your preferences by clicking on Manage Preferences. For more information please see our Privacy policy.

Manage cookies
Accept & close

Cookies preferences

Accept & close
Back