Langue

Italiano English 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

Le fichier messages doit être un fichier au format .CSV composé de 7 colonnes

Les colonnes doivent être toujours dans le même ordre, de gauche à droite, les colonnes sont les suivantes :

  1. Numéro de téléphone destinataire du message

Le numéro de téléphone doit être exprimé au format international.

Exemple de numéro téléphonique : +44123456789

  1. Expéditeur du message

L'expéditeur du message peut être alphanumérique et ne doit pas contenir plus de 11 caractères.

  1. 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.

  1. Qualité du message

La qualité du message est exprimée avec un caractère p ou s Premium ou Standard.

  1. Type de message

Les types actuellement gérés sont :

  • texte
  • long
  • binaire
  • ucs
  • wappush
  • long
  • lucs
  1. UDH (en-tête utilisateur)

Ce champ devra être renseigné en présence de messages à 8 octets, puis de type binaire.

  1. 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 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”

Si le fichier de messages s'appelle envoi.csv, le fichier d'envoi devra s'appeler .csv.send

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