Expertise developer

Intégrer l'API SMS Maroc en 10 minutes : Exemples complets pour Laravel, Node.js et Python

Tutoriel développeur : intégrez l'envoi de SMS OTP et transactionnels au Maroc en quelques lignes de code avec nos SDK et exemples d'API REST.

Intégrer l'API SMS Maroc en 10 minutes : Exemples complets pour Laravel, Node.js et Python

1. Intégration en Node.js / TypeScript

typescript
import { EnvoiSMS } from 'envoisms';

const client = new EnvoiSMS({ apiKey: process.env.ENVOISMS_API_KEY });

async function sendOtp(phone: string, code: string) {
  const response = await client.messages.send({
    to: phone, // Format international E.164: +2126XXXXXXXX
    sender_id: 'MONENTREPRISE',
    body: `Votre code de vérification est : ${code}. Valable 5 minutes.`,
  });

  console.log(`SMS expédié avec succès, ID : ${response.id}`);
}

2. Intégration en PHP / Laravel

php
use Illuminate\Support\Facades\Http;

class SmsService
{
    public function sendNotification(string $phone, string $text): bool
    {
        $response = Http::withToken(config('services.envoisms.key'))
            ->post('https://api.envoisms.ma/v1/messages', [
                'to'        => $phone,
                'sender_id' => 'MONENTREPRISE',
                'body'      => $text,
            ]);

        return $response->successful();
    }
}

3. Intégration en Python (Django / FastAPI)

python
import os
import requests

def send_sms_alert(phone: str, message: str):
    url = "https://api.envoisms.ma/v1/messages"
    headers = {
        "Authorization": f"Bearer {os.getenv('ENVOISMS_API_KEY')}",
        "Content-Type": "application/json"
    }
    payload = {
        "to": phone,
        "sender_id": "MONENTREPRISE",
        "body": message
    }
    
    response = requests.post(url, json=payload, headers=headers, timeout=5)
    response.raise_for_status()
    return response.json()

💡 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.Existe-t-il un environnement de test gratuit pour les développeurs ?
Oui. Utilisez vos clés préfixées par env_test_ pour exécuter des tests d'intégration illimités simulant l'ensemble des statuts et webhooks sans consommer de crédit réel.
Q.Quels sont les codes de retour HTTP en cas d'erreur de requête ?
L'API retourne les codes HTTP standards (400 pour un numéro invalide, 401 pour une clé API non valide, 402 pour un solde insuffisant, 429 pour le rate limiting).

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