Sorry, you need to enable JavaScript to visit this website.

Image CAPTCHA
Saisir les caractères affichés dans l'image.

Comment envoyer un SMS long dans une campagne SMS ?

Comment envoyer un SMS long dans une campagne SMS ?
2011-05-092013-02-11APIfr
160 caractères ne vous suffisent pas pour communiquer avec vos clients ? Vous souhaitez partager plus d’informations ? Avec le SMS long des API d’Orange, c’est aujourd’hui possible d’envoyer des textos de plus de 160 caractères (voir article sur le...
Publié le 9 Mai 2011 par Soraya Benali dans API

160 caractères ne vous suffisent pas pour communiquer avec vos clients ?
Vous souhaitez partager plus d’informations ?
Avec le SMS long des API d’Orange, c’est aujourd’hui possible d’envoyer des textos de plus de 160 caractères (voir article sur le produit SMS long).

 

sms-long-2.jpg

Voici un tutoriel pour envoyer un SMS long.
http://api.orange.com/fr/api/sms-api/documentation

Pour rappel, l'API SMS est un service web d'envoi et de réception de SMS.
Pour envoyer un SMS avec l’API SMS, il suffit de lancer une simple requête HTTP dans votre navigateur web en utilisant la méthode sendSMS. Celle-ci vous permet d'envoyer un SMS dans le monde entier.


La requête de l’API avec la méthode sendSMS :

http://run.orangeapi.com/sms/sendSMS.xml?id=[votre API Access Key]&from=[numéro court d'émission]&to=[numéro de téléphone]&content=[votre message à envoyer]

Les requêtes utilisent indifféremment les méthodes GET ou POST en mode HTTP ou HTPPS. Le service web expose une interface dans un style REST-RPC.
à partir d'une simple requête HTTP.

Pour envoyer un SMS long, il suffit d’insérer le paramètre « long_text »à votre requête.
Par exemple :

http://run.orangeapi.com/sms/sendSMS.xml?id=[votre API Access Key]&from=[numéro court d'émission]&to=[numéro de téléphone]&content=[votre message à envoyer]&long_text=[activer ou non le SMS long]
Pour activer ou non la fonctionnalité "SMS long", il faut compléter le champ par « false » ou par « true ».

Valeurs :
- "false" : seuls les messages de moins de 160 caractères peuvent être envoyés.
- "true" : le message sera découpé en plusieurs SMS de 134 caractères chacun qui seront ensuite concaténés (regroupés) sur le téléphone mobile de destination.

Veuillez noter qu'un SMS long est limité à 34170 caractères, soit 255 SMS à concaténer.

De plus, pour contrôler le nombre de SMS envoyés, vous avez la possibilité d’insérer le paramètre « max_sms » dans votre requête.

Par exemple :
http://run.orangeapi.com/sms/sendSMS.xml?id=[votre API Access Key]&from=[numéro court d'émission]&to=[numéro de téléphone]&content=[votre message à envoyer]&long_text=[activer ou non le SMS long]&max_sms=[nombre maximum de "parties" d'un SMS long]

Il permet de définir le nombre maximum de "parties" (SMS à concaténer) qui constitue votre "SMS long". Pour cela, il faut compléter le champ par le nombre de parties à concaténer.

Valeurs : entier strictement supérieur à 1.

Enfin, vous pouvez toujours suivre la réception de votre texto avec le paramètre «ack».
En insérant ce paramètre, vous pouvez ou non activer l’accusé de réception.

Par exemple :
http://run.orangeapi.com/sms/sendSMS.xml?id=[votre API Access Key]&from=[numéro court d'émission]&to=[numéro de téléphone]&content=[votre message à envoyer]&long_text=[activer ou non le SMS long]&max_sms=[nombre maximum de "parties" d'un SMS long]&ack=[activer ou non l'accusé de réception]

Avec les valeurs :
true (activé) ou false (désactivé)
Valeur par default : false (ceci est champ optionnel)

Une fois le SMS envoyé avec ce paramètre à “true“, utilisez l’API get history pour récupérer les informations suivantes : - Le code de statut du SMS <ack_status_code> et le message associé <ack_status_msg> :

200 - Message delivered to handset
201 - Waiting for notification
400 - Error delivering the message
500 - Internal error

Pour plus d’infos, dirigez-vous sur cette page : http://api.orange.com/fr/api/get-history-api

C’est à vous de tester !

Astuce, pour essayer ce nouveau paramètre, utilisez l’Explorer Tool !

Soraya, community manager Orange API
 

Ajouter un commentaire

comments

  • Les adresses de pages web et de courriels sont transformées en liens automatiquement.
  • Les lignes et les paragraphes vont à la ligne automatiquement.
  • Tags HTML autorisés : <a> <em> <strong> <cite> <blockquote> <code> <ul> <ol> <li> <dl> <dt> <dd> <br>

Plain text

  • Aucune balise HTML autorisée.
  • Les adresses de pages web et de courriels sont transformées en liens automatiquement.
  • Les lignes et les paragraphes vont à la ligne automatiquement.

Email HTML

  • Les lignes et les paragraphes vont à la ligne automatiquement.
  • Les adresses de pages web et de courriels sont transformées en liens automatiquement.
Image CAPTCHA
Saisir les caractères affichés dans l'image.
Changer d'affichage