Documentation API iAgility
Comprendre les API iAgility avant de les intégrer : SMS A2P, RCS, qualification de numéros, flux MVNO et authentification sécurisée.
Cette page explique les usages métier et les grands principes. La référence technique officielle reste disponible sur apidoc.iagility.fr pour les endpoints, les paramètres et les tests Swagger. La documentation Swagger s’ouvre dans un nouvel onglet afin de conserver cette page comme guide métier et la référence technique comme espace de test dédié.
Des API pour connecter vos parcours client
Les API iAgility sont des connecteurs métier : elles permettent à vos applications CRM, marketing, service client, plateformes opérateurs ou outils internes de communiquer directement avec notre infrastructure.
SMS A2P
Envoyer des SMS marketing ou transactionnels depuis vos applications, avec suivi des retours de livraison.
RCS
Créer des messages mobiles enrichis : cards, carrousels, boutons, templates, événements et rapports.
Qualification
Qualifier un ou plusieurs numéros mobiles en temps réel : validité du numéro, statut réseau, opérateur courant, portabilité éventuelle et indicateurs de joignabilité avant contact.
MVNO
Piloter des flux SMS P2P, des webhooks opérateurs et le cycle de vie de numéros virtuels mobiles.
Comprendre les standards d’intégration
Ces standards facilitent le dialogue entre équipes métier, IT, prestataires et développeurs. Ils rendent l’intégration plus lisible, plus testable et plus simple à maintenir.
OpenAPI
OpenAPI est un standard de description d’API. Il documente les endpoints, les paramètres, les formats de réponse et les règles d’authentification.
SSO
Le SSO centralise l’authentification. Une application cliente obtient un jeton sécurisé avant d’appeler les API iAgility.
JWT Bearer token
Un JWT est un jeton sécurisé. Le Bearer token est la méthode standard pour le transmettre dans l’en-tête d’autorisation de chaque appel.
Comment fonctionne une intégration API ?
1. Obtenir ses accès
iAgility active les services et délivre les identifiants associés au périmètre client.
2. S’authentifier
L’application récupère un jeton JWT via l’authentification SSO.
3. Appeler l’API
Elle utilise l’endpoint adapté : SMS, RCS, qualification, MVNO ou rapports.
4. Suivre les retours
DLR, webhooks, logs et rapports permettent de piloter les résultats.
SMS et RCS : deux parcours complémentaires
SMS A2P : messages courts, utiles, suivis
Le SMS A2P permet d’envoyer des messages depuis une application vers un utilisateur final. Deux parcours sont distingués : marketing pour les campagnes promotionnelles, notification pour les messages transactionnels, alertes, codes ou confirmations.
- Choisir la route adaptée : marketing ou notification.
- Transmettre destinataire, émetteur, contenu et paramètres d’envoi.
- Suivre les retours de livraison, sans assimiler un DLR à une lecture du message.
RCS : messages enrichis et parcours interactifs
Le RCS permet de créer des messages plus visuels : texte enrichi, image, card, carrousel, bouton d’action ou template. Avant l’envoi, un contrôle de compatibilité permet d’orienter les destinataires vers le bon canal.
- Vérifier si le numéro peut recevoir du RCS.
- Préparer le message enrichi et l’expéditeur configuré.
- Suivre les événements et prévoir un repli SMS lorsque nécessaire.
Catalogue des API
Qualification Live HLR
Qualifier un ou plusieurs numéros mobiles en temps réel : validité, statut réseau, opérateur associé, portabilité éventuelle et joignabilité avant contact.
MVNO & SMS P2P
Piloter des besoins avancés : services opérateurs, numéros virtuels mobiles, flux P2P, activations, portabilités, DLR et webhooks.
TOKEN / Authentification
Obtenir un jeton sécurisé, puis l’utiliser dans les appels API avec le standard JWT Bearer token. Tous les endpoints nécessitent un JWT valide.
Documentation technique officielle
Swagger iAgility API Gateway
La documentation interactive disponible sur apidoc.iagility.fr reste la référence technique. Elle permet aux équipes de consulter les endpoints, les formats de requête/réponse, les exemples, les statuts d’erreur, les règles d’authentification et les limites par API.
Cette page WordPress sert de guide de lecture : elle explique les usages et les concepts pour faciliter les échanges entre décideurs, équipes métier et équipes techniques.
Vous avez un projet d’intégration API ?
Parlons de votre cas d’usage, des accès nécessaires et de la meilleure façon de connecter vos outils à l’infrastructure iAgility.
À lire aussi : Réglementation Voix & SMS pour cadrer consentement, opt-out, SenderID et contraintes d’usage.