SMS Notification Tutorial

An SMS notification is a message that you can send to an MSISDN (phone number) over the SMMP protocol to devices that have opted in for a specific sender ID (long or short code). SMS messages appear in recipients' native SMS clients.

See the SMS Notification Reference for options and settings details.

Resources:

  1. Open your messaging project from the dashboard, then Create and select the Message composer.
  2. Under Channels, select SMS.
  3. Select the radio button for your message audience, then click Content in the header to move on.
    • All Users: Sends the message to your entire audience.
    • Target Specific Users: Create a recipient group based on segmentation data. See: Target Specific Users.
    • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Test Groups.
    • Upload Users: Upload a list of users just before sending the message. Select this option if you want to include merge fields in your message. See: Upload Users.
  4. Click Text Message (SMS), enter your message text, then click Delivery in the header to move on. Include merge fields if you selected Upload Users for your audience. The character count and the total number of SMS notifications that will be sent update as you type.

  5. Select a delivery type and Optional Delivery Features, then click Review in the header to move on.
  6. Review the device preview and message summary. To make changes, click the associated step in the progress header. When you've made your changes, return to Review.
  7. Click Send Message or Schedule Message. If you chose Upload Users in the Audience step, click Upload & Send, then:
    1. Click Choose File, and select the file that contains your list of users. Uploaded merge field names will be verified against the merge fields set in the Content step.
    2. Click Send Message.

Send an MMS Notification

You can send multi-media messages (MMS) to your SMS audience. MMS messages include a fallback, ensuring that users who can't view the original MMS message still receive a message that makes sense.

When sending an MMS message, you provide the URL for your image. If using Airship as your CDN, you can choose to upload your media rather than entering a URL.

MMS messages must be:

  • .gif, .jpeg, .jpg, or .png format.
  • Hosted over HTTP or HTTPS (for media not hosted by Airship).
  • Smaller than 2 MB (or 1 MB for .gif) — though you should use the smallest media possible to ensure that your audience receives messages quickly, regardless of connection quality.

See the SMS Notification Reference for options and settings details.

  1. Open your messaging project from the dashboard, then Create and select the Message composer.
  2. Under Channels, select SMS.
     Note

    When SMS is the only enabled channel, the composer is reduced to only fields relevant to SMS, and defaults to SMS-specific settings.

  3. Select the radio button for your desired message audience, then click Content in the header to move on.
    • All Users: Sends the message to your entire audience.
    • Target Specific Users: Create a recipient group based on segmentation data. See: Target Specific Users.
    • Test Users: Predefined recipient groups. After choosing Test Users, select from the Test Groups dropdown menu that appears. See: Test Groups.
    • Upload Users: Upload a list of users just before sending the message. Select this option if you want to include merge fields in your message. See: Upload Users.
     Important

    If you are using merge fields in your message, you must select Upload Users.

  4. Enter your MMS message Content.

    1. Select Image Message (MMS).
    2. Provide the media for your message.
      • URL: Enter the address of your image, beginning with HTTP or HTTPS and ending with the image extension.
      • Upload: Click Upload Media and select your image.
    3. (Optional) Enter a Subject and/or Text Message to accompany your image, including merge fields if you selected Upload Users for your audience. The subject appears in bold, but it might not appear if you are sending from a toll-free number.
    4. Enter SMS Fallback Text. Users who cannot receive your MMS message will receive this text along with the image URL.
    5. Click Delivery to continue.
     Note

    There is no guarantee as to the order in which media and text appear to users. Media and text send separately.

  5. Select a delivery type and Optional Delivery Features, then click Review in the header to move on.
  6. Review the device preview and message summary. Click the arrows to page through the MMS and SMS fallback previews. You can also select a preview directly from the dropdown menu. To make changes, click the associated step in the progress header. When you've made your changes, return to Review.
  7. Click Send Message or Schedule Message. If you chose Upload Users in the Audience step, click Upload & Send, then:
    1. Click Choose File, and select the file that contains your list of users. Uploaded merge field names will be verified against the merge fields set in the Content step.
    2. Click Send Message.

Upload Users

If sending an email, SMS, or open channel message, you can Upload Users in the Audience step of the composer. This provides a means to register new users and send them a message at the same time.

 Important

Upload Users can only be used with a single channel at a time. Make sure you have only Email, SMS, or a single Open Channel enabled.

Complete the rest of the composer like normal, and you will upload the list during the Review step. The Send Message button will instead be labeled Upload & Send. After clicking the button:

  1. Click Choose File, and select the file that contains your list of users.
  2. Click Send Message.

See Audience Lists: Inline Lists for file format requirements and general information about Inline lists.