WhatsApp pour l'onboarding client via l'API : tutoriel pour les éditeurs

Intégrer WhatsApp dans l'onboarding client de votre plateforme commence par comprendre les étapes techniques concrètes : obtenir un accès API, créer un template, envoyer le premier message et recevoir les réponses. Ce tutoriel couvre chaque étape de façon pratique, à destination des équipes techniques d'éditeurs SaaS, CRM ou marketing automation.

Étape 1 : obtenir un accès à l'API WhatsApp Business

Avant d'envoyer le premier message d'onboarding, votre plateforme doit disposer d'un accès à l'API WhatsApp Business via un BSP (Business Solution Provider) certifié Meta.

Option recommandée pour les éditeurs : passer par un Meta Tech Provider

Passer par un Meta Tech Provider comme Whakup vous évite de gérer vous-même la certification Meta, les serveurs WhatsApp et la conformité technique. Vous récupérez directement :

• Un token d'accès API.
• Un phone_number_id associé à votre numéro WhatsApp Business.
• Un endpoint REST pour l'envoi de messages.
• Un mécanisme d'embedded signup pour onboarder vos propres clients.

Ce dont vous avez besoin pour démarrer :

• Un numéro de téléphone dédié (fixe ou mobile, non déjà enregistré sur WhatsApp).
• Un Meta Business Manager vérifié.
• Un compte WhatsApp Business Account (WABA) lié à votre BSP.

Pour le détail de cette configuration initiale, consultez le guide complet de l'API WhatsApp Business.

Étape 2 : créer et soumettre un template d'onboarding

Un template d'onboarding est un message pré-approuvé par Meta que vous pouvez envoyer à tout moment, même si le contact n'a pas initié la conversation.

Créer un template via l'API :

POST https://graph.facebook.com/v18.0/{whatsapp-business-account-id}/message_templates

{
  "name": "onboarding_bienvenue",
  "language": "fr",
  "category": "UTILITY",
  "components": [
    {
      "type": "BODY",
      "text": "Bonjour {{1}}, votre compte {{2}} est activé. Commencez par compléter votre profil : {{3}}"
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "type": "URL",
          "text": "Accéder à mon compte",
          "url": "https://app.votreplateforme.com/onboarding?token={{4}}"
        }
      ]
    }
  ]
}

Points clés :

• category: "UTILITY" pour les messages transactionnels d'onboarding (coût ~0,0336 €/msg FR).
• category: "MARKETING" si le message contient une incitation promotionnelle (coût ~0,08 €/msg FR).
• Les variables {{1}}, {{2}} etc. sont remplacées dynamiquement lors de l'appel d'envoi.
• L'approbation prend généralement quelques heures.

Étape 3 : envoyer le premier message d'onboarding

Une fois le template approuvé, déclenchez l'envoi lors de l'inscription du nouvel utilisateur.

Appel API d'envoi :

POST https://graph.facebook.com/v18.0/{phone-number-id}/messages
Authorization: Bearer {ACCESS_TOKEN}

{
  "messaging_product": "whatsapp",
  "to": "33612345678",
  "type": "template",
  "template": {
    "name": "onboarding_bienvenue",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Sophie" },
          { "type": "text", "text": "MaPlateforme" },
          { "type": "text", "text": "https://app.maplateforme.com/profil" },
          { "type": "text", "text": "abc123token" }
        ]
      }
    ]
  }
}

Réponse attendue :

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "33612345678", "wa_id": "33612345678" }],
  "messages": [{ "id": "wamid.HBgN..." }]
}

Stockez le message_id dans votre base de données pour tracker le statut (livré, lu) via les webhooks.

Étape 4 : configurer les webhooks pour suivre l'onboarding

Les webhooks Meta envoient en temps réel les événements liés aux messages. Pour l'onboarding, les événements critiques sont :

Événement	Signification	Action recommandée
messages.sent	Message envoyé à Meta	Log interne
messages.delivered	Livré sur l'appareil	Marquer comme livré
messages.read	Lu par le destinataire	Avancer dans la séquence
messages.failed	Échec de livraison	Fallback email/SMS
Message entrant	Le client a répondu	Créer ticket ou bot

Configurer l'URL de webhook :

1. Dans le tableau de bord Meta for Developers, section Webhooks.
2. Ajoutez votre URL HTTPS (ex. https://api.votreplateforme.com/webhooks/whatsapp).
3. Choisissez le token de vérification.
4. Abonnez-vous aux champs : messages, message_deliveries, message_reads.

Handler webhook minimal en Node.js :

app.post('/webhooks/whatsapp', (req, res) => {
  const { entry } = req.body;
  entry.forEach(e => {
    e.changes.forEach(change => {
      const { statuses, messages } = change.value;
      if (statuses) handleStatusUpdate(statuses);
      if (messages) handleIncomingMessage(messages);
    });
  });
  res.sendStatus(200);
});

Étape 5 : intégrer l'embedded signup pour vos clients

Si votre plateforme est multi-clients (chaque client a son propre WABA), l'embedded signup permet à chaque client de connecter son numéro WhatsApp en quelques minutes, depuis votre interface.

Flux embedded signup :

1. Votre plateforme affiche un bouton "Connecter WhatsApp".
2. Le client passe par le formulaire Meta embarqué (OAuth) sans quitter votre interface.
3. À l'issue, vous récupérez le waba_id et le phone_number_id du client.
4. Vous associez ces identifiants au compte client dans votre base.

Ce mécanisme élimine toute intervention manuelle et permet de scaler l'onboarding WhatsApp à des dizaines ou centaines de clients simultanément. Pour un aperçu technique détaillé, consultez comment choisir entre build et buy pour l'intégration WhatsApp.

FAQ

Mon équipe doit-elle passer une certification Meta pour utiliser l'API ?

Non. En passant par Whakup, Meta Tech Provider certifié, c'est Whakup qui détient la certification. Votre équipe accède directement à l'API via des credentials délégués, sans aucune démarche de certification.

Peut-on tester l'intégration sans payer de frais Meta ?

Oui. Meta propose un sandbox WhatsApp Business permettant d'envoyer et recevoir des messages en environnement de test sans frais. Les templates y sont simulés. Une fois en production, les frais Meta s'appliquent (0,0248 € utility ou 0,0712 € marketing pour les numéros FR).

Comment gérer plusieurs numéros WhatsApp pour plusieurs clients de ma plateforme ?

L'architecture multi-tenant de Whakup permet d'associer un phone_number_id distinct à chaque client. Chaque client envoie des messages depuis son propre numéro. Les webhooks incluent le phone_number_id dans chaque événement, ce qui permet de router les notifications vers le bon client dans votre système.

Que faire si un message d'onboarding échoue ?

Implémentez un fallback automatique : si le statut passe à failed (numéro non WhatsApp, compte bloqué, etc.), déclenchez l'envoi d'un email ou d'un SMS avec le même contenu. Enregistrez le code d'erreur Meta pour analyse et ajustement de la liste de contacts.

---

Prêt à intégrer WhatsApp dans l'onboarding de votre plateforme ? Accédez à l'API WhatsApp Business de Whakup : documentation REST complète, sandbox de test, embedded signup intégré et support technique dédié aux éditeurs. Démarrez en quelques jours.