WhatsApp

GetMyBot connecte WhatsApp via la WhatsApp Cloud API (Meta Graph API). Une fois connecté, le bot reçoit les messages entrants de WhatsApp et leur applique vos réactions, et les opérateurs peuvent mener des échanges dans les dialogues. Pour un aperçu général du multicanal, voir la page 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 Bots → « Ajouter un canal » → 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.

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

Bots → sur le canal WhatsApp, l'icône « Modèles de messages » (📄) → le dialogue « Modèles du canal WhatsApp ». Le dialogue comporte des boutons :

  • « 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).