Guide de configuration du plugin WhatsApp (Webmecanik Automation) 💬 – Webmecanik

Ce guide vous détaille la configuration des cinq champs du plugin (Automation → Plugins → Messages Whatsapp), ainsi que les prérequis à paramétrer au préalable dans Meta.

Champ du plugin	Provenance dans Meta
Jeton d'accès (Access token)	Jeton d'utilisateur système à longue durée de vie (voir Étape 2). Le jeton de l'étape 1. Essayer est temporaire (24h) et ne sert qu'à un test manuel rapide.
ID du compte WhatsApp Business	Application → Cas d'utilisation → Connexion avec WhatsApp → Étape 1. Essayer → ID du compte WhatsApp Business
ID du numéro de téléphone	Même panneau → ID du numéro de téléphone (l'identifiant numérique, pas le numéro de téléphone lui-même)
Clé secrète de l'application (App secret)	Application → Paramètres de l'application → Basique → Clé secrète de l'application → Afficher
Jeton de vérification Webhook	Une chaîne de caractères de votre choix. La même valeur doit être saisie côté Meta (voir étape 4).

0. Avant de commencer — Créer l'application Meta 🛠️

Les instructions ci-dessous supposent que vous disposez déjà d'une application Meta intégrant le cas d'usage WhatsApp, d'un compte WhatsApp Business et d'un numéro de téléphone. Si vous partez de zéro, réalisez d'abord ces étapes.

0.1 — Portfolio d'entreprise (Business Portfolio)

L'application et le compte WhatsApp Business doivent être rattachés à un portfolio d'entreprise sur business.facebook.com. Créez-en un si votre compte n'en possède pas encore.

0.2 — Créer l'application

Rendez-vous sur developers.facebook.com → Mes applications → Créer une application. Indiquez un nom et un e-mail de contact.

⚠️ Attention : Le nom de l'application ne doit pas contenir le mot « whatsapp » (Meta refuse l'utilisation de ses marques déposées). Choisissez un nom comme Automation messaging.

0.3 — Sélectionner le cas d'utilisation

À l'étape suivante, cochez Entrer en contact avec des clients via WhatsApp, puis finalisez l'assistant. Cela ajoute la section Connexion avec WhatsApp dans laquelle se déroulent les étapes suivantes.

0.4 — Compte WhatsApp Business et numéro de téléphone

Lors de cette configuration, Meta crée un nouveau compte WhatsApp Business (WABA) ou connecte un compte existant, puis met à disposition un numéro de test. Ce numéro de test ne peut envoyer des messages qu'à un panel restreint de destinataires pré-enregistrés.

Pour votre trafic réel, enregistrez votre propre numéro : Cas d'utilisation → Connexion avec WhatsApp → Étape 2. Configuration pour la production → Enregistrer votre numéro de téléphone WhatsApp.

Ajoutez également un moyen de paiement dans ce même panneau 💳. Sans moyen de paiement configuré, seules les réponses envoyées dans la fenêtre de service client de 24h seront transmises, et vos envois de campagnes échoueront.

0.5 — Vérification de l'entreprise et publication de l'application 🛑

L'étape 3. Vérification de l'entreprise est requise pour sortir du mode de test, et l'application elle-même doit être publiée. Tant qu'elle reste non publiée, Meta ne délivre que les Webhooks de test déclenchés depuis le tableau de bord : aucun reçu de distribution ni aucun désabonnement ne parviendra à votre instance.

1. ID du compte WhatsApp Business et ID du numéro de téléphone 🆔

Rendez-vous dans Application → Cas d'utilisation → Connexion avec WhatsApp → Étape 1. Essayer. Les deux identifiants se trouvent à côté du numéro. Ce même panneau contient également le jeton temporaire si vous souhaitez effectuer un test API rapide.

2. Jeton d'accès — Utiliser un jeton d'utilisateur système 🔑

Accédez à business.facebook.com → Paramètres d'entreprise → Utilisateurs → Utilisateurs système → sélectionnez (ou ajoutez) l'utilisateur système → Générer un jeton.

Associez au préalable l'application et le compte WhatsApp Business à cet utilisateur système, sinon le jeton ne pourra pas envoyer de messages.

Autorisations requises :

whatsapp_business_messaging
whatsapp_business_management

Contrairement au jeton temporaire de 24h issu de l'étape Essayer, un jeton d'utilisateur système n'expire pas.

3. Clé secrète de l'application (App secret) 🔒

Rendez-vous dans Application → Paramètres de l'application → Basique → Clé secrète de l'application → Afficher.

Ce champ est obligatoire. La vérification de signature du webhook est stricte : si la clé secrète est manquante ou erronée, chaque notification envoyée par Meta recevra une erreur 403 Invalid signature. Les reçus de distribution et les désabonnements seront alors rejetés silencieusement.

4. URL de rappel (Callback URL) et jeton de vérification (côté Meta) 🔗

Accédez à Application → Cas d'utilisation → Connexion avec WhatsApp → Étape 2. Configuration pour la production → Configurer les Webhooks.

URL de rappel (Callback URL) : https://<domaine-de-votre-instance>/whatsapp/message/callback
Jeton de vérification (Verify token) : La même chaîne de caractères que celle saisie dans le champ Jeton de vérification Webhook du plugin Webmecanik.

Cliquez sur Vérifier et enregistrer. Meta interroge l'URL avec les paramètres hub.mode=subscribe&hub.verify_token=…&hub.challenge=… et le plugin renvoie la valeur challenge si le jeton correspond.

ℹ️ Remarque : Une application ne dispose que d'une seule URL de rappel. Si vous la pointez vers une instance de production, vos tunnels de développement local (type ngrok) ne recevront plus les webhooks.

5. Abonnement aux champs du Webhook (côté Meta) 🔔

Dans ce même panneau, sous la section Champs du Webhook, abonnez-vous uniquement au champ messages.

Les statuts de distribution (envoyé, distribué, lu, échec) ainsi que les réponses aux boutons (désabonnement) sont tous transmis sous ce champ. Le plugin ignore l'ensemble des autres événements.

⚠️ Points d'attention récapitulatifs

L'application doit être publiée (étape 0.5). En mode développement, seuls les webhooks de test du tableau de bord Meta sont distribués.
La clé secrète (App secret) est obligatoire (étape 3).
N'utilisez pas le jeton temporaire pour la configuration de votre instance. Il expire au bout de 24h et les envois échoueront avec une erreur d'authentification.
Un moyen de paiement est nécessaire pour déclencher l'envoi de messages initiés par l'entreprise (les envois de campagnes).