Apprendre à envoyer des SMS avec l’API SMS d’Orange

Version imprimable

11/10/2016, 22h47
Francis Walter

Apprendre à envoyer des SMS avec l’API SMS d’Orange

Bonjour,

Je vous présente un article sur l'envoie de SMS avec l'API SMS de Orange.

Citation:

Envoyé par Introduction

L’API SMS d’Orange disponible dans certains pays en zone d’Afrique et Moyen-Orient permet l'envoi et la réception de SMS vers les mobiles du monde entier, quel que soit l'opérateur. Il vous permet de toucher plus rapidement votre cible comparé à l’email.
L’API peut être utile pour envoyer un accusé de réception d’une livraison, diffuser des informations à une liste de clients, souhaiter la bonne année à une liste de numéros, créer un groupe de discussion par SMS, organiser un sondage.
Cet article vous expliquera en quelques étapes comment faire votre premier appel à l'API SMS en Node*js qui va récupérer le résultat de la requête au format JSON (JavaScript Object Notation) pour l’afficher dans votre application.

:fleche: Retrouvez les autres cours et tutoriels pour apprendre à programmer avec les APIs d'Orange
:fleche: Retrouvez tous les meilleurs cours et tutoriels Solution d'entreprise.
12/10/2016, 10h33
Népomucène

Cela fonctionne sur l'Europe ?
12/10/2016, 12h18
devalender

Bonjour a tous

S'il vous plait ne pourrait ton pas avoir de tuto aussi bien faite en php ?

Merci à tous
13/10/2016, 13h47
Oscar.STEFANINI

Du coup on peut envoyer des sms avec n'importe quel numéro de téléphone ?? vers n'importe lequel ?
14/10/2016, 07h11
steel-finger

Petit précision la fonction suivante : `new Buffer()` est déprécié il faut utilisé `Buffer.from()`
24/10/2016, 14h14
Orange_Partner

Citation:

Envoyé par Oscar.STEFANINI

Du coup on peut envoyer des sms avec n'importe quel numéro de téléphone ?? vers n'importe lequel ?

@Oscar, il ne s'agit pas d'envoi de SMS à Partir d'un d'un téléphone. Nous parlons des SMS que vous pouvez envoyer à vos clients à partir de votre application.
L'offre que nous vous proposons vois permets cependant d'envoyer des SMS à vos client quelque soit leur opérateur.
24/10/2016, 14h20
Orange_Partner

Citation:

Envoyé par devalender

Bonjour a tous

S'il vous plait ne pourrait ton pas avoir de tuto aussi bien faite en php ?

Merci à tous

@Devalender, merci de regarder ce tuto mise en ligne par des Developer ivoiriens https://www.youtube.com/watch?v=32cce0YAq5Q
24/10/2016, 16h41
Oscar.STEFANINI

Citation:

Envoyé par Orange_Partner

@Oscar, il ne s'agit pas d'envoi de SMS à Partir d'un d'un téléphone. Nous parlons des SMS que vous pouvez envoyer à vos clients à partir de votre application.
L'offre que nous vous proposons vois permets cependant d'envoyer des SMS à vos client quelque soit leur opérateur.

Merci beaucoup de votre réponse. après relecture de mon message, je me rends compte à quel point j'avais lu la news de travers. Bien à vous et merci de nous faire disposer d'api et d'en parler sur developpez.com

Code en WDlangage de Windev.

Bonjour, pour exemple le code pour utiliser cette API Orange en WDlangage de Windev (testé en V20)

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
// API Orange : Récupération du nombre d'unité disponible 
i,j est un entier
ExpirationTime est un entier sans signe
UrlToken, ClientID, ClientSecret, AuthorizationHeader, EntêteHTTPsupplémentaire, Body, ResEntêteApi, ResApi, Tag sont des chaînes
Token, UrlSendSMS est une chaîne
 
stResApiJson est une Structure
	country est une chaîne
	service est une chaîne
	contractId est une chaîne
	availableUnits est un entier
	expires est une chaîne
	scDescription est une chaîne
END
 
MyBuffer est un Buffer
MyResApiJson est une stResApiJson
 
 
//----- Demande un jeton
UrlToken = "https://api.orange.com/oauth/v2/token"
 
ClientID = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
ClientSecret = "xxxxxxxxxxxxxxxxx"
AuthorizationHeader = "Basic " + Crypte(ClientID + ":" + ClientSecret, "", crypteAucun, encodeBASE64)
 
EntêteHTTPsupplémentaire = "Authorization: " + AuthorizationHeader
 
Body = [
	grant_type=client_credentials
]
Token = ""
 
IF HTTPRequête(UrlToken, "", EntêteHTTPsupplémentaire, Body) THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 200 OK" THEN
		ResApi = HTTPDonneRésultat(httpRésultat)
		Token = ExtraitChaîne(ExtraitChaîne(ResApi, 4,Caract(10)), 4, Caract(34))
		ExpirationTime = Val(ExtraitChaîne(Remplace(ExtraitChaîne(ResApi,5, Caract(0x0a)),TAB,""),4,Caract(34)))
	END
ELSE
	Info( ErreurInfo(errMessage))
	STOP
END
 
//----- Envoie la demande
 
UrlSendSMS = "https://api.orange.com/sms/admin/v1/contracts"
EntêteHTTPsupplémentaire = "Authorization: Bearer " + Token
 
IF HTTPRequête(UrlSendSMS, "", EntêteHTTPsupplémentaire, "") THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	ResApi = HTTPDonneRésultat(httpRésultat)
	IF ExtraitChaîne(ResEntêteApi, 1, RC) = "HTTP/1.1 200 OK" THEN
		Tag = [
		"country":"SEN"
		]
		i = Position(ResApi, Tag)
		IF i > 0 THEN
			j = Position(ResApi, "}", i)
			IF j > 0 THEN
				MyBuffer = ResApi[[i-1 A j]]
				MyResApiJson:country = ""
				MyResApiJson:service = ""
				MyResApiJson:contractId = ""
				MyResApiJson:availableUnits = -1
				MyResApiJson:expires = ""
				MyResApiJson:scDescription = ""
				Désérialise(MyResApiJson, MyBuffer,psdJSON)
				Info(ChaîneConstruit("il reste %1 unité(s)",MyResApiJson:availableUnits))
			ELSE
				Erreur("La structure de la réponse est incorrecte !")
			END
		ELSE
			Erreur(ChaîneConstruit("Tag : %1 not found !", Tag))
		END
	ELSE
		Erreur(ResEntêteApi)
	END
ELSE 
	Trace(ErreurInfo(errMessage))
END

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
// API Orange : Envoyer un sms 
ExpirationTime est un entier sans signe
UrlToken, ClientID, ClientSecret, AuthorizationHeader, EntêteHTTPsupplémentaire, Body, ResEntêteApi, ResApi sont des chaînes
Token, SenderAddress, SenderName, ReceiverAdress, UrlSendSMS, TypeDuMessage, MessageSMS est une chaîne
 
//----- Demande un jeton
UrlToken = "https://api.orange.com/oauth/v2/token"
 
ClientID = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
ClientSecret = "xxxxxxxxxxxxxxxxx"
AuthorizationHeader = "Basic " + Crypte(ClientID + ":" + ClientSecret, "", crypteAucun, encodeBASE64)
 
EntêteHTTPsupplémentaire = "Authorization: " + AuthorizationHeader
 
Body = [
grant_type=client_credentials
]
Token = ""
 
IF HTTPRequête(UrlToken, "", EntêteHTTPsupplémentaire, Body) THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 200 OK" THEN
		ResApi = HTTPDonneRésultat(httpRésultat)
		Token = ExtraitChaîne(ExtraitChaîne(ResApi, 4,Caract(10)), 4, Caract(34))
		ExpirationTime = Val(ExtraitChaîne(Remplace(ExtraitChaîne(ResApi,5, Caract(0x0a)),TAB,""),4,Caract(34)))
	ELSE
 
	END
ELSE
	Info( ErreurInfo(errMessage))
	STOP
END
 
//----- Envoie un sms
SenderAddress = "33123456789"									// sans le + mais avec l'indicatif 33=France 221=Sénégal
SenderName = "Philippe"
ReceiverAdress = "+221013456789"
MessageSMS = "Il est " + HeureVersChaîne(HeureSys(),"hh:mm:ss")
 
UrlSendSMS = "https://api.orange.com/smsmessaging/v1/outbound/tel%3A%2B" + SenderAddress + "/requests"
EntêteHTTPsupplémentaire = "Authorization: Bearer " + Token	// attention aux espaces 1 seul après ":" et après "Bearer"
Body = [
{
	"outboundSMSMessageRequest":{
		"address":"tel:%3",
		"outboundSMSTextMessage":{
			"message":"%4"
		},
		"senderAddress":"tel:+%1",
		"senderName":"%2"
	}
}
]
Body = ChaîneConstruit(Body, SenderAddress, SenderName, ReceiverAdress, MessageSMS)
 
TypeDuMessage = "application/json"
 IF HTTPRequête(UrlSendSMS, "", EntêteHTTPsupplémentaire, Body, TypeDuMessage) THEN
 	ResEntêteApi = HTTPDonneRésultat(httpEntête)
 	ResApi = HTTPDonneRésultat(httpRésultat)
 	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 201 Created" THEN
 		Info("SMS envoyé.....")
 	ELSE
 		Erreur(ResEntêteApi)
 	END
 ELSE
 	Trace(ErreurInfo(errMessage))
 END

16/11/2016, 13h52
fabi75

En France ?

Cela marche en France? je ne trouve pas l'API française sur le lien vers orange :(
16/11/2016, 14h00
PhilDeDakar

1 pièce(s) jointe(s)

Citation:

Envoyé par fabi75

Cela marche en France? je ne trouve pas l'API française sur le lien vers orange :(

Désolé je ne sais pas si cela fonctionne en Europe, mais j'ai bien l’impression que cela n'existe pas...
Pièce jointe 224989
16/11/2016, 15h11
Pierre Louis Chevalier

Citation:

Envoyé par fabi75

Cela marche en France? je ne trouve pas l'API française sur le lien vers orange :(

Non : L’API SMS d’Orange disponible dans certains pays en zone d’Afrique et Moyen-Orient
18/11/2016, 17h37
wamania

Je suis presque sûr d'avoir récemment entendu un de mes clients me dire qu'ils envoyaient leurs SMS par Orange, et je serais bien étonné que ça n'existe pas en France.
Par contre ce qui ne fait aucun doute, c'est que la version française doit naturellement être 20 à 30 plus compliquée que les autres.
"API SMS Orange France" qui aurait évidemment été bien trop simple et efficace.... :mouarf:
18/11/2016, 17h47
PhilDeDakar

Citation:

Envoyé par wamania

Je suis presque sûr d'avoir récemment entendu un de mes clients me dire qu'ils envoyaient leurs SMS par Orange, et je serais bien étonné que ça n'existe pas en France.
Par contre ce qui ne fait aucun doute, c'est que la version française doit naturellement être 20 à 30 plus compliquée que les autres.
"API SMS Orange France" qui aurait évidemment été bien trop simple et efficace.... :mouarf:

Bonjour
Au Sénégal, (par exemple) pour s'inscrire et obtenir les codes, il faut fournir des pièces d'identité et les statuts de la société puis on paye avec une CB en Franc CFCA. Donc pour pouvoir le faire d'Europe il suffit de passer par une société Sénégalaise, il y n'y a pas de contrôle sur l'adresse IP de l'expéditeur des requêtes HTTP par rapport au pays...
11/01/2017, 16h38
windowsneuf

[Orange] API SMS pour envoyer des SMS depuis Internet à plusieurs destinataires

0U
11/01/2017, 18h42
PhilDeDakar

API ORANGE - SMS

Bonjour,
Je suis quasiment sur que cela n'est pas possible directement, il faut passer par une procédure qui va envoyer les sms un par un.
09/02/2017, 17h29
Community Management

Bonjour à tous,

:fleche: Un sondage pour partager votre retour d'expérience sur l'API SMS d'Orange

:merci:
11/11/2019, 18h04
Abdel Khader

1 pièce(s) jointe(s)

Bonjour
je suis beaucoup intéressé par ce code en wlangage,
j'utilise W20 en Cote d'ivoire mais lorsque j’exécute la procédure, voici le message qui s'affiche.

merci de bien vouloir m'aider

Pièce jointe 516582

Actualisation du code en wlanguage

Bonjour Suite au précèdent code d'envoi de sms j'apporte ma modeste contribution a l'évolution du code
il s'agit de modifier le body comme suit :
Code:

1 2 3 4 5 6 7 8 9 10 11 12 Body = [ { "outboundSMSMessageRequest":{ "address":"tel:%2", "senderAddress":"tel:+%1", "outboundSMSTextMessage":{ "message":"%3" } } } ] Body = ChaîneConstruit(Body, SenderAddress, ReceiverAdress, MessageSMS)

Citation:

Envoyé par PhilDeDakar

Bonjour, pour exemple le code pour utiliser cette API Orange en WDlangage de Windev (testé en V20)

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
// API Orange : Récupération du nombre d'unité disponible 
i,j est un entier
ExpirationTime est un entier sans signe
UrlToken, ClientID, ClientSecret, AuthorizationHeader, EntêteHTTPsupplémentaire, Body, ResEntêteApi, ResApi, Tag sont des chaînes
Token, UrlSendSMS est une chaîne
 
stResApiJson est une Structure
	country est une chaîne
	service est une chaîne
	contractId est une chaîne
	availableUnits est un entier
	expires est une chaîne
	scDescription est une chaîne
END
 
MyBuffer est un Buffer
MyResApiJson est une stResApiJson
 
 
//----- Demande un jeton
UrlToken = "https://api.orange.com/oauth/v2/token"
 
ClientID = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
ClientSecret = "xxxxxxxxxxxxxxxxx"
AuthorizationHeader = "Basic " + Crypte(ClientID + ":" + ClientSecret, "", crypteAucun, encodeBASE64)
 
EntêteHTTPsupplémentaire = "Authorization: " + AuthorizationHeader
 
Body = [
	grant_type=client_credentials
]
Token = ""
 
IF HTTPRequête(UrlToken, "", EntêteHTTPsupplémentaire, Body) THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 200 OK" THEN
		ResApi = HTTPDonneRésultat(httpRésultat)
		Token = ExtraitChaîne(ExtraitChaîne(ResApi, 4,Caract(10)), 4, Caract(34))
		ExpirationTime = Val(ExtraitChaîne(Remplace(ExtraitChaîne(ResApi,5, Caract(0x0a)),TAB,""),4,Caract(34)))
	END
ELSE
	Info( ErreurInfo(errMessage))
	STOP
END
 
//----- Envoie la demande
 
UrlSendSMS = "https://api.orange.com/sms/admin/v1/contracts"
EntêteHTTPsupplémentaire = "Authorization: Bearer " + Token
 
IF HTTPRequête(UrlSendSMS, "", EntêteHTTPsupplémentaire, "") THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	ResApi = HTTPDonneRésultat(httpRésultat)
	IF ExtraitChaîne(ResEntêteApi, 1, RC) = "HTTP/1.1 200 OK" THEN
		Tag = [
		"country":"SEN"
		]
		i = Position(ResApi, Tag)
		IF i > 0 THEN
			j = Position(ResApi, "}", i)
			IF j > 0 THEN
				MyBuffer = ResApi[[i-1 A j]]
				MyResApiJson:country = ""
				MyResApiJson:service = ""
				MyResApiJson:contractId = ""
				MyResApiJson:availableUnits = -1
				MyResApiJson:expires = ""
				MyResApiJson:scDescription = ""
				Désérialise(MyResApiJson, MyBuffer,psdJSON)
				Info(ChaîneConstruit("il reste %1 unité(s)",MyResApiJson:availableUnits))
			ELSE
				Erreur("La structure de la réponse est incorrecte !")
			END
		ELSE
			Erreur(ChaîneConstruit("Tag : %1 not found !", Tag))
		END
	ELSE
		Erreur(ResEntêteApi)
	END
ELSE 
	Trace(ErreurInfo(errMessage))
END

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
// API Orange : Envoyer un sms 
ExpirationTime est un entier sans signe
UrlToken, ClientID, ClientSecret, AuthorizationHeader, EntêteHTTPsupplémentaire, Body, ResEntêteApi, ResApi sont des chaînes
Token, SenderAddress, SenderName, ReceiverAdress, UrlSendSMS, TypeDuMessage, MessageSMS est une chaîne
 
//----- Demande un jeton
UrlToken = "https://api.orange.com/oauth/v2/token"
 
ClientID = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
ClientSecret = "xxxxxxxxxxxxxxxxx"
AuthorizationHeader = "Basic " + Crypte(ClientID + ":" + ClientSecret, "", crypteAucun, encodeBASE64)
 
EntêteHTTPsupplémentaire = "Authorization: " + AuthorizationHeader
 
Body = [
grant_type=client_credentials
]
Token = ""
 
IF HTTPRequête(UrlToken, "", EntêteHTTPsupplémentaire, Body) THEN
	ResEntêteApi = HTTPDonneRésultat(httpEntête)
	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 200 OK" THEN
		ResApi = HTTPDonneRésultat(httpRésultat)
		Token = ExtraitChaîne(ExtraitChaîne(ResApi, 4,Caract(10)), 4, Caract(34))
		ExpirationTime = Val(ExtraitChaîne(Remplace(ExtraitChaîne(ResApi,5, Caract(0x0a)),TAB,""),4,Caract(34)))
	ELSE
 
	END
ELSE
	Info( ErreurInfo(errMessage))
	STOP
END
 
//----- Envoie un sms
SenderAddress = "33123456789"									// sans le + mais avec l'indicatif 33=France 221=Sénégal
SenderName = "Philippe"
ReceiverAdress = "+221013456789"
MessageSMS = "Il est " + HeureVersChaîne(HeureSys(),"hh:mm:ss")
 
UrlSendSMS = "https://api.orange.com/smsmessaging/v1/outbound/tel%3A%2B" + SenderAddress + "/requests"
EntêteHTTPsupplémentaire = "Authorization: Bearer " + Token	// attention aux espaces 1 seul après ":" et après "Bearer"
Body = [
{
	"outboundSMSMessageRequest":{
		"address":"tel:%3",
		"outboundSMSTextMessage":{
			"message":"%4"
		},
		"senderAddress":"tel:+%1",
		"senderName":"%2"
	}
}
]
Body = ChaîneConstruit(Body, SenderAddress, SenderName, ReceiverAdress, MessageSMS)
 
TypeDuMessage = "application/json"
 IF HTTPRequête(UrlSendSMS, "", EntêteHTTPsupplémentaire, Body, TypeDuMessage) THEN
 	ResEntêteApi = HTTPDonneRésultat(httpEntête)
 	ResApi = HTTPDonneRésultat(httpRésultat)
 	IF ExtraitChaîne(ResEntêteApi,1,RC) = "HTTP/1.1 201 Created" THEN
 		Info("SMS envoyé.....")
 	ELSE
 		Erreur(ResEntêteApi)
 	END
 ELSE
 	Trace(ErreurInfo(errMessage))
 END

Bonjour
Comment faire quand (ExtraitChaîne(ResEntêteApi,1,RC)) donne comme valeur HTTP/1.1 40 au lieu de HTTP/1.1 200 ?