Method parameters
This method was created as an alternative to the SendSingleSMS method with the option type=TEXT, as SendSingleSMS creates a new message for each call and allocates it in the database . An (an intensive usage leads of SendSingleSMS leads to a database overload).
Use SendDirectSMS when you have to send thousands of text messages each day and you need a deep customization of each message (i.e. placeholders of personal data fields are not enough for your needs).
- string SendDirectSMS(string accessKey, int listID, string subject, string type, string content, string numero, Option[] options)
- accessKey: access key obtained using the Login method
- listID: list identifier. Lists and corresponding IDs can be obtained calling the GetLists Method
- subject: subject of the text message
- content: message text source
- type = ID, content is the identifier of the text message to be sent
- numero: recipient's number. Use international prefix (either with 00 or +), otherwise default list prefix will be applied
- options: an array of key/value pairs for options setting. A subset of the options listed for the WS_MailUpSend.CreateSMS method and WS_MailUpSend.SendSMS method are available for this method as well.
- note: a string containing notes about the message
- dyn_fld: boolean value to enable/disable the use of dynamic fields in the message (dyn_fld=true, dyn_fld=false)
- from: sender of the text message
- track_delivery: boolean value indicating whether the sending will appear in the delivery report or not
- isUnicode: boolean value indicating whether to use Western alphabets only (0 means "false"), or Eastern alphabets as well, such as Arabic, Russian, Chinese, and so on (1 means "true").
...
Note |
---|
Statistical data about this message will be stored in the message "Default N", where "N" indicates the list identifier |
If error code=0, the call to the method was successful and the method returns the details of the sending
...
Code Block | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://services.mailupnet.it/WS"> <soap:Header/> <soap:Body> <ws:SendDirectSMS> <!--Use <ws:accessKey> accessKey<accessKey value that is returned by LoginFromId method--> <ws:accessKey>HzAgwRRJaAKBtkgNWpkAuURfV4SxMm6T3HJegRuSkUivKJElNNcmSQe8nqGyoM9</ws:accessKey> <ws:listID>1</ws:listID> <ws:content>this is message text</ws:content> <!-- "numero" is recipient's number. Use international prefix (either with 00 or +), otherwise default list prefix will be applied --> <ws:numero>+393351234567<18889624587</ws:numero> <ws:options> <!-- Sender can be a number (with international prefix) or a string (up to 11 characters) --> <ws:Option><ws:Key>from</ws:Key><ws:Value>mittente</ws:Value></ws:Option> <!-- Unicode messages have a lenght of 70 chars instead of 160. --> <!--Concatenation of text messages exceeding lenght specified above is automatically either for Unicode or not Unicode messages--> <!-- (up to 3 messages can be concatenated) --> <ws:Option><ws:Key>isUnicode</ws:Key><ws:Value>false</ws:Value></ws:Option> </ws:options> </ws:SendDirectSMS> </soap:Body> </soap:Envelope> |
...