Webhooks : transférez les SMS entrants vers votre système

Grâce aux webhooks, SureSMS peut automatiquement transférer les SMS entrants vers un autre système. C'est pratique lorsque les réponses des clients doivent être enregistrées ou déclencher une action sans intervention manuelle.

1. Qu'est-ce qu'un webhook ?

Un webhook est un message automatique envoyé d'un système à un autre. Lorsqu'un client répond à votre SMS, SureSMS transmet automatiquement le message à votre système, sans que vous ayez besoin de vous connecter pour le récupérer.

Déroulement : Le client envoie un SMS → SureSMS le reçoit → votre système en est informé.

Vous pouvez par exemple utiliser les webhooks pour :

• enregistrer les réponses dans un CRM
• lancer un flux dans Zapier ou Make
• enregistrer les inscriptions à un concours
• ouvrir un dossier d'assistance

2. Voici ce que vous devez mettre en place en premier lieu

1. Un compte SureSMS associé à un numéro capable de recevoir des SMS. Il peut s'agir de votre propre numéro virtuel, d'une carte SIM hébergée ou d'un code d'accès à un numéro court, par exemple TAXA en 1414.
2. Une adresse web, c'est-à-dire une URL, capable de recevoir le message. Elle provient généralement du système vers lequel vous souhaitez envoyer le message, par exemple Zapier, Make, HubSpot ou votre CRM. Elle peut également provenir de votre développeur.
3. L'adresse doit être accessible depuis Internet et, de préférence, commencer par https://.

3. Comment configurer le webhook

1. Connectez-vous au portail SureSMS et rendez-vous sur Intégrations → Webhooks.
2. Cliquez Créer un nouveau webhook.
3. Sélectionnez le type dans le champ Description:
   • POST sur les SMS reçus (recommandé), si vous souhaitez recevoir les données au format JSON. Cela convient à la plupart des systèmes.
   • GET sur les messages reçus (recommandé), si votre système ne peut recevoir des données que dans l'adresse Web elle-même.
4. Saisissez votre adresse Web dans URI. Le portail fournit un exemple que vous devez remplacer par votre propre adresse.
5. Sélectionnez dans Tous les numéros, si le webhook doit s'appliquer à tous vos numéros ou uniquement à un numéro ou un mot-clé spécifique. Un mot-clé n'est reconnu que s'il s'agit du premier mot du SMS.
6. Si vous avez choisi POST, vous devez remplir Valeur POST. Il s'agit du JSON que SureSMS envoie à votre URL. Utilisez le bouton Insérer un champ de fusion pour saisir des valeurs dynamiques. Ce champ ne peut pas contenir plus de 1 000 caractères.
7. Cliquez Pierre précieuse.

4. Champs de fusion

Les champs de fusion sont remplacés par les valeurs correspondantes lorsqu'un SMS est reçu. Voici les plus couramment utilisés :

Champ de tresses	Contenu
<%bodyjson%>	Le texte du SMS, prêt pour le format JSON. Utilisez-le dans JSON.
<%body%>	Le texte du SMS
<%fromphonenumber%>	Numéro de l'expéditeur
<%receivedbyphonenumber%>	Votre numéro, auquel le SMS a été envoyé
<%countrycode%>	Code pays de l'expéditeur
<%receivedutcdatetime%>	Heure de réception (UTC)

Utilisez le menu déroulant du portail pour consulter la liste complète.

Exemple : GET

https://ditdomæne.dk/sms?fra=<%fromphonenumber%>&til=<%receivedbyphonenumber%>&tekst=<%body%>

Exemple : POST

{
 "time" : "",
 "sender" : "",
 "receiver": "",
 "message": ""
}

Si les valeurs de test proviennent de l'expéditeur +4512345678, reçoit +4587654321 et le texte Test de SureSMS, l'exemple POST se présente comme suit :

{
  "time" : "2026-10-23T07:54:00Z",
  "sender": "+4512345678",
  "receiver": "+4587654321",
  "message": "Test SureSMS"
}

5. Comment effectuer le test

a) Cliquez sur le bouton « Test »

Dans la fenêtre de configuration, vous pouvez cliquer sur Test, avant d'enregistrer. SureSMS envoie un appel test à votre adresse avec les valeurs de test ci-dessus. Vous serez informé de la réussite de l'opération et du code d'état HTTP renvoyé par votre système. Tout code de la série 200 signifie que cela fonctionne.

b) Faites un vrai test

Envoyez un SMS depuis votre propre téléphone portable vers ce numéro. N'oubliez pas votre mot de passe, si vous en utilisez un. Ouvrez ensuite l'onglet Journal sur la page « Webhooks », puis cliquez sur Mettre à jour. Vous pouvez voir ici exactement ce qui a été envoyé, quelle a été la réponse de votre système et à quel moment.

c) Tu n'as pas encore de système en place ?

Vous pouvez utiliser un service de test gratuit tel que webhook.site. Elle vous fournit une adresse temporaire. Saisissez cette adresse comme URI, envoyez un SMS de test et consultez le message en direct sur webhook.site.

6. Si cela ne fonctionne pas

• Le test échoue avec le code d'erreur 400 « Bad Request » : Utilisez-vous <%bodyjson%> en JSON ? Le JSON est-il valide, avec des guillemets et des virgules corrects ?
• Le test fonctionne, mais on ne reçoit rien par SMS : Est-ce le bon numéro ? Le SMS commence-t-il par le mot de passe ? Le webhook a-t-il été supprimé ?
• Délai d'attente : Votre système doit répondre en quelques secondes. Effectuez les traitements lourds après coup, et non pendant que SureSMS attend une réponse.
• Adresse non valide : L'adresse doit commencer par http:// ou https://.
• Votre système est temporairement indisponible : SureSMS effectue 3 tentatives à une minute d'intervalle.
• Pare-feu : Si vous souhaitez autoriser des adresses IP fixes, vous pouvez les obtenir en contactant SureSMS.

Le webhook est envoyé dès la réception du SMS. Les webhooks ne nécessitent pas d'abonnement particulier, mais vous devez disposer d'une solution permettant de recevoir des SMS.