Guide complet : configurer l'API WhatsApp Cloud pour votre entreprise au Maroc

Mettre en place l'API WhatsApp Cloud demande un compte Meta Business, une application dans le Meta Developer Portal, un numéro de téléphone dédié, la vérification de votre entreprise, puis la configuration d'un webhook pour recevoir les messages. Ce guide déroule chaque étape, avec un exemple d'envoi de message en Python, jusqu'au passage en production.

Réponse rapide : pour configurer l'API WhatsApp Cloud au Maroc, créez une application Business dans le Meta Developer Portal, ajoutez le produit WhatsApp, récupérez le Phone Number ID et un token, envoyez un message template de test, puis branchez un webhook HTTPS pour recevoir les messages. Vérifiez ensuite votre entreprise pour passer en production avec un numéro et un nom officiels.

Prérequis

Avant de commencer, réunissez :

• un compte Meta Business (business.facebook.com) au nom de votre entreprise ;
• un numéro de téléphone dédié, non associé à un compte WhatsApp existant ;
• les documents légaux de l'entreprise (registre de commerce) pour la vérification ;
• un serveur capable d'exposer une URL HTTPS publique pour le webhook.

Étape 1 — Créer l'application dans le Meta Developer Portal

1. Rendez-vous sur developers.facebook.com et connectez-vous.
2. Créez une application de type Business.
3. Ajoutez le produit WhatsApp à l'application.
4. Associez votre compte Meta Business.

Meta vous fournit alors un numéro de test et un token temporaire (24 h) pour vos premiers essais.

Étape 2 — Récupérer les identifiants clés

Dans le tableau de bord WhatsApp de l'application, notez :

• le Phone Number ID (identifiant du numéro) ;
• le WhatsApp Business Account ID (WABA ID) ;
• le token d'accès (temporaire pour tester, puis permanent via un utilisateur système).

Étape 3 — Envoyer votre premier message (Python)

Le premier contact avec un client doit toujours passer par un modèle (template) approuvé. Exemple avec le modèle par défaut hello_world :

import requests

PHONE_NUMBER_ID = "VOTRE_PHONE_NUMBER_ID"
TOKEN = "VOTRE_TOKEN"
DESTINATAIRE = "2126XXXXXXXX"  # format international, sans +

url = f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages"
headers = {"Authorization": f"Bearer {TOKEN}", "Content-Type": "application/json"}
payload = {
    "messaging_product": "whatsapp",
    "to": DESTINATAIRE,
    "type": "template",
    "template": {"name": "hello_world", "language": {"code": "en_US"}},
}

r = requests.post(url, headers=headers, json=payload)
print(r.status_code, r.json())

Un code 200 et un message_id confirment l'envoi.

Étape 4 — Configurer le webhook (recevoir les messages)

Le webhook est indispensable : c'est lui qui vous notifie des messages entrants et des statuts (livré, lu).

1. Exposez une URL HTTPS publique (votre backend, ou un tunnel comme ngrok pour tester).
2. Dans l'application → WhatsApp → Configuration, renseignez l'URL de rappel et un verify token (chaîne secrète de votre choix).
3. Meta envoie une requête GET de vérification : votre serveur doit renvoyer le paramètre hub.challenge si le verify_token correspond.

Exemple minimal avec Flask :

from flask import Flask, request

app = Flask(__name__)
VERIFY_TOKEN = "mon_secret"

@app.route("/webhook", methods=["GET"])
def verify():
    if request.args.get("hub.verify_token") == VERIFY_TOKEN:
        return request.args.get("hub.challenge"), 200
    return "Forbidden", 403

@app.route("/webhook", methods=["POST"])
def receive():
    data = request.get_json()
    # Traiter les messages entrants ici
    print(data)
    return "OK", 200

4. Abonnez l'application au champ messages pour recevoir les événements.

Étape 5 — Vérifier votre entreprise (Business Verification)

Pour dépasser les limites du mode test, Meta exige la vérification d'entreprise : upload des documents légaux et confirmation de l'adresse. Au Maroc, préparez le registre de commerce et un justificatif au nom exact de l'entité. Comptez de quelques jours à deux semaines.

Étape 6 — Passer en production

• Enregistrez votre numéro définitif et définissez le nom d'affichage (soumis à validation Meta).
• Générez un token permanent via un utilisateur système (ne jamais laisser un token temporaire en production).
• Créez et faites approuver vos templates (marketing, utility, authentication).
• Branchez le tout sur votre CRM et, si besoin, un agent IA (réponses en darija, routage, paiement CMI en MAD).

Récapitulatif des étapes

Questions fréquentes

Faut-il savoir coder pour utiliser l'API ? Pour un usage avancé (CRM, IA), oui, ou passer par un intégrateur. Pour un usage simple, certaines plateformes s'appuient sur l'API sans code.

Le webhook doit-il tourner en HTTPS ? Oui, obligatoirement. Meta n'accepte que des URL sécurisées.

Combien de temps prend la vérification d'entreprise au Maroc ? Généralement de quelques jours à deux semaines, selon la conformité des documents fournis.

Peut-on utiliser un numéro déjà présent sur WhatsApp ? Non, pas s'il est actif sur l'application classique. Prévoyez un numéro dédié à l'API.

Aller plus loin

Un déploiement solide ne s'arrête pas au premier message : il connecte WhatsApp à vos outils métier et à des agents gouvernés. Découvrez notre pratique d'intégration IA, ou parlez de votre projet à un consultant Hunter BI pour un déploiement clé en main (webhook, CRM, agent IA en darija).