DocumentationCampaign Classic v7Campaign Classic v7 Documentation
v7
Applies to Campaign Classic v7
v8
Also applies to Campaign v8

Configure SMS channel

Last update: Thu Aug 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User
  • Developer
  • Admin

To send to a mobile phone, you need:

  1. An external account specifying a connector and type of message.

    Note that legacy connectors are now deprecated. Deprecated capabilities are still available, but they will not be further enhanced, nor supported. Learn more in this page.

  2. A delivery template in which this external account is referenced.

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

Create an SMPP external account

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.

To send a SMS to a mobile phone, you first need to create your SMPP external account.
For more information on SMS protocol and settings, refer to this page.

To do this, follow the steps below:

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

  2. Define the account type as Routing, the channel as Mobile (SMS), and the delivery mode as Bulk delivery.

  3. Check the Enabled box.

  4. In the Mobile tab, select Extended generic SMPP from the Connector drop-down list.

    note caution
    CAUTION
    As of release 20.2, legacy connectors are deprecated and not supported. We recommend using the Extended generic SMPP connector. For more information on how to migrate to the recommended connector, refer to this page.

  5. The Enable verbose SMPP traces in the log file option allows you to dump all SMPP traffic in log files. This option must be enabled to troubleshoot the connector and to compare with the traffic seen by the provider.

  6. 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.

  7. 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 below.

    If you like, you can authorize character transliteration by checking the corresponding box.

    For more on this, refer to this section.

  8. 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.

  9. In the Mapping of encodings tab, you can define encodings.

    For more on this, refer to this section.

  10. 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.

  11. If you are configuring an Extended generic SMPP connector, you can set up automatic replies.

    For more on this, refer to this section.

SMS character transliteration

Character transliteration can be set up in a SMPP mobile delivery external account, under the Mobile tab.

Transliteration consists of replacing one character of an SMS by another when that character is not taken into account by the GSM standard.

  • If transliteration is authorized, each character that is not taken into account is replaced by a GSM character when the message is sent. For example, the letter “ë” is replaced by “e”. The message is therefore slightly altered, but the character limit will remain the same.
  • When transliteration is not authorized, each message that contains characters that are not taken into account is sent in binary format (Unicode): all of the characters are therefore sent as they are. However, the SMS messages using Unicode are limited to 70 characters (or 67 characters per SMS for messages sent in multiple parts). If the maximum number of characters is exceeded, several messages will then be sent, which may create additional costs.
IMPORTANT
Inserting personalization fields into the content of your SMS message may introduce characters that are not taken into account by the GSM encoding.

By default, character transliteration is disabled. If you would like all of the characters in your SMS messages to be kept as they are, to not alter proper names for example, we recommend that you do not enable this option.

However, if your SMS messages contain a lot of characters that generate Unicode messages, you can choose to enable this option to limit the costs of sending your messages.

The following table presents the characters taken into account by the GSM standard. All of the characters inserted into the message body, other than those mentioned below, convert the entire message into binary format (Unicode) and therefore limit it to 70 characters.

Basic characters

@
SP
0
¡
P
¿
p
£
_
!
1
A
Q
a
q
$
"
2
B
R
b
r
¥
#
3
C
S
c
s
è
¤
4
D
T
d
t
é
%
5
E
U
e
u
ù
&
6
F
V
f
v
ì
'
7
G
W
g
w
ò
(
8
H
X
h
x
Ç
)
9
I
Y
i
y
LF
*
:
J
Z
j
z
Ø
ESC
+
;
K
Ä
k
ä
ø
Æ
,
<
L
Ö
l
ö
CR
æ
-
=
M
Ñ
m
ñ
Å
ß
.
>
N
Ü
n
ü
å
É
/
?
O
§
o
à

SP: Space

ESC: Escape

LF: Line Feed

CR: Carriage Return

Advanced characters (counted twice)

^ { } [ ~ ] | €

Text encodings

When sending an SMS message, Adobe Campaign can use one or several text encodings. Each encoding has its own specific character set and determines the number of characters that fit into an SMS message.

When configuring a new SMPP mobile delivery external account, you can define the Mapping of encodings in the Mobile tab: the data_coding field allows Adobe Campaign to communicate which encoding is used to the SMSC.

NOTE
The mapping between the data_coding value and the encoding actually used is standardized. Nevertheless, certain SMSC have their own specific mapping: in this case, your Adobe Campaign administrator needs to declare this mapping. Check with your provider to find out more.

You can declare data_codings and force the encoding if necessary: to do this, specify a single encoding in the table.

  • When no mapping of encodings is defined, the connector takes on a generic behavior:

    • It will try to use GSM encoding to which it assigns the value data_coding = 0.
    • If GSM encoding fails, it will use UCS2 encoding to which it assigns the value data_coding = 8.

  • When you define the encodings that you would like to use as well as the linked data_coding field values, Adobe Campaign will try to use the first encoding in the list, then the following, if the first encoding proves impossible.

IMPORTANT
The order of declaration is important: it is recommended that you put the list in ascending order of cost in order to favor the encodings allowing you to fit as many characters as possible in each SMS message.
Only declare the encodings that you would like to use. If some of the encodings provided by the SMSC should not correspond to your purpose of use, do not declare them in the list.

Automatic reply

When setting up an extended generic SMPP connector, you can configure automatic replies.

When a subscriber replies to an SMS message which was sent to them via Adobe Campaign and their message contains a keyword such as “STOP”, you can configure messages which are automatically sent back to them in the Automatic reply sent to the MO section.

NOTE
The keywords are not case-sensitive.

For each keyword, specify a short code, which is a number that is usually used to send deliveries and will serve as a sender name, then enter the message that will be sent to the subscriber.

You can also link an action to your automatic response: Send to quarantine or Remove from quarantine. For example, if a recipient sends the keyword “STOP”, they will automatically receive an unsubscription confirmation and are sent to quarantine.

If you link the Remove from quarantine action to an automatic response, the recipients sending the corresponding keyword are automatically removed from quarantine.

Recipients are listed in the Non deliverables and addresses table available through the Administration > Campaign Management > Non deliverables Management menu.

  • To send the same reply no matter what the short code, leave the Short code column empty.
  • To send the same reply no matter what the keyword, leave the Keyword column empty.
  • To carry out an action without sending a response, leave the Response column empty. For example, this allows you to remove from quarantine a user who replies with a message other than “STOP”.

If you have multiple external accounts using the Extended generic SMPP connector with the same provider account, the following issue may happen: when sending a reply to a short code, it may be received on any of your external account connections. Consequently, the automatic reply that is sent could not be the expected message.
To avoid this, apply one of the following solutions, depending on the provider you are using:

  • Create one provider account for each external account.

  • Use the System type field from the Mobile > Connection settings tab to distinguish each short code. Ask your provider a different value for each account.

The steps for setting up an external account using the Extended generic SMPP connector are detailed in the Create an SMPP external account section.

Change the delivery template

Adobe Campaign provides you with a template for delivering to mobiles. This template is available in the Resources > Templates > Delivery templates node. For more on this, refer to the About templates section.

To deliver via SMS channel, you must create a template in which the channel connector is referenced.

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

In the example below, we create a template to deliver messages via the SMPP account enabled earlier. To do this:

  1. Go to the Delivery templates node.

  2. Right-click the Send to mobiles template, and select Duplicate.

  3. Change the label of the template, for example Sent to mobiles (SMPP).

  4. Click Properties.

  5. In the General tab, select a routing mode that corresponds to the external account that you created in the previous steps.

  6. Click Save to create the template.

You now have an external account and a delivery template that let you deliver via SMS.

601d79c3-e613-4db3-889a-ae959cd9e3e1