Guide : Comment connecter son compte WhatsApp Business API (WABA) au Maroc

L'API officielle WhatsApp Business (WABA) représente le standard institutionnel pour la délivrance de notifications transactionnelles, de codes de vérification (OTP) et d'alertes clients à grande échelle. Contrairement aux passerelles non officielles basées sur l'émulation mobile, l'infrastructure WABA connectée en direct au Cloud API de Meta offre un taux de délivrance optimal, un risque de blocage de ligne bien plus faible, une haute disponibilité et l'éligibilité au badge bleu d'entreprise (attribué à la discrétion de Meta).

Sur EnvoiSMS.ma, l'onboarding d'un compte WhatsApp Business s'effectue directement via le protocole officiel Embedded Signup v3 de Meta. Ce guide détaille l'ensemble du processus technique et administratif pour connecter votre numéro d'entreprise en moins de 5 minutes.

Avant de lancer la procédure de connexion dans votre espace EnvoiSMS.ma, assurez-vous de disposer des éléments suivants :

• Un numéro de téléphone dédié : Ce numéro doit pouvoir recevoir un code de vérification par SMS ou appel vocal standard. Il ne doit pas être actuellement actif sur l'application mobile WhatsApp standard ou WhatsApp Business. Si le numéro est déjà utilisé sur un smartphone, vous devrez préalablement supprimer le compte dans les réglages de l'application mobile WhatsApp (Réglages > Compte > Supprimer mon compte).
• Un compte Facebook personnel administrateur : Vous devez disposer d'un accès administrateur au Meta Business Manager (Gestionnaire d'entreprise) de votre société.
• Les informations légales de l'entreprise : Dénomination sociale exacte (correspondant au Registre du Commerce), adresse du siège social, numéro de téléphone officiel et site internet avec nom de domaine d'entreprise (ex: votre-entreprise.ma).

Le raccordement s'effectue sans aucune saisie manuelle de clés API ou de tokens éphémères :

1. Accédez au Dashboard EnvoiSMS : Rendez-vous dans la section Canaux & Intégrations > WhatsApp et cliquez sur « Connecter un compte WhatsApp Business ».
2. Authentification sécurisée Meta : Une fenêtre modale officielle Meta s'ouvre. Connectez-vous avec votre profil Facebook administrateur.
3. Sélection du Business Manager : Choisissez votre compte d'entreprise Meta existant ou laissez l'assistant en créer un nouveau automatiquement.
4. Configuration du profil WhatsApp Business (WABA) :

• Saisissez le Nom d'affichage (Display Name) officiel de votre marque. Ce nom doit être strictement conforme aux directives de Meta (ex: Pharmacie Centrale Maroc, Atlas Delivery).
• Sélectionnez votre catégorie d'activité (E-commerce, Banque/Finance, Santé, Services professionnels).

1. Vérification du numéro de téléphone : Saisissez votre numéro de téléphone marocain (+212) ou international. Choisissez la réception du code à 6 chiffres par SMS ou par Appel vocal. Entrez le code dans l'interface Meta.
2. Validation et clôture : Cliquez sur Continuer. La fenêtre se ferme et votre compte est instantanément provisionné sur EnvoiSMS.ma.

Dès la validation du flux Embedded Signup, l'architecture EnvoiSMS.ma finalise l'interconnexion automatique avec l'infrastructure Meta :

• Échange OAuth : Le code d'autorisation retourné par Meta est échangé contre un System User Access Token permanent, stocké de manière chiffrée.
• Enregistrement des identifiants : Le waba_id (identifiant de votre compte WhatsApp Business) et le phone_number_id (identifiant du point de terminaison d'envoi) sont associés à votre compte EnvoiSMS.
• Souscription aux Webhooks : Votre numéro est automatiquement abonné aux récepteurs d'événements EnvoiSMS.ma. Vous recevez ainsi en temps réel les accusés de réception (DLR : sent, delivered, read, failed) via nos Webhooks clients.

L'API officielle WhatsApp Business obéit à des règles de conformité strictes définies par Meta :

• Messages initiés par l'entreprise : Tout envoi vers un utilisateur qui n'a pas écrit à l'entreprise au cours des 24 dernières heures doit obligatoirement utiliser un Template pré-approuvé par Meta (catégorisés en AUTHENTICATION pour les OTP, UTILITY pour les statuts de commande/livraison, ou MARKETING pour les offres).
• Fenêtre de session de 24h : Lorsqu'un client vous envoie un message, une session de conversation s'ouvre pendant 24 heures. Durant cet intervalle, vous pouvez lui répondre en texte libre, envoyer des images, des documents PDF ou des formulaires interactifs sans recourir à un template.
• Création des modèles : Vous pouvez soumettre vos templates directement depuis l'interface EnvoiSMS.ma (Campagnes > WhatsApp Templates). La validation par les algorithmes de Meta s'effectue généralement en 1 à 15 minutes.

L'un des atouts de la plateforme EnvoiSMS.ma réside dans son moteur d'orchestration omnicanal. Si un destinataire ne dispose pas d'une connexion Internet active ou si son numéro n'est pas enregistré sur WhatsApp, notre routeur intelligent peut basculer le message de manière déterministe vers le réseau SMS local marocain (Maroc Telecom, Inwi, Orange).

Ce mécanisme de repli garantit un taux de remise proche de 100% pour vos flux critiques tels que les codes OTP d'authentification à deux facteurs et les notifications de livraison urgente.