Socialmailer API

Questa funzione consente di creare un nuovo messaggio unificato in 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_data: Array con i dati che costituiscono il nuovo messaggio unificato (setUnifiedMessageConfigurationData);

Il campo message_data è un campo composito definito all'interno del file di definizione WSDL del web service e dentificati dal tag tns (this name space).

Esso deve riportare la seguente struttura:

• language: Language (languageValues, tipo di dato composito definito nel WSDL);

• newsletter_messenger: Messaggero Newsletter (enabledValues, tipo di dato composito definito nel WSDL);

• sms_messenger: Messaggero Sms (enabledValues, tipo di dato composito definito nel WSDL);

• fax_messenger: Messaggero Fax (enabledValues, tipo di dato composito definito nel WSDL);

• social_messenger: Messaggero Social (enabledValues, tipo di dato composito definito nel WSDL);

• facebook_messenger: Messaggero Facebook (socialMessengerValues, tipo di dato composito definito nel WSDL);

• twitter_messenger: Messaggero Twitter (socialMessengerValues, tipo di dato composito definito nel WSDL);

• linkedin_messenger: Messaggero LinkedIn (socialMessengerValues, tipo di dato composito definito nel WSDL);

• newsletter_sender: Mittente validato Newsletter (Email) (newsletterSendersValues, tipo di dato composito definito nel WSDL);

• sms_sender: Mittente validato Sms (Sender - OADC) (smsSendersValues, tipo di dato composito definito nel WSDL);

• title: Titolo (string);

• author: Autore (authorValues, tipo di dato composito definito nel WSDL);

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_hash: l'hash del messaggio unificato inserito (token);

Alcuni campi dell'array message_data da passare alla richiesta 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:

• languageValues: lingue disponibili per il messaggio;

• enabledValues: stato di abilitato/disabilitato per un messaggero;

• socialMessengerValues: approccii o modalità di invio tramite Social;

• newsletterSendersValues: mittenti per le Newsletter;

• smsSendersValues: mittenti per gli SMS;

• authorValues: elenco degli utenti che possono essere autori di un messaggio;