Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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. Method parameters

Performs a single sending of an email message, already existing or created as the request is executed.

 

  • string SendSingleNewsletter(string accessKey, int listID, string subject, string type, string content, string recipientEmail, Option[] options)
  • accessKey:

...

  •  access key obtained using the Login method
  • listID: list identifier. Lists and corresponding IDs can be obtained calling the GetLists Method
  • subject: subject of the email message
  • type: type of message text (HTML, URL, FILE, TEXT, ID)
  • content:

...

  •  message text source, depending on the type:
    • type = HTML,
    content è il codice HTML del messaggio
    •  content is the HTML code of the message
    • type = TEXT,
    content è il
    •  content is the PLAIN-
    TEXT del messaggio
    • TEXT of the message
    • type = URL,
    content è l'url da quale ricavare in codice HTML del messaggio
    •  content is the url from which to draw the HTML code of the message
    • type = FILE,
    content è uno array di byte che rappresenta il file dal quale ricavare il codice HTML del messaggio
    •  content is a byte array from which to draw the HTML code of the message
    • type = ID, content
    è l'identificativo della newsletter da inviare
    • is the identifier of the newsletter to be sent
  • options:

...

  • an array

...

  • of key/value

...

  • note: una stringa contenente delle note relative al messaggiopairs for options setting. A subset of the options listed for the CreateNewsletter Method and SendNewsletter Method are available for this method as well.
    • note: a string containing notes about the message
    • dyn_fld:
    una valore booleano per abilitare/disabilitare l'utilizzo dei campi dinamici all'interno del messaggio
    • boolean value to enable/disable the use of dynamic fields in the message (dyn_fld=true, dyn_fld=false)
    • emb_img:
    un valore booleano per abilitare/disabilitare l'utilizzo di immagini embedded all'interno del messaggio
    •  boolean value to enable/disable the use of embedded images in the message (emb_img=true, emd_img=false)
    • link_track:
    una valore booleano per abilitare/disabilitare il tracciamento dei link
    • boolean value to enable/disable the use of link tracking in the message (link_trcak=true, link_track=false).
    Se
    •  If link_track=true
    e non viene specificato nessun'altra opzione fra
    • and no other option is specified among 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.
    • tracking of all protocols is activated. In order to disable a protocol, specify the corresponding parameter
    • track_http:
    una valore booleano per abilitare/disabilitare il tracciamento del protocollo http
    • boolean value to enable/disable the use of http protocol tracking in the message (track_http=true, track_http=false)
    • track_https:
    una valore booleano per abilitare/disabilitare il tracciamento del protocollo HTTPS
    • boolean value to enable/disable the use of HTTPS protocol tracking in the message (track_https=true, track_https=false)
    • track_mailto:
    una valore booleano per abilitare/disabilitare il tracciamento del protocollo MAILTO
    • boolean value to enable/disable the use of MAILTO protocol tracking in the message (track_mailto=true, track_mailto=false)
    • track_ftp:
    una valore booleano per abilitare/disabilitare il tracciamento del protocollo FTP
    • boolean value to enable/disable the use of FTP protocol tracking in the message (track_ftp=true, track_ftp=false)
    • track_news:
    una valore booleano per abilitare/disabilitare il tracciamento del protocollo NEWS
    • boolean value to enable/disable the use of NEWS protocol tracking in the message (track_news=true, track_news=false)
    • link_params:
    una stringa che permette di specificare dei parametri aggiuntivi per i link tracciati
    •  a string allowing to specify additional parameters for tracked links
    • 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.
    •  a string containing a personalized code for the <body> tag
    • header: a string containing a personalized code for the <header> tag
    • conf_msg: boolean value to mark the message used as a subscription confirmation
    • attach<nn>_data =
    base64
    •  base64 file encoding
    del file
    • attach<nn>_name =
    nome del file
    • filename
    • from_email:
    una stringa che contiene l'email mittente, se non indicato verrà utilizzato il valore impostato per la lista;
    •  a string containing the sender email address. If not specified, the default value for the list will be used
    • 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)

...

    •  a string containing the sender name. If not specified, the default value for the list will be used
    • field1… field<nn> = it is possible to indicate one or more personal data fields to be updated for the recipient of this message. They work exactly like as in the SendNewsletter Method, but referred to a single recipient: as a consequence, the character ";" is not required as a separator

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

Sample SendSingleNewsletter Method

Code Block
languagehtml/xml
linenumberstrue
<SendSingleNewsletterResult>
<errorCode>0</errorCode>
<errorDescription>Message sent to support@mailup.it</errorDescription>
</SendSingleNewsletterResult>