Page tree

Versions Compared

Key

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

...

Code Block
languagehtml/xml
<input type="hidden" name="dynsndmail" value="email@example.com" > 
<input type="hidden" name="dynsndname" value="Name Surname"> 

 È possibile specificare i campi sopra riportati nei casi si volesse sostituirli ai valori preimpostati per la lista

It is possible to specify the fields above in case you should want to replace the default values for the list.

These fields allow to send a subscription confirmation message with personalized sender, and, in case both have been specified, they will be set as key values in the “From” field, while the default name and email address for the MailUp list will be used for the “Sender” field. So, on many clients this message will be viewed as “sent by Sender on behalf of From”. A confirmation email like this contains a link to the newsletter management system to complete the subscription, while, if the recipient replies to the email message (“Reply to”), the reply will be sent to the address indicated in the “From” field. This practice is very useful when a confirmation email is sent to an acquaintance: the invitation is much more effective if the person who invites is among the senders of the email (in the “From” field).

Anyway, filling up this fields is optional: in case neither of them has been specified the confirmation request email will be sent using the default list values to fill the “From” field.

Updsubscriber.aspx (User update)

 

Questa funzione consente una modifica all'anagrafica di un utente. 
URL: http://newsletter.nomedominio.tld/frontend/xmlUpdSubscriber.aspx 
PARAMETRI IN INGRESSO:

...

NOME

...

.

...

DESCRIZIONE

...

ListGuid

...

SI

...

Codice alfanumerico proprio della lista di distribuzione

...

List

...

SI

...

Codice lista di distribuzione

...

Email

...

NO (1)

...

Indirizzo e-mail dell'utente

...

Sms

...

NO (1)

...

Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2)

...

Replace

...

NO

...

Parametro per abilitare o meno la sostituzione dei gruppi per l'utente specificatoValori accettati: 0/1/false/true – Valore di default: false

...

Group

...

NO

...

I gruppi nei quali iscrivere l'utente

...

csvFldNames

...

NO

...

codici dei campi anagrafici (separati da (wink)

...

csvFldValues

...

NO

...

...

CODICE

DESCRIZIONE

0

Modifica completata con successo

1

Errore generico

Xmlchksubscriber.aspx (User subscription check)

Questa funzione consente la verifica sullo stato di iscrizione di un utente. 
URL: http://newsletter.nomedominio.tld/frontend/xmlChkSubscriber.aspx 
PARAMETRI IN INGRESSO:

NOME

OBBL.

DESCRIZIONE

ListGuid

SI

Codice alfanumerico proprio della lista di distribuzione

List

SI

Codice lista di distribuzione

Email

NO (1)

Indirizzo e-mail dell'utente

Sms

NO (1)

Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2)

...

CODICE

DESCRIZIONE

1

Errore generico / utente non iscritto

2

Utente iscritto (OPT-IN)

3

Utente disiscritto (OPT-OUT)

4

Utente in attesa di conferma iscrizione (PENDING)

...

 

Xmlsubscribe.aspx (User subscription)

 

Questa funzione è analoga alla precedente, le principali differenze consistono nel formato con cui si specificano i parametri e nal fatto che la xmlSubscribe restituisce un codice di ritorno con informazioni sull'esito dell'operazione. 
Per creare un form che iscrive a più liste contemporaneamente, inviando una sola email di richiesta conferma, utilizzare l'API subscribe.aspx descritta nel precedente paragrafo. 
URL: http://newsletter.nomedominio.tld/frontend/xmlSubscribe.aspx (sostituire la parte in rosso con il dominio di terzo livello corretto)
(OBBL. = Obbligatorio) 
PARAMETRI IN INGRESSO:

 

NOME

OBBLIGATORIO.

DESCRIZIONE

Email

NO (1)

Indirizzo e-mail dell'utente

Sms

NO (1)

Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2)

List

SI

Lista di distribuzione

Group

NO

I gruppi nei quali iscrivere l'utente

Confirm

NO

parametro per abilitare o meno l'email di richiesta confermaValori accettati: 0/1 e di default: 1

csvFldNames

NO

codici dei campi anagrafici (separati da (wink)

csvFldValues

NO

valori corrispondenti ai codici dei campi anagrafici (separati da (wink)

retCode

NO

Parametro per abilitare o meno la restituizione del codice di ritorno della chiamataValori accettati: 0/1 – Valore di default: 0

Dynsndmail(3)

NO

"dynamic sender e-mail address" Indirizzo e-mail del mittente nell'e-mail di richiesta conferma (se non specificato viene usato il valore di default specificato per la lista)

dynsndname(3)

NO

"dynamic sender name" Nome del mittente nell'e-mail di richiesta conferma (se non specificato viene usato il valore di default specificato per la lista)



(1) deve essere specificato almeno uno dei parametri email e sms
(2) se non specificato verrà utilizzato il prefisso internazionale italiano (0039)
(3) per ulteriori dettagli sull'utilizzo di questi campi consultare la descrizione dei campi omonimi per la pagina subscribe.aspx 

VALORI RESTITUITI

 

CODICE

DESCRIZIONE

0

Operazione completata con successo

1

Errore generico

2

Indirizzo email/numero cellulare non valido

3

Utente già iscritto


Nota: per conoscere il dominio di terzo livello utilizzato è sufficiente entrare in MailUp e guardare l'indirizzo della propria console. Ad esempio in figura sotto tale dominio è "v73.s02.it" 
 
Figura 13: indicazione del dominio di terzo livello per una certa console 

 

 

Xmlchksubscriber.aspx (User subscription check)


Questa funzione consente la verifica sullo stato di iscrizione di un utente. 
URL: http://newsletter.nomedominio.tld/frontend/xmlChkSubscriber.aspx 
PARAMETRI IN INGRESSO:

NOME

OBBL.

DESCRIZIONE

ListGuid

SI

Codice alfanumerico proprio della lista di distribuzione

List

SI

Codice lista di distribuzione

Email

NO (1)

Indirizzo e-mail dell'utente

Sms

NO (1)

Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2)


(1) deve essere specificato almeno uno dei parametri email e sms
(2) se non specificato verrà utilizzato il prefisso internazionale italiano (0039) 
VALORI RESTITUITI

CODICE

DESCRIZIONE

1

Errore generico / utente non iscritto

2

Utente iscritto (OPT-IN)

3

Utente disiscritto (OPT-OUT)

4

Utente in attesa di conferma iscrizione (PENDING)



NOTA:
Il codice 1 viene restituito sia in caso di errore (ad esempio il ListGuid non corrisponde alla lista specificata) che in caso di utente non iscritto 

 

 

 

Xmlunsubscribe.aspx (User unsubscription)

 

 

 

Questa funzione forza la disiscrizione di un utente da una lista. 
URL: http://newsletter.nomedominio.tld/frontend/xmlUnSubscribe.aspx 
PARAMETRI IN INGRESSO:

 

 

 

NOME

OBBL.

DESCRIZIONE

ListGuid

SI

Codice alfanumerico proprio della lista di distribuzione

List

SI

Codice lista di distribuzione

Email

NO (1)

Indirizzo e-mail dell'utente

Sms

NO (1)

Numero di cellulare dell'utente, comprensivo di prefisso internazionale (2)

 

 

 


(1) deve essere specificato almeno uno dei parametri email e sms
(2) se non specificato verrà utilizzato il prefisso internazionale italiano (0039) 
VALORI RESTITUITI

 

 

 

CODICE

DESCRIZIONE

0

Utente disiscritto con successo

1

Errore generico

3

Utente non esistente / già disiscritto

 

 

 


NOTA:
In caso di esito positivo l'utente verrà spostato tra gli opt-out e gli verrà inviata una email di conferma dove previsto


 

Updsubscriber.aspx (User update)


This function allows to update a user's personal data.


URL: http://newsletter.domainname.tld/frontend/xmlUpdSubscriber.aspx 


INPUT PARAMETERS:

Name

Mandatory?

Description

ListGuid

Y

Alphanumeric code associated to a distribution list

List

Y

List ID

Email

(1)

User email address

Sms

(1)

User mobile number, with international prefix (2)

Replace

N

Parametro per abilitare o meno la sostituzione dei gruppi per l'utente specificatoValori accettati: 0/1/false/true – Valore di default: false

Group

N

Groups to which to subscribe the user

csvFldNames

N

Personal data codes (separated by ";" character)

csvFldValues

N

Values related to personal data codes (separated by ";" character)


(1) either email or sms parameter must be specified
(2) if blank, international code for Italy will be used (0039) 


OUTPUT VALUES:

CODE

DESCRIPTION

0

Data updated successfully

1

Generic error