Differences

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

Link to this comparison view

ravenftp_api_fr [2012/02/14 16:40] (current)
Line 1: Line 1:
 +{{:logo_trasp.png|}}
 +
 +
 +
 +==== Langue ====
 +
 +
 +
 +[[ravenftp api|{{italy.png|Italiano}}]] [[ravenftp api en|{{united_kingdom_great_britain_.png|English}}]] [[ravenftp api fr|{{france.png|Français}}]] 
 +
 +
 +
 +====== RavenFTP API ======
 +
 +
 +
 +===== Description =====
 +
 +
 +
 +Grâce au système d'envoi basé sur le protocole FTP, on peut envoyer de grandes quantités de SMS en quelques secondes. Le système accepte en entrée des fichiers au format CSV. 
 +
 +
 +
 +L'adresse du serveur FTP d'AirTelco est : **ftp.airtelco.com** 
 +
 +
 +
 +==== Structure du répertoire d'accueil ====
 +
 +
 +
 +Le répertoire d'accueil contient deux sous répertoires
 +
 +
 +
 +  * sms
 +
 +répertoire qui contiendra les fichiers messages avec la description des SMS qui seront traités par la passerelle d'airtelco.
 +
 +
 +
 +  * statut
 +
 +répertoire qui contiendra le fichier avec l'état final d'envoi.
 +
 +
 +
 +===== Structure du fichier messages =====
 +
 +
 +
 +<note>Le fichier messages doit être un fichier au format .CSV composé de 7 colonnes</note>
 +
 +
 +
 +Les colonnes doivent être toujours dans le même ordre, de gauche à droite, les colonnes sont les suivantes : 
 +
 +
 +
 +  - Numéro de téléphone destinataire du message
 +
 +Le numéro de téléphone doit être exprimé au format international.
 +
 +<note>Exemple de numéro téléphonique : +44123456789</note>
 +
 +
 +
 +  - Expéditeur du message
 +
 +L'expéditeur du message peut être alphanumérique et ne doit pas contenir plus de 11 caractères. 
 +
 +
 +
 +  - Corps du message
 +
 +Le corps du message varie en fonction du type de SMS que l'on souhaite envoyer. Pour les messages de type **texte**, on peut envoyer des textes contenant des caractères appartenant à l'alphabet GSM.
 +
 +Pour envoyer des messages contenant des caractères qui NE font PAS partie de l'alphabet GSM, il faut utiliser le type ucs (Unicode) et dans ce cas le texte du message doit contenir la valeur hexadécimale des caractères que l'on veut envoyer vers le téléphone portable. Dans ce cas, le texte ne pourra pas faire plus de 72 caractères.
 +
 +Pour envoyer des messages qui rentrent dans l'alphabet GSM, mais avec un texte de plus de 160 caractères, il faut positionner comme type de message **long**. En revanche, si le texte était UCS, mais avec une longueur de plus de 72 caractères, le type de message devra être **lucs**.
 +
 +
 +
 +  - Qualité du message
 +
 +La qualité du message est exprimée avec un caractère **p** ou **s** Premium ou Standard.
 +
 +
 +
 +  - Type de message
 +
 +Les types actuellement gérés sont :
 +
 +
 +
 +  * texte
 +
 +  * long
 +
 +  * binaire
 +
 +  * ucs
 +
 +  * wappush
 +
 +  * long
 +
 +  * lucs
 +
 +
 +
 +  - UDH (en-tête utilisateur)
 +
 +Ce champ devra être renseigné en présence de messages à 8 octets, puis de type binaire. 
 +
 +
 +
 +  - URL (pour messages WAP-PUSH)
 +
 +Ce champ devra être renseigné en présence de messages wap push.
 +
 +
 +
 +Pour en savoir plus, nous vous conseillons de charger l'exemple présent dans la [[start_it|pagina principale]] de la documentation. 
 +
 +
 +
 +===== Envoi de SMS =====
 +
 +
 +
 +Après avoir créé le fichier de messages, vous devez l'enregistrer dans le répertoire sms. Par la suite, pour activer l'envoi des SMS, il faut effectuer en séquence le chargement d'un fichier vide ayant le même nom que le fichier des messages, mais ayant l'extension **".envoi"** 
 +
 +
 +
 +<note important>Si le fichier de messages s'appelle envoi.csv, le fichier d'envoi devra s'appeler .csv.send</note>
 +
 +
 +
 +Le système d'envoi FTP peut traiter en moyenne environ 200/sms par seconde. En fin de traitement, il génèrera un fichier d'état qui sera stocké dans le répertoire **statut**. 
 +
 +
 +
 +==== Structure du fichier d'état ====
 +
 +
 +
 +Le fichier d'état généré aura une structure ressemblant à ceci : 
 +
 +
 +
 +**1:SENT:553\\
 +
 +2:SENT:554\\
 +
 +3:SENT:555\\
 +
 +4:SENT:556\\
 +
 +5:SENT:557\\
 +
 +6:SENT:558\\
 +
 +END:ID:318**
 +
 +
 +
 +où le numéro à droite indique la ligne du fichier CSV traité, la chaîne suivante indiquant l'état du message et la valeur numérique à droite correspond à l'identifiant du message. Au bas du fichier, on trouvera la chaîne **END:ID:NNN** où la valeur numérique indique l'identifiant de la totalité de l'envoi.
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
  
ravenftp_api_fr.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