SMS authoring

Use Adobe Journey Optimizer B2B Edition to send text messages (SMS) to your customers on their mobile devices. You can create, personalize, and preview messages in text format from the SMS editor.

SMS configurations

Adobe Journey Optimizer B2B Edition sends text messages through SMS service providers (or SMS gateway providers). Before creating your SMS message, configure your service provider from the Administrator settings.

SMS gateway service providers

Adobe Journey Optimizer B2B Edition currently integrates with third-party providers who offer text messaging services independently. Supported providers for text messaging are Sinch, Twilio, and Infobip.

Before you configure an SMS channel in Adobe Journey Optimizer B2B Edition, you must create an account with one of these providers to get your API Token and Service ID. These credentials are required to configure the connection between Adobe Journey Optimizer B2B Edition and the applicable provider.

IMPORTANT
Your use of text messaging services is subject to additional terms and conditions from the applicable provider. As third-party solutions, Sinch, Twilio, and Infobip are available to Adobe Journey Optimizer B2B Edition users through an integration. Adobe does not control, and is not responsible for third-party products. For any issues or requests for assistance related to the text messaging services (SMS), contact your provider.

Verify an existing SMS API configuration

NOTE
The described settings are accessible only to the users with SMS Admin privileges.

On the left navigation, expand the Administrator section and click Configuration.

Access the congfiguration of AMA API credentials

The page lists the available API configurations for your instance. You can filter the displayed API credentials by the SMS service provider or creator.

Click the filter icon to filter the list of API credentials

Create a new API credentials for an SMS service provider

Sinch

To configure Sinch as your SMS provider with Adobe Journey Optimizer B2B Edition:

  1. On the left navigation, expand the Administrator section and click Configuration.

  2. Click the Create new API credentials at the top-right of the API credentials list.

  3. Configure your SMS API credentials:

    Configure the Sinch SMS API credentials {width="500"}

    • SMS vendor - Choose Sinch as the SMS provider.

    • Name - Enter a name for your API credential.

    • Service ID and API Token - Access the APIs page from your Sinch account (you can find your credentials under the SMS tab).

    For more information about finding this information for your Sinch account, see the Sinch developer documentation

  4. Click Submit when the configuration details of your API credentials are complete.

Twilio

To configure Twilio as your SMS provider with Adobe Journey Optimizer B2B Edition:

  1. On the left navigation, expand the Administrator section and click Configuration.

  2. Click the Create new API credentials at the top-right of the API credentials list.

  3. Configure your SMS API credentials:

    Configure the Twilio SMS API credentials {width="500"}

    • SMS vendor - Choose Twilio as the SMS provider.

    • Name - Enter a name for your API credential definition.

    • Account SID and Auth Token - Access the Account Info pane of your Twilio Console Dashboard page to find your credentials.

    For more information about finding this information for your Twilio account, see the Twilio Help Center.

  4. Click Submit at the top-right of the page when the configuration details of your API credentials are complete.

Infobip

To configure Infobip as your SMS provider with Adobe Journey Optimizer B2B Edition:

  1. On the left navigation, expand the Administrator section and click Configuration.

  2. Click the Create new API credentials at the top-right of the API credentials list.

  3. Configure your SMS API credentials:

    Configure the Infobip SMS API credentials {width="500"}

    • SMS vendor - Choose Infobip as the SMS provider.

    • Name - Enter a name for your API credential definition.

    • API base URL and API key - Access your web interface homepage or the API key management page for your Infobip account to find your credentials.

    For more information about finding this information for your Infobip account, see the Infobip documentation.

  4. Click Submit at the top-right of the page when the configuration details of your API credentials are complete.

When you click Submit, the credentials are immediately validated and saved, redirecting you to the API credentials listing page. If the submitted credentials are invalid, the system displays an error message on the listing page. In this case, you can choose to cancel the configuration, or to update it and submit again.

Add an SMS action in an account journey

You can set up text message deliveries in an Account Journey when you add a Take an action node and do the following:

  1. For the Action on target, choose People.

  2. For the Action on people, choose Send SMS.

    Take an action - send sms {width="800" modal="regular"}

  3. At the bottom of the Take an action panel, click Create SMS.

  4. In the dialog, enter a unique Name for the email and a Subject line.

    Create new SMS dialog {width="500"}

Create the SMS message

IMPORTANT
SMS consent management



In accordance with the industry standards and regulations, all SMS marketing messages must contain a way for the recipients to unsubscribe easily. To do this, SMS recipients can reply with opt-in and opt-out keywords. All standard opt-in and opt-out keywords are supported and honored. In addition, any custom keywords configured for your SMS service provider account are supported and honored.
  1. Enter the text that you want to send in the Message field.

    You can create a message of up to 1600 characters, with every 160 characters considered as a single SMS message.

  2. Personalize the text message.

    At anytime while authoring the text message, click the Personalize icon to the right of the text message box.

    Click the Personalize icon to add tokens to the message {width="800" modal="regular"}

    The displayed page provides access to your Adobe Marketo Engage Lead and System tokens. Both standard and custom tokens are included. You can use the Search bar to locate the token you need, or navigate through the folder tree to find and select any of the lead/system tokens.

    Place your cursor at the location in the message where you want to add the token. Add a token by clicking the plus ( + ) symbol next to it. If you want to add the token with a fallback (default that appears in case that field is not available for a lead), click the ellipsis ( ) and choose Insert with fallback text.

    Click the ellipses to use a fallback for the token {width="700" modal="regular"}

    In the Enter fallback value dialog, enter the text that appears as a fallback and then click Add.

    Enter the fallback text for the token {width="400"}

    When your personalization tokens are placed, click Save to save changes and return to the main SMS authoring workspace. You can continue to edit the message with the tokens as needed.

  3. Add URLs to the text message.

    After defining your content, you can add URLs to your message by clicking the Link icon.

    This action opens a dialog, where you can choose one of two types of URLs to link:

    • External URL - This type is any external URL that you enter in the text box.
    • Landing Page - Choose this option to select any of the approved Adobe Marketo Engage Design Studio landing pages from your Marketo Engage instance.

    The dialog also includes options for the URL links:

    • Shorten URL - Select this checkbox to shorten the URL, which is necessary for tracking. For a landing page, it uses the Marketo Engage subdomain for the shortened URL. A sample of the shortened URL format is displayed. The actual URL is created when the SMS is sent to the recipient.

    • Include mkt_tok - Select this checkbox to track activity against a user.

    When the link options are complete, click Add to save the changes and add the URL link to the SMS message.

Set the SMS properties

  1. In the SMS properties section, enter a Name (required, 100 character maximum) and Description (optional, 300 character maximum) for your message.

    Alpha, numeric, special characters are allowed for these fields. The following reserved characters are not allowed: \, /, :, *, ?, ", <, > and |.

  2. Choose the SMS Type:

    • Use Marketing for promotional text messages, which require user consent.
    • Use Transactional for non-commercial messages, such as order confirmation, password reset notifications, or delivery information.
  3. For SMS configuration, choose one of the pre-defined API configurations.

    This setting determines which SMS gateway service provider and account is used to deliver the message.

  4. Enter the Sender number ​that you want to use for your communications.

    Take an action - send sms {width="700" modal="regular"}

    The recipient number is always mapped to the Lead.mobilePhone field in Marketo Engage.

Simulate the text message content preview-test

When your message content is defined, you can use test profiles to simulate (preview) its content. If you inserted personalized content, you can check how this content is displayed in the message using test profile data.

IMPORTANT
Make sure to save your SMS message before you proceed to simulate the text message.
  1. Click Simulate Content at the top of the SMS authoring workspace.

  2. From the Simulate Content page, click Add People.

  3. Use the Simulate Content page to manage the leads used for your test profile.

    In the displayed list, you can search for and add any of the leads (up to 10 leads at a time) from the Marketo Engage lead database.

    To search, enter the whole email address and pressing Enter. The corresponding lead profile is displayed for selection.

    The preview updates to the personalization fields for the selected profile.

    All the added leads appear on the left.

    You can manage this list by adding more people and deleting individual leads from the profile listing (it does not remove them from the database).

  4. Simulate content for a selected lead.

    Select any of the leads listed on the left and the SMS preview on the page updates for the corresponding lead.

    You can also select a lead from the selector above the preview space to update the SMS preview on the page for the corresponding lead.

  5. To exit the Simulate Content page and return back to the SMS authoring workspace, click Close at the top right.

Providing recipients the capability to unsubscribe from receiving communications from a brand and honoring this choice is a legal requirement. Failing to comply with these regulations introduces legal risks for your brand. This function also helps you avoid sending unsolicited communications to your recipients, which could cause them to mark your messages as spam and harm your reputation.

When you provide this option, SMS recipients can reply with opt-in and opt-out keywords. All standard opt-in and opt-out keywords are supported and honored, and any custom keywords that are configured at the SMS service provider. When unsubscribed, the profiles are automatically removed from the audience of future marketing messages.

Journey Optimizer B2B Edition provides the ability to manage opt-out in SMS messages using the following logic:

  • By default, if a lead has opted out from receiving communications from you, the corresponding profile is excluded from subsequent SMS deliveries

  • This lead consent coming from different sources (such as AEP or the SMS service provider) is synced to Journey Optimizer B2B Edition. Currently, it supports only a single consent state per lead at the instance level (a lead ‘John Doe’ is either subscribed to or unsubscribed from all promotional SMS in the instance). It does not currently support double opt-in on brand level/individual subscription list level consent.

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0