Language

Italiano English Français

RavenFTP API

Descrizione

Attraverso il sistema di invio basato su protocollo FTP è possibile inviare grandi quantità di SMS in pochi secondi. Il sistema accetta in ingresso file in formato CSV.

L'indirizzo del server FTP di AirTelco è : ftp.airtelco.com

Struttura della home

All'interno della directory home sono presenti due sottodirectory

  • sms

directory che conterrà i file messaggi con la descrizione degli SMS che saranno processati dal gateway di airtelco.

  • status

directory che conterrà il file con lo stato finale della spedizione.

Struttura del file messaggi

Il file messaggi deve essere un file in formato CSV formato da 7 colonne

Le colonne devono essere sempre nello stesso ordine, da sinistra vestro destra le colonne sono le seguenti :

  1. Numero di telefono destinatario del messaggio

Il numero di telefono deve essere espresso nel formato internazionale.

Esempio di numero telefonico : +44123456789

  1. Mittente del messaggio

Il mittente del messaggio puo essere alfanumerico e non deve contenere più di 11 caratteri.

  1. Corpo del messaggio

Il corpo del messaggio varia in base alla tipologia di SMS che si intende inviare. Per messaggi di tipo text è possibile inviare testi che contengono caratteri che fanno parte dell'alfabeto GSM. Se si intende inviare messaggi che contengono caratteri NON presenti all'interno dell'alfabeto GSM è necessario utilizzare la tipologia ucs (Unicode) in questo caso il testo del messaggio deve contenere il valore esadcimale dei caratteri che si intendono inviare al cellulare. In quest ultimo caso il testo non puo superare i 72 caratteri. Per inviare messaggi che rientrano nell'alfabeto GSM ma con un testo superiore ai 160 caratteri è necessario settare come tipologia di messaggio long mentre nel caso in cui il testo fosse UCS ma con una lunghezza superiore ai 72 caratteri la tipologia del messaggio dovrà essere lucs.

  1. Qualità del messaggio

La qualità del messaggio è espressa con un carattere p oppure s Premium o Standard.

  1. Tipologia messaggio

Le tipologie attualmente supportate sono :

  • text
  • long
  • binary
  • ucs
  • wappush
  • long
  • lucs
  1. UDH (User Data Header)

Questo campo dovrà essere valorizzato in presenza di messaggi ad 8 bit quindi di tipologia binary.

  1. URL (per messaggi WAP-PUSH)

Questo campo dovrà essere valorizzato in presenza di messaggi wap push.

Per maggiori informazioni è consigliabile scaricare l'esempio presente nella pagina principale della documentazione.

Invio SMS

Dopo aver creato il file messaggi è necessario portarlo nella directory sms. Successivamente per attivare l'invio degli SMS bisogna effettuare in sequenza l'upload di un file vuoto con lo stesso nome del file messaggi ma con estensione ”.send”

Se il file messaggi si chiama invio.csv il file spedizione dovrà chiamarsi invio.csv.send

Il sistema di invio FTP può processare in media circa 200/sms al secondo. Al termine genererà un file di stato che sarà slavato nella directory status.

Struttura del file di stato

Il file di stato generato avrà una struttura simile alla seguente :

1:SENT:553
2:SENT:554
3:SENT:555
4:SENT:556
5:SENT:557
6:SENT:558
END:ID:318

dove il numero a destra indica la riga del file CSV processato, la stringa successiva lo stato del messaggio e il valore numerico a destra l'identificativo del messaggio. Al termine del file sarà sempre presente la stringa END:ID:NNN dove il valore numerico indica l'identificativo dell'intera spedizione.

ravenftp_api.txt · Last modified: 2012/02/14 16:40 (external edit)
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki