Specifiche API

Post/Get HTTP

Accesso al gateway SMS

Per poter utilizzare le API l'utente dovrà abilitare l'accesso e configurare il suo IP nel pannello di configurazione della propria area riservata all'indirizzo:
https://www.smskdev.it/playsms

La sicurezza delle transazioni é assicurata da Verisign®. Il sistema accetta sia GET che POST.

Doku Wiki - Esempio chiamata GET

Eseguito il login accedere dal menù alla sezione Il Mio Account > Configurazione Utente.

  • Scegliere SI dalla dropdown in corrispondenza dell'opzione "Abilita Webservice ".
  • Specificare l'IP o gli IP dai quali saranno lanciate le chiamate nel campo in corrispondenza dell'opzione "WebService Ip Range", per aprire il Webservice su tutte le reti specificare *.*.*.*

Invio SMS tramite http

Per l'invio di un SMS é sufficiente una chiamata HTTPS.
Esempio di chiamata per invio SMS:

https://www.smskdev.it/playsms/send.php?user=utente&passkey=utente&to=39XXXXXXXXXX&text=testo%20messaggio

Nota bene: il testo dell'SMS deve essere condificato secondo lo standard URLENCODE

output della chiamata in formato JSON
stdClass Object
(
  [data] => Array
    (
      [0] => stdClass Object
        (
          [status] => OK
          [error] => 0
          [smslog_id] => 5496
          [queue] => b09035435513302c1beb6a29224c9976
          [to] => 39XXXXXXXX
        )
    )
    [error_string] => 
    [timestamp] => 1413318506
)

Come si può vedere dall'esempio, il tracciato riporta:

  • [status] OK - Esito dell'accodamento (OK o KO)
  • [error] 0 - Eventuale codice errore
  • [smslog_id] 5496
  • [queue] b09035435513302c1beb6a29224c9976
  • [to] 39XXXXXXXX
Codici di errore

Le operazioni concluse con successo riporteranno la dicitura "OK" nei messaggi di conferma
La tabella riportante i codici di errore delle chiamate fallite è disponibile sulla KDEV SMS Doku Wiki.

Doku Wiki - Tabelle di errore


DLR - Notifica di ricezione

Ogni SMS inviato viene accompagnato da un Delivery Report "ricevuta di ritorno"
I Delivery Report (DLR) sono serviti in formato .CSV.

I DLR contengono il codice di riferimento dell¹operazione, fai riferimento alla tabella codici per conoscere l'esito


SMTP o funzione email to SMS

Al momento dell'attivazione riceverete una mail con il seguente testo:

Il mittente abilitato alla funzione MAIL to SMS é nome@dominio.it. Invia una mail a: 39xxxxxxxxx@kdev.it sostituendo le x con il numero del dispositivo mobile desiderato, il soggetto della mail sarà recapitato come SMS.


Upload di file CSV

Nella mail di attivazione verranno forniti i parametri FTP per accedere alla propria area utente, mediante questi parametri potrete caricare via FTP o SFTP un file CSV nel formato:

mittente;numero_cellulare_destinazione;testo del messaggio

Una volta caricato, il file CSV verrà automaticamente spedito entro 3 minuti.


Sulla KDEV SMS Doku Wiki potrai trovare esempi di codice della API del servizio KDEV SMS Gateway, pronti per esser copiati, modificati ed utilizzati!

KDEV SMS - Documentazione ufficiale

Chiama ora!

Sempre disponibile 24/7!
Segui la voce guida.

KDEV SMS - Chiama ora

Calendario eventi

KDEV SMS - Calendario eventi

Le date evento ed i modelli di SMS da utilizzare come idee per le tue campagne SMS!

Calendario KDEV SMS

SMS DB Cleansing

KDEV SMS Database Cleansing

Rimozione dal vostro DB dei numeri mobile non più raggiungibili, per un risparmio fino al 30%!

SMS DB Cleansing

Acquista

Acquista ora il tuo pacchetto SMS personalizzato sull'SMS FoxBox Shop!

SMS FoxBox Shop

Documenti

"Codice di Condotta relativo alla fornitura di servizi di messaggistica aziendale contenenti codici alfanumerici (Alias) come mittenti (Codice)"
Scarica il documento


Per registrare l’alias mittente compila questo modulo.