Documentation Campaign Campaign Classic v7 Documentation

Configure SMS channel on a mid-sourcing infrastructure setting-up-sms-channel

Last update: Wed May 29 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
SMS

CREATED FOR:

User
Developer
Admin

To send to a mobile phone with mid-servers, you need:

An SMS Operator created on the Mid-server used for the SMS external account created on the Marketing server.
An external account on the Marketing server, specifying the Channel and Delivery mode.
An external account on the Mid-server, detailing the connector and message type.
A delivery template that references the external account to streamline the sending process.

NOTE

For SMS deliveries, typology should be using a specific SMS affinity created in one dedicated application server container. Learn more

Create the SMS Operator on the Mid-server create-sms-operator

To start the configuration process, you must create an SMS Operator on the Mid-server specifically for the external account.

IMPORTANT

Each SMS connector requires a unique SMS Operator.

In the Administration > Access management > Operators node node of the tree, click the New icon.
Specify the user’s Identification parameters, including their login, password, and name. The login and password are necessary for the operator to log in to Adobe Campaign securely.

Note that the Name (login) is to be later used to name your SMPP external account in the Mid-server.
Select the permissions granted to the operator in the Operator access rights section.

To allocate rights to the operator, click the Add button located above the list of rights. Next, select an Operator group or Named rights from the available groups list.
Click Save to finalize the creation of the operator. The profile is now included in the list of existing operators.

Create an SMS external account on the Marketing server create-accound-mkt

To send a SMS to a mobile phone with Mid-servers, you first need to create your SMS external account on the Marketing server.

In the Platform > External accounts node of the tree, click the New icon.
Type-in your Label and Internal name. Note that the Internal name is to be later used to name your SMPP external account in the Mid-server.
Define the account type as Routing, the channel as Mobile (SMS), and the delivery mode as Mid-sourcing.
In the Mid-Sourcing tab, specify the mid-sourcing server connection parameters.

Enter the details of the previously created SMS connector in the Account and Password fields.
Confirm your configuration by clicking Test the connection.
Click Save.

Create an SMPP external account on the Mid-server creating-smpp-mid

IMPORTANT

Using the same account and password for multiple external SMS accounts can result in conflicts and overlap between the accounts. Refer to the SMS troubleshooting page.

Once you have successfully set up your SMS external account on the Marketing server, the next step is to establish your SMPP external account on the Mid-server.

For more information on SMS protocol and settings, refer to this page.

To do this, follow the steps below:

In the Platform > External accounts node of the tree, click the New icon.

Type-in your Label and Internal name.

note warning
WARNING
When assigning an Internal name, make sure to follow the specified naming convention: `SMS Operator Name_Internal Name of the Marketing SMS external account`

Define the account type as Routing, the channel as Mobile (SMS), and the delivery mode as Bulk delivery.
Check the Enabled box.
In the Mobile tab, select Extended generic SMPP from the Connector drop-down list.
The Enable verbose SMPP traces in the log file option allows you to dump all SMPP traffic in log files. This option should only be enabled to troubleshoot the connector and to compare with the traffic seen by the provider.
Contact your SMS service provider who will explain to you how to complete the different external account fields from the Connection settings tab.

Then, contact your provider, depending on the one chosen, who will give you the value to enter into the SMSC implementation name field.

You can define the number of connections to the provider per MTA child. By default, it is set to 1.

By default, the number of characters in an SMS meets the GSM standards.

SMS messages using GSM encoding are limited to 160 characters, or 153 characters per SMS for messages sent in multiple parts.

note note
NOTE
Certain characters count as two (braces, square brackets, the euro symbol, etc.).
The list of available GSM characters is presented in this section.

You can also authorize character transliteration by checking the corresponding box.

In the Throughput and delays tab, you can specify the maximum throughput of outbound messages (“MT”, Mobile Terminated) in MT per second. If you enter “0” in the corresponding field, the throughput will be unlimited.

The values of all of the fields corresponding to durations need to be completed in seconds.
In the Mapping of encodings tab, you can define encodings.

For more on this, refer to this section.
In the SMSC specificities tab, the Send full phone number option is disabled by default. Do not enable it if you want to respect the SMPP protocol and transfer only digits to the server of the SMS provider (SMSC).

However, given that certain providers require the use of the ‘+’ prefix, it is advised that you check with your provider and they will suggest that you enable this option if necessary.

The Enable TLS over SMPP checkbox allows you to encrypt SMPP traffic. For more on this, refer to this page.
If you are configuring an Extended generic SMPP connector, you can set up automatic replies.

For more on this, refer to this section.

Change the delivery template changing-the-delivery-template

Adobe Campaign offers a mobile delivery template located in the Resources > Templates > Delivery templates node. For more on this, refer to the About templates section.

To send messages through the SMS channel, you must create a template that includes a reference to the channel connector.

To keep the native delivery template, we recommend that you duplicate it and then configure it.

In the example below, we generate a template to facilitate the delivery of messages through the previously created SMPP account. To do this:

In the Resources > Templates > Delivery templates node of the tree, right-click the Send to mobiles template, and select Duplicate.
Change the label of the template, for example Sent to mobiles (SMPP).
Click Properties.
In the General tab, select a routing mode that corresponds to the external account that you created in the section Create an SMS external account on the Marketing server.
Click Save to create the template.