La nouvelle API d’Esendex, ce qui change pour vos intégrations

Avant, il fallait une API par canal, des requêtes en XML et le mot de passe de votre compte dans vos fichiers de configuration. Vos développeurs maintenaient plusieurs connexions et perdaient du temps à décrypter des messages d’erreur génériques. Désormais, la nouvelle API d’Esendex envoie vos SMS et vos messages RCS depuis une seule intégration. Un champ à changer suffit pour passer de l’un à l’autre. Cette API REST multicanale échange en JSON et s’appuie sur des clés API dédiées. Voici ce qui change pour vos équipes.

Une plateforme reconstruite de A à Z

Cette nouvelle API n’est pas une simple mise à jour. Esendex a entièrement refait sa plateforme et son architecture. Pour Richard Hanscott, PDG d’Esendex, les technologies évoluent vite, la réglementation se durcit et la sécurité compte plus que jamais. Il fallait reconstruire.

Vos développeurs ont le choix entre deux connexions. L’API REST multicanale repose sur un format unique, une URL de base et une clé API. Le SMPP, lui, prend en charge les flux de SMS continus à fort volume. Les deux passent par la même plateforme, vous avez donc moins à configurer et à maintenir. 

Sans aucun développement nécessaire, l’Email to SMS transforme aussi vos e-mails en SMS. 

Pour vous décider, comparez l’API REST, le SMPP et l’Email to SMS.

Ancienne ou nouvelle API d’Esendex ? Ce qui change

L’ancienne API reposait sur une architecture XML. La nouvelle part d’une base REST en JSON, conçue pour plusieurs canaux.

Critère	Ancienne API	Nouvelle API
Canaux	Une API distincte selon le canal	SMS et RCS dans la même API. D’autres canaux à venir
Messages d’erreur	Erreurs XML génériques	Codes HTTP standard et message d’erreur précis en JSON
Sécurité	Identifiants principaux du compte	Clés API dédiées, avec date d’expiration possible
Architecture	XML historique	REST en JSON, avec webhooks

Concrètement, vos développeurs maintiennent un seul code pour le SMS et le RCS. Les statuts de livraison et les réponses des deux canaux arrivent au même endroit, sur vos webhooks ou dans une boîte de réception unique.

Les erreurs se corrigent aussi plus vite. Chaque réponse renvoie un code de statut précis. Son message nomme le problème, là où l’ancienne API se contentait de retours XML génériques.

Enfin, vos intégrations utilisent leurs propres clés API. Le mot de passe de votre compte reste réservé au portail, protégé par une double authentification.

Les fonctionnalités de la nouvelle API d’Esendex

Vos équipes y retrouvent les outils dont elles ont besoin au quotidien :

• les codes OTP, que l’API génère, envoie puis vérifie, avec une validité réglable entre 90 et 900 secondes ;
• les modèles de messages, réutilisables d’un envoi à l’autre pour garder le même ton ;
• les contacts et les groupes, synchronisés directement depuis votre CRM, sans export ni import manuel ;
• le suivi du solde, avec une alerte par e-mail quand il passe sous le seuil que vous fixez.

D’autres outils complètent l’ensemble. Vous programmez vos campagnes une seule fois ou de façon récurrente. Vous pouvez aussi les étaler à un rythme choisi. 

Des champs placés entre crochets insèrent dans chaque message le prénom de votre client ou toute autre donnée de votre fichier. 

Les liens courts mesurent les clics de chaque destinataire. Une boîte de réception regroupe aussi les réponses par conversation.

Côté réglementation, plusieurs règles d’envoi s’appliquent automatiquement. Les mots-clés STOP bloquent d’eux-mêmes les envois concernés. Les plages horaires autorisées sont respectées selon le pays et la nature de chaque message. Les désinscriptions, elles, se gèrent directement par API.

Une API SMS simple à intégrer pour vos développeurs

Un format unique et des erreurs explicites

Vos requêtes partent dans un format unique, le JSON, et uniquement sur HTTPS. La documentation de l’API d’Esendex fournit des exemples cURL prêts à copier.

En cas de problème, chaque réponse renvoie un statut explicite. Une erreur 401 signale par exemple une clé ou une référence de compte erronée. Le code 429 indique, lui, que vous dépassez la limite de débit. 

La version de l’API figure dans l’URL (/v2/). Les améliorations s’ajoutent sans que vous ayez à modifier votre code. 

Avec le défi des 5 minutes, chronométrez le temps qu’il vous faut pour envoyer votre premier SMS.

Quels langages fonctionnent avec la nouvelle API d’Esendex ?

Vos développeurs peuvent utiliser n’importe quel langage qui envoie des requêtes HTTPS. Nos guides en présentent cinq, chacun avec un exemple de code complet.

PHP	Python	Java	JavaScript et Node.js	C#
Votre contrôleur Laravel ou votre service Symfony appelle l’API avec cURL, sans SDK à installer.	Un seul appel avec la bibliothèque requests envoie votre message, sans package propre à Esendex.	Votre application Java envoie vos messages avec HttpURLConnection, fourni avec le JDK, sans aucune dépendance.	Depuis Node.js 18, fetch() est intégré. Votre JSON part tel quel, sans package npm.	Votre projet .NET s’appuie sur HttpClient. Aucun package NuGet n’entre dans vos dépendances.

Une sécurité renforcée à chaque étape

Des accès contrôlés

L’accès au portail Esendex passe par une double authentification. Chaque utilisateur n’accède ensuite qu’aux fonctions autorisées par ses droits. Seuls les rôles Administrateur et Développeur donnent accès aux clés API.

Vos clés API peuvent avoir une date d’expiration. Il vaut d’ailleurs mieux en créer une par environnement, l’une pour vos tests et l’autre pour la production.

Des échanges chiffrés

Tous les échanges passent par HTTPS. Toute requête non chiffrée est refusée d’office. Vos données sont chiffrées pendant leur transfert comme une fois stockées.

Côté webhooks, une signature HMAC-SHA-256 vous assure que chaque notification vient bien d’Esendex. L’authentification OAuth 2.0 est aussi possible.

Une plateforme certifiée

La plateforme est certifiée ISO 27001, la norme internationale de sécurité de l’information. Ses vulnérabilités sont recherchées en permanence, selon le référentiel OWASP.

Pour vous faire une idée de la nouvelle API d’Esendex, testez-la. L’essai gratuit dure sept jours, sans engagement. Si votre projet va plus loin, comme le passage au RCS, parlez-en à nos experts.