Vos SMS partent de votre propre mobile.Découvrez comment
PLATFORMEArchitecture API-premièreJumelage sécurisé de l'appareilVisibilité de la livraisonContrôle multi-appareilsDocumentation en version

WEBHOOK V2 · Tous les événements mobiles, livrés à votre logiciel

Transformez chaque événement de votre mobile connecté en action instantanée.

SMSMobileAPI Webhook V2 envoie des événements HTTPS structurés à vos applications lorsqu'un SMS est soumis, envoyé, échoué ou reçu, lorsqu'un appel mobile est manqué, entrant ou sortant, et lorsqu'une activité WhatsApp ou e-mail prise en charge se produit. Configurez tout visuellement depuis votre tableau de bord — aucune boucle de sondage nécessaire.

Lire la documentation API

Choisissez les événements reçus par chaque destination. Testez, mettez en pause, surveillez et faites tourner sa clé de signature depuis un seul espace de travail.

SMSAppelE‑MAIL
JSON signé
SMSMobileAPIWEBHOOK V2File d'attente d'événements persistante
EN DIRECT
HTTPS POST
CRMAssistanceAUTOMATISATIONANALYTIQUES
Événement mobile → file d'attente persistante → livraison HTTPS signée → votre flux de travail
15 types d'événements

Couvrez SMS, les appels, WhatsApp et les e‑mails avec des noms d'événements précis.

Routage sélectif

Envoyez différents groupes d'événements vers différentes destinations HTTPS.

Livraison signée

Vérifiez chaque requête à l'aide de sa signature HMAC-SHA256 et de son horodatage.

Réessais persistants

Les défaillances temporaires d'une destination sont réessayées sans bloquer les autres comptes.

Comment fonctionne WEBHOOK V2

D'un événement mobile réel vers votre application en trois étapes claires.

Votre mobile connecté et les services SMSMobileAPI génèrent des événements opérationnels. Webhook V2 place chaque événement éligible dans une file d'attente de livraison persistante et envoie une charge utile JSON signée au HTTPS URL que vous avez sélectionné.

  1. 1

    Un événement se produit

    Un message est soumis, un mobile envoie ou reçoit un SMS, un appel change d'état, ou des activités WhatsApp ou e‑mail prises en charge sont enregistrées.

  2. 2

    Webhook V2 l'achemine

    SMSMobileAPI crée un identifiant d'événement stable et met en file d'attente une livraison uniquement pour les destinations abonnées à ce type d'événement.

  3. 3

    Votre logiciel réagit

    Votre endpoint public HTTPS vérifie la signature, enregistre l'ID de l'événement et déclenche votre workflow CRM, d'assistance, d'alerte ou d'automatisation.

15 types d'événements précis

Abonnez-vous uniquement aux événements mobiles dont votre workflow a besoin.

Une destination peut tout recevoir, ou vous pouvez séparer les systèmes de production, l'analytique et les alertes opérationnelles. Chaque événement porte un nom précis afin que votre application puisse le traiter de manière prévisible.

SMS

5
sms.api.submitted

SMS soumis via API

Une requête API a créé un travail d'envoi SMS. Utile pour confirmer que la requête est bien entrée sur la plateforme.

sms.sent

SMS envoyé

Le mobile connecté a confirmé l'opération d'envoi SMS.

sms.failed

SMS échoué

Le mobile connecté a renvoyé une erreur d'envoi SMS.

sms.received

SMS reçu

Un mobile connecté a synchronisé un SMS entrant.

sms.mobile.sent

SMS envoyé depuis le mobile

Un SMS a été envoyé manuellement depuis le mobile connecté.

Appels

3
call.missed

Appel manqué

Un appel manqué a été synchronisé depuis un mobile connecté.

call.incoming

Appel entrant

Un appel entrant a été synchronisé depuis un mobile connecté.

call.outgoing

Appel sortant

Un appel sortant a été synchronisé depuis un mobile connecté.

WhatsApp

5
whatsapp.submitted

WhatsApp soumis

Un travail d'envoi de WhatsApp a été créé.

whatsapp.sent

WhatsApp envoyé

L'environnement WhatsApp connecté a confirmé que le message a été envoyé.

whatsapp.failed

WhatsApp en échec

L'opération d'envoi WhatsApp a échoué.

whatsapp.received

WhatsApp reçu

Un message WhatsApp a été récupéré après que le compte a demandé la synchronisation.

whatsapp.voice.transcribed

Message vocal transcrit

Un message vocal WhatsApp récupéré et éligible a été converti en texte exploitable.

Configurez tout visuellement

Gestion professionnelle des webhooks sans modifier de fichiers de configuration.

Ouvrez Webhook V2 dans le tableau de bord SMSMobileAPI, ajoutez un nom de destination et des HTTPS URL publics, sélectionnez les événements, puis enregistrez. Le tableau de bord vous fournit les contrôles nécessaires pour l'exploitation quotidienne et le dépannage.

Plusieurs destinations

Créez des destinations dédiées pour votre CRM, votre supervision, vos analyses ou les applications clients.

Filtres d'événements

Sélectionnez précisément quels événements de type SMS, d'appel, WhatsApp et d'e-mail chaque URL reçoit.

Test de livraison

Envoyez un événement de test contrôlé avant d'utiliser la destination en production.

Mettre en pause et réactiver

Arrêtez une destination instantanément sans supprimer sa configuration.

Rotation des secrets

Générez un nouveau secret de signature lorsque votre procédure de sécurité l'exige.

Activité de livraison

Consultez les livraisons en file d'attente, délivrées, en nouvelle tentative et échouées, avec les informations sur les tentatives et le statut HTTP.

Configurer Webhook V2
Webhook V23 actives
Destinations3Délivrés · 24 h1,284Nouvelle tentative2
CRM de productionhttps://crm.example.com/hooks/mobileActif

sms.receivedcall.missedwhatsapp.received

Alertes opérationnelleshttps://ops.example.com/eventsActif

sms.failedwhatsapp.failed

Contrôles représentatifs du tableau de bord Webhook V2.

FIABILITÉ PAR CONCEPTION

Conçu pour une livraison fiable et indépendante.

La livraison via webhook est asynchrone. Votre flux mobile n'attend pas la réponse d'un URL tiers, et une destination en échec n'empêche pas la livraison à un autre client ou une autre destination.

01

File persistante

Les événements éligibles sont stockés avant la livraison afin qu'une indisponibilité temporaire du récepteur n'efface pas l'événement.

02

Livraison au moins une fois

Une livraison peut être retentée. Stockez l'ID de l'événement et traitez-le une seule fois dans votre application.

03

Réessais progressifs

Les échecs temporaires sont réessayés avec des délais croissants, jusqu'à la limite de tentatives de la plateforme.

04

Isolation des pannes

Un point de terminaison lent ou indisponible ne peut pas arrêter la livraison vers des destinations non liées.

05

Protection automatique

Une destination présentant des échecs répétés peut être mise en pause pour protéger la file et votre infrastructure.

06

Visibilité opérationnelle

Le tableau de bord et la surveillance webmaster exposent l'état de la file, les résultats et les erreurs de livraison récentes.

SIGNÉ ET VÉRIFIABLE

Vérifiez la requête avant de faire confiance à l'événement.

Chaque livraison inclut un horodatage, un identifiant de livraison, le type d'événement, une clé d'idempotence stable et une signature HMAC-SHA256. Conservez le secret de signature sur votre serveur, calculez la signature à partir du corps brut de la requête et rejetez les requêtes invalides ou obsolètes.

X-SMSMobileAPI-EventLe type d'événement, par exemple sms.received.X-SMSMobileAPI-DeliveryL'identifiant unique de livraison pour cette destination.X-SMSMobileAPI-TimestampHorodatage Unix utilisé lors de la vérification de la signature.X-SMSMobileAPI-SignatureSignature HMAC-SHA256 à comparer de manière sécurisée.Idempotency-KeyUUID d'événement stable utilisé pour empêcher le traitement en double.

ENVELOPPE D'ÉVÉNEMENT COHÉRENTE

Une enveloppe JSON cohérente pour chaque canal.

L'enveloppe reste prévisible à travers SMS, les appels, WhatsApp et l'e‑mail. L'objet data contient les champs pertinents pour le type d'événement, tandis que les identifiants de premier niveau vous permettent d'acheminer et de dédupliquer chaque livraison.

  • id— identifiant d'événement stable
  • type— type d'événement exact
  • occurred_at— moment où l'activité s'est produite
  • data— informations spécifiques au canal
{
  "id": "whv2_01J...",
  "type": "sms.received",
  "api_version": "2026-09-22",
  "created_at": "2026-09-22T12:00:00Z",
  "occurred_at": "2026-09-22T11:59:58Z",
  "data": {
    "guid": "...",
    "from": "+32...",
    "message": "Can you call me back?"
  }
}

DE L'ÉVÉNEMENT AU RÉSULTAT MÉTIER

Faites de la communication mobile le déclencheur de la prochaine action métier.

Conversations CRM

Ajoutez un message SMS ou WhatsApp reçu au contact approprié et alertez le responsable affecté.

Relance après appel manqué

Créez une tâche de rappel, envoyez un SMS de suivi ou prévenez l'équipe de garde après un appel manqué.

Support client

Ouvrez ou mettez à jour un ticket de support lorsqu'un client répond depuis son mobile.

Opérations e‑commerce

Mettez à jour les flux de communication de commande après l'envoi, la confirmation ou l'échec d'un message mobile.

Surveillance et alertes

Envoyez les échecs de livraison ou les activités d'appel inhabituelles vers vos outils d'observabilité et de gestion d'incidents.

Flux de travail IA et données

Alimentez des événements autorisés dans des flux de classification, de reporting ou d'assistance sans interroger en boucle le API.

Arrêtez d'interroger pour détecter les changements

L'interrogation effectue des requêtes répétées. Les webhooks notifient votre logiciel lorsqu'un changement se produit.

L'interrogation consomme des requêtes même lorsqu'aucun événement ne s'est produit et ajoute un délai entre les vérifications. Webhook V2 pousse l'événement pertinent vers votre point de terminaison, rendant l'automatisation plus rapide, plus simple et plus facile à faire évoluer.

Interrogation
Un nouvel événement ?Requêtes répétées · délai supplémentaire
WEBHOOK V2
Événement
Prévenez-moi lorsqu'il se produit.Événement pertinent · flux de travail immédiat

FAQ Webhook V2

Questions avant de connecter votre point de terminaison.

Dois-je créer une boucle d'interrogation ?

Non. Webhook V2 envoie les événements auxquels vous êtes abonné vers votre point de terminaison public HTTPS. Vous pouvez toujours utiliser les API lorsque vous devez interroger l'historique ou obtenir des détails.

Puis-je configurer plusieurs URL de webhook ?

Oui. Vous pouvez créer plusieurs destinations et choisir un ensemble d'événements différent pour chacune, dans les limites de compte affichées sur le tableau de bord.

Comment savoir qu'un SMS a réellement été envoyé ?

Utilisez sms.api.submitted pour savoir que la tâche a été créée et sms.sent pour la confirmation fournie par le mobile connecté. Considérez-les comme deux étapes opérationnelles distinctes.

Un webhook peut-il être livré plusieurs fois ?

Oui. Webhook V2 utilise une livraison au moins une fois (at-least-once). Enregistrez l'ID d'événement stable ou Idempotency-Key et ignorez une livraison que vous avez déjà traitée.

Que doit renvoyer mon point de terminaison ?

Renvoyez une réponse HTTP 2xx après avoir accepté l'événement en toute sécurité. Le traitement peut se poursuivre de manière asynchrone au sein de votre application.

Les événements WhatsApp reçus sont-ils collectés en continu ?

Non. La récupération des messages reçus via WhatsApp suit son propre processus de synchronisation fondé sur le consentement. L'événement whatsapp.received est disponible après qu'un message éligible a été récupéré.

Vos événements mobiles. Votre logiciel. Vos actions.

Connectez votre logiciel à l'activité de votre mobile réel dès maintenant.

Créez votre compte ou connectez-vous, ouvrez Webhook V2, ajoutez une destination publique HTTPS et choisissez les événements importants pour votre flux de travail. Envoyez un événement de test, vérifiez sa signature et activez votre intégration.