Expertise technical

Comment whitelister votre Sender ID chez IAM, Orange et inwi

Whitelister sender id iam orange inwi : guide technique avec exemples de code pour les développeurs au Maroc.

Comment whitelister votre Sender ID chez IAM, Orange et inwi

L'une des plus grandes incompréhensions des équipes techniques lors du déploiement d'une [API SMS au Maroc](/fr/api/) concerne le processus de "Whitelisting" (Mise en liste blanche) du nom d'expéditeur (Sender ID).

Vous configurez l'API, vous paramétrez sender: "MAMARQUE", et le résultat est frustrant : le SMS arrive chez certains de vos collaborateurs, mais pas chez d'autres. Pourquoi ? Parce que le routage au Maroc dépend de trois réseaux distincts (Maroc Telecom, Orange, inwi), et que l'autorisation de votre marque doit être configurée sur les pare-feux des trois opérateurs.

Voici comment se déroule ce processus complexe en coulisses et comment gérer les asymétries de validation.

Pourquoi la validation se fait opérateur par opérateur

L'infrastructure télécom marocaine n'a pas de "base de données centrale" pour les Sender IDs d'entreprise. Chaque opérateur (IAM, inwi, Orange Maroc) possède son propre système de filtrage SS7 (SMS Firewall) et ses propres équipes de conformité (NOC - Network Operations Center).

Pour protéger leurs abonnés contre le phishing (sms frauduleux de type "Votre colis est bloqué"), chaque opérateur exige de vérifier manuellement que la société "Alpha S.a.r.l" a bien le droit d'émettre des SMS sous le nom "AlphaPromo". Tant qu'un opérateur n'a pas validé la demande, son pare-feu bloquera vos envois sur son réseau.

Le rôle de votre fournisseur SMS dans ce processus

En tant qu'entreprise, vous ne contactez pas directement IAM ou Orange pour cela. C'est le rôle de votre fournisseur de passerelle (Gateway SMS).

Le flux typique de validation :

  1. Vous soumettez votre lettre d'engagement (NOC) et votre RC via la console EnvoiSMS.ma.
  2. Nos ingénieurs de routage vérifient la conformité technique (longueur < 11 caractères, caractères autorisés).
  3. Nous transmettons officiellement le dossier de votre entreprise, via nos partenaires de routage, aux 3 opérateurs marocains.
  4. Les opérateurs configurent leurs filtres pour accepter le trafic de nos routes sous ce Sender ID spécifique.

Délais de validation par opérateur (2026)

L'absence de synchronisation crée une "zone grise" : chaque opérateur avance à son propre rythme, et votre Sender ID peut être actif chez l'un plusieurs jours avant les autres. De bout en bout, l'homologation prend 15 à 30 jours :

  • Réseau inwi : validation sur son propre calendrier.
  • Réseau Orange Maroc : processus très strict, sur son propre calendrier.
  • Réseau IAM (Maroc Telecom) : en tant qu'opérateur leader concentrant un trafic immense, les délais de configuration manuelle sont parfois plus longs.

L'erreur classique des développeurs : Tester la campagne sur son propre téléphone Orange dès que le Sender ID y passe, voir que ça marche, et lancer la campagne globale. Résultat : tous les clients IAM ne reçoivent rien, et le taux de DLR "Failed/Rejected" explose.

Que faire si un seul opérateur bloque encore

Pendant la phase de "zone grise" (ex: inwi et Orange ont validé, mais IAM est en attente), comment communiquer ?

  1. Ne lancez pas vos campagnes globales marketing. Attendez la confirmation formelle du fournisseur que les 3 voyants sont au vert.
  2. Utilisez le fallback "Sender ID par défaut" pour l'OTP : Si vous intégrez des codes de validation urgents, configurez votre code pour détecter une erreur 403 Forbidden ou un DLR Rejected. En cas d'échec, renvoyez automatiquement le message avec un Sender ID numérique valide, ou un Sender ID neutre fourni par la plateforme en attendant la fin du whitelisting.
javascript
// Exemple logique de fallback Node.js (Pseudo-code)
async function sendImportantOtp(userPhone, code) {
  try {
    // Tentative avec le Sender ID de marque en cours de validation
    await smsApi.send({ to: userPhone, body: `Code: ${code}`, sender: "MAMARQUE" });
  } catch (error) {
    if (error.statusCode === 403 || error.code === 'SENDER_ID_REJECTED') {
      console.warn("Sender ID bloqué (sûrement IAM en attente). Fallback...");
      // Nouvel essai avec le Sender ID de secours pré-approuvé
      await smsApi.send({ to: userPhone, body: `Code: ${code}`, sender: "ENVOISMS" });
    }
  }
}

La clé d'un routage robuste est de toujours anticiper que le réseau opérateur a le dernier mot. Procédez à vos demandes de whitelisting bien avant vos dates de mise en production.

Pour savoir si l'écart que vous observez entre opérateurs est normal, comparez-le aux taux de remise mesurés par opérateur dans notre baromètre.

💡 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.Comment suivre l'acheminement sur les réseaux IAM, Inwi et Orange ?
Nos routes locales vers Maroc Telecom (IAM), Orange et inwi, avec bascule automatique entre routes, renvoient un statut de livraison opérateur pour chaque message, par webhook. Le délai de remise dépend de l'opérateur et du réseau du destinataire.
Q.Comment la plateforme gère-t-elle le format des numéros marocains ?
EnvoiSMS normalise automatiquement les numéros saisis (06..., 07..., 00212...) vers le standard E.164 (+212) pour éviter tout échec de distribution.

Articles suggérés

Formatage SMS au Maroc : Sauts de ligne, Encodage GSM-7 vs UCS-2 et Optimisation des Coûts
technical

Formatage SMS au Maroc : Sauts de ligne, Encodage GSM-7 vs UCS-2 et Optimisation des Coûts

Formatage WhatsApp Business au Maroc : Texte Enrichi, Emojis et Boutons Interactifs
technical

Formatage WhatsApp Business au Maroc : Texte Enrichi, Emojis et Boutons Interactifs

Chatbot WhatsApp en Darija Marocain : Comment l'IA Traite l'Arabizi et le Mix Français-Arabe
technical

Chatbot WhatsApp en Darija Marocain : Comment l'IA Traite l'Arabizi et le Mix Français-Arabe