Expertise technical

Migrer de Vonage/Nexmo vers EnvoiSMS : checklist complète

Migrer vonage nexmo envoisms : guide technique avec exemples de code pour les développeurs au Maroc.

sms marocapi smsotp maroc
Migrer de Vonage/Nexmo vers EnvoiSMS : checklist complète

De nombreuses entreprises marocaines et centres d'appels utilisent Vonage (anciennement Nexmo) pour leurs envois de [SMS en masse](/fr/cas-usage/marketing) ou leurs alertes transactionnelles. Nexmo a longtemps été la référence des développeurs pour sa simplicité.

Cependant, face à l'augmentation des [frais de routage vers le Maroc (+212)](/fr/tarifs/) par les agrégateurs mondiaux et au besoin de [conformité CNDP](/fr/blog/cndp-et-sms-marketing-au-maroc-ce-qu-il-faut-vraiment-savoir/) (hébergement local des données), la migration vers une API souveraine comme EnvoiSMS devient stratégique. La transition entre deux API REST est rapide, mais requiert une attention particulière sur le formatage des données. Voici la checklist technique de migration.

1. Mappez vos paramètres API (Le dictionnaire de traduction)

L'API de Vonage et l'[API EnvoiSMS](/fr/api/) utilisent des conventions de nommage différentes dans leurs payloads JSON. Voici l'équivalence stricte à implémenter dans votre code : | Paramètre Vonage (Nexmo) | Équivalent EnvoiSMS | Type de donnée | | :--- | :--- | :--- | | `api_key` / `api_secret` | `Authorization: Bearer <Token>` | Header HTTP (Sécurité renforcée) | | `from` | `sender_id` | String (Max 11 caractères alphanumériques) | | `to` | `recipient` | String (Format E.164 : +2126XXXXXX) | | `text` | `message` | String (Supporte GSM-7 et Unicode) | | `type="unicode"` | *(Automatique)* | EnvoiSMS détecte l'UTF-8 nativement | *Note sur l'authentification :* Nexmo accepte souvent l'API Key dans l'URL (GET) ou le Body (POST). Pour des raisons de standard de sécurité moderne, EnvoiSMS exige le passage du token dans le Header HTTP d'autorisation.

2. Gérez vos Sender ID (Le piège classique)

Sur Nexmo, pour envoyer un SMS en France ou au Royaume-Uni, vous pouvez souvent inventer le champ `from` à la volée dans votre code. Au Maroc, le marché est régulé (Sender ID Whitelisting). **Avant de modifier votre code :** Vous devez demander au support EnvoiSMS de [valider et enregistrer officiellement votre "Nom d'expéditeur"](/fr/blog/comment-obtenir-un-sender-id-alphanumerique-au-maroc-en-2026/) auprès des opérateurs marocains (IAM, inwi, Orange). Cette validation prend environ 24h. Si vous omettez cette étape, vos SMS génèreront une erreur `403 Forbidden` ou seront bloqués par les filtres télécoms locaux.

3. Adaptez la gestion des Webhooks (DLR - Accusés de réception)

Si vous utilisez les Delivery Receipts (DLR) de Vonage pour mettre à jour le statut de vos envois dans votre CRM (ex: marquer un [code OTP](/fr/guides/otp-authentication-maroc/) comme reçu), le format de retour (Callback) va changer. Vonage envoie souvent un paramètre `status` (ex: `delivered`, `failed`). Avec EnvoiSMS, configurez l'URL de votre Webhook dans le tableau de bord. Votre serveur (Endpoint) recevra un payload JSON standardisé : ```json { "message_id": "msg_8f7d6c5b", "status": "DELIVERED", "recipient": "+212600000000", "timestamp": "2026-10-15T14:32:01Z" } ``` Assurez-vous de modifier le contrôleur de votre application (Express.js, Laravel, Spring) pour parser ces nouvelles clés JSON.

4. La Période de Transition (Le "Shadow Testing")

Ne coupez pas Nexmo du jour au lendemain. Appliquez le principe de la bascule sécurisée : 1. **Semaine 1 (Test en double) :** Branchez EnvoiSMS uniquement sur vos environnements de Staging / Pré-production. 2. **Semaine 2 (Bascule Transactionnelle) :** Passez 100% de vos [SMS Marketing (Push promotionnel)](/fr/cas-usage/marketing) sur EnvoiSMS, car ils sont moins critiques à la seconde près. 3. **Semaine 3 (Bascule OTP) :** Si les campagnes marketing fonctionnent parfaitement avec un bon taux de `DELIVERED`, basculez vos flux critiques (Mots de passe oubliés, alertes serveurs). En migrant vers un acteur local, vous ne changez pas seulement quelques lignes de code JSON : vous supprimez les sauts de réseaux internationaux (Hops) de Nexmo, ce qui diminue structurellement la latence de livraison sur les téléphones marocains.

💡 Pourquoi choisir EnvoiSMS pour votre entreprise ?

⚡

Délivrabilité Critique

Moins de 4 secondes pour vos OTP via des canaux directs opérateurs IAM, Inwi et Orange Maroc.

💰

Optimisation du Budget

WhatsApp Business API à 0,13 MAD seulement par session. Le meilleur ROI conversationnel.

🛡️

Données Souveraines (CNDP)

Hébergement conforme aux réglementations de protection des données personnelles locales.