PHP SMS API Maroc : Tutoriel Complet avec Code Source et Webhooks

Pour envoyer des SMS depuis votre application PHP au Maroc, créez un compte sur EnvoiSMS.ma et générez une clé API dans l'onglet Développeurs. Vos requêtes s'authentifient via l'en-tête HTTP Authorization: Bearer env_live_... vers notre endpoint sécurisé.

Voici un exemple minimaliste et robuste en PHP pur :

$ch = curl_init('https://api.envoisms.ma/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer env_live_VOTRE_CLE',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'recipient' => '+212612345678',
        'message' => 'Votre code de confirmation est 849201.',
        'sender_id' => 'VOTREMARQUE'
    ])
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);

Avant tout appel API, nettoyez les saisies utilisateurs. Au Maroc, les numéros commencent souvent par 06 ou 07. Une fonction de regex simple permet de convertir 0612345678 en +212612345678. EnvoiSMS valide également automatiquement les plages attribuées par l'ANRT.

Configurez un script webhook.php pour recevoir les accusés de réception. Récupérez le corps brut de la requête (file_get_contents('php://input')) et vérifiez la signature HMAC transmise dans $_SERVER['HTTP_X_ENVOISMS_SIGNATURE'] avant d'enregistrer le statut en base de données.

Ne bloquez pas le thread principal de votre serveur web : déléguez les envois de SMS à un gestionnaire de files d'attente (Redis, RabbitMQ ou worker CLI). Journalisez les message_id pour faciliter le rapprochement comptable et technique.