Question 1

Getting Started with EnvoiSMS.ma

Accepted Answer

Welcome to EnvoiSMS.ma. Our platform allows you to send SMS and WhatsApp Business sessions directly to mobile phones in Morocco using direct Tier-1 carrier connectivity. To get started, create a free account on our console. Once your information is verified, your account will be credited with 5 free SMS to test our routes in Sandbox mode. Within your dashboard, you will find your secret API access keys in the Developer tab. Keep them secure and never share them publicly.

Question 2

How much does it cost to send an SMS via EnvoiSMS.ma in Morocco?

Accepted Answer

The price per SMS depends on the volume and destination carrier (IAM, Inwi, Orange). EnvoiSMS.ma offers a tiered pricing structure via prepaid credit packs starting at 0.43 MAD HT per SMS for the Discovery Pack (129 MAD HT for 300 SMS) down to 0.31 MAD HT per SMS for the Domination Pack (3,149 MAD HT for 10,000 SMS). For volumes exceeding 100,000 SMS per month, we offer custom negotiated rates on a bespoke quote, along with dedicated API integration. All topups are billed in Moroccan Dirhams (MAD) with a standard 20% recoverable VAT invoice.

Question 3

Is there a free trial or test credit available?

Accepted Answer

Yes, EnvoiSMS.ma offers 5 free SMS credits upon account registration to test our gateway. These credits can be used instantly in Sandbox mode to validate your technical integration and test our direct routing. The test account activation is immediate and does not require any credit card details.

Question 4

How are undelivered messages billed?

Accepted Answer

Billing depends entirely on the messaging channel used. For SMS: Moroccan telecom carriers charge for every single message submission attempt to the network, regardless of whether the recipient's device is turned off or out of coverage. We follow this carrier rule. However, we do not charge for SMS sent to invalid or malformed numbers that our system blocks before sending. For WhatsApp: Charges are session-based (24-hour window). You are only billed if the conversation-starting message is successfully delivered to the user's handset.

Question 5

What is a Sender ID and how do you register it in Morocco?

Accepted Answer

A Sender ID is the textual sender name (up to 11 characters) that appears on your recipients' mobile phones instead of a short number. In Morocco, for compliance and anti-spam purposes, Sender IDs must be registered with the telecom operators (IAM, Inwi, Orange). You can request your Sender ID registration directly from the EnvoiSMS.ma console, providing company registration documents (RC, ICE). Carrier approval takes between 24 and 48 hours.

Question 6

What is the price difference between SMS without a custom Sender ID and SMS with a custom Sender ID?

Accepted Answer

The rates displayed in our credit packs (from 0.43 MAD to 0.31 MAD per SMS) apply to SMS delivery without a custom Sender ID (using our shared "EnvoiSMS" sender ID), and to verified businesses that have registered their custom Sender ID with the required documents (Registre de Commerce, ICE, authorization form). By default, using an unverified custom Sender ID is billed at a flat rate of 0.792 MAD (excl. VAT) per SMS. Your prepaid balance is deducted in real-time according to the sender ID used and your company validation status.

Question 7

What is the difference between the SMS API and the WhatsApp Business API at EnvoiSMS.ma?

Accepted Answer

SMS and WhatsApp Business serve complementary goals. SMS is the ultimate universal channel. It works without internet connectivity on every mobile handset and guarantees a 98% open rate in under 3 minutes. It is perfect for critical alerts, OTP verification codes, and urgent messages. The WhatsApp Business API supports rich media interactions (images, PDF, interactive buttons, lists) and uses a 24-hour conversation session billing model (from 0.09 MAD per message). It is perfect for customer support, sales conversations, and interactive marketing.

Question 8

Does EnvoiSMS.ma offer the WhatsApp Business API in Morocco?

Accepted Answer

Yes, EnvoiSMS.ma provides official WhatsApp Business API integration for businesses in Morocco. As a messaging solution provider, we enable companies to register their official WhatsApp Business profile with Meta, get the green verified badge, and send approved message templates. The service integrates via our REST API and includes a visual template builder within the console.

Question 9

How do you send an OTP code via SMS in Morocco with EnvoiSMS.ma?

Accepted Answer

EnvoiSMS.ma provides a REST API to generate and send verification codes (OTP) via SMS in just a few lines of code. You can use our standard SMS endpoint `/v1/sms/send` by sending a message containing the code generated by your own application. The message is routed through optimized multi-carrier delivery to the recipient's carrier (IAM, Inwi, or Orange) to minimize latency. Alternatively, our platform features a dedicated `/v1/verify` endpoint that handles secure code generation, time-to-live (TTL) expiration, and server-side verification automatically, avoiding the need to store keys locally.

Question 10

What is the average delivery time for an OTP in Morocco?

Accepted Answer

Thanks to our optimized multi-carrier routing with local networks, the average delivery latency for an OTP is under 4 seconds across all networks in Morocco. Our periodic benchmarking in 2026 demonstrates average delivery times of 2.8 seconds on Maroc Telecom (IAM), 2.5 seconds on Orange, and 2.4 seconds on Inwi. This high speed ensures an optimal user experience and prevents drop-offs during registrations or purchases.

Question 11

Does the OTP API handle code expiration and regeneration?

Accepted Answer

Yes, our dedicated `/v1/verify` endpoint manages the entire lifecycle of the verification code seamlessly. By default, the system applies a code time-to-live (TTL) of 5 minutes (300 seconds), which can be customized in the HTTP request. If the user enters the code after this limit, the API returns an expired status. Additionally, validation is locked out automatically after 3 failed attempts to protect against brute-force attacks.

Question 12

Does EnvoiSMS.ma cover the three Moroccan carriers (IAM, Inwi, Orange)?

Accepted Answer

Yes, EnvoiSMS.ma provides 100% coverage of the national mobile network in Morocco through optimized multi-carrier routing to all three historical operators. We maintain a dedicated API integration connected to the networks of Maroc Telecom (IAM), Orange Maroc, and inwi, with reliability-optimized routing specifically tuned for inwi. This carrier-grade infrastructure bypasses international gray routes, eliminating lost messages and preserving brand Sender ID on IAM and Orange.

Question 13

Does the service work for sending international SMS from Morocco?

Accepted Answer

Yes, EnvoiSMS.ma allows you to send international SMS with coverage extending to over 190 countries globally. In addition to our priority routes in Morocco, we leverage a global aggregation network to route your transactional and marketing messages to Africa (Tunisia, Algeria, Senegal, Ivory Coast, etc.), Europe, and the Americas. International rates can be reviewed directly inside the console based on the destination country.

Question 14

How do you integrate the EnvoiSMS.ma SMS API in PHP?

Accepted Answer

Integrating with PHP is straightforward using the native cURL library to send JSON POST requests. Here is a production-ready code sample:

```php
<?php
$ch = curl_init("https://api.envoisms.ma/v1/sms/send");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer YOUR_API_KEY",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "to" => "+212612345678",
    "message" => "Votre code de verification est 123456.",
    "sender_id" => "EnvoiSMS"
]));
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
``` Make sure to replace `YOUR_API_KEY` with the secret access token from your dashboard Developer page.

Question 15

How do you integrate the EnvoiSMS.ma SMS API in Node.js?

Accepted Answer

In Node.js, you can send messages using the native Fetch API (standard in Node.js v18+) or HTTP client libraries like Axios. Here is a standard integration snippet:

```javascript
const fetch = require(node-fetch); // Optional on Node.js 18+

fetch(https://api.envoisms.ma/v1/sms/send, {
  method: POST,
  headers: {
    Authorization: Bearer YOUR_API_KEY,
    Content-Type: application/json
  },
  body: JSON.stringify({
    to: +212612345678,
    message: Votre code de verification est 123456.,
    sender_id: EnvoiSMS
  })
})
.then(res => res.json())
.then(data => console.log(data))
.catch(err => console.error(err));
``` Be sure to keep your API keys safe in environment variables (`process.env`) for security compliance.

Question 16

How do you integrate the EnvoiSMS.ma SMS API in Python?

Accepted Answer

Integrating with Python is simple and can be done with the popular `requests` library. Here is the integration snippet:

```python
import requests

response = requests.post(
    "https://api.envoisms.ma/v1/sms/send",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "to": "+212612345678",
        "message": "Votre code de verification est 123456.",
        "sender_id": "EnvoiSMS"
    }
)
print(response.json())
``` Ensure the package is installed using `pip install requests` before running this script.

Question 17

Does the API offer real-time delivery reports (DLR)?

Accepted Answer

Yes, EnvoiSMS.ma features real-time HTTP webhooks (callbacks) to notify your server of the final SMS status (delivered, expired, failed). As soon as the destination carrier (IAM, Orange, Inwi) updates the message status, our system sends a POST request with a JSON payload to the URL configured in your dashboard. To secure these callbacks, each payload features a HMAC SHA256 signature generated using your secret key, allowing you to authenticate the sender.

Question 18

Is there an official SDK or only a REST API?

Accepted Answer

EnvoiSMS.ma features a standard, OpenAPI-compliant REST API that works with any programming language. We also maintain official SDKs and client packages for PHP, Node.js, and Python to speed up your integration workflow. These libraries handle security authentication, phone formatting, and simplified error management natively.

Question 19

Does the data transit through servers located in Morocco?

Accepted Answer

Yes. To guarantee absolute compliance and minimum network latency, our core server infrastructure and databases are hosted locally in Morocco, on Cloudflare edge infrastructure. This meets the strict digital data sovereignty criteria mandated by Bank Al-Maghrib and the CNDP for financial institutions, insurance companies, and government entities. Furthermore, local Moroccan messages never transit through international routing hubs.

Question 20

Is EnvoiSMS.ma compliant with Moroccan data protection regulations (CNDP)?

Accepted Answer

Yes, EnvoiSMS.ma is fully compliant with Law 09-08 regarding the protection of individuals with respect to the processing of personal data. Our platform features built-in tools to guarantee CNDP compliance, including automated opt-out management (STOP SMS keywords to block future marketing sends) and strict adherence to legal sending hours (no promotional SMS sent after 9 PM, on Sundays, or on public holidays). A formal registration with the CNDP governs the data processing of the client databases you manage on our service.

Question 21

What is the average delivery rate for SMS sent via EnvoiSMS.ma?

Accepted Answer

EnvoiSMS.ma maintains an average delivery rate of 99.3% for all message attempts directed to active mobile phone numbers in Morocco. This high reliability is due to our optimized multi-carrier routing with Maroc Telecom, Orange, and Inwi, avoiding the spam filtering issues that block international gray routes. Detailed delivery reports and operator-specific performance analytics are available at any time within the console.

Question 22

Does EnvoiSMS.ma offer technical support in French/Arabic?

Accepted Answer

Yes, our technical support team is located in Casablanca and provides assistance in French, standard Arabic, and Moroccan Darija. Customer support can be contacted via support tickets, email, phone (+212 6 12 34 56 78), and a dedicated WhatsApp channel for Pro and Enterprise clients. Our technical engineers are available to help you troubleshoot REST API integrations, webhooks configurations, or e-commerce plugins.

Question 23

Is there a real-time service status page?

Accepted Answer

Yes, EnvoiSMS.ma maintains a public, real-time service status page accessible at `https://envoisms.ma/status`. This page displays the current availability of the REST gateway, routing status with IAM, Orange, and Inwi, as well as average message latencies. You can subscribe to updates on this page to get notified during planned maintenance windows or network incidents.

How can we help you?

Popular questions

Getting Started

Developer & API

Delivery & Troubleshooting

Cannot find what you need?