Questa funzione consente di inserire un nuovo contatto nella tua rubrica 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);
- contact_data: Array con i dati che costituiscono l'anagrafica del contatto (setContactData);
Il campo contact_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:
- contact-firstname: Nome del contatto (string);
- contact-lastname: Cognome del contatto (string);
- contact-gender: Genere (sesso) del contatto (genderValues, tipo di dato composito definito nel WSDL);
- contact-birthdate: Data di nascita del contatto (date);
- contact-street: Indirizzo di residenza del contatto (string);
- contact-number: Numero civico di residenza del contatto (string);
- contact-city: Città di residenza del contatto (string);
- contact-cap: CAP di residenza del contatto (int);
- contact-nation: Nazione del contatto (nationValues, tipo di dato composito definito nel WSDL);
- contact-district: Provincia di residenza del contatto (districtValues, tipo di dato composito definito nel WSDL);
- contact-telephone: Telefono del contatto (string);
- contact-fax: Fax del contatto (string);
- contact-mobile: Cellulare del contatto (string);
- contact-carrier: Operatore mobile del contatto (carrierValues, tipo di dato composito definito nel WSDL);
- contact-email: Indirizzo email del contatto (string);
- company-name: Ragione sociale del contatto, se è di tipo "company" (azienda) (string);
- company-street: Indirizzo dell'azienda (string);
- company-number: Numero civico dell'azienda (string);
- company-city: Città dell'azienda (string);
- company-cap: CAP dell'azienda (int);
- company-nation: Nazione dell'azienda (nationValues, tipo di dato composito definito nel WSDL);
- company-district: Provincia dell'azienda (districtValues, tipo di dato composito definito nel WSDL);
- company-telephone: Telefono dell'azienda (string);
- company-fax: Fax dell'azienda (string);
- company-email: Indirizzo email dell'azienda (string);
- company-website: Sito internet dell'azienda (anyURI);
- settings-type: Tipologia del contatto ( "private" o "company" - "privato" o "azienda") (typeValues, tipo di dato composito definito nel WSDL);
- settings-language: Lingua del contatto (languageValues, tipo di dato composito definito nel WSDL);
- settings-note: Note (string);
- social-facebook: Facebook (string);
- social-twitter: Twitter (string);
- social-linkedin: LinkedIn (string);
- social-plaxo: Plaxo (string);
- social-skype: Skype (string);
- social-msn: MSN Messenger (string);
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_hash: l'hash del contatto inserito (token);
Alcuni campi dell'array contact_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: