Question 1

Débuter avec EnvoiSMS.ma

Accepted Answer

Bienvenue sur EnvoiSMS.ma. Notre plateforme vous permet d'envoyer des SMS et des sessions WhatsApp Business directement vers les mobiles au Maroc avec une connectivité directe de Rang 1. Pour commencer, créez un compte gratuit sur notre console. Après validation de vos informations, votre compte est crédité de 5 SMS gratuits utilisables immédiatement en mode Sandbox pour tester nos routes. Dans votre console, vous trouverez vos clés d'accès API secrètes dans l'onglet Développeur. Gardez-les précieusement et ne les partagez jamais.

Question 2

Envoyer votre premier SMS

Accepted Answer

Vous pouvez envoyer votre premier message de deux manières : directement depuis la console graphique ou via l'API. Depuis la console : Accédez à l'onglet "Nouveau message", saisissez le numéro au format international (ex: +212600000000), tapez votre texte, choisissez un Sender ID approuvé et cliquez sur envoyer. Vous verrez le statut passer instantanément à "Livré" si le mobile est allumé. Via l'API : Effectuez une requête HTTP POST sur l'endpoint `/v1/messages` avec votre Bearer Token. Le corps de la requête doit spécifier le destinataire, le texte et le Sender ID.

Question 3

Enregistrement de Sender ID au Maroc

Accepted Answer

Au Maroc, l'envoi de SMS avec un nom d'expéditeur personnalisé (Sender ID alphanumérique, ex: "MaMarque") est strictement réglementé pour éviter l'usurpation d'identité. Chaque Sender ID doit être déclaré auprès des trois opérateurs marocains (Maroc Telecom, Orange, inwi). Pour ce faire, vous devez soumettre une demande via notre console en fournissant votre ICE (Identifiant Commun de l'Entreprise) ou Registre de Commerce (RC) ainsi qu'une lettre d'autorisation signée. La validation prend généralement 24 à 48 heures ouvrées. Les Sender IDs génériques (ex: "SMS", "INFO", "ALERT") sont interdits par les opérateurs locaux.

Question 4

Choisir entre SMS et WhatsApp API

Accepted Answer

Le choix du canal dépend de la nature de vos messages. Le SMS est idéal pour les notifications urgentes hors-ligne car il ne nécessite pas de connexion internet sur le mobile du destinataire. WhatsApp Business API permet d'envoyer des contenus enrichis (images, documents, boutons interactifs) et affiche un taux d'engagement 5 fois supérieur au SMS. Côté budget, le SMS est facturé à l'unité envoyée. WhatsApp fonctionne avec une facturation par session de 24 heures initiée par l'entreprise, ce qui est souvent plus économique pour les conversations interactives ou le support client.

Question 5

Vérification de compte d'entreprise

Accepted Answer

Pour des raisons de conformité réglementaire au Maroc et pour éviter le spam, tous les comptes professionnels doivent être vérifiés avant de pouvoir envoyer du trafic de production. Pour vérifier votre compte, rendez-vous dans l'onglet "Paramètres > Vérification" et téléchargez les documents suivants : une copie de votre ICE ou certificat d'inscription au registre de commerce (RC), et la pièce d'identité du représentant légal. Nos équipes examinent les dossiers sous 2 heures ouvrées. Une fois approuvé, votre compte est débloqué et vous pouvez recharger des crédits sans limites.

Question 6

Sécurité et gestion des clés API

Accepted Answer

Votre clé API EnvoiSMS.ma donne un accès complet à votre solde et permet d'envoyer des messages. Elle doit être traitée avec le même niveau de sécurité qu'un mot de passe. Ne stockez jamais vos clés API dans votre code source ou sur des dépôts publics (comme GitHub). Utilisez des variables d'environnement (.env) sécurisées sur vos serveurs. Si vous pensez que votre clé a été compromise, vous pouvez en générer une nouvelle instantanément depuis l'onglet Développeur. L'ancienne clé sera révoquée immédiatement.

Question 7

Tarifs, Taxes et Facturation au Maroc

Accepted Answer

EnvoiSMS.ma est une plateforme marocaine. Tous nos tarifs sont libellés en Dirhams marocains (MAD) hors taxes. Conformément à la législation fiscale en vigueur au Maroc, les rechargements de crédits sont soumis à la TVA nationale de 20%. Une facture légale affichant le montant HT, le montant de la TVA et vos informations fiscales (ICE, RC) est générée automatiquement à chaque rechargement. Elle est téléchargeable au format PDF depuis l'onglet "Facturation" de votre console pour votre comptabilité.

Question 8

Moyens de paiement acceptés

Accepted Answer

Pour recharger votre solde de messages, nous proposons plusieurs canaux adaptés au marché marocain : 1. Carte bancaire : Paiement sécurisé en ligne via le CMI (cartes marocaines et internationales). Votre solde est crédité instantanément. 2. Virement bancaire : Effectuez un virement sur notre RIB marocain. Votre solde est mis à jour sous 24h après réception des fonds. 3. Espèces via CashPlus : Générez un code de paiement depuis votre console et réglez en espèces dans n'importe quelle agence CashPlus au Maroc. Le crédit est immédiat.

Question 9

Facturez-vous les messages non reçus ?

Accepted Answer

La facturation dépend strictement du canal utilisé. Pour le SMS : Les opérateurs télécoms marocains facturent chaque tentative de soumission de message au réseau, que le téléphone du destinataire soit éteint ou hors réseau. Nous appliquons la même règle. Cependant, nous ne facturons pas les SMS vers les numéros invalides ou syntaxiquement incorrects détectés par notre système avant l'envoi. Pour WhatsApp Business : La facturation est basée sur des sessions de discussion de 24h. Vous n'êtes facturé que si le premier message initiant la session est effectivement délivré sur le mobile de l'utilisateur.

Question 10

Authentification et requêtes API

Accepted Answer

L'API EnvoiSMS.ma est une API REST sécurisée. Toutes les requêtes doivent être effectuées en HTTPS. Pour authentifier vos appels, incluez votre clé API secrète dans l'en-tête de votre requête sous le format Bearer Token : `Authorization: Bearer VOTRE_CLE_API`. Les requêtes doivent inclure l'en-tête `Content-Type: application/json` et les données doivent être envoyées au format JSON. Notre API applique une limite par défaut de 60 requêtes par minute par compte en sandbox, extensible sur demande pour la production.

Question 11

Envoi d'OTP et de SMS transactionnels

Accepted Answer

Les SMS transactionnels (ex: codes OTP, confirmations de commande) exigent une délivrabilité maximale et une latence minimale. Pour garantir un envoi en moins de 2 secondes, utilisez notre endpoint `/v1/messages` ou `/v1/verify` en spécifiant une route premium directe. Normalisez les numéros marocains au format international (ex: +212600000000). Notre système gère automatiquement le retrait du 0 initial. Veillez à ce que vos messages OTP respectent l'encodage GSM-7. Un SMS standard contient un maximum de 160 caractères. L'utilisation de caractères spéciaux ou d'émojis bascule le message en Unicode, limitant le segment à 70 caractères, ce qui peut doubler vos coûts d'envoi.

Question 12

Configuration des webhooks de livraison

Accepted Answer

Les webhooks vous permettent de recevoir les accusés de réception (DLR) envoyés par les opérateurs mobiles marocains sans avoir à interroger notre API en boucle. Pour configurer votre webhook, rendez-vous dans l'onglet "Webhooks" de votre console, saisissez l'URL publique de votre serveur (ex: https://api.votresite.com/envoisms-webhook) et cochez les événements à écouter (ex: `message.delivered`, `message.failed`). Chaque notification est envoyée sous forme de requête HTTP POST avec un payload JSON contenant le `message_id`, le numéro de téléphone du destinataire, le statut et l'horodatage.

Question 13

Sécuriser vos webhooks avec HMAC

Accepted Answer

Pour éviter que des tiers n'envoient de fausses notifications sur votre serveur, EnvoiSMS.ma signe chaque requête de webhook avec une signature cryptographique. Nous incluons un en-tête `X-EnvoiSMS-Signature` dans chaque requête POST. Cette signature est générée à l'aide d'un algorithme HMAC-SHA256 en utilisant le corps brut de la requête (payload) et votre clé API secrète comme clé de hachage. Sur votre serveur, vous devez calculer le hash HMAC-SHA256 du corps brut reçu avec votre clé API et vérifier qu'il correspond à la signature reçue dans l'en-tête avant de traiter l'accusé de réception.

Question 14

Intégration SMS avec WooCommerce

Accepted Answer

Informer vos clients par SMS de l'état de leur commande est un excellent moyen de réduire les paniers abandonnés et de rassurer les acheteurs au Maroc. Pour intégrer EnvoiSMS.ma avec WooCommerce, vous pouvez utiliser notre plugin officiel ou configurer des requêtes cURL via le fichier `functions.php` de votre thème WordPress sur les crochets d'action de commande (ex: `woocommerce_order_status_completed`). Configurez des modèles simples : confirmation de commande à l'achat, alerte d'expédition avec lien de suivi du transporteur local, et code de validation OTP à la création du compte client.

Question 15

Pourquoi mes SMS ne sont-ils pas livrés ?

Accepted Answer

Lorsqu'un SMS ne parvient pas à son destinataire, notre console affiche un statut précis reçu de l'opérateur local. Statut PENDING (En attente) : Le message est transmis à l'opérateur mais ne peut pas être remis immédiatement au mobile. Cause courante : Mobile éteint, hors zone de couverture ou mémoire de stockage des SMS saturée. L'opérateur tente de livrer le message pendant 48 heures avant de le marquer comme expiré. Statut FAILED (Échec) : La livraison a échoué. Causes : Numéro invalide ou inexistant, rejet par l'opérateur dû à un Sender ID non validé, ou blocage pour non-respect des règles anti-spam.

Question 16

Filtrage des opérateurs et règles anti-spam au Maroc

Accepted Answer

Les opérateurs marocains appliquent des filtres stricts pour protéger les utilisateurs du spam commercial. Horaires d'envoi : L'envoi de SMS promotionnels et marketing au Maroc est interdit pendant la nuit (généralement entre 21h00 et 8h00) ainsi que les jours fériés. Tout SMS marketing envoyé durant ces périodes sera bloqué ou retardé par les opérateurs. Conformité CNDP : Chaque SMS marketing doit obligatoirement inclure un moyen de désinscription simple pour l'utilisateur (mention "STOP" ou numéro court d'exclusion). Les envois sans option de désinscription s'exposent à des plaintes et au blocage définitif du Sender ID.

Question 17

Erreur 1 : Unknown Subscriber / Abonné inconnu

Accepted Answer

L'Erreur 1 est renvoyée directement par l'opérateur du destinataire (Maroc Telecom, Orange ou inwi) lorsque le numéro demandé n'existe pas dans sa base de données. Causes fréquentes : Le numéro a été mal saisi par l'utilisateur (faute de frappe), le numéro correspond à une ligne fixe (non éligible aux SMS standards), ou la ligne mobile a été résiliée par l'abonné et désactivée par l'opérateur. Solution : Supprimez immédiatement ce numéro de vos listes d'envoi pour éviter de gaspiller des crédits sur des tentatives d'envoi qui échoueront systématiquement.

Question 18

Erreur 2 : Absent Subscriber / Abonné absent

Accepted Answer

L'Erreur 2 indique que l'infrastructure de l'opérateur a tenté de joindre le mobile du destinataire mais n'a reçu aucun signal. Causes fréquentes : Le mobile est éteint, configuré en mode avion, ou se trouve dans une zone sans aucune couverture réseau. Comportement : Cette erreur n'est définitive qu'après expiration du délai de rétention de l'opérateur (généralement 48 heures). Pendant cette période, le statut reste en attente (Pending). Si le mobile est rallumé ou capte du réseau avant 48h, le SMS est livré.

Comment pouvons-nous vous aider ?

Questions populaires

Démarrage & Fonctionnement

Développeur & API

Délivrabilité & Erreurs

Vous ne trouvez pas de réponse ?