Questa funzione restituisce l'elenco dei destinatari di 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 i destinatari (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_recipients: i dati del messaggio unificato richiesto (unifiedMessageRecipients, tipo di dato composito definito nel WSDL);
Gli elementi che costituiscono il nodo message_recipients appartengono al tipo unifiedMessageRecipientData, che presenta la seguente struttura:
- contact: Hash del contatto destinatario (token);
- messenger: Messaggero con il quale il messaggio è stato veicolato (messengerValues);
- value: Destinazione (contatto vero e proprio) (string);
- sent_date: Data di invio del messaggio (date);
- read_date: Data di lettura da parte del destinatario (date);
- bounced_date: Data di rimbalzo del messaggio in caso di bounces (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:
- messengerValues: elenco dei messaggeri attraverso i quali veicolare il messaggio;