Expertise developer

Webhook SMS : Recevez des Accusés de Réception (DLR) en Temps Réel au Maroc

Guide complet pour implémenter et sécuriser les webhooks d'accusés de réception SMS (DLR) sur les réseaux IAM, Inwi et Orange.

Webhook SMS : Recevez des Accusés de Réception (DLR) en Temps Réel au Maroc

1. Comprendre le Cycle de Vie d'un SMS (DLR)

Chaque SMS transite par plusieurs états : queued (en attente d'envoi), sent (transmis au centre de messagerie SMSC de l'opérateur), delivered (reçu sur le terminal du client) ou failed (numéro injoignable ou résilié). Les webhooks EnvoiSMS vous transmettent ces états en temps réel.

2. Configuration de votre URL de Callback

Dans la console EnvoiSMS.ma (onglet Webhooks), renseignez votre URL HTTPS publique. Dès qu'un changement de statut intervient chez Maroc Telecom, Orange ou Inwi, notre passerelle envoie un payload JSON par requête HTTP POST.

3. Sécurisation par Signature Cryptographique HMAC-SHA256

Pour empêcher toute usurpation, chaque notification inclut un en-tête X-EnvoiSMS-Signature. Calculez le hash HMAC-SHA256 du corps brut avec votre secret webhook : s'il correspond, la notification provient authentiquement de nos serveurs.

4. Nettoyage Automatique des Bases de Données

Les retours failed avec motif opérateur (numéro non attribué, carte SIM expirée) vous permettent de désactiver automatiquement les numéros obsolètes de votre CRM, évitant ainsi de dépenser du crédit inutilement lors des prochaines campagnes.

5. Gestion des Pannes et Politique de Réessai

Si votre serveur renvoie une erreur 5xx ou ne répond pas dans les 5 secondes, EnvoiSMS déclenche une politique de réessais automatiques échelonnés (exponential backoff) pour garantir zéro perte de données.

💡 Pourquoi choisir EnvoiSMS pour votre entreprise ?

⚡

Délivrabilité Opérateurs

Routes locales vers IAM, Orange et Inwi, avec bascule automatique entre routes et statut de livraison transmis par webhook.

💰

Optimisation Budgétaire

WhatsApp Business API dès 0,65 MAD par message. Le meilleur retour sur investissement.

🛡️

Données Souveraines (CNDP)

Hébergement conforme aux réglementations de protection des données personnelles locales.

Q.Quel est le délai moyen de réception d'un DLR ?
Généralement entre 2 et 10 secondes après l'envoi, dès que le réseau mobile confirme la remise sur le téléphone.
Q.Que faire si le téléphone du destinataire est éteint ?
Le statut reste `sent` pendant la durée de validité opérateur (généralement 48h à 72h). Dès le rallumage, le statut bascule à `delivered`.

Articles suggérés

Inbound Webhooks : Connecter TikTok & Meta Lead Ads directement à WhatsApp pour convertir vos prospects
developer

Inbound Webhooks : Connecter TikTok & Meta Lead Ads directement à WhatsApp pour convertir vos prospects

WhatsApp Flows : Créer des formulaires natifs dans le chat pour sécuriser le COD au Maroc
developer

WhatsApp Flows : Créer des formulaires natifs dans le chat pour sécuriser le COD au Maroc

Laravel SMS Maroc : Notification Channel et Tutoriel
developer

Laravel SMS Maroc : Notification Channel et Tutoriel