Virtual SIM API

Il servizio Virtual SIM è suddiviso in due tipologie :

• Dedicato

Al cliente sarà associato un numero telefonico esclusivamente dedicato al suo account. Tutti i messaggi in ingresso saranno inoltrati secondo le modalità di inoltro scelte.

• Condiviso

Al cliente sarà associato un numero telefonico condiviso tra più clienti. I messaggi in ingresso da inoltrare al cliente saranno identificati attraverso un codice di condivisione scelto all'atto dell'attivazione.

Con il servizio di ricezione Virtual SIM è possibile ricevere gli SMS in entrata attraverso POST HTTP. Di seguito è riportato l'URL che il gateway SMS richiamerà successivamente all'arrivo di ogni SMS

Il gateway SMS andrà a valorizzare i seguenti parametri :

• to

Numero telefonico della Virtual SIM associato all'account del cliente

• from

Mittente del messaggio in ingresso

• body

Testo del messaggio inviato

Attraverso questa funzione è possibile richiedere al gateway SMS di formattare i messaggi ricevuti nello standard RSS.

Di seguito è riportato un esempio di GET per richiedere gli ultimi 5 SMS non ancora scaricati.

• login

Login dell'account fornita all'atto dell'attivazione del servizio

• password

Password dell'account fornita all'atto dell'attivazione del servizio

• recv_id

Identificativo univoco del servizio di ricezione. E' possibile sapere qual'è l'identificativo del servizio entrando nell'area riservata.

• action

il parametro action deve essere uguale a: getmess

• rss

il parametro rss deve essere valorizzato con la versione RSS che si desidera utilizzare. L'unica versione al momento supportata è la 1.0. Quindi il suo valore dovrà essere uguale ad 1

• num

attraverso questo parametro è possibile specificare il numero massimo di messaggi che si desidera ricevere in risposta.

Esempio di risposta:

<?xml version=“1.0”?>
<rdf:RDF>
<item rdf:about=””>
<title>+3933333333</title>
<link/>
<description>Hello World</description>
</item>
</rdf:RDF>

Con il servizio Virtual SIM è possibile ricevere una copia del messaggio via mail. Il cliente potrà impostare, attraverso il pannello di configurazione online, un indirizzo email sul quale ricevere copia degli SMS in entrata ed eventualmente rispondere attraverso il servizio Email to SMS.

In associazione al servizio Virtual SIM viene fornita gratuitamente una piattaforma di SMS Voting, che permette di gestire contemporaneamente più votazioni SMS attraverso il software RavenDesk.