Migrer d'un script PHP fait maison vers une API SMS professionnelle : pourquoi et comment

Ce script send_sms.php finit par devenir le cœur névralgique de la communication de l'entreprise. Mais quand la PME grandit, ce "bricolage" devient un goulet d'étranglement qui coûte de l'argent et des clients. Voici pourquoi et comment refactoriser ce code legacy vers une API SMS B2B professionnelle.

Si vous vous reconnaissez dans l'une de ces situations, le refactoring est urgent :

1. La cécité des accusés de réception (DLR) : Votre script envoie le message (HTTP 200 OK) et s'arrête là. Vous n'avez aucune idée si le client a réellement reçu le SMS sur son téléphone. Les Delivery Reports (DLR) sont inexistants.
2. Le blocage Synchrone (Timeout) : Votre script PHP s'exécute de manière synchrone. S'il y a 500 SMS à envoyer lors d'une boucle foreach, la page web du client (ou du logiciel) "tourne dans le vide" pendant 3 minutes jusqu'à ce que le serveur affiche une erreur 504 Gateway Timeout.
3. Le désastre Unicode (Darija / Arabe) : Dès qu'un utilisateur tape un émoji ou une lettre accentuée, le SMS arrive avec des points d'interrogation (???) parce que la gestion de l'encodage GSM-7 vs UCS-2 n'a pas été codée proprement.
4. Le risque légal (CNDP) : Le script n'inclut aucune logique de désabonnement. Si un client répond "STOP", il n'y a aucun Webhook pour l'écouter. Vous continuez à le spammer, vous exposant aux sanctions de la CNDP.

La migration vers une plateforme professionnelle comme EnvoiSMS ne consiste pas juste à changer l'URL de la requête API. C'est l'occasion d'adopter une architecture asynchrone.

L'ancienne méthode (À bannir) :

foreach ($clients as $client) {
    // Le script attend la réponse pour CHAQUE client. Catastrophe de performance.
    file_get_contents("http://api-obscure.com/send?to=".$client['tel']."&msg=Promo");
}

La nouvelle méthode (L'API Professionnelle en Asynchrone) :
Plutôt que d'envoyer 500 requêtes HTTP (qui vont tuer vos ressources serveur), utilisez le endpoint d'Envoi en Masse (Bulk) d'une API moderne.
Vous construisez un seul Payload JSON contenant les 500 numéros, et vous faites UNE seule requête HTTP.

$payload = [
    "sender_id" => "MA_MARQUE",
    "message" => "Promo du jour : -20% sur tout le magasin !",
    "recipients" => ["+212600000001", "+212600000002", /* ... 498 autres numéros */]
];

$ch = curl_init('https://api.envoisms.ma/v1/sms/bulk');
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Authorization: Bearer VOTRE_TOKEN_ICI'));
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
$response = curl_exec($ch);
// La plateforme d'EnvoiSMS se charge de la file d'attente (Queuing) de son côté.

Déléguez la complexité. Ne demandez plus à votre code PHP de vérifier si le SMS est arrivé.
Configurez un routeur (Endpoint) sur votre serveur : https://votre-site.ma/api/sms-webhook.
Fournissez cette URL à EnvoiSMS.

C'est la plateforme qui va "Pousser" (POST) l'information vers votre serveur dès que Maroc Telecom ou inwi confirme la réception. Vous n'avez plus qu'à insérer cette donnée propre dans votre base de données :

// Fichier webhook.php
$data = json_decode(file_get_contents('php://input'), true);
if ($data['status'] === 'DELIVERED') {
    // Mettre à jour la BDD : UPDATE sms_logs SET status = 'reçu' WHERE id = ?
}

Migrer un script maison vers une API professionnelle n'est pas un coût supplémentaire : c'est l'assurance-vie de l'intégrité de vos bases de données et de l'expérience de vos utilisateurs marocains.