Glossaire de l'automatisation WhatsApp : déclencheurs, étapes, reprise en main, fenêtre de 24 heures et plus
L'automatisation WhatsApp a son propre vocabulaire. Un déclencheur détermine ce qui lance une automatisation : un message, un tag ou un appel de webhook, les étapes décident de ce qui est renvoyé, la reprise en main la met en pause lorsqu'une personne répond depuis le téléphone, et la fenêtre de 24 heures détermine quand des réponses autres que des templates peuvent partir. Les templates, l'opt-in, les statuts d'exécution, les motifs d'exécution ignorée et les webhooks signés complètent le tableau, et chaque terme est expliqué ici en une ligne.
easyCoexistence connecte votre numéro WhatsApp Business à la Cloud API de Meta via Coexistence et y fait tourner des automatisations avec le vocabulaire ci-dessus : quatre critères de correspondance, 19 types d'étapes, une reprise en main lorsque vous répondez depuis le téléphone, et un journal d'exécution sur 30 jours avec motifs d'exécution ignorée.
Façons dont une automatisation WhatsApp sélectionne les messages entrants : Tout message, Contient un mot-clé, Premier message et Hors horaires.
Types d'étapes sur un numéro, de Répondre par texte et Envoyer un template à Poser une question, Diviser en chemins et Agent répond.
Nombre maximal d'étapes qu'une ligne d'une automatisation peut contenir, 60 au total, avec des embranchements imbriqués sur 4 niveaux au maximum.
Fenêtre de service client de Meta : les messages hors template ne sont autorisés que dans les 24 heures suivant le dernier message du client.
Catégories de templates de Meta : marketing, utilitaire et authentification.
Motifs d'exécution ignorée qu'une exécution peut afficher, d'une réponse récente depuis votre téléphone à une clé IA qui a cessé de fonctionner.
Quels termes décrivent la connexion derrière les automatisations ?
Les automatisations tournent sur un numéro connecté à l'API de Meta, tout en restant dans l'application WhatsApp Business. Ces six termes décrivent cette connexion et là où vont les messages entrants du numéro :
- Coexistence : l'onboarding de Meta qui connecte un numéro déjà présent dans l'application WhatsApp Business à la Cloud API, pour que l'application et le logiciel partagent le numéro et ses discussions.
- Cloud API : l'API hébergée de Meta pour envoyer et recevoir des messages WhatsApp Business ; la voie officielle pour les logiciels.
- Mode de réception : là où vont les messages entrants d'un numéro, affiché sur sa page sous Où vont les messages entrants comme Via easyCoexistence ou Directement vers votre système.
- Via easyCoexistence (géré) : Meta livre à easyCoexistence, les automatisations et Conversations peuvent utiliser les messages, et une Forward URL facultative reçoit une copie signée.
- Directement vers votre système (direct) : Meta poste les messages du numéro directement vers votre propre destination webhook, et les automatisations sont désactivées.
- Forward URL : votre endpoint HTTPS qui reçoit chaque modification entrante d'un numéro géré, signée avec X-EC-Signature.
Quels sont les éléments de base d'une automatisation ?
Une automatisation est un déclencheur et un flux d'étapes sur un numéro. Le déclencheur nomme l'événement et la correspondance le restreint ; une seule automatisation répond à un message donné, selon sa priorité. Voici les noms utilisés par l'éditeur sous « Quand un message arrive » :
- Automatisation : un déclencheur et un flux de jusqu'à 30 étapes par ligne, 60 au total, sur un numéro, activées ou désactivées en bloc.
- Déclencheur : l'événement qui lance une automatisation ; sur un numéro WhatsApp, « Quand un message arrive », « Quand un contact reçoit un tag » ou « Quand votre système appelle une URL ».
- Tout message : la correspondance générale, pour tout ce que le client écrit.
- Contient un mot-clé : s'exécute lorsque le message correspond à l'un des 30 mots-clés maximum ; les majuscules n'ont pas d'importance.
- Mode du mot-clé : Contient (n'importe où dans le message), Commence par (au début) ou Est exactement (le message entier).
- Premier message : s'exécute sur une discussion sans historique, y compris le premier message d'un habitué après l'activation des automatisations, ou après environ 30 jours sans échange.
- Hors horaires : s'exécute pendant votre fermeture, à partir d'un Fuseau horaire, de Jours d'ouverture et des heures De / À au format 24 heures.
- Priorité : l'ordre qui choisit une seule automatisation : mot-clé, puis Premier message, puis Hors horaires, puis la correspondance générale, la plus ancienne d'abord.
Que signifie chaque type d'étape ?
Les étapes s'exécutent dans l'ordre, de haut en bas, après le bloc Déclencheur, et deux d'entre elles créent des embranchements : « Diviser en chemins » (selon des règles sur le texte, les champs, les tags ou les horaires) et « L'IA choisit le chemin » (selon le sens) contiennent chacune une ligne d'étapes par chemin, plus une ligne « Sinon ». Une ligne contient jusqu'à 30 étapes, 60 au total, avec des embranchements imbriqués sur 4 niveaux. Un numéro accepte 19 types d'étapes ; outre ceux ci-dessous, l'éditeur propose « Poser une question » (jusqu'à 3 boutons cliquables, attend la réponse et l'enregistre dans un champ du contact), « L'agent répond », « Passer à une personne » (met le bot en pause sur la discussion et vous envoie un e-mail), « Me notifier », « Envoyer une image ou un fichier », « Enregistrer dans le contact », « Tag », « L'IA enregistre des détails », « Appeler une API », « Lancer une automatisation » et « Revenir à une étape ». Voici les types d'étapes principaux et leurs intitulés :
- Répondre par texte : un message fixe de 4 096 caractères maximum, envoyé tel quel.
- Variables : {{
first_name}}, {{name}}, {{message}} et {{phone}}, ainsi que {{contact.field}} pour un champ de contact enregistré et {{vars.name}} pour la réponse d'une étape précédente, remplies lors de l'exécution de l'étape. - Envoyer un template : envoie un template approuvé du numéro, avec des variables positionnelles dans le corps ; fonctionne en dehors de la fenêtre de 24 heures.
- Répondre avec l'IA : votre propre modèle, avec votre clé Anthropic, OpenAI ou OpenRouter, rédige la réponse.
- Instructions : le prompt de l'étape IA, ou celui d'un agent, jusqu'à 20 000 caractères ; un agent peut aussi s'appuyer sur des fichiers de connaissances, des liens et du texte.
- Appeler mon webhook : envoie le message et jusqu'à 10 messages récents de la discussion à votre URL, et renvoie une réponse reçue dans les 20 secondes.
- Attendre : suspend l'exécution de 1 à 1 380 minutes, soit 23 heures, avant l'étape suivante.
- Arrêter : met fin à l'exécution ; autorisé uniquement comme dernière étape de sa ligne.
Quelles règles et limites ont leur propre nom ?
Certains mots viennent de Meta et s'appliquent à toute entreprise sur WhatsApp ; d'autres sont des réglages sous Avancé dans l'éditeur d'automatisation. Les deux décident si une réponse part ou non, d'où l'intérêt de les connaître :
- Fenêtre de 24 heures : fenêtre de service client de Meta ; les messages autres que les templates ne sont autorisés que dans les 24 heures suivant le dernier message du client.
- Template : un format de message que Meta examine à l'avance, dans la catégorie marketing, utilitaire ou authentification ; nécessaire pour écrire en premier ou après 24 heures.
- Opt-in : la personne vous a donné son numéro et accepté de recevoir vos messages, condition exigée par Meta avant de lui écrire en premier.
- Écho : le webhook
smb_message_echoesde Meta, qui signale un message envoyé depuis l'application ou un appareil lié. - Reprise en main : la pause après votre réponse depuis le téléphone ou depuis Conversations, réglée dans « Mettre en pause une discussion après que j'y ai répondu (heures) », 4 par défaut, de 0 à 168.
- Limite de réponses IA : « Réponses IA par discussion et par heure, au maximum », 10 par défaut, de 1 à 60.
- Tokens : les unités facturées par les fournisseurs d'IA ; « Réponse la plus longue (tokens) » plafonne une réponse, 600 par défaut, de 50 à 2 000.
- Règle des 14 jours : Meta déconnecte un numéro en Coexistence dont l'application n'a pas été ouverte sur le téléphone depuis environ 14 jours.
Que signifient les termes du journal d'exécution ?
Chaque fois qu'une automatisation démarre sur un message, elle laisse une exécution dans l'onglet Exécutions, conservée 30 jours, avec la sortie, la durée et les tokens de chaque étape. Ces termes expliquent ce que vous y voyez :
- Exécution : une seule exécution d'une automatisation sur un message entrant, un tag ou un appel de webhook, ou sur un test.
- Statut d'exécution : En file d'attente, En cours, En attente (suspendue dans une étape Attendre), Terminée, Échec ou Ignorée.
- Motif d'exécution ignorée : la raison pour laquelle une exécution s'est arrêtée volontairement, par exemple « Vous avez répondu à cette discussion depuis votre téléphone récemment ».
- Tester / Essayer : exécute les étapes enregistrées sur un message d'exemple ; rien n'est envoyé, mais l'IA et le webhook s'exécutent vraiment.
- En pause : le statut d'une automatisation dont la clé IA a été refusée par le fournisseur ; elle redémarre dès qu'une clé valide est enregistrée.
- Remplacée : une exécution en attente annulée parce qu'un nouveau message du client a relancé la même automatisation.
Erreurs courantes
- Lire En pause comme Désactivée. En pause signifie que la clé IA ne fonctionne plus ; l'automatisation redémarre toute seule dès qu'une clé valide est enregistrée, alors que Désactivée reste éteinte tant que vous ne l'activez pas.
- Croire que le message d'absence de l'application et Hors horaires sont la même chose. L'un vit dans l'application téléphone que le logiciel ne voit pas ; l'autre est une automatisation côté API.
- Attendre que Premier message ne se déclenche que pour de nouveaux contacts. Il se déclenche pour toute discussion sans historique enregistré, habitués compris.
Créez-les vous-même dans l'éditeur ou en demandant à votre IA, avec votre propre clé. De US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec les 3 premiers jours en essai gratuit.
Questions fréquemment posées
Quelle est la différence entre une automatisation et un agent IA ?
Une automatisation est un déclencheur et des étapes, même quand elle se ramifie : chaque chemin est un chemin que vous avez tracé. Un agent IA décide lui-même de sa prochaine action. Une étape « L'agent répond » place l'un de vos agents dans une automatisation, avec ses instructions, ses connaissances et ses outils, comme l'enregistrement d'un champ de contact ou le passage de la discussion à une personne, alors qu'une étape Répondre avec l'IA ne fait que rédiger la réponse. Un agent complet à vous peut aussi se trouver derrière Appeler mon webhook ou une Forward URL.
Où ces termes apparaissent-ils dans le dashboard ?
Les correspondances et les modes de mots-clés se trouvent dans le bloc Déclencheur de l'éditeur d'automatisation, et les étapes dans le menu + entre les blocs. La reprise en main et la limite de réponses IA sont sous Avancé, les exécutions et leurs motifs d'exécution ignorée dans l'onglet Exécutions, et le mode de réception sur la page du numéro.
Lesquels de ces termes viennent de Meta ?
Coexistence, Cloud API, la fenêtre de 24 heures, les templates et leurs catégories, l'opt-in, les échos et la règle des 14 jours sont ceux de Meta. Les correspondances, étapes, reprises en main, statuts d'exécution, motifs d'exécution ignorée et X-EC-Signature sont des noms utilisés dans le dashboard et l'API d'easyCoexistence.
Que signifie X-EC-Signature ?
C'est l'en-tête qui prouve qu'un appel de webhook ou un transfert vient d'easyCoexistence : t=<secondes unix>,v1=<HMAC-SHA256 de « <t>.<body> » calculé avec un secret que vous seul détenez>. Votre serveur le recalcule et le compare avant de faire confiance à la requête.
Poursuivre la lecture
Prêt à commencer ?
Configurez WhatsApp Coexistence en quelques minutes, pas en quelques mois. L’application continue de fonctionner sur le téléphone.
Commencer l'essai gratuitVérifié le