Vortext est une API qui vous permet d'intégrer facilement l'envoi de SMS dans vos applications. Son API permet :
pour envoyer des SMS (max 600 caractères) aux clients des applications
pour récupérer l'état des livraisons précédentes
Cette API permet à vos applications de :
abstrait d'un fournisseur de services comme Orange ou SFR
bénéficier de tarifs avantageux, même pour un petit volume de données
bénéficient de garde-fous : nombre limité de SMS / minute ou par heure, ou liste blanche des numéros autorisés à contacter. Les intégrations sur les plateformes de développement et de test sont donc sans risque, même en cas de bug / régression de l'application, évitant les risques d'envoyer trop de SMS, ou à des destinataires que l'on voudrait éviter (clients réels).
La demande d'un compte d'accès au service se fait directement dans le portail ITCare via la page de détail du service.
Vous pouvez également demander un compte en créant une demande de support dans ITCare : vous devrez préciser dans quelle application et dans quel environnement ce compte d'accès doit être créé, ainsi que les limites que vous souhaitez.
Le mot de passe vous sera ensuite transmis par courrier électronique.
Pour plus d'information, veuillez consulter la page SMS - Didacticiels.
Vous pouvez estimer le nombre de SMS nécessaires à son envoi pour vous permettre de réduire vos coûts.
Pour plus de détails et découvrir un système de comptage, merci de visiter: https://developers.mtarget.fr/tools#main
Demandez à votre gestionnaire de compte technique les tarifs actuels par SMS envoyés sur la plateforme Vortext.
La documentation Swagger API est disponible ici :
Le chemin de base de l'API Vortext est situé à l'adresse :
https://vortext.cloud.cegedim.com pour les services hébergés dans les centres de données cegedim.cloud.
https://messages.cloud.cegedim.com pour les applications tierces qui atteignent Vortext sur Internet.
Toutes les méthodes sont relatives à cette URL.
Par exemple, si vous voulez obtenir le statut de Vortext, vous devez utiliser :
Toutes les demandes à l'API de Vortext sont effectuées par le protocole HTTP, en utilisant le cryptage de transport TLSv1.
Pour l'instant, l'authentification de base est utilisée pour chaque demande faite au service de Vortext.
Chaque demande est complètement apatride, de sorte que vous pouvez utiliser le service Vortext avec une simple ligne decurl.
Si vous ne connaissez pas l'authentification de base, il suffit d'un en-tête de requête http 'Authorization' :
L'identifiant utilisé est username:password encodé en base 64. La plupart des bibliothèques vous demanderont simplement de fournir un nom d'utilisateur et un mot de passe.
Cette API est principalement destinée à traiter les messages json dans les corps de demande et de réponse http.
Utilisez l'en-tête Content-Type : application/json pour indiquer au service Vortext le format du corps de votre requête.
Utilisez l'en-tête Accept : application/json pour indiquer au service Vortext le format que vous souhaitez pour le corps de la réponse.
Comme json ne supporte pas nativement la date et l'heure, tous les paramètres étiquetés comme date dans cette API sont des chaînes au format ISO8601 :
où Z est le fuseau horaire (comme+0200).
Exemples : 2016-06-01T12:27:19.000+0200
Pour les paramètres de requête, n'oubliez pas d'encoder ces paramètres en url.
Vous pouvez personnaliser le nom de l'expéditeur du SMS, au lieu d'un numéro classique tel que "30180". Pour ce faire, veuillez faire une demande dans ITCare à notre équipe en demandant la mise en place de cette fonctionnalité.
Une fois votre compte configuré, tous les SMS envoyés le seront avec ce nom d'expéditeur. Pour l'instant, il n'est pas possible d'avoir plusieurs noms d'expéditeur par compte.
Il est possible de recevoir des réponses PUSH (appel REST https) dès qu'un client répond à un SMS envoyé précédemment. Pour activer cette fonctionnalité, veuillez faire une demande dans ITCare à notre équipe.
Voici les spécifications des demandes sortantes que vous recevrez une fois activées :
Vous pouvez fixer des limites pour éviter les appels multiples / mauvaises boucles et empêcher certaines inondations :
total de SMS envoyés par minute
total de SMS envoyés par heure
Pour activer cette fonctionnalité, veuillez faire une demande dans ITCare à notre équipe.
Protocole
https
URL
<votre>
Méthode HTTP
POST
Authentification
Aucun
Content-Type
application/json
Corps du message
{ "response": { "content": "Response of your customer", "answeredAt" : "2020-02-12T13:00:00.000+0000" }, "message": { } }