API WhatsApp pour les SaaS e-commerce : tutoriel 2026

Intégrer l'API WhatsApp Business dans un SaaS e-commerce se décompose en étapes techniques précises : création du compte Meta, configuration du numéro, exposition des webhooks, envoi du premier template. Ce tutoriel couvre chaque étape dans l'ordre, en ciblant les équipes techniques d'éditeurs SaaS.

Étape 1 — Prérequis et compte Meta Business

Avant d'écrire la moindre ligne de code, vous avez besoin de :

• Un compte Meta Business Manager vérifié (vérification d'identité entreprise, 1 à 3 jours ouvrés).
• Un numéro de téléphone dédié non encore utilisé sur WhatsApp (mobile ou fixe, France ou autre pays).
• Un Meta Tech Provider ou accès direct à la Cloud API Meta (pour les éditeurs SaaS, passer par un provider comme Whakup simplifie drastiquement l'onboarding — voir la section dédiée).

Si votre SaaS embarque l'onboarding client en marque blanche, l'Embedded Signup permet à vos marchands de connecter leur WABA depuis votre interface sans quitter votre produit. Ce flux est documenté en détail dans le guide sur l'Embedded Signup WhatsApp.

Étape 2 — Configuration du numéro et premier message test

Une fois le WABA (WhatsApp Business Account) créé et le numéro enregistré, récupérez deux identifiants critiques dans le Meta Business Manager :

• phone_number_id : l'ID du numéro WhatsApp côté API.
• waba_id : l'ID du compte Business WhatsApp.
• access_token : jeton d'accès permanent (System User token recommandé pour la production).

Pour le guide complet sur ces identifiants, voir Phone Number ID et WABA ID : à quoi servent-ils ?.

Premier appel API — envoi d'un message template :

curl -X POST \
  "https://graph.facebook.com/v19.0/{phone_number_id}/messages" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "33612345678",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "fr" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "CMD-2026-00123" },
            { "type": "text", "text": "89,90 €" }
          ]
        }
      ]
    }
  }'

Une réponse 200 avec un messages[0].id confirme l'envoi. Le statut réel de livraison arrive via webhook.

Étape 3 — Configuration des webhooks

Les webhooks Meta poussent vers votre endpoint les événements suivants : messages entrants, statuts de livraison (sent, delivered, read, failed), changements de statut de numéro.

Configuration dans Meta Business Manager :

1. URL du webhook : https://votre-saas.com/webhooks/whatsapp
2. Token de vérification : une chaîne aléatoire que Meta envoie lors du handshake initial.
3. Champs à souscrire : messages, message_deliveries, message_reads.

Endpoint de vérification (GET) :

@app.route('/webhooks/whatsapp', methods=['GET'])
def verify_webhook():
    mode = request.args.get('hub.mode')
    token = request.args.get('hub.verify_token')
    challenge = request.args.get('hub.challenge')
    if mode == 'subscribe' and token == VERIFY_TOKEN:
        return challenge, 200
    return 'Forbidden', 403

Endpoint de réception (POST) :

Vérifiez systématiquement la signature X-Hub-Signature-256 avant de traiter le payload. Retournez un 200 OK immédiatement et traitez le message de manière asynchrone (queue Redis, Celery, BullMQ, etc.) pour éviter les timeouts Meta.

Étape 4 — Gestion des templates et du multi-tenant

Dans un SaaS e-commerce multi-marchands, chaque marchand dispose de son propre WABA et de ses propres templates. Votre architecture doit gérer :

Ressource	Par plateforme	Par marchand (WABA)
Access token	Non	Oui (System User par WABA)
Templates HSM	Non (soumis par WABA)	Oui
Numéro WhatsApp	Non	Oui (1 à N numéros)
Webhooks	Oui (endpoint partagé, routage par WABA ID)	Non

Pour le multi-tenant, un endpoint webhook unique est préférable : vous routez les événements entrants en fonction du metadata.phone_number_id ou du metadata.display_phone_number présent dans chaque payload.

Les règles de catégorisation des templates (marketing vs. utility vs. authentication) impactent directement la facturation. Consultez le guide complet sur les templates WhatsApp et leurs catégories pour structurer vos templates correctement dès la soumission.

Passer par Whakup : réduire le temps d'intégration

Si vous ne souhaitez pas gérer directement la relation Meta (création d'app, audit, gestion des tokens système), Whakup expose une API REST + webhooks unifiés au-dessus de la Cloud API Meta.

Avantages pour un éditeur SaaS :

• Un seul endpoint d'envoi, indépendamment du nombre de WABA gérés.
• Embedded Signup prêt à l'emploi pour l'onboarding de vos marchands.
• Hébergement EU, conformité RGPD, SLA documenté.
• Tarif transparent : 0,0088 €/message (frais Whakup) + frais Meta selon la catégorie du template.

Accédez à la documentation et démarrez l'intégration via l'API WhatsApp Whakup pour SaaS e-commerce.

Pour comprendre les avantages comparatifs entre construire sa propre infrastructure et passer par un provider, lisez Build vs. Buy WhatsApp API.

FAQ

Combien de temps prend la validation d'un template WhatsApp ?

Meta valide les templates HSM généralement en quelques heures (souvent moins de 24h en semaine). Le délai peut s'allonger si le template contient des variables inhabituelles ou un contenu ambigu. Soumettez les templates en avance pour ne pas bloquer votre go-live.

Peut-on envoyer des messages WhatsApp sans template approuvé ?

Oui, dans la fenêtre de session de 24 heures après qu'un utilisateur vous a contacté. Hors de cette fenêtre, seuls les templates pré-approuvés peuvent initier une conversation. Pour les flux e-commerce (relance, notification), vous aurez donc systématiquement besoin de templates.

Comment tester l'intégration sans numéro WhatsApp en production ?

Meta propose un numéro de test dans le Business Manager (limité à 5 destinataires de test). Pour des tests plus poussés, Whakup met à disposition un environnement sandbox documenté permettant de simuler les envois et les événements webhook sans frais Meta.

Quel langage ou framework pour implémenter les webhooks WhatsApp ?

N'importe quel framework HTTP suffit : Node.js/Express, Python/FastAPI, PHP/Laravel, Ruby on Rails. L'essentiel est de répondre au GET de vérification Meta et de traiter les POST de manière asynchrone. Les SDKs officiels Meta existent pour Node.js et Python.