Questa funzione restituisce l'elenco delle letture ricevute da un messaggio unificato inviato dal tuo account di Socialmailer.
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);
- message_hash: l'hash del messaggio unificato di cui si desidera recuperare le letture ricevute (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);
- message_reads: i dati del messaggio unificato richiesto (unifiedMessageReads, tipo di dato composito definito nel WSDL);
Gli elementi che costituiscono il nodo message_recipients appartengono al tipo unifiedMessageReadData, che presenta la seguente struttura:
- contact: Hash del contatto che ha letto il messaggio unificato (token);
- messenger: Messaggero utilizzato per veicolare il messaggio (messengerValues);
- date: Data della lettura (date);
- remote_ip: Indirizzo IP del contatto che ha effettuato la lettura (string);
- remote_agent: Browser utilizzato per la lettura (string);
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:
- messengerValues: elenco dei messaggeri attraverso i quali veicolare il messaggio;