Socialmailer API

Questa funzione restituisce tutte le azioni di un contatto relative alla piattaforma Socialmailer (iscrizione a Socialmailer, disiscrizione da Socialmailer, ricezione di un messaggio unificato, lettura di un messaggio unificato, click su di un link definito in un messaggio unificato, rimbalzo di un messaggio unificato).

I parametri da passare in input alla chiamata sono:

• account_token: il token di autenticazione del tuo account Socialmailer (token);

• account_username: lo username del tuo account Socialmailer (string);

• account_password: la password del tuo account Socialmailer (string);

• contact_hash: l'hash del contatto del quale si vogliono recuperare le azioni (token);

In output la funzione restituisce:

• encoding: il charset di codifica della risposta (string);

• status: il valore dello stato restituito risposta (integer);

• message: la descrizione dello stato restituito dalla risposta (string);       

• contact_activities: l'insieme dei dati richiesti (contactActivities, tipo di dato composito definito nel WSDL);

Gli elementi che costituiscono l'array contact_activities appartengono al tipo contactActivityData, che presenta la seguente struttura:

• action: Azione eseguita (actionValues, tipo di dato composito definito nel WSDL);

• object: Oggetto sul quale l'azione è stata eseguita (objectValues, tipo di dato composito definito nel WSDL);

• hash: Hash dell'attività eseguita (token);

• date: Data di esecuzione dell'attività (date);

Alcuni campi presenti nella risposta della funzione sono campi compositi definiti all'interno del file di definizione WSDL del web service.

Sono identificati dal tag tns (this name space) e riportano un elenco di valori predefiniti che possono essere assunti.

Essi sono:

• actionValues: valori possibili per le azioni;

• objectValues: valori possibili per gli oggetti sui quali possono essere eseguite azioni;