Recevoir les événements SMS en temps réel avec les webhooks API
Soyez informé en temps réel de chaque événement SMS
Les webhooks de l'API SMS Envopulse permettent à vos applications de recevoir instantanément les événements liés à vos SMS : envoi, livraison, erreurs ou réponses utilisateurs. Vous pouvez ainsi automatiser vos traitements, synchroniser vos systèmes et réagir sans délai.
Voir les événements disponibles Tester les webhooks en sandbox-
🔔 Réception temps réel des événements SMS
-
📩 Suivi des statuts d'envoi et de livraison
-
💬 Gestion des réponses SMS (MO)
-
⚙️ Automatisation de workflows
-
🔐 Webhooks sécurisés et fiables
Webhook : notification automatique côté serveur
Un webhook est un appel HTTP automatique envoyé par l'API Envopulse vers votre application lorsqu'un événement se produit.
Contrairement à une requête classique :
vous n'avez pas besoin d'interroger l'API en continu
les données vous sont envoyées dès qu'un événement survient
Les webhooks sont idéaux pour les traitements temps réel.
À quoi servent les webhooks dans une intégration SMS ?
Les webhooks permettent de :
suivre le statut des SMS envoyés
déclencher des actions métier automatiques
synchroniser vos bases de données
alimenter des outils tiers (CRM, ERP, support)
éviter les tâches de polling coûteuses
Ils rendent votre intégration plus réactive et plus fiable.
Quels événements SMS pouvez-vous recevoir ?
L'API Envopulse émet des webhooks pour plusieurs catégories d'événements :
📩 Événements d'envoi et de livraison
SMS envoyé
SMS délivré
SMS échoué
SMS expiré
💬 Événements de réponses SMS
réception d'un SMS entrant (MO)
réponse à une notification ou un rappel
⚠️ Événements d'erreur
erreur de routage
numéro invalide
quota dépassé
blocage réglementaire (STOP SMS)
Chaque événement contient les informations nécessaires à son traitement.
Comment les webhooks sont déclenchés
Flux de fonctionnement :
Un événement SMS se produit
Envopulse génère un événement
Un webhook HTTP est envoyé à votre endpoint
Votre application reçoit et traite les données
Les webhooks sont envoyés :
en temps réel
au format JSON
via HTTPS
Vous choisissez les événements que vous souhaitez recevoir.
Structure d'un événement webhook
Exemple de payload JSON reçu par webhook :
{
"event": "sms.delivered",
"message_id": "abc123",
"to": "+33600000000",
"status": "delivered",
"timestamp": "2026-01-21T10:15:00Z"
}Le payload contient les identifiants nécessaires pour faire le lien avec vos systèmes.
Garantir l'authenticité des événements reçus
Pour sécuriser les webhooks, Envopulse met en place :
Endpoints HTTPS
Signatures ou secrets partagés
Limitation des tentatives
Journalisation des envois
Bonnes pratiques côté développeur :
valider la signature du webhook
répondre rapidement (HTTP 200)
traiter les événements de façon idempotente
journaliser les erreurs
La sécurité est essentielle pour éviter les faux événements.
Fiabilité et gestion des erreurs
En cas d'échec de livraison d'un webhook :
Des tentatives de renvoi sont effectuées
Les événements restent consultables via l'API
Vous pouvez resynchroniser vos données
Cela garantit une continuité de traitement, même en cas d'incident.
Automatiser vos workflows grâce aux événements
Les webhooks sont utilisés pour :
mettre à jour un statut de commande
confirmer un rendez-vous
déclencher un email ou un ticket support
analyser la délivrabilité
tracer des parcours utilisateurs
alimenter des dashboards internes
Les possibilités dépendent uniquement de votre logique métier.
Tester vos webhooks avant la mise en production
La sandbox Envopulse permet de :
Simuler des événements SMS
Tester vos endpoints webhook
Valider les payloads
Vérifier vos traitements
Étape indispensable avant tout déploiement.