Method parameters

The SendMessageNL method:

  1. Allows to send a message to the recipients listed in a CSV file
  2. Synchronously executes the following steps:

    1. Scheduling of a sending at the date and time contained in the parameters
    2. Return of a delivery ID to the caller

  3. Asynchronously executes the following steps:

    1. Creation of a group in MailUp in which to gather the recipients that have to be imported
    2. Import to MailUp of the recipients included in the file. Recipients will be imported to the list indicated by the filename (see Appendix B for details)

 

Parameters listGuid listId can be used together or alternatively, passing one of them as null or empty: in the first case the list is verified using both parameters, otherwise using only the provided parameter.

 

SendMessageNL method

  • Requires the CSV file to be moved to MailUp servers
  • Manages import and sending for a specific list. Differently from batch FTP imports from a CSV file, this method does not allow to import contacts to different lists. All recipients must be imported in the same list
  • The file containing the recipients must be in CSV format (can also be provided in a compressed format using ZIP compression).The file and its fields must be structured following the guidelines contained in the Appendix B
  • Cannot perform a check on the possible duplication of contacts in the file, so the customer's system that creates the file has to take on this check.



The combination of the parameters timeDateSending and sendDelayTest determines the date of the scheduled sending 

TimeDateSending parameter can assume the following values:

SendDelayTest is considered only if the value provided by timeDateSending parameter indicates an Immediate sending.

This parameter can assume the following values:


How a sending is scheduled according to the parameters timeDateSending e sendDelayTest is summed up in the following table

timeDateSending

sendDelayTest

Scheduled sending date in MailUp

value <= current date (Immediate sending)

sendDelayTest > 0

current date + sendDelayTest

value <= current date (Immediate sending)

sendDelayTest <= 0

current date + fixed value in MailUp

value > current date (Scheduled sending)

sendDelayTest > 0

timeDateSending

value > current date (Scheduled sending)

sendDelayTest <= 0

timeDateSending


The method returns