È 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.
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:
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.
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"; |
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):
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.