Differences

This shows you the differences between two versions of the page.

Link to this comparison view

ravenftp_api [2012/02/14 16:40] (current)
Line 1: Line 1:
 +{{:logo_trasp.png|}}
 +
 +==== Language ====
 +
 +[[ravenftp api|{{italy.png|Italiano}}]] [[ravenftp api en|{{united_kingdom_great_britain_.png|English}}]] [[ravenftp api fr|{{france.png|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 =====
 +
 +<note>Il file messaggi deve essere un file in formato CSV formato da 7 colonne</note>
 +
 +Le colonne devono essere sempre nello stesso ordine, da sinistra vestro destra le colonne sono le seguenti :
 +
 +  - Numero di telefono destinatario del messaggio
 +Il numero di telefono deve essere espresso nel formato internazionale.
 +<note>Esempio di numero telefonico : +44123456789</note>
 +
 +  - Mittente del messaggio
 +Il mittente del messaggio puo essere alfanumerico e non deve contenere più di 11 caratteri. 
 +
 +  - 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**.
 +
 +  - Qualità del messaggio
 +La qualità del messaggio è espressa con un carattere **p** oppure **s** Premium o Standard.
 +
 +  - Tipologia messaggio
 +Le tipologie attualmente supportate sono :
 +
 +  * text
 +  * long
 +  * binary
 +  * ucs
 +  * wappush
 +  * long
 +  * lucs
 +
 +  - UDH (User Data Header)
 +Questo campo dovrà essere valorizzato in presenza di messaggi ad 8 bit quindi di tipologia binary. 
 +
 +  - 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 [[start_it|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"** 
 +
 +<note important>Se il file messaggi si chiama invio.csv il file spedizione dovrà chiamarsi invio.csv.send</note>
 +
 +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