Couvrez SMS, les appels, WhatsApp et les e‑mails avec des noms d'événements précis.
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 APIChoisissez 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.
Envoyez différents groupes d'événements vers différentes destinations HTTPS.
Vérifiez chaque requête à l'aide de sa signature HMAC-SHA256 et de son horodatage.
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
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
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
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
5sms.api.submittedSMS 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.sentSMS envoyé
Le mobile connecté a confirmé l'opération d'envoi SMS.
sms.failedSMS échoué
Le mobile connecté a renvoyé une erreur d'envoi SMS.
sms.receivedSMS reçu
Un mobile connecté a synchronisé un SMS entrant.
sms.mobile.sentSMS envoyé depuis le mobile
Un SMS a été envoyé manuellement depuis le mobile connecté.
Appels
3call.missedAppel manqué
Un appel manqué a été synchronisé depuis un mobile connecté.
call.incomingAppel entrant
Un appel entrant a été synchronisé depuis un mobile connecté.
call.outgoingAppel sortant
Un appel sortant a été synchronisé depuis un mobile connecté.
whatsapp.submittedWhatsApp soumis
Un travail d'envoi de WhatsApp a été créé.
whatsapp.sentWhatsApp envoyé
L'environnement WhatsApp connecté a confirmé que le message a été envoyé.
whatsapp.failedWhatsApp en échec
L'opération d'envoi WhatsApp a échoué.
whatsapp.receivedWhatsApp reçu
Un message WhatsApp a été récupéré après que le compte a demandé la synchronisation.
whatsapp.voice.transcribedMessage vocal transcrit
Un message vocal WhatsApp récupéré et éligible a été converti en texte exploitable.
email.sentE-mail envoyé
Une demande d'envoi d'e-mail a été créée par SMSMobileAPI.
email.receivedE-mail reçu
Une boîte aux lettres connectée a reçu un e-mail.
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.
https://crm.example.com/hooks/mobileActifsms.receivedcall.missedwhatsapp.received
https://ops.example.com/eventsActifsms.failedwhatsapp.failed
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.
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.
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.
Réessais progressifs
Les échecs temporaires sont réessayés avec des délais croissants, jusqu'à la limite de tentatives de la plateforme.
Isolation des pannes
Un point de terminaison lent ou indisponible ne peut pas arrêter la livraison vers des destinations non liées.
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.
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 stabletype— type d'événement exactoccurred_at— moment où l'activité s'est produitedata— 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.
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.
