SMS > Interfacce di programmazione
logo Neomedia

È possibile interfacciare le vostre applicazioni direttamente con i nostri server, così da poter facilmente automatizzare ed integrare l'invio degli SMS nelle vostre procedure aziendali o siti web.

Ecco alcuni esempi di possibili applicazioni:

Neomedia mette a disposizione delle API (Application Programming Interface, cioè delle interfacce di programmazione) molto semplici e pratiche, e quindi veloci da implementare nei vostri sistemi. Esiste sia una pratica libreria per siti web in linguaggio PHP, sia un'API generica di rete basata sul comune protocollo HTTP e quindi facilmente utilizzabile con qualsiasi linguaggio e da qualsiasi applicazione connessa ad Internet.

Libreria PHP

Per l'invio di SMS tramite siti web scritti in PHP è possibile utilizzare un'apposita libreria sviluppata da Neomedia (nmsms.php). Se il vostro sito è ospitato sui nostri server la libreria è già installata ed è immediatamente utilizzabile. Se invece il sito web è presso un altro provider è necessario installare la libreria nel proprio spazio, scaricandola da questo link.

Al momento la libreria definisce solo la seguente funzione:

errore nmsms_send( account, password, testo, destinatari, [mittente, [opzioni]] )

Questi sono i parametri della funzione:

account
È l'account a cui addebitare l'invio dell'SMS.
password
È la password dell'account di addebito.
testo
È il testo del messaggio SMS da inviare. Se più lungo di 160 caratteri verrà automaticamente scomposto in più messaggi concatenati (massimo 3). Si fa presente che alcuni simboli speciali, ad esempio quello dell'Euro (€), occupano due caratteri.
destinatari
Questi sono i destinatari a cui inviare il messaggio SMS. Si possono specificare uno o più destinatari (senza alcun limite predefinito) separati da uno o più spazi, virgole o punti e virgola. Si possono specificare sia numeri di telefono che voci della rubrica dell'account di addebito.
mittente
Il contenuto di questo campo apparirà ai destinatari come mittente del messaggio SMS. Si può specificare un proprio numero di cellulare oppure un testo alfanumerico di massimo 11 caratteri.
opzioni
È un Array di stringhe opzionali. Al momento è possibile specificare solo l'opzione "bassocosto" che se presente imposta tale modalità di invio del messaggio.

La funzione restituisce come valore di ritorno una stringa con l'eventuale messaggio di errore oppure NULL in caso di esito positivo. Da notare che in quest'ultimo caso non vuol dire che l'SMS sia stato correttamente consegnato ai destinatari, ma semplicemente che il messaggio è stato correttamente accettato dai nostri server. Sul Pannello di controllo dell'account di addebito è possibile vedere l'esito degli invii e le eventuali notifiche di ricezione.

Esempio di uso della libreria PHP

Di seguito mostriamo un semplice esempio di uso della libreria PHP. Viene inviato un messaggio contemporaneamente al numero "321123456" ed alla voce di rubrica "maria.", facendo apparire "Pippo" come mittente, ed addebitando le spese sul Conto servizi dell'account "pippo".

require_once 'nmsms.php';

$error = nmsms_send( 'pippo', 'pippopw', 'Testo del messaggio SMS.', '321123456, maria', 'Pippo' );

if( !empty($error) )
    echo "Si è verificato il seguente errore: $error";
else
    echo "Messaggio inviato correttamente";

API generica di rete

Si tratta di una interfaccia generica, utilizzabile da qualsiasi applicazione a prescindere dal linguaggio di programmazione utilizzato. L'interfaccia utilizza il comune protocollo HTTP (o HTTPS), cioè lo stesso usato per navigare nel web. Quindi l'unico requisito per il suo utilizzo è che l'applicazione possa accedere ad Internet.

Si tratta di effettuare una normale richiesta HTTP (o HTTPS), di tipo GET o POST, alla seguente URL:

http://sms.neomedia.it/send

I parametri da passare alla richiesta sono i seguenti (da scrivere rigorosamente in minuscolo):

account
È l'account a cui addebitare l'invio dell'SMS.
password
È la password dell'account di addebito.
testo
È il testo del messaggio SMS da inviare. Se più lungo di 160 caratteri verrà automaticamente scomposto in più messaggi concatenati (massimo 3). Si fa presente che alcuni simboli speciali, ad esempio quello dell'Euro (€), occupano due caratteri.
destinatari
Questi sono i destinatari a cui inviare il messaggio SMS. Si possono specificare uno o più destinatari (senza alcun limite predefinito) separati da uno o più spazi, virgole o punti e virgola. Si possono specificare sia numeri di telefono che voci della rubrica dell'account di addebito.
mittente (opzionale)
Il contenuto di questo campo apparirà ai destinatari come mittente del messaggio SMS. Si può specificare un proprio numero di cellulare oppure un testo alfanumerico di massimo 11 caratteri.
bassocosto (opzionale)
Se presente e diverso da zero, imposta la modalità di invio dei messaggi a basso costo.

In caso di esito positivo, la richiesta ritorna il testo "OK". In caso di esito negativo, la richiesta ritorna il testo "ERRORE:" seguito dal messaggio di errore.

Se possibile, invece del protocollo HTTP si consiglia di utilizzare (sempre con la stessa URL) il protocollo HTTPS, cioè la versione cifrata dell'HTTP, in modo che la password non venga trasmessa in chiaro e quindi non possa essere intercettata da eventuali malintenzionati.