WS_MailUpSend.SendDirectSMS

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 content, string numero, Option[] options)
  • accessKey: access key obtained using the LoginFromId method
  • listID: list identifier. Lists and corresponding IDs can be obtained calling the GetLists Method
    
  • content: message text source
  • 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. Only the following options are available for this method:
    
    • from: sender of the text message (note: restrictions may apply in some countries and the sender may be overwritten, please contact us for country specific information)
    • 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").
    • MessageId: the ID of the message used to store statistical data
      
      

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

SOAP Examples

<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 length of 70 chars instead of 160. -->
                <!--Concatenation of text messages exceeding length 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>

<SendDirectSMSResult>
  <errorCode>0</errorCode>
  <errorDescription>Message sent +18889624587</errorDescription>
</SendDirectSMSResult>