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).
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
Consultante social media - CM pour @Orange, j'ai animé le blog relation client durant 2 ans. Avant de rejoindre les blogs d'Orange Business, j'étais community manager Orange API.
Dans la vie ? Génération web... Je mange un #donut; j'aime les donuts, c'est ici que j'ai mangé des donuts... Cela vous dit quelque chose ? Un peu vieux jeu, mais ça fonctionne toujours ! Cherchez "les médias sociaux expliqué avec un donut" ;)