Passer au contenu
Français
Créer un ticket Portail client
smsmode.com
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Qu’est-ce qu’un Webhook (URL de notification) et comment le configurer ?

Un webhook (ou URL de notification) est un système permettant à la plateforme smsmode d’envoyer automatiquement des données vers votre propre serveur dès qu’un événement spécifique se produit sur votre compte.

Techniquement, il s'agit d'une requête HTTP automatique (souvent en méthode POST ou GET) envoyée en temps réel vers une adresse web (endpoint) que vous avez définie. Le payload de cette requête contient toutes les informations liées à l'événement.

🔧 Pourquoi utiliser un webhook ?

Contrairement à une API classique où c'est vous qui devez interroger régulièrement nos serveurs pour savoir si une action a abouti (polling), le webhook fonctionne à l'inverse : c'est smsmode qui vous "pousse" l'information instantanément.

L'utilisation de webhooks est indispensable pour automatiser vos processus. Ils sont idéaux pour :

  • Suivre la délivrabilité (DLR) : Connaître le statut exact de vos messages (remis, en cours, échec, numéro invalide) en temps réel.

  • Récupérer les réponses : Recevoir directement sur vos serveurs les réponses textuelles (MO) de vos destinataires (ex : confirmation de rendez-vous, "OUI", "STOP").

  • Synchroniser vos outils : Mettre à jour automatiquement les fiches de vos clients dans votre CRM, votre ERP ou votre base de données interne sans intervention humaine.

⚙️ Comment configurer votre URL de notification ?

Pour indiquer à smsmode vers quelle adresse web envoyer ces notifications, deux méthodes s'offrent à vous :

🟢 Option 1 : Configurer une URL globale depuis l'espace client

Vous pouvez définir une URL par défaut pour l'ensemble de votre compte directement depuis l'interface smsmode :

  1. Rendez-vous dans la rubrique Paramètres.

  2. Accédez à l'onglet Webhook / URL de notification.

  3. Saisissez votre URL publique et enregistrez.

Une fois configurée, cette URL recevra automatiquement les statuts de tous vos envois.

🟢 Option 2 : Spécifier l'URL dynamiquement dans chaque requête API

Si vous gérez plusieurs applications ou campagnes différentes, vous pouvez transmettre une URL spécifique à chaque envoi en ajoutant le paramètre de notification (ex : notification_url) directement dans votre requête API.

Cette méthode est très flexible. Elle permet de segmenter vos retours de données selon le contexte de l'envoi.

💡 Règle de priorité :

Ces deux options peuvent coexister. Si vous avez configuré une URL globale dans votre espace client, mais que vous transmettez une URL différente dans une requête API spécifique, c'est l'URL précisée dans la requête API qui prendra le dessus pour cet envoi précis.