SMS API

envoyez et recevez des SMS partout dans le monde

SMS API"

imprimer cette page

retour à l'espace développeurs

description de l'API

SMS API
en bref
envoyez et recevez des SMS via votre site Web ou votre application informatique.
difficulté
1/5
temps d'apprentissage
10 minutes
type de requête
HTTP (REST – RPC)
gamme
mobile
prix et rémunération
prix par SMS sortant
rémunération possible par SMS entrant


  

 

Utilisez cette API pour créer votre propre service d'envoi et de réception de SMS sur Internet. Vous pouvez ainsi :

  • envoyer des SMS dans le monde entier (avec notification de bonne réception) ;
  • créer un service de réception de SMS sur votre application Web, celle-ci peut en plus vous permettre de gagner de l'argent ;
  • utiliser cette API pour facturer vos clients grâce aux numéros de réception surfacturés que nous proposons (micro-paiement de sonneries pour mobiles par exemple) ;
  • et bien d'autres applications encore !

Remarques sur l'utilisation de l'API SMS :

  • ce service d’envoi et de réception de SMS n’est pas réservé aux mobiles de clients Orange, elle permet d’émettre et de recevoir des SMS vers de très nombreuses destinations dans le monde ;
  • l’accusé de réception vous permet de savoir si le SMS a été livré au téléphone mobile ;
  • les SMS longs sont pris en charge (SMS de plus de 160 caractères) ;
  • deux types d’encodage sont disponibles: GSM 7-bit et UCS-2, ce qui permet d’écrire des SMS dans tous les alphabets ;
  • le principe de « session » entre votre application et un mobile est disponible. Ces sessions permettent d’éviter d’utiliser des mots-clés pour envoyer un SMS MO vers votre application pendant une période de 24h00 si votre application a émis un premier SMS MT vers le meme mobile ou si l’utilisateur a émis un premier SMS MO ;
  • il est possible de personnaliser l’émetteur du SMS (champ from) qui s’affiche sur le téléphone mobile de réception.
L’utilisation de l’API SMS d’Orange API impose de respecter les règles de déontologie suivantes :
  • obtenir le consentement (opt-in) des possesseurs des MSISDN qui recevront les SMS ;
  • interdiction d’emettre des SMS qui peuvent altérer le bon fonctionnement du téléphone portable ;
  • interdiction d’émettre des messages à caractère violent ou pornographique ou des messages susceptibles de porter atteinte au respect de la personne humaine et de sa dignité ;
  • concernant les numéros 31244, 51244 et 71244, vous trouverez ici l’ensemble des règles de déontologie à respecter.


1 . testez !

Saisissez votre numéro de mobile et cliquez sur 'envoyer'.
Un SMS "Hello world" vous sera envoyé.
Ceci est un exemple parmi toutes les applications que vous pouvez créer grâce à notre API SMS !

*Cette démo est limitée aux téléphones mobiles des pays suivant: FRANCE, UK



2 . quelle application ?

  • organisez un sondage via un SMS ;
  • réalisez une campagne de promotion auprès de vos clients via un SMS (voir le tutoriel) ;
  • envoyez les accusés de réception de la livraison de colis ;
  • diffusez des résultats d'examens à vos élèves ;
  • réalisez une application de réception de SMS surfacturés.

Toutes les combinaisons de nos API sont possibles : inspirez-vous de mash-up

documentation de l'API

L'API SMS est un service web d'envoi et de réception de SMS.
Sachez toutefois que votre identifiant (API Access Key) devra toujours être passé en paramètre dans l’URL de votre requête.

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.

1 . méthode

a.sendSMS

La méthode sendSMS vous permet d'envoyer un SMS dans le monde entier à partir d'une simple requête HTTP.

Tutoriel utilisant la méthode sendSMS :

sendSMS
requête

http://run.orangeapi.com/sms/sendSMS.xml?id=[votre API Access Key]&from=[numéro court d'émission ou nom d’émetteur personnalisé]&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]&content_encoding=[type d’encodage à utiliser]&session=[activer ou non la session]&session_duration=[définir le durée de la session]&tag=[votre propre tag]

Détails des paramètres disponibles ici >

Paramètre de la requêteDescription
id
type : string
champ : obligatoire

API Access Key est votre identifiant personnel lors de l'usage d'une API. L'API Access Key est disponible dans la rubrique mon espace personnel
from
type : string
champ : obligatoire

Ce paramètre permet de spécifier l’émetteur du SMS, il peut s’agir de :

Un numéro court d’émission dépendant de la destination du SMS.

numéro court

couverture

fonctionnalités
20345 Orange France émission et réception de SMS
38100 Orange France, SFR, Bouygues telecom et Free mobile émission de SMS
38699* Orange France, SFR et Bouygues telecom émission et réception de SMS
31244** Orange France, SFR et Bouygues telecom réception et émission de SMS
967482 Orange UK émission et réception de SMS
447797805210 International (destinations) émission et réception de SMS
world International (destinations) émission de SMS

Veuillez noter :
le numéro d’émission qui apparait sur le téléphone mobile du récepteur est un numéro court local (différent pour chaque pays)

  • * tout dialogue avec un téléphone portable utilisant ce numéro doit commencer par l’émission d’un SMS MT (sendsms) avant de recevoir un SMS MO (receivesms) ;

    * il est interdit de faire de la promotion concernant ce numéro (par exemple, il est impossible d’indiquer sur un site web ou une affiche ‘”envoyez un SMS au 38699”) ;

  • ** tout dialogue avec un téléphone portable utilisant ce numéro doit commencer par la réception d'un SMS M0 (receivesms) avant d'envoyer un SMS MT (sendsms) ;

    ** lors de la réception de SMS sur ce numéro court, le numéro de téléphone reçu sera aliasé (masqué), vous pouvez tout de même y répondre en utilisant le "31244" en paramètre "from" de votre requête ;

    ** lors de l'envoi d'un SMS MT depuis ce numéro court, la fonctionnalité SMS long ne peut pas être utilisée (celle-ci génèrera une erreur).

---

Un mot dédié dont vous avez au préalable fait la demande auprès de notre équipe commerciale en remplissant ce formulaire.

Dans ce cas, insérez simplement ce mot dédié (URL encodé) en tant que valeur du paramètre "from".

Voici les règles de formatage de ce mot dédié :
- Il ne doit pas dépasser 11 caractères (alphanumériques uniquement).
- Il ne doit pas comporter de caractères spéciaux ni d’espaces (sauf tirets).
- Il ne doit pas être composé uniquement de chiffres (au moins une lettre).

Voici les contraintes qu’entraîne l’utilisation du champ « from » personnalisé :
- le SMS est limité à 146 caractères (et non 160).
- offre non compatible avec les SMS longs et l’encodage en UCS-2.
- les SMS peuvent être émis uniquement vers les operateurs métropolitains Orange, Bouygues, SFR et Free mobile.
to
type : string
champ : obligatoire

Numéro du mobile de destination au format international (ou alias dans le cas d'un envoi depuis le 31244).
ex. : 3312345678 (France) ou 441234567890 (Royaume-Uni)
content
type : string
champ : optionnel

Contenu du SMS, limité à 160 caractères
long_text
type : boolean
champ : optionnel

Permet d'activer ou non la fonctionnalité "SMS long".

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 chacuns qui seront ensuite concaténés (regroupés) sur le téléphone mobile de destination.

Valeur par défaut : "false" 

Notes concernant l’utilisation du SMS long :
- un SMS long est limité à 34170 caractères, soit 255 SMS à concaténer.
- le SMS long ne fonctionne pas vers un numéro aliasé (lors d'un SMS émis depuis le 31244).
max_sms
type : integer
champ : optionnel

Permet de définir le nombre maximum de "parties" (SMS à concaténer) pouvant constituer un "SMS long".

Valeurs : entier strictement supérieur à 1.

Dans le cas où cette limite serait dépassée, le SMS ne sera pas envoyé.
ack
type : boolean
champ : optionnel

Permet d’activer ou non l’accusé de réception.

Valeurs : "true" (activé) ou "false" (désactivé)
Valeur par défaut : "false"

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>
- Le message associé <ack_status_msg> :

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

- La date et l’heure de réception du SMS <ack_date>
content_encoding
type : string
champ : optionnel

Ce paramètre permet de spécifier l’encodage du contenu à utiliser lors de la requête à l’API sendSMS.

Valeurs :
"gsm7" (valeur par défaut du paramètre)
Encodage des caractères au format GSM 7-bit.
Cet encodage (par défaut de la norme GSM) est aussi celui utilisé par défaut par notre API SMS.

"ucs2"
Encodage des caractères au format UCS-2.
Cet encodage permet l’utilisation de nombreux alphabets tels que l’Arabe, le Japonais et bien d’autres alphabets, mais aussi les caractères chinois.

Valeur par défaut : "gsm7"


Notes concernant l’utilisation de l’UCS-2 :
- la valeur du paramètre « content » doit être encodée en UTF-8.
- la valeur du paramètre « content » ne doit pas excéder 60 caractères.
- la fonctionnalité « SMS long » ne fonctionne pas avec cet encodage.
- le paramètre « from » doit être défini à « world » pour le monde entier ou « 38100 » pour la France uniquement.
- l’utilisation de la méthode POST doit être privilégiée au GET (l’encodage de l’URL dépendant du client HTTP).
- Il est nécessaire de spécifier l’encodage UTF-8 dans le header de la requête en POST : Content-Type: text/html; charset=UTF-8
session
type : boolean
champ : optionnel

Ce paramètre permet d'activer ou non la fonctionnalité de sessions SMS suite à l’envoi d’un SMS. Pour l’activation de sessions sur réception d’un SMS, voir section "receiveSMS".

Valeurs : "true" (activé) ou "false" (désactivé).
Lors de l'activation de ce paramètre, une session (dont vous pouvez déterminer la durée) est créée entre votre application et le mobile ciblé.
Cette session permet à l'utilisateur du mobile de ne pas avoir à insérer votre mot-clé dans le contenu de son SMS pour vous répondre.

Valeur par défaut : "false"


Notes concernant l’utilisation des sessions SMS :
- Les sessions ne peuvent être activées par ce paramètre qu’avec un numéro court qui fonctionne en sendSMS puis en receiveSMS (20345, 38699, 447797805210 et 967482).
- Lors d'une session en cours avec un mobile, si une nouvelle requête à l'API (avec "session=true") est exécutée entre votre application et ce même mobile, le compteur temporel repartira à zéro.
- Une session peut-être initialisée soit par une requête au sendSMS (vu dans ce chapitre), soit par l'envoi d'un SMS depuis un mobile (voir section "receiveSMS").
- Un même mobile ne peut être "en session" qu'avec un service Orange API SMS à la fois.
session_duration
type : integer
champ : optionnel

Ce paramètre permet de spécifier la durée de la session créée (en minutes).

Valeurs : chiffre entier compris entre 120 (2 heures) et 1440 (24 heures).
Valeur par défaut : 1440
tag
type : string
champ : optionnel

Permet de définir un mot-clé qui peut vous aider à regrouper vos requêtes API sous un même label lors de l'utilisation de l'API getHistory.

Valeurs : n'importe quel mot (limité à 50 caractères encodés en UTF-8).
Valeur par défaut : pas de tag.

caractères disponibles avec l'encodage en GSM 7-bit (valeur par défaut du paramètre) :

  • ceux compris aussi bien dans la table GSM 7-bit que dans la table ISO 8859-1 seront retranscris à l'identique (voir lien ci-dessous) ;
  • certains seront remplacés par des caractères de substitution (voir lien ci-dessous) ;
  • enfin, tous les autres caractères seront remplacés par le symbole "_".
liste des caractères retranscris sans transformation > 

a
 
b
 
c
 
d
 
e
 
f
 
g
 
h
 
i
 
j
 
k
 
l
 
m
 
n
 
o
 
p
 
q
 
r
 
s
 
t
 
u
 
v
 
w
 
x
 
y
 
z
 
A
 
B
 
C
 
D
 
E
 
F
 
G
 
H
 
I
 
J
 
K
 
L
 
M
 
N
 
O
 
P
 
Q
 
R
 
S
 
T
 
U
 
V
 
W
 
X
 
Y
 
Z
 
£
 
$
 
¥
 
è
 
é
 
ù
 
ì
 
ò
 
Ø
 
ø
 
0
 
1
 
2
 
3
 
4
 
5
 
6
 
7
 
8
 
9
 
Å
 
å
 
^
 
{
 
}
 
\
 
[
 
~
 
]
 
|
 
@
 
æ
 
ß
 
!
 
"
 
#
 
%
 
&
 
'
 
(
 
)
 
*
 
+
 
-
 
.
 
/
 
:
 
;
 
?
 
¡
 
Ñ
 
Æ
 
¿
 
ä
 
ö
 
ñ
 
ü
 
à
 
€
 
<
 
=
 
>
 
_
 
§
 




















 Le caractère € ne fonctionne qu'avec les numéros d'émission "38100" et "world".


liste des caractères remplacés par des caractères de substitution >


 







caractère




substitution




caractère




substitution








`




'




Ë




E








À




A




Ì




I








Â




A




Í




I








Ã




A




Î




I








Ä




A




Ï




I








Ç




C




Ò




O








È




E




Ó




O








É




E




Ô




O








Ê




E




Õ




O








Ö




O




ê




e








Ù




U




ë




e








Ú




U




î




i








Û




U




ï




i








Ü




U




ô




o








Ý




Y




õ




o








â




a




û




u








ã




a




ÿ




y








ç




c


 
 








 

Réponse


A chaque appel d'API, des informations relatives à l'appel vous sont envoyées au format XML




    

  • <?xml version="1.0" encoding="UTF-8" ?>
    • 

  • <response>
    • 

  •  

      

    • <status>
      • 

    •  

        

      • <status_code>200</status_code>
        • 

      • <status_msg><![CDATA[OK]]></status_msg>
        • 

      

      • 

    • </status>
      • 

    • <call_info>
      • 

    •  

        

      • <call_id>3DhG5wUla1nVtWArwKm2</call_id>
        • 

      

      • 

    • </call_info>
      • 

    • <data>
      • 

    

      

    •  

        

      • <nbr_sms_sent>3</nbr_sms_sent>
        • 

      

      • 

    

      

    • </data>
      • 

    

    • 

  • </response>
    • 





Détails des paramètres disponibles ici >





 


Paramètre de la réponseDescription


 





<status_code>










type : integer















code de statut de la réponse
voir tableau ci-dessous
















<status_msg>












type : string

















message de statut de la réponse







 




code



message




 



200
ok
(ok)		




400
id is missing
(API Access Key est manquante)		




401
unauthorised id 
(API Access Key invalide)		




402
insufficient credit
(crédit insuffisant)		




430
content is missing
(contenu manquant)		




431
from parameter is invalid
(le paramètre from est manquant)		




433
wrong phone number format
 (mauvais formatage du numéro)		




440
content too long
(le nombre de caractères autorisés est dépassé)		




441
unauthorised destination
(destination non autorisée)		




442
unauthorised source for this destination
 (paramètre from non valide pour cette destination)		




447
unreacheable destination
(destination non accessible)		




448
Unauthorized source
(paramètre "from" invalide)		




449
Limit max_sms reached
(la limite "max_sms" à été dépassée)		




450
Unauthorized parameters
(combinaison de paramètres interdite dans ce type de requête)		




451
existing session for this number
(numéro déjà utilisé dans une autre session)		




452
bad parameter session duration
(mauvais paramétrage de la durée de la session)		








470
Unauthorized destination : blacklisted MSISDN
(le numéro de destination est bloqué par l'API, non compatible avec le champ "from" personnalisé)		




499
tag is too long
("tag" dépasse les 50 caractères)		




500
internal error
(erreur interne)		




















<call_id>










type : string










Identifiant unique d'appel d'API
















<nbr_sms_sent>










type : integer










Nombre de SMS envoyés suite à la requête à l'API.



















 

b. receiveSMS







La méthode receiveSMS vous permet de recevoir des SMS du monde entier, sur votre application Web et/ou directement par email.


Tutoriels utilisant la méthode receiveSMS :



 



 receiveSMS 




 


configuration du receiveSMS :


Vous devez tout d'abord configurer la réception de SMS dans la rubrique mon espace personnel :


    

  • votre méthode de réception : sur une URL (script), par email, ou les deux ;
    • 

  • vos mots-clés* (jusqu'à 5), qui nous permettent de rediriger les SMS vers votre application ;
    • 

  • l'activation de la création de session pour chacun de vos mots-clés (voir explicatif ci-dessous).
    • 


* Les mots-clés des API SMS et MMS sont partagés. Un mot clé rajouté pour l'API SMS fonctionnera aussi avec l'API MMS et inversement. 
 


Les sessions :

Pour chacun de vos mots-clés, vous pouvez activer ou non la création automatique de session.
 Si cette fonctionnalité est activée sur l'un (ou plusieurs) de vos mots-clés, un SMS reçu depuis ce mot-clé créera automatiquement une session de 24 heures entre votre application de réception de SMS et le mobile envoyeur.               Ceci indique que durant cette période, le mobile envoyeur n'aura plus besoin d'insérer votre mot-clé dans le contenu de son SMS pour joindre votre application. 
 
  Notes concernant l’utilisation des sessions SMS :
 

    

  • les sessions ne peuvent être activées par configuration de mot-clé que pour les numéros courts qui fonctionnent en receiveSMS puis en sendSMS (20345, 447797805210, 31244, 51244, 71244 et 967482). Dans le cas des shortcodes 51244 et 71244, le sendSMS se fait par retour XML (cf. ci-dessous) ;
    • 

  • une session peut-être initialisée soit par une requête au sendSMS (voir section "sendSMS"), soit par l'envoi d'un SMS depuis un mobile (vu dans ce chapitre) ;
    • 

  • un même mobile ne peut être "en session" qu'avec un service Orange API SMS à la fois.
    • 



 


envoi du SMS depuis le mobile :

Formatage du SMS : 
 Le SMS est limité à 160 caractères et doit être sous la forme : 
 [votre mot-clé]* espace ou retour à la ligne [contenu] 

 exemple (ici, l’un de nos mot-clé est "orange") : 


orange Bonjour, comment vas-tu ?


 * Si vous avez configuré ce mot-clé pour créer une session, celui-ci ne sera alors utile que pour l'envoi du premier SMS créant la session (si toutefois vous l’ajoutez dans les SMS suivants, celui-ci sera considéré comme du contenu normal et ne sera pas interprété).

 


Numéros d’envoi disponibles :


    

  • Non surtaxés
    • 



 



 




shortcode

 

couverture

 

facturation pour l’émetteur

 

fonctionnalités




 



20345
Orange France
prix d'un SMS
émission et réception de SMS




967482
Orange UK
prix d'un SMS
émission et réception de SMS




38699
Orange France, SFR et Bouygues telecom
prix d'un SMS
émission et réception de SMS 

 Veuillez noter :
 Il est par contre obligatoire de commencer tout dialogue avec ce numéro par une émission de SMS (sendSMS) avant d'en recevoir un (receiveSMS).		




31244*
Orange France, SFR et Bouygues telecom
prix d'un SMS
réception et émission de SMS




+447797805210
International (tous pays, tous opérateurs)
prix d'un SMS du pays emetteur
émission et réception de SMS






 


    

  • Surtaxés
    • 



 



 




shortcode

 

couverture

 

facturation pour l’émetteur

 

fonctionnalités




 



51244*
Orange France, SFR et Bouygues telecom
prix d’un SMS + 0,20€
réception de SMS




71244*
Orange France, SFR et Bouygues telecom
prix d’un SMS + 0,50€
réception de SMS







  * ces numéros sont mis à disposition par l'association SMS+, certaines contraintes déontologiques y sont associés, merci de les prendre en compte. Sachez par exemple que le numéro de téléphone que vous recevrez sur votre application sera un alias (numéro masqué afin de garantir le respect de la vie privée de l'émetteur du SMS). 


 


méthodes de réception :

Par URL, les données du SMS sont envoyées en GET sur votre script : 




http://www.monsite.com/fichierReception.php?api=[méthode API utilisée]&call_id=[identifiant unique du SMS reçu]&dateCreated=[date et heure de réception]&from=[numéro de mobile émetteur]&to=[numéro court de réception]&content=[contenu du SMS reçu]




Détails des paramètres disponibles ici >





 


Paramètre de la requête Description


 





api










type : string










Nom de l’API utilisée : receiveSMS
















call_id










type : string










identifiant unique du SMS reçu.

 Ce paramètre permet d'obtenir d'avantage de détails concernant ce SMS grâce à la métode "getUsageDetails".
















dateCreated










type : date (ISO 8601)










Date et heure de réception du SMS au format suivant :
 YYYY-MM-DDTHH:MM:SS
















from










type : string










Numéro du téléphone mobile émetteur du SMS ou alias dans le cas d’un SMS reçu par des shortcodes aliasé (voir section « Numéros d’envoi disponibles »)
















to










type : string










Numéro d’envoi proposé par l’API (voir section « Numéros d’envoi disponibles »)
















content










type : string










Contenu du SMS, limité à 160 caractères (mot clé inclus)


















 
 Par email, le SMS sera transféré vers la boite mail sous la forme : 




De: The Orange API Team (No Reply) [noreply-instantapi@orange-api.net] 
 A: [adresse email] 
 Date: [date et heure] 
 Objet: Sms received ([call_id])




Date : [date et heure de réception] 
 From : [numéro de mobile émetteur] 
 To : [numéro court de réception] 
 Call ID : [identifiant unique du SMS reçu] 

 Content : [contenu du SMS]




 
 Codes de retour  retournés par l'API :  

 


 




code



message




 



200
ok
 (ok)		




460
bad XML
 (le XML de confirmation de réception est mal formaté)		




461
bad XML status, string ok needed.
 (le statut XML de confirmation de réception doit mentionner "ok")		




462
bad HTTP status code
 (mauvais code de retour HTTP)		




463
XML <response> tag too long (over 160 characters)
 (la réponse au SMS surtaxé dépasse les 160 caractères)		




464
Missing <response> tag
 (la balise <response> qui permet de répondre aux SMS surtaxés est manquante)		




465
timeout request
 (la requête n'a pas pu aboutir)		




500
internal error
 (erreur interne)		






 


 


confirmation de réception et réponse :

SMS normaux 
 Lors de la réception de SMS sur votre application (en notification par URL), il est important d’informer l’API de la bonne réception de ce SMS sur votre service. 

 Insérez simplement ces quelques lignes dans votre script de réception PHP :

<?php
 echo " 

 <?xml version="1.0“ encoding=“UTF-8“ ?>
 <receivesms>
 <status>ok</status>
 </receivesms> 

 ";
 ?>



 SMS surtaxés 
 De plus, dans le cas de la réception d’un SMS surtaxé, vous avez l’obligation d’y répondre (en moins de 160 caractères) sans quoi vous ne gagnerez pas de crédits. Cette réponse ne vous est pas facturée. 

 Cette réponse obligatoire de votre application implique que vous devez choisir la méthode de réception par "URL" ou par "Email et URL" (et pas uniquement par email, méthode qui ne permet pas de répondre à un SMS surtaxé). 

 Utilisez simplement la balise <response> prévue à cet effet, le mobile émetteur recevra alors instantanément votre réponse. 

<?php
 echo " 

 <?xml version="1.0“ encoding=“UTF-8“ ?>
 <receivesms>
 <status>ok</status>
 <response>votre réponse au SMS surtaxé</response>
 </receivesms> 

 ";
 ?>


 





2 . exemple de code


envoyer un SMS en quelques lignes de code !


    

  • 1. copiez/collez ce code dans un fichier PHP.
    • 

  • 2. remplissez les paramètres API Access Key, FROM, TO et CONTENT.
    • 

  • 3. chargez le fichier sur votre serveur Web.
    • 

  • 4. exécutez votre page.
    • 





<?php


// votre API Access Key
$access_key = "XXXXXXX";

// adresse de l'API sendSMS
$adresse = "http://run.orangeapi.com/sms/sendSMS.xml";
 // numéro court d'émission
 $from = "38100";
// numéro de téléphone du destinataire (au format international)
$to = "336XXXXXXXX";
// activation du SMS long
$long_text = "true";
// limite du nombre de SMS à concaténer
$max_sms = "3";
 // activation de l'accusé de réception
$ack = "true";
 // activation de la session
$session = "true";
// durée de la session
$session_duration = "300";
 // type d'encodage
$content_encoding = "gsm7";
// contenu du SMS
$content = urlencode("votre contenu ici !");

// exécution de la requête> envoi du SMS
 $fd = file_get_contents($adresse . "?id=" . $access_key . "&from=" . $from . "&to=" . $to . "&content=" . $content . "&long_text=" . $long_text . "&max_sms=" . $max_sms . "&ack=" . $ack . "&session=" . $session . "&session_duration=" . $session_duration . "&content_encoding=" . $content_encoding);
 
// Affichage de la réponse de l'API
$xml=simplexml_load_string($fd);
echo($xml->status->status_code . " - " . $xml->status->status_msg);


?>








    

    

      






tarifs de l'API









principes de facturation de l'API SMS:


    

  • chaque fois que votre application envoie un SMS (SMS MT), votre compte est débité ;
    • 

  • chaque fois que votre application reçoit un SMS (SMS MO), votre compte est :                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          

      

    • débité si vous utilisez un numéro non-surtaxé ;
      • 

    • rémunéré si vous utilisez un numéro surtaxé.
      • 

    

    • 



utilisez l'option autorefill pour être sur de ne jamais manquer de crédit sur votre compte


NB: l'usage des API d'Orange se fait à l'aide de crédits. Les crédits sont communs à toutes les API. Chaque crédit vaut 0.01€ TTC



 




1. tarifs selon les cas d’usage


a. envoyez des SMS vers des mobiles:


Vous pouvez envoyer des SMS via votre site Web ou votre application informatique depuis un numéro d'émission mutualisé. Les numéros d’émission disponibles sont : 38100 pour la France métropolitaine et WORLD pour le monde (voir la zone de couverture).


principes de facturation:


    

  • chaque SMS envoyé par votre application est débité de votre compte ;
    • 

  • le prix du SMS est déterminé en fonction du numéro d’émission et de la destination du SMS ;
    • 

  • chaque "partie" de 134 caractères d'un SMS long est facturé le prix d'un SMS ;
    • 

  • une remise au volume est appliquée en fonction de la recharge achetée.
    • 













à partir de 0,074 € HT


par SMS envoyé*












* prix à destination et en provenance de la France métropolitaine, pour un SMS reçu sans session, tarif pour l'achat d'une recharge de 836,22 € HT,  contactez-nous pour de plus gros volumes


 


b. envoyez des SMS avec un nom d’émetteur personnalisé


Vous pouvez envoyer des SMS via votre site Web ou votre application informatique depuis un nom d’émetteur personnalisé. Ce service n’est disponible à ce jour que pour la France métropolitaine.


principes de facturation:


    

  • chaque SMS envoyé par votre application est débité de votre compte ;
    • 

  • une remise au volume est appliquée en fonction de la recharge achetée.
    • 













300€ HT de frais d’abonnement annuels par nom d’émetteur personnalisé 
 


+
 


à partir de 0,083 € HT par SMS envoyé* 












* prix à destination de la France métropolitaine, tarif pour l'achat d'une recharge de 836,22 € HT, contactez-nous pour de plus gros volumes


 


c. envoyez des SMS et recevez en réponse des SMS non surfacturés pour l'émetteur


Vous pouvez envoyer des SMS via votre site Web ou votre application informatique depuis un numéro d’émission mutualisé, et permettre aux destinataires de vos SMS de répondre avec ou sans mot-clé sur ce numéro d’émission. Ces SMS ne sont pas surfacturés pour l'émetteur du SMS et ne lui coûtent donc que le prix normal d'un SMS en fonction de son forfait.


Les numéros d’émission disponibles sont : 38699 pour la France métropolitaine, 20345 pour Orange France uniquement, 967482 pour Orange UK uniquement et +447797805210 pour le monde (voir la zone de couverture).


principes de facturation du SMS envoyé:


    

  • chaque SMS envoyé par votre application est débité de votre compte ;
    • 

  • le prix du SMS est déterminé en fonction du numéro d’émission et de la destination du SMS ;
    • 

  • chaque "partie" de 134 caractères d'un SMS long est facturé le prix d'un SMS ;
    • 

  • une remise au volume est appliquée en fonction de la recharge achetée.
    • 



principes de facturation du SMS reçu:


    

  • chaque utilisateur paye le SMS dans son forfait ou hors forfait, sans surfacturation ;
    • 

  • 

    chaque SMS reçu par votre application est débité de votre compte, les SMS reçus dans le cadre d’une session (sans mot-clé) ont un tarif plus élevé ;
    

    • 

  • une remise au volume est appliquée en fonction de la recharge achetée.
    • 













à partir de 0,083 € HT par SMS envoyé*
 à partir de 0,032 € HT par SMS reçu en réponse* 












* prix à destination et en provenance de la France métropolitaine, pour un SMS reçu sans session, tarif pour l'achat d'une recharge de 836,22 € HT, contactez-nous pour de plus gros volumes


option:  nous pouvons vous proposer des numéros dédiés pour votre application aussi bien pour la France que pour l’international, contactez-nous si vous désirez recevoir un devis


 


d. recevez des SMS non surfacturés pour l’émetteur et répondez par SMS


Vous pouvez recevoir sur votre site Web ou votre application informatique des SMS sur un numéro de réception mutualisé, et y répondre par SMS sur ce même numéro mutualisé. Le premier SMS reçu depuis un mobile nécessite un mot-clé. Si une session est configurée pour ce mot-clé, les SMS reçus ensuite peuvent l’être avec ou sans mot-clé. Ces SMS ne sont pas surfacturés pour l'émetteur et ne lui coûtent donc que le prix normal d'un SMS en fonction de son forfait.


Les numéros de réception disponibles sont : 31244 pour la France métropolitaine et +447797805210 pour le monde (voir la zone de couverture).


principes de facturation du SMS reçu:


    

  • chaque utilisateur paye le SMS dans son forfait ou hors forfait, sans surfacturation ;
    • 

  • chaque SMS reçu par votre application est débité de votre compte, les SMS reçus dans le cadre d’une session (sans mot-clé) ont un tarif plus élevé ;
    • 

  • une remise au volume est appliquée en fonction de la recharge achetée, contactez-nous pour de plus gros volumes.
    • 



principes de facturation du SMS envoyé:


    

  • chaque SMS envoyé par votre application est débité de votre compte ;
    • 

  • le prix du SMS est déterminé en fonction du numéro d’émission et de la destination du SMS ;
    • 

  • chaque "partie" de 134 caractères d'un SMS long est facturé le prix d'un SMS ;
    • 

  • une remise au volume est appliquée en fonction de la recharge achetée..
    • 













à partir de 0,032 € HT par SMS reçu*
 à partir de 0,074 € HT par SMS envoyé en réponse* 












* prix à destination et en provenance de la France métropolitaine, pour un SMS reçu sans session, tarif pour l'achat d'une recharge de 836,22 € HT, contactez-nous pour de plus gros volumes


option: pour éviter l’utilisation d’un mot clé pour l’émetteur du SMS pour le premier SMS, nous pouvons vous proposer des numéros dédiés pour votre application aussi bien pour la France que pour l’international, contactez-nous si vous désirez recevoir un devis


 


e. gagnez des revenus en recevant des SMS surfacturés


Vous pouvez gagner de l’argent en recevant sur votre site Web ou votre application informatique des SMS sur un numéro de réception mutualisé, et y répondre par SMS. Le premier SMS reçu depuis un mobile nécessite un mot-clé. Si une session est configurée pour ce mot-clé, les SMS reçus ensuite peuvent l’être avec ou sans mot-clé. Les SMS sont surfacturés pour l’émetteur, et ils doivent obligatoirement recevoir en contrepartie une réponse envoyée par votre site Web ou application informatique.


Les numéros de réception disponibles sont : 51244 et 71244 pour la France métropolitaine.


principes de facturation du SMS reçu:


    

  • chaque utilisateur paye le SMS dans son forfait ou hors forfait, plus la surfacturation ;
    • 

  • chaque SMS reçu par votre application via un numéro surfacturé rémunère votre compte.
    • 



principes de facturation du SMS envoyé:


    

  • les SMS envoyés en réponse par votre application sont gratuits
    • 

  • afin de déclencher la rémunération, un SMS doit obligatoirement être envoyé en réponse
    • 

  • chaque SMS reçu par votre application crédite votre compte, les SMS reçus dans le cadre d’une session (sans mot-clé) ont une rémunération plus faible
    • 













51244 (émetteur : prix SMS + 0,20€ TTC) : 0,08 € reversé par SMS surfacturé reçu *
 71244 (émetteur : prix SMS + 0,50€ TTC) : 0,20 € reversé par SMS surfacturé reçu * 












* reversement sur compte bancaire pour une entreprise en France métropolitaine, pour un SMS hors session


option: pour éviter l’utilisation d’un mot clé pour l’émetteur du SMS pour le premier SMS, nous pouvons vous proposer des numéros dédiés à votre application en France, contactez-nous si vous désirez recevoir un devis


 


2. grilles tarifaires détaillées


prix en crédits









 




 




prix en crédit    selon le type de numéro mutualisé








 




pays




numéro    mutualisé MT uniquement




numéro    mutualisé bidirectionnel MT/MO




numéro    mutualisé MT → MO




numéro    mutualisé MO → MT non    surtaxé




numéro    mutualisé MO → MT surtaxé








 




38100,    WORLD




personnalisé
 (+ frais annuels 300€ HT)




+447797805210




38699,    20345, 967482




31244




51244,    71244








 




MT




MT




MT




MO SANS SESSION
 




MO AVEC SESSION
 




MT




MO SANS SESSION
 




MO AVEC SESSION




MO SANS SESSION
 




MO AVEC SESSION




MT




MO




MT








europe




France




10,00




11,20




13,40




4,30




5,50




11,20




4,30




5,50




4,30




5,50




10,00




0,00




0,00








Royaume    Uni




12,31




N/A




13,50




4,30




5,50




13,50




4,30




5,50




N/A




N/A




N/A




N/A




N/A








Allemagne




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Autriche




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Belgique




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Danemark




10,32




N/A




11,75




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Espagne




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Estonie




10,00




N/A




11,67




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Finlande




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Grèce




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Hongrie




13,08




N/A




14,27




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Irlande




10,61




N/A




11,81




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Italie




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Luxembourg




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Norvège




10,61




N/A




11,81




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Pays-Bas




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Pologne




13,08




N/A




14,27




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Portugal




13,84




N/A




15,04




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Roumanie




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Slovaquie




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Suède




12,92




N/A




14,12




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Suisse




11,08




N/A




12,27




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








reste du monde




Algérie




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Antilles    Françaises (Guyane, Guadeloupe, Martinique, St Martin, St Barthelemy)




57,91




N/A




59,11




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Bostwana




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Cameroun




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Côte    d'Ivoire




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Egypte




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Israël




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Madagascar




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Maroc




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Maurice




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Réunion




57,91




N/A




59,11




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Sénégal




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Tunisie




12,00




N/A




13,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Turquie




14,61




N/A




15,81




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








 




Autres    pays




14,00




N/A




15,19




4,30




5,50




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








 


prix de base en € HT


Pour la recharge à 8,36 € HT, sans réduction, cf. le tableau ci-dessous pour les réductions liées aux autres recharges.









 




 




prix de base en €    HT selon le type de numéro mutualisé (sans réduction)








 




pays




numéro    mutualisé MT uniquement




numéro    mutualisé bidirectionnel MT/MO




numéro    mutualisé MT → MO




numéro    mutualisé MO → MT non    surtaxé




numéro    mutualisé MO → MT surtaxé








 




38100,    WORLD




personnalisé
 (+ frais annuels 300€ HT)




+447797805210




38699,    20345, 967482




31244




51244,    71244








 




MT




MT




MT




MO SANS SESSION




MO AVEC SESSION




MT




MO SANS SESSION




MO AVEC SESSION




MO SANS SESSION




MO AVEC SESSION




MT




MO




MT








europe




France




0,084




0,094




0,112




0,036




0,046




0,094




0,036




0,046




0,036




0,046




0,084




0,000




0,000








Royaume    Uni




0,103




N/A




0,113




0,036




0,046




0,113




0,036




0,046




N/A




N/A




N/A




N/A




N/A








Allemagne




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Autriche




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Belgique




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Danemark




0,086




N/A




0,098




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Espagne




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Estonie




0,084




N/A




0,098




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Finlande




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Grèce




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Hongrie




0,109




N/A




0,119




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Irlande




0,089




N/A




0,099




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Italie




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Luxembourg




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Norvège




0,089




N/A




0,099




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Pays-Bas




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Pologne




0,109




N/A




0,119




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Portugal




0,116




N/A




0,126




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Roumanie




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Slovaquie




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Suède




0,108




N/A




0,118




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Suisse




0,093




N/A




0,103




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








reste du monde




Algérie




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Antilles    Françaises (Guyane, Guadeloupe, Martinique, St Martin, St Barthelemy)




0,484




N/A




0,494




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Bostwana




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Cameroun




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Côte    d'Ivoire




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Egypte




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Israël




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Madagascar




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Maroc




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Maurice




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Réunion




0,484




N/A




0,494




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Sénégal




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Tunisie




0,100




N/A




0,110




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








Turquie




0,122




N/A




0,132




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








 




Autres    pays




0,117




N/A




0,127




0,036




0,046




N/A




N/A




N/A




N/A




N/A




N/A




N/A




N/A








 


recharges


En fonction de la recharge achetée, vous bénéficiez d’une remise:









recharge




nombre de crédits 




réduction 












prix    (TTC) 




prix    (HT) 








10




8.36




1000




- 








50




41.82




5350




6.50%








100




83.61




11000




9.10%








500




418.06




56000




10.70%








 1000 




836.22




113000




11.50%








 


reversements en crédits









 




reversement    en crédits selon le type de numéro court








pays




numéro    court MO → MT surtaxé








51244




71244








MT




MO SANS SESSION




MO AVEC SESSION




MT




MO SANS SESSION




MO AVEC SESSION








France




0.00




8.00




7.00




0.00




20.00




19.00








Autres    pays




N/A




N/A




N/A




N/A




N/A




N/A