DÉVELOPPEURS

API de messagerie conçues pour les développeurs

Utilisez nos APIs multicanales pour envoyer et recevoir des SMS et des messages RCS. D’autres canaux arriveront bientôt.

Les APIs Esendex vous offrent une interface unique pour tous vos besoins en matière de messagerie, vous permettant ainsi de connecter facilement votre logiciel à vos utilisateurs

Essai gratuit

Documentation API

Pourquoi intégrer l’API Esendex à vos outils ?

Intégration rapide

Nos APIs offrent un point d’intégration unique pour tous canaux de communication, ce qui vous évite d’avoir à gérer plusieurs fournisseurs et réseaux. Il vous suffit de vous concentrer sur votre stratégie messaging.

Support dédié

Grâce à nos ressources développeurs, intégrez nos APIs en quelques clics. Nous mettons à votre disposition une documentation API détaillée, des exemples de code dans plusieurs langages, des guides et une équipe support dédiée, prête à vous aider.

APIs fiables et sécurisées

Avec un taux de disponibilité de 99,99 % et des certifications ISO, et Cyber Essentials, vous êtes entre de bonnes mains !

Deux méthodes pour connecter vos outils à l’API Esendex

L’API Esendex vous laisse le choix entre deux méthodes d’intégration. L’API REST convient à la plupart des projets. Le protocole SMPP répond aux besoins des entreprises qui envoient de très gros volumes de SMS.

L’API REST multicanale

Cette API envoie vos SMS et vos messages RCS en HTTPS. Pour passer d’un canal à l’autre, vous modifiez un seul paramètre dans votre requête JSON.

Toutes vos requêtes utilisent le même format JSON, la même URL de base et la même clé API.
Une seule requête peut cibler jusqu’à 50 000 destinataires.
Comptez moins de 3 heures entre la configuration de votre compte et votre premier envoi.

Le protocole SMPP

Compatible avec la version 3.4 du protocole, le SMPP maintient une connexion permanente avec notre passerelle. Vos SMS partent en continu, sans ouvrir une nouvelle requête pour chaque message.

Les sessions persistantes offrent un débit élevé et des accusés de réception en temps réel.
Les connexions sont chiffrées en TLS 1.2 ou plus. Vous pouvez aussi passer par un tunnel VPN IPsec dédié.
Notre équipe technique configure la connexion avec vous.

Une intégration accessible aux développeurs comme
aux équipes no-code

L’API Esendex s’intègre facilement à vos CRM, ERP et plateformes métier. Vous reliez vos outils à vos canaux de communication sans multiplier les connexions. Vous pouvez connecter les services Esendex à vos systèmes en seulement quelques minutes.

// The POST v2/messages endpoint allows you to send a message to to up to 50,000 recipients in one request.
// The message can also be sent via different channels; including SMS and RCS.

curl -X POST 'https://api.esendex.fr/v2/messages' -H 'X-Api-Key: {{your-key-here}}' -H 'Content-Type: application/json' -d

{
  "accountReference": "EXxxxxxxxx",
  "name": "name",
  "characterSet": "characterSet",
  "channel": "channel",
  "from": "from",
  "validity": "2025-07-30T09:38:04.4517739+00:00",
  "messageType": "messageType",
  "body": {
    "text": "text",
    "templateId": "templateId"
  },
  "recipients": [
    {
      "msisdn": "msisdn",
      "variables": {},
      "metaData": {}
    }
  ],
  "addressBook": {
    "contacts": [
      {
        "id": "id"
      }
    ]
  },
  "metaData": {}
}

Créez un compte gratuitement

Essai gratuit de 7 jours. Sans engagement.

Inscription gratuite

Lancez-vous

Découvrez comment rendre votre service opérationnel rapidement

Documentation API

Votre langage, votre guide d’intégration

L’API Esendex fonctionne avec tout langage capable d’envoyer une requête HTTPS. Pour démarrer plus vite, suivez le guide de votre langage.

PHP

L’extension cURL, déjà intégrée à PHP, suffit pour envoyer vos messages.

Découvrir

Python

La bibliothèque requests envoie votre requête en un seul appel.

Découvrir

Java

HttpURLConnection, inclus dans le JDK, envoie vos messages sans bibliothèque externe.

Découvrir

JavaScript et Node.js

La fonction fetch(), native depuis Node.js 18, gère l’envoi sans package à installer.

Découvrir

c#

Le client HttpClient de .NET envoie vos requêtes sans package externe.

Découvrir

Premiers pas avec l’API Esendex

Authentification

Générez votre clé API dans le portail Esendex, rubrique Developer Tools. Créez une clé par environnement et ne l’exposez jamais dans du code côté navigateur.

URL de base et sécurité

Toutes les requêtes passent par https://api.esendex.fr en HTTPS, avec TLS 1.2 ou plus. Le trafic non chiffré est automatiquement bloqué.

Format des numéros

Les numéros des destinataires suivent la norme internationale E.164, par exemple +33612345678, sans espace ni zéro initial.

Limite de débit

Si vous dépassez le seuil autorisé, l’API renvoie le code 429. Patientez 5 secondes avant de renvoyer la requête.

Versions

La version figure dans l’URL, comme /v2/messages. Un changement de version majeure signale des modifications incompatibles avec la précédente.

Webhooks

Nos notifications partent d’adresses IP dynamiques. Pour les sécuriser, vérifiez plutôt la signature HMAC-SHA-256 de chaque webhook.

Les points d’accès de l’API

Chaque fonctionnalité dispose de son propre point d’accès, toujours derrière https://api.esendex.fr/v2. Voici les principaux, détaillés dans la documentation développeur.

Point d’accès	Utilisation
/v2/messages	Envoi immédiat d’un SMS ou d’un message RCS, jusqu’à 50 000 destinataires
/v2/schedules/delayed	Envoi à une date et une heure données, avec récurrence possible
/v2/throttle-schedule	Envoi réparti par heure ou sur une période choisie
/v2/templates	Création et mise à jour des modèles de messages
/v2/contacts	Gestion des contacts synchronisés depuis votre CRM
/v2/webhooks	Abonnement aux statuts de livraison et aux réponses
/v2/otps	Génération et vérification de codes à usage unique
/v2/optouts	Consultation et mise à jour des désinscriptions

FAQ | Plus d’informations sur l’API Esendex

Existe-t-il un environnement de test pour l’API Esendex ?

L’essai gratuit de 7 jours, sans engagement, vous donne accès à l’API. Vous créez une clé API et testez vos premiers envois avant de choisir une offre.

Comment recevoir les accusés de réception et les réponses en temps réel ?

Configurez les webhooks de l’API en quelques minutes depuis le portail développeur. Esendex envoie alors à votre serveur les statuts de livraison et les messages entrants dès qu’ils arrivent. Vous pouvez aussi récupérer les réponses à la demande dans la boîte de réception de l’API.

Peut-on programmer des envois avec l’API Esendex ?

Oui. L’API planifie vos envois à la date et à l’heure de votre choix. Un envoi peut aussi se répéter chaque jour, chaque semaine, chaque mois ou chaque année. Pour une grande campagne, l’envoi cadencé diffuse vos messages progressivement, à un débit ou sur une durée que vous choisissez.

Faut-il être développeur pour utiliser l’API Esendex ?

Non. La documentation fournit des exemples de code prêts à copier-coller, que vous adaptez à vos données. Vous pouvez aussi passer par nos connecteurs prêts à l’emploi pour vos outils no-code et votre CRM. Nous pouvons également prendre en charge l’intégration pour vous. Développeur ou non, rien ne vous empêche de vous lancer !

« Sans l’API SMS d’Esendex, nous n’aurions pas pu proposer une solution de retrait en magasin aussi performante. »

Manager commercial – Capgemini