WS_MailUpSend.SendDirectSMS method

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 intensive usage 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").
      
      

If error code=0, the call to the method was successful and the method returns the details of the sending

Sample SendDirectSMS request

<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 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>+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>

Sample SendDirectSMS response

<SendDirectSMSResult>

  <errorCode>0</errorCode>

  <errorDescription>Message sent +18889624587</errorDescription>

</SendDirectSMSResult>