SMS methods

SMS methods

Recommended methods to be used to send text messages (SMS)

The following table includes the recommended API methods to be used to perform certain tasks.

Num.

Action

Description

SOAP API

Other methods

Num.

Action

Description

SOAP API

Other methods

1

Create new text message

Create a new text message with dynamic fields (optional) that can then be used as "existing message" fro the actions listed below
(MESSAGE_ID is returned). New message is also available on MailUp console.

CreateSMS

 

2

Single sending of EXISTING messages
to a specified recipient 

A single existing text message is sent to a single recipient by specifying MESSAGE_ID and destination number.
Message shall be previously created and it can be customized by means of dynamic fields

SendSingleSMS

 

3

Single sending of NEW messages
to a specified recipient 

In this case existing messages cannot be used, a brand new text message (with or without dynamic fields) has to be created
and sent to a single recipient

SendDirectSMS

 

4

Bulk sending of EXISTING messages
to all subscribers or groups of them

A single existing text message is sent to many recipients (e.g. all list subscribers, one or more groups ...). by specifying
MESSAGE_ID and List/group identifiers
Message shall be previously created and it can be customized by means of dynamic fields

SendSMS

 

5

Bulk sending of NEW messages
to all subscribers or groups of them

A new text message (with or without dynamic fields) has to be created and sent to a list of subscribers.


Each action of this type creates a new message on MailUp admin console.
The greater is the number of  messages and the higher is the load on MailUp admin console, leading to
slowering access time to web pages and response time of web services. Please use alternative solutions
provided in this page if you have to make more than ten actions of this type per day

CreateSMS  + SendSMS
or SendSmsFast

 

6

Bulk sending of NEW messages
to a list of recipients with a specific
text message for each recipient

In some cases customization through dynamic fields could be not enough
A list of {recipient + message text for this recipient} has to be provided as input and all messages shall be sent as a single campaign.
This option has not the side effects of option #5 and it also allows sending of completely different messages for each recipient.

N/A

SMS sending from CSV file

7

Immediate sending

For text messages to be sent as soon as possible

SendSingleSMS 
SendDirectSMS  
SendSMS
SendSmsFast 

SMS sending from CSV file 

8

Scheduled sending

For text messages to be sent at specified time

SendSMS
SendSmsFast 

SMS sending from CSV file 

9

Sending of concatenated messages

When message length is higher than 160 characters (or higher than 70 chars if "Unicode" (use Unicode for non western alphabets)

SendSingleSMS 
SendDirectSMS  
SendSMS
SendSmsFast 

SMS sending from CSV file