Permette di eseguire un invio singolo di un messaggio email. Il messaggio da inviare può essere già esistente oppure essere creato durante l'esecuzione della richiesta.
string SendSingleNewsletter(string accessKey, int listID, string subject, string type, string content, string recipientEmail, Option[] options)
accessKey: chiave di accesso ottenuta chiamando il metodo Login listID: identificativo della lista MailUp. Gli identificativi delle liste disponibili saranno recuperabile attraverso un apposito metodo del WebService. subject: oggetto del messaggio type: tipo di origine del testo del messaggio (HTML, URL, FILE, TEXT, ID) content: origine del testo del messaggio, dipende dal type:
- type = HTML, content è il codice HTML del messaggio
- type = TEXT, content è il PLAIN-TEXT del messaggio
- type = URL, content è l'url da quale ricavare in codice HTML del messaggio
- type = FILE, content è uno array di byte che rappresenta il file dal quale ricavare il codice HTML del messaggio
- type = ID, content è l'identificativo della newsletter da inviare
options: un array di coppie key/value per impostare le varie opzioni di invio. E' possibile specificare un sottoinsieme delle opzioni previste per i metodo CreateNewsletter e SendNewsletter:
- note: una stringa contenente delle note relative al messaggio
- dyn_fld: una valore booleano per abilitare/disabilitare l'utilizzo dei campi dinamici all'interno del messaggio (dyn_fld=true, dyn_fld=false
- emb_img: un valore booleano per abilitare/disabilitare l'utilizzo di immagini embedded all'interno del messaggio (emb_img=true, emd_img=false)
- link_track: una valore booleano per abilitare/disabilitare il tracciamento dei link (link_trcak=true, link_track=false). Se link_track=true e non viene specificato nessun'altra opzione fra track_http, track_https, track_mailto, track_ftp, track_news, si considera abilitato il tracciamento di tutti i protocolli. Per disabilitare un protocollo specificare la relativa opzione.
- track_http: una valore booleano per abilitare/disabilitare il tracciamento del protocollo http (track_http=true, track_http=false)
- track_https: una valore booleano per abilitare/disabilitare il tracciamento del protocollo HTTPS (track_https=true, track_https=false)
- track_mailto: una valore booleano per abilitare/disabilitare il tracciamento del protocollo MAILTO (track_mailto=true, track_mailto=false)
- track_ftp: una valore booleano per abilitare/disabilitare il tracciamento del protocollo FTP (track_ftp=true, track_ftp=false)
- track_news: una valore booleano per abilitare/disabilitare il tracciamento del protocollo NEWS (track_news=true, track_news=false)
- link_params: una stringa che permette di specificare dei parametri aggiuntivi per i link tracciati
- body_code: una stringa che contiene un codice personalizzato del TAG <body>
- header: una stringa che contiene un codice personalizzato del TAG <header>
- conf_msg: un valore booleano per marcare la newsletter come messaggio di conferma iscrizione.
- attach<nn>_data = base64 encoding del file
- attach<nn>_name = nome del file
- from_email: una stringa che contiene l'email mittente, se non indicato verrà utilizzato il valore impostato per la lista;
- from_name: una stringa che contiene il nome del mittente, se non indicato verrà utilizzato il valore impostato per la lista;
- campo1 … campo<nn> = è possibile indicare uno o più campi anagrafici da aggiornare per il destinatario specificato. Vengono gestiti esattamente come le opzioni corrispondenti del metodo SendNewsletter per un destinatario singolo (quindi non devono essere specificati i ; come separatore)
Se il codice di errore è 0, il messaggio conterrà l'identificativo del'invio.
Esempio di messaggio SendSingleNewsletterResult:
<SendSingleNewsletterResult>
<errorCode>0</errorCode>
<errorDescription>Message sent to support@mailup.it</errorDescription>
</SendSingleNewsletterResult>