Method parameters

Sends a newsletter

• string SendNewsletter(string accessKey, int listID, int newsletterID, Option[] options)
• accessKey: access key obtained using the Login method
• newsletterID: identificativo del messaggio ritornato dal metodo CreateNewsletter 
• options: un array di coppie key/value per impostare le varie opzioni di invio
  • from_email: a string containing the sender email address. If not specified, the default value for the list will be used
  • from_name: a string containing the sender name. If not specified, the default value for the list will be used
  • clear_stats: a boolean value to enable/disable the deletion of statistics referred to previous mailings of the same message
  • send_to: a mandatory string indicating to whom the message will be sent. If send_to=ALL the message is sent to all subscribers, if send_to=RECIPIENTS the message is sent to specific email addresses, if send_to=GROUPS the message is sent to subscribers to specific groups
  • recipients: a string indicating the recipients of the message. Its content depends on the value assumed by "send_to". If send_to = ALL, "recipients" parameter is ignored and the message is sent to all the recipients in the list; if send_to=RECIPIENTS, "recipients" parameter contains a list of email addresses separated by the ";" character; if send_to=GROUPS, il "recipients" parameter contains the IDs of the recipient groups, separated by the ";" character 
  • exclude: a string containing the IDs of the groups to be excluded from the sending, separated by the ";" character
  • filters: una stringa contenente l'elenco dei filtri (identificativi) separati dal caratteri ; da utilizzare per individuare gli utenti ai quali dovrà essere inviato il messaggio.
  • filters_as: una stringa che indica la modalità di applicazione degli eventuali filtri indicatifilters_as=AND, tutti i filtri devono essere soddisfattifilters_as=OR, almeno uno dei filtri deve essere soddisfatto
  • deliverydt: una stringa contenente la data e l'ora per la quale deve essere schedulato la partenza dell'invio. Il formato deve essere il seguente: yyyyMMddHHmmss. Se non specificato l'invio inizia immediatamente ed in caso di invio già in corso il messaggio viene accodato a quelli in uscita.
  • timezone: un intero che identifica il fuso orario.
  • campo1 … campo<nn> = nel caso l'opzione recipients contenga l'elenco degli indirizzi email è possibile indicare uno o più campi anagrafici da aggiornare. Ogni option "campo<nn>" è una stringa contenente i valori per il campo anagrafico <nn> per gli indirizzi email indicati nell'opzione "recipients". Anche in questo caso, i valori devo essere separati dal carattere ;.

Se il codice di errore è 0, il messaggio conterrà l'identificativo del'invio.
Esempio di messaggio SendNewsletterResult:
<SendNewsletterResult>
<errorCode>0</errorCode>
<errorDescription>0</errorDescription>
<listID>1</listID>
<newsletterID>1</newsletterID>
<deliveryStatus>Sending in progress</deliveryStatus>
</SendNewsletterResult>

Come specificare i campi anagrafici

...

• • a string containing the IDs of the filters separated by the ";" character, to be used to retrieve the recipients of the message
  • filters_as: a string indicating how to apply the filters: if filters_as=AND, all the conditions in the filters have to be met; if filters_as=OR, at least one of them
  • deliverydt: a string containing date and time of scheduled delivery, in the format yyyyMMddHHmmss. If not specified, the sending starts immediately, and in case another sending is in progress the message is queued
  • timezone: an indication of the time zone
  • field1… field<nn> = in case the "recipients" parameter contains a list of email addresses, it is possible to indicate one or more personal data fields to be updated. Each option "field<nn>" is a string containing the values for the personal data field <nn> referred to the email  addresses indicated in the "recipients" parameter. Values must be separated by the ";" character

If error code=0, the message will contain the ID of the sending

Sample SendNewsletter

<SendNewsletterResult>
<errorCode>0</errorCode>
<errorDescription>0</errorDescription>
<listID>1</listID>
<newsletterID>1</newsletterID>
<deliveryStatus>Sending in progress</deliveryStatus>
</SendNewsletterResult>

Specifying personal data fields

It is important that the number of elements indicated for each "field<nn>" parameter corresponds to the number of addresses in the "recipients" parameter.
E.g. the message must be sent to three email addresses: recipients=johnsmith@example.com;pauljohnson@example.com;anntaylor@example.com
If name and surname are specified in field1 and field2, they will have to be detailed as follows:
field1=John;Paul;Ann
field2=Smith;Johnson;Taylor
In case of empty personal data fields, the number of elements must always be the same; in the example below, there are no personal data associated to the second email address:
field1=John;;Ann
field2=Smith;;Taylor