SendMessageNL Method

Method parameters

The SendMessageNL method allows to:

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)

• int SendMessageNL(string accessKey, string fileName, string separator, string listId, string listGuid, string messageId, string senderName, string sender, string subject, DateTime timeDateSending, int sendDelayTest)
• accessKey: access key obtained using the Login method
• fileName: name of the CSV files containing the recipients of the message
• separator: separating character used in the CSV file. If null or empty, the character ';' will be used by default.
• listId: list identifier
• listGuid: GUID of the list in MailUp
• messageId: ID of the message to be sent
• senderName: name of the sender of the message. If null or empty, the system will use the default name for the list.
• sender: indirizzo email del mittente del Messaggio. If null or empty, the system will use the default address for the list. If no default sender has been defined for the list, the sending does not start.
• subject: subject of the message
• timeDateSending: date and time of scheduled sending
• sendDelayTest: desired delay for the immediate sending
  
  

Parameters listGuid e 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.

La combinazione dei parametri timeDateSending e sendDelayTest determina la data in cui MailUp programmal'invio.
Il parametro timeDateSending può assumere i seguenti valori :

• Se data e ora hanno un valore che appartiene al passato l'invio è gestito come Invio Immediato. Il ritardo minimo prestabilito è calcolato in base al valore fornito dal parametro sendDelayTest:.
• Se il valore di data/ora è successivo a quello attuale allora l'invio è gestito come Invio Schedulato Pianificato, programmato.

Il parametro sendDelayTest viene preso in considerazione solo se il valore fornito dal parametro timeDateSending indica un Invio Immediato.
I valori che può assumere il parametro sono:

• uguale o minore di zero. In questo caso il ritardo dell'Invio Immediato è un valore fisso definito in MailUp (Configurato in 20 minuti).
• Maggiore di zero. In questo caso il ritardo dell'Invio Immediato corrisponde al valore del parametro.

Il calcolo della schedulazione di un Invio in base ai parametri timeDateSending e sendDelayTest è riassunto nella tabella seguente:

Tabella 7: Calcolo programmazione invio
Il metodo restituisce:

• L'identificativo numerico dell'Invio.
• -1 in caso l'operazione non può essere portata a buon fine (ad esempio parametri errati o problemi di sistema).