Le nostre interfacce API SMS sono facili e rapidissime da integrare
Protocolli REST e Web Service
Europ SMS offre un canale alternativo al tradizionale sito web per l’invio di SMS: Rest o Web Services
Europ SMS utilizza una versione semplificata di REST, si tratta semplicementedi URL ed JSON: questo garantisce la massima semplicità di implementazione in qualsiasi ambiente da PHP a JAVA a IOS.
A cosa serve il REST?
Permette di utilizzare la piattaforma Europ SMS direttamente dall’interno di altri software. Il servizio è utilizzato in molti ambiti, tra cui:
- software di gestione dei rapporti con i clienti (CRM);
- software di gestione pratiche;
- software per palestre;
I software elencati inviano automaticamente, mediante rest, messaggi di promemoria, di notifica o di informazioni rendendo più efficente il rapporto con il cliente/utente.
Facciamo una prova
www.services.europsms.com/smpp-gateway.php?op=sendSMS2&smpp_id=QUIEMAIL&utenti_password=QUIPASS&tipologie_s
ms_id=2&destinatari_destination_addr=QUINUM&trasmissioni_messaggio=
prova&trasmissioni_mittente=test
se il numero è 3381009999 QUINUM = %2B393381009999
tipologie sms: (1 è per economy, 2 per professional, 3 per economy otp )
è semplicissimo, si può mandare sms anche dal browser! I dati si possono mandare in GET o in POST ed in questo caso non viene proprio usato JSON ma l’id trasmissione.
Per consultare lo stato:
Il risultato è un oggetto JSON. È davvero semplicissimo, se ci sono difficoltà rimaniamo a disposizione.
WEB SERVICES L’alternativa
A cosa serve il web service?
Il web service è un servizio che permette di utilizzare la piattaforma Europ SMS direttamente dall’interno di altri software che inviano automaticamente, mediante il web service, messaggi di promemoria, di notifica o di informazioni rendendo più efficente il rapporto con il cliente/utente.
Come funziona?
La tecnologia web service si basa su un protocollo molto diffuso denominato SOAP: tutti i maggiori linguaggi di programmazione dispongono di librerie SOAP per utilizzare web service.
Per poter utilizzare il web service di Europ SMS è sufficiente:
- L’URL del WSDL: http://www.services.europsms.com/service.php?wsdl
- Le credenziali di accesso alla piattaforma Europ SMS: le stesse utilizzate per il sito web
- Tipologia sms : (1 è per economy, 2 per professional, 3 per economy otp )
Con le informazioni elencate qualsiasi programmatore con discreta esperienza è in grado di utilizzare il web service Europ SMS.
Il WSDL è un linguaggio che permette di descrivere le funzionalità offerte da un web service: la lettura del WSDL è molto complicata ed è riservata alle librerie software. Alcuni linguaggi di programmazione, per agevolare il lavoro del programmatore, autoconfigurano il software partendo proprio dalle informazioni contenute nel documento WSDL
L’indirizzo http://www.services.europsms.com/service.php permette una consultazione “umana” del WSDL:
- elenca le operazioni attualmente rese disponibili;
- per ciascuna operazione elenca i parametri necessari all’utilizzo.
Il web service può essere utilizzato all’interno di moltissimi ambienti di sviluppo. Riportiamo un esempio nel linguaggio oggi più diffuso: il PHP
Un esempio compatibile con PHP5
class Destinatari {
public $destinatari_destination_addr;
public $destinatari_stati_consegna_id;
function __construct($destinatari_destination_addr,$destinatari_stati_consegna_id) {
$this->destinatari_destination_addr=$destinatari_destination_addr;
$this->destinatari_stati_consegna_id=$destinatari_stati_consegna_id;
}
}
$client = new SoapClient(“http://www.services.europsms.com/service.php?wsdl”);
$destinations[]=new Destinatari(‘+393380000000’,1);
$messaggio=”Prova invio SMS da web service.”;
$client->sendWsSMS2(‘utente’,’password’, 1, $messaggio,$destinations,”);
Occorre precisare che l’esempio riportato utilizza la libreria NuSOAP: in precedenza PHP non supportava nativamente il protocollo SOAP ed era molto diffuso l’utilizzo di librerie esterne. L’esempio pertanto si adatta anche a vecchie versioni di PHP
È possibile utilizzare anche altre librerie o linguaggi: per maggiori approfondimenti vi invitiamo a consultare il web o una software house di fiducia.
Per Ulteriori info Europ SMS
Europ SMS Assistenza
info@europsms.com
+39 3386304860