
API SMS
Un service simple et fiable pour envoyer des SMS dans le monde.
Vous avez la liberté d'intégrer l'envoi de SMS au coeur de vos algorithmes et de vos procédures métiers afin de profiter du moyen de communication le plus instantané et global.
API OVH
Les cas d'usages
Les avantages
- API Rest
- Expéditeur personnalisable
- Accusé de réception
- SMS différé
- 200 000 SMS
- Haute délivrabilité, routes redondées
- Couverture mondiale 600 opérateurs
- SMS réponse (two-way)
Tout savoir sur l'envoi de SMS au sein d'applications
Le destinataire recevra un SMS provenant d'un numéro court dont le contenu sera "Test message".
L'API retournera le nombre de crédits retirés, les destinataires valides et invalides,
ainsi que les identifiants des SMS pour suivre leur état.
Le service SMS d'OVH vous permet de personnaliser vos expéditeurs (11 caractères alphanumériques maximum).
Pour éviter toute usurpation d'identité, il est nécessaire de procéder à la validation de votre expéditeur.
3. Le champ "status" peut contenir les valeurs suivantes :
- waitingValidation: En attente de validation
- refused: Validation refusée (la raison sera disponible dans le champ "comment")
- enable: Activé (votre expéditeur est utilisable)
- disable: Désactivé (l'expéditeur est temporairement désactivé et réactivable à tout moment)
Une fois votre expéditeur validé, vous pouvez envoyer un SMS avec cet expéditeur.
Lors de l'envoi d'un SMS avec un expéditeur personnalisé, une mention légale "STOP 36111" sera ajoutée à la fin de votre SMS, et votre SMS ne sera pas envoyé le week-end et entre 22h et 8h du matin. Si vous envoyez votre SMS le dimanche à 16h, l'envoi sera automatiquement repoussé au lundi à 8h.
Toutefois, si votre SMS n'est pas à vocation marketing, vous pouvez spécifier le paramètre "'noStopClause': true" dans l'appel pour que cette mention ne soit pas ajoutée et que votre SMS soit envoyé instantanément à tout moment.
OVH vous permet de programmer l'envoi d'un SMS à une date ultérieure.
Le champ "differedPeriod" permet ici de décaler l'envoi de 120 minutes.
Le SMS sera donc envoyé deux heures plus tard.
L'état du SMS est récupérable via le champ "deliveryReceipt" :
Le champ "deliveryReceipt" peut contenir les valeurs suivantes :
- 0: En cours d'envoi
- 1: Délivré
- 2: Rejected or Expired
- 4: En attente sur le réseau de l'opérateur du destinataire
- 8: Transmis au réseau de l'opérateur du destinataire
- 16: Undeliverable
Une information supplémentaire est disponible avec le champ "ptt".
Le champ "ptt" retournera un code dont la description est disponible via l'appel à la méthode :
OVH permet d'être notifié en temps réel du changement d'état d'un SMS via un appel HTTP.
Pour paramétrer l'URL sur laquelle vous voulez être appelé :
Une fois la configuration effectuée, à chaque changement d'état d'un SMS, l'URL sera appelée avec les paramètres suivants :
- id: L'ID du SMS
- dlr: Le statut deliveryReceipt
- ptt: Le statut ptt
- date: Date de mise à jour du statut
- sender: L'expéditeur du SMS
- receiver: Le numéro du destinataire du SMS
Vous ne souhaitez pas vous soucier de la quantité de crédit qu'il vous reste ?
OVH vous propose de recréditer automatiquement votre compte lorsque vous franchissez un seuil défini de crédits.
Un bon de commande sera généré et payé automatiquement sur votre compte client OVH, puis régularisé.
OVH vous permet de recevoir des réponses à vos SMS.
Lorsque vous envoyez un SMS avec le champ "senderForResponse", votre destinataire pourra vous répondre.
La liste des SMS reçus est consultable via l'API :
OVH vous permet d'être notifié en temps réel lorsqu'un destinataire répond à votre SMS via un appel HTTP.
Pour paramétrer l'URL sur laquelle vous voulez être appelé :
Une fois la configuration effectuée, à chaque SMS entrant, l'URL sera appelée avec les paramètres suivants :
- id: Identifiant du SMS
- alias: Numéro de l'expéditeur
- shortcode: Numéro auquel l'expéditeur a répondu
- keyword: Premier mot de la réponse
- moMessage: Réponse
Pour optimiser vos envois massifs, vous pouvez précharger les destinataires dans un fichier CSV.
Pour créer un fichier de destinataires, utilisez la méthode suivante :
Le fichier doit comporter, a minima, une colonne "number" avec le numéro des destinataires.
Vous pouvez définir d'autres colonnes qui peuvent être utilisées pour remplacer des variables dans vos envois.
Exemple de fichier :
Pour envoyer un SMS à tous les destinataires de ce fichier, il ne vous reste plus qu'à appeler la méthode suivante :
POST https://api.ovh.com/1.0/sms/sms-aa1-1/jobs { "message": "Bonjour, M. #NAME#. Vous avez #AGE# ans.", "receiversSlotId": 1, "senderForResponse": true "tag": "MaCampagne" }
Avec cet appel, les trois destinataires recevront un message personnalisé.
Par exemple, monsieur Dupont recevra le message "Bonjour, M. Dupont. Vous avez 47 ans."
De plus, l'ajout du paramètre "tag" vous permettra de rechercher les SMS correspondant à cet envoi via la méthode :
Veuillez noter que la méthode https://api.ovh.com/1.0/sms/sms-aa1-1/jobs ne vous renverra pas les ID des SMS dans ce mode. L'envoi se fera, en effet, de façon asynchrone.
Pour connaître à l'avance le tarif de votre envoi, vous pouvez appeler la méthode suivante :
Cet appel vous retournera une structure vous permettant de connaître le prix de 1000 SMS vers la France, dans la devise utilisée en France (€).