Base de connaissances GetMyBot

WhatsApp

Le canal WhatsApp dans GetMyBot : connexion via la Cloud API, configuration du webhook dans Meta, la fenêtre de 24 heures, les modèles de messages et leur usage dans les réactions.

Sur cette page

Connectez votre numéro WhatsApp Business pour que le bot réponde aux messages selon vos réactions et qu’un opérateur puisse poursuivre la conversation depuis le compte. GetMyBot utilise WhatsApp Cloud API, l’interface officielle de Meta. Les identifiants nécessaires sont détaillés ci-dessous.

WhatsApp impose une limite : une réponse libre ne peut être envoyée que pendant les 24 heures suivant le message du client. Au-delà, un rappel exige un modèle approuvé. Pour les règles communes aux messageries, voir Canaux.

Connexion d'un canal WhatsApp

La connexion nécessite cinq identifiants de votre application Meta (WhatsApp Cloud API). Tous sont obligatoires :

  • Phone number ID — l'identifiant du numéro WhatsApp Business.
  • WABA ID — l'identifiant du WhatsApp Business Account.
  • Access token — le jeton d'accès de l'application Meta.
  • Verify token — une chaîne arbitraire que vous inventez vous-même. Elle sert à la vérification du webhook dans Meta (voir ci-dessous).
  • App secret — le secret de l'application Meta. Il est nécessaire pour vérifier la signature HMAC des webhooks entrants (en-tête X-Hub-Signature-256).

Étapes dans l'interface :

  1. Ouvrez Projets, trouvez le projet voulu, cliquez sur Ajouter un canal, puis choisissez WhatsApp.
  2. Remplissez les cinq champs ci-dessus et, si vous le souhaitez, un nom de canal (facultatif).
  3. Cliquez sur « Vérifier » — GetMyBot valide les identifiants auprès de Meta.
  4. Cliquez sur « Connecter ».

Configuration du webhook dans Meta

Après la connexion, le canal reçoit une Callback URL de la forme {adresse}/ch/{channelID} (dans l'interface — l'icône de webhook 🔗). Elle doit être renseignée avec votre Verify token dans l'application Meta : WhatsApp → Configuration → Webhook.

Comment ça fonctionne :

  1. Meta envoie à la Callback URL une requête de vérification et compare le verify_token transmis à votre Verify token. En cas de correspondance, le webhook est considéré comme confirmé.
  2. Ensuite Meta envoie à cette adresse des événements (messages entrants, statuts de livraison, verdicts de modération des modèles).
  3. Chaque requête entrante est signée par l'en-tête X-Hub-Signature-256 ; GetMyBot vérifie la signature à l'aide de l'App secret — c'est pourquoi cet identifiant est requis à la connexion.

La fenêtre de session de 24 heures

WhatsApp limite les échanges à l'initiative du bot : les messages libres ne peuvent être envoyés à un utilisateur que dans les 24 heures suivant son dernier message entrant. Chaque nouveau message entrant de l'utilisateur renouvelle la fenêtre.

En dehors de la fenêtre de 24 heures, il est impossible d'envoyer un message libre — le seul moyen de recontacter l'utilisateur (re-engagement) est un modèle de message approuvé. C'est pourquoi les modèles sont l'outil clé pour les diffusions et les rappels sur WhatsApp.

Par exemple, si le client écrit lundi à 15 h, les réponses libres sont autorisées jusqu’à mardi 15 h, sauf s’il écrit de nouveau. Un nouveau message du client rouvre la fenêtre de 24 heures.

Modèles de messages

Un modèle de message (message template) est un message préalablement approuvé par Meta, qui peut être envoyé en dehors de la fenêtre de session. La gestion des modèles se fait dans l'interface de GetMyBot.

Où gérer les modèles

Sur la page Projets, cliquez sur Modèles de messages (icône 📄) du canal WhatsApp pour ouvrir Modèles du canal WhatsApp. La fenêtre comporte :

  • « Créer un modèle » — composer un nouveau modèle.
  • « Synchroniser » — récupérer le catalogue de modèles depuis Meta (actualiser les statuts et la liste).

Catégories de modèles

  • MARKETING (Marketing) — promotions, annonces, diffusions.
  • UTILITY (Service) — notifications liées aux actions de l'utilisateur (statuts de commande, rappels).
  • AUTHENTICATION (Authentification) — codes de confirmation.

Champs d'un modèle

  • Nom — lettres latines minuscules, chiffres et _, jusqu'à 512 caractères.
  • Langue — une locale Meta.
  • Catégorie — l'une des trois ci-dessus.

Pour les catégories Marketing et Service, en plus :

  • En-tête — aucun / texte / image / vidéo / document. Pour un en-tête média, un fichier d'exemple est téléversé.
  • Corps — obligatoire, jusqu'à 1024 caractères. Les variables sont notées {{1}}, {{2}}, … strictement dans l'ordre de 1 à N, sans trous.
  • Pied de page — jusqu'à 60 caractères.
  • Boutons — jusqu'à 10 : réponse rapide, lien (jusqu'à 2), téléphone (1), copie de code (1).
  • Pour chaque variable {{n}}, il faut fournir une valeur d'exemple — c'est une exigence de Meta pour la modération.

Pour la catégorie Authentification, le corps est fixé par Meta elle-même ; on configure : la durée de validité du code (1–90 minutes), la recommandation de sécurité et le texte du bouton de copie du code.

Modération

Le bouton « Créer » envoie aussitôt le modèle à la modération de Meta — il n'y a pas d'étape séparée « envoyer à la vérification ». Le verdict arrive de façon asynchrone (via le webhook), la liste des modèles se rafraîchit automatiquement. Statuts :

  • PENDING (En vérification)
  • APPROVED (Approuvé)
  • REJECTED (Rejeté) — avec indication du motif
  • ainsi que PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

On peut modifier les modèles dans les statuts APPROVED, REJECTED, PAUSED. Le nom et la langue ne peuvent pas être changés ; pour les modèles approuvés, la catégorie est également verrouillée.

Utilisation d'un modèle dans une réaction

L'envoi d'un modèle est une action de réaction :

  1. Dans le constructeur de réaction, ouvrez « Actions » → « Ajouter une action » → « Envoyer un modèle WhatsApp ».
  2. L'action n'est disponible que si le bot dispose d'un canal WhatsApp connecté prenant en charge les modèles.
  3. Seul un modèle approuvé (APPROVED) peut être sélectionné.
  4. On renseigne les paramètres : les valeurs des variables {{n}} dans le corps, l'en-tête texte, l'en-tête média par lien, les paramètres des boutons URL. Dans les paramètres, on peut utiliser des substitutions de variables.

Le canal d'envoi réel est déterminé par le canal de l'événement : si l'événement provient de WhatsApp, le modèle part vers WhatsApp.

Dialogues et pièces jointes

Un opérateur peut répondre dans un dialogue WhatsApp et envoyer des pièces jointes — image, vidéo ou document — en tenant compte de la fenêtre de 24 heures (hors fenêtre, l'échange libre est indisponible). Les médias entrants des abonnés sont chargés via un proxy et affichés dans le dialogue.

Tarification

GetMyBot tient le compte des conversations WhatsApp (conversations) par catégorie — marketing / utility / authentication / service. Dans la version actuelle, c'est uniquement un enregistrement à des fins d'observabilité (record-only) : aucun solde n'est débité pour les conversations.

Pour aller plus loin

  • Canaux — multicanal et matrice des capacités.
  • Réactions : les bases — comment construire le comportement du bot.
  • Diffusions — envoi en masse (sur WhatsApp — via des modèles approuvés).