Configure SMS channel sms-configuration

Before sending SMS, you must configure your Adobe Journey Optimizer environment. To preform this:

These steps must be performed by an Adobe Journey Optimizer System Administrator.

Prerequisites sms-prerequisites

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

Prior to SMS channel configuration, you must create an account with one of these providers to get your API Token and Service ID, which you need to configure the connection between Adobe Journey Optimizer and the applicable provider.

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 users via 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, contact your provider.

CAUTION
To access and edit SMS subdomains, you must have the Manage SMS Subdomains permission on the production sandbox. Learn more about permissions in this page.

Create new API credentials create-api

Sinch sinch-api

To configure Sinch with Journey Optimizer, follow these steps:

  1. In the left rail, browse to Administration > Channels and select the API Credentials menu. Click the Create new API credentials button.

  2. Configure your SMS API credentials, as detailed below:

    • Name: choose a name for your API Credential.

    • Service ID and API Token: access the APIs page, you can find your credentials under the SMS tab. Learn more in Sinch Documentation.

    • Opt-In Keywords: enter the default or custom keywords that will automatically trigger your Opt-In Message. For multiple keywords, use comma-separated values.

    • Opt-In Message: enter the custom response that is automatically sent as your Opt-In Message.

    • Opt-Out Keywords: enter the default or custom keywords that will automatically trigger your Opt-Out Message. For multiple keywords, use comma-separated values.

    • Opt-Out Message: enter the custom response that is automatically sent as your Opt-Out Message.

    • Help Keywords: enter the default or custom keywords that will automatically trigger your Help Message. For multiple keywords, use comma-separated values.

    • Help Message: enter the custom response that is automatically sent as your Help Message.

    • Double Opt-In Keywords: enter the keywords which trigger the double opt-in process. If a user profile does not exist, it is created upon successful confirmation. For multiple keywords, use comma-separated values. Learn more on the SMS Double Opt-in.

    • Double Opt-In Message: enter the custom response that is automatically sent in response to the double opt-in confirmation.

  3. Click Submit when you finished the configuration of your API credentials.

After creating and configuring your API credential, you now need to create a channel surface (i.e. message preset) for SMS messages.

Twilio twilio-api

To configure Twilio with Journey Optimizer, follow these steps:

  1. In the left rail, browse to Administration > Channels and select the API Credentials menu. Click the Create new API credentials button.

  2. Configure your SMS API credentials, as detailed below:

    • Name: choose a name for your API Credential.

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

    • Message SID: enter the unique identifier assigned to every message created by Twilio’s API. Learn more in Twilio Documentation.

  3. Click Submit when you finished the configuration of your API credentials.

After creating and configuring your API credential, you now need to create a channel surface (i.e. message preset) for SMS messages.

Infobip infobip-api

To configure Infobip with Journey Optimizer, follow these steps:

  1. In the left rail, browse to Administration > Channels and select the API Credentials menu. Click the Create new API credentials button.

  2. Configure your SMS API credentials, as detailed below.

    • Name: choose a name for your API Credential.

    • API base URL and API key: access your web interface homepage or the API key management page to find your credentials. Learn more in Infobip Documentation.

    • Opt-In Keywords: enter the default or custom keywords that will automatically trigger your Opt-In Message. For multiple keywords, use comma-separated values.

    • Opt-In Message: enter the custom response that is automatically sent as your Opt-In Message.

    • Opt-Out Keywords: enter the default or keywords that will automatically trigger your Opt-Out Message. For multiple keywords, use comma-separated values.

    • Opt-Out Message: enter the custom response that is automatically sent as your Opt-Out Message.

    • Help Keywords: enter the default or custom keywords that will automatically trigger your Help Message. For multiple keywords, use comma-separated values.

    • Help Message: enter the custom response that is automatically sent as your Help Message.

    • Double Opt-In Keywords: enter the keywords which trigger the double opt-in process. If a user profile does not exist, it is created upon successful confirmation. For multiple keywords, use comma-separated values.

    • Double Opt-In Message: enter the custom response that is automatically sent in response to the Double Opt-In confirmation.

    • Principal Entity ID: enter your assigned DLT principal entity ID.

    • Content Template ID: enter your registered DLT content template ID.

    • Validity Period: enter the message validity period in hours. In the event that messages cannot be delivered within this timeframe, the system will make additional attempts to resend them. The default validity period is set to 48 hours.

    • Callback Data: enter the additional client data that will be sent on the Notify URL.

  3. Click Submit when you finished the configuration of your API credentials.

After creating and configuring your API credential, you now need to create a channel surface (i.e. message preset) for SMS messages.

Create a SMS surface message-preset-sms

Once your SMS channel has been configured, you must create a channel surface to be able to send SMS messages from Journey Optimizer.

To create a channel surface, follow these steps:

  1. In the left rail, browse to Administration > Channels and select Branding > Channel surfaces. Click the Create channel surface button.

  2. Enter a name and a description (optional) for the surface, then select the SMS channel.

    note note
    NOTE
    Names must begin with a letter (A-Z). It can only contain alpha-numeric characters. You can also use underscore _, dot. and hyphen - characters.
  3. Define the SMS settings.

    Start by selecting the SMS Type that will be sent with the surface: Transactional or Marketing.

    • Choose Marketing for promotional text messages: these messages require user consent.
    • Choose Transactional for non-commercial messages such as order confirmation, password reset notifications, or delivery information for example.

    When creating a SMS message, you must choose a valid channel surface matching the category you selected for your message.

    note caution
    CAUTION
    Transactional messages can be sent to profiles who unsubscribed from marketing communications. These messages can only be sent in specific contexts.
  4. Select the SMS configuration to associate with the surface.

    For more on how to configure your environment to send SMS messages, refer to this section.

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

  6. Select your SMS Execution Field to select the Profile attribute associated with the profiles’ phone numbers.

  7. If you want to use the URL shortening function in your SMS messages, select an item from the Subdomain list.

    note note
    NOTE
    To be able to select a subdomain, make sure you have previously configured at least one SMS subdomain. Learn how
  8. Enter the Opt-out number you want to use for this surface. When profiles opt out from this number, you are still able to send them messages from other numbers you may be using to send out text messages with Journey Optimizer.

    note note
    NOTE
    In Journey Optimizer, opt-out for text messages is no longer managed at the channel level. It is now specific to a number.
  9. Once all the parameters have been configured, click Submit to confirm. You can also save the channel surface as draft and resume its configuration later on.

  10. Once the channel surface has been created, it displays in the list with the Processing status.

    note note
    NOTE
    If the checks are not successful, learn more on the possible failure reasons in this section.
  11. Once the checks are successful, the channel surface gets the Active status. It is ready to be used to deliver messages.

You are now ready to send text messages with Journey Optimizer.

Related topics

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76