Référence des automatisations WhatsApp : déclencheurs, étapes, variables et limites
Les automatisations easyCoexistence sur un numéro WhatsApp démarrent à partir d'un message qui arrive, d'un contact qui reçoit un tag, ou d'un appel de votre système. Un message a quatre correspondances : Chaque message, Contient un mot-clé, Premier message et Hors heures d'ouverture. Viennent ensuite des étapes, jusqu'à 30 par ligne et 60 au total, avec des embranchements, des questions et des agents IA. Un message ne déclenche qu'une seule automatisation, les règles par mot-clé en premier.
Étapes dans une ligne, 60 au total, embranchements imbriqués sur 4 niveaux ; Arrêter et Retourner à une étape ne peuvent terminer qu'une ligne.
Par automatisation, jusqu'à 100 caractères chacun ; un seul suffit, et les majuscules sont ignorées.
Caractères autorisés dans les Instructions d'une étape Répondre avec l'IA, dont les réponses sont limitées à 50 à 2 000 tokens.
Durée maximale d'une étape Attendre : 23 heures, pour que l'étape de texte suivante reste dans la fenêtre de 24 heures de Meta.
Délai dont votre webhook dispose pour répondre avant que l'étape Appeler mon webhook n'échoue ; un champ reply dans la réponse est envoyé au client.
Durée de conservation des exécutions, avec chaque message de départ et chaque réponse ; le texte des messages est supprimé après la durée de conservation que vous choisissez (30, 90 ou 365 jours, 90 par défaut).
Quels déclencheurs et correspondances une automatisation WhatsApp peut-elle utiliser ?
Le déclencheur principal, « Un message arrive » (message_received), se déclenche lorsqu'un client écrit au numéro : texte, photos, vidéos, documents, audios, autocollants, positions, cartes de contact, réponses aux boutons et aux listes, et commandes. Une note vocale est transcrite avec votre clé OpenAI ou OpenRouter et enregistrée sous la forme « [message vocal] » suivi des mots, qu'un mot-clé peut reconnaître ; sans une telle clé, elle reste « [message vocal] ». Les réactions, les statuts et les avis système ne lancent jamais d'exécution, et les conversations de groupe n'atteignent pas l'API sur un numéro Coexistence. Deux autres déclencheurs ne partent pas d'un message. « Un contact reçoit une étiquette » (tag_added) se déclenche chaque fois qu'un contact joignable sur le numéro reçoit l'étiquette que vous nommez, depuis un flux, un agent IA, vous-même dans Conversations ou update_contact. « Votre système appelle une URL » (webhook_received) se déclenche lorsque votre propre système envoie en POST un JSON contenant un numéro de téléphone à l'URL de l'automatisation, avec le secret de l'automatisation comme Bearer token, pour une nouvelle commande ou une réservation ; le corps, jusqu'à 20 Ko, est disponible sous {{vars.webhook.*}}. Dans les deux cas, {{message}} est vide et une personne qui n'a pas écrit au cours des dernières 24 heures ne peut recevoir qu'un send_template. Il n'existe pas de déclencheur planifié. Sur le déclencheur de message, Hors heures d'ouverture considère comme ouverts les jours cochés sous « Ouvert le », entre De et À, dans un fuseau horaire IANA tel que America/Sao_Paulo ; une heure de fin antérieure à l'heure de début correspond à un créneau de nuit (22:00 à 06:00), et un jour non coché compte comme fermé toute la journée. Dans l'API, hours prend timezone, days (1 = lundi à 7 = dimanche, les jours d'ouverture) et start et end. Premier message se déclenche lorsque easyCoexistence crée un enregistrement pour la conversation : le premier message d'un client depuis l'activation d'une automatisation sur le numéro, y compris pour les clients de longue date, ou le premier message après 30 jours de silence. Une conversation que vous avez ouverte depuis le téléphone compte déjà comme vue.
Comment fonctionnent les modes de correspondance par mot-clé ?
Sous « Où doit figurer le mot », Contient (« N'importe où dans le message ») est la valeur par défaut, Commence par correspond à « Au début » et Est exactement à « Le message entier » ; dans l'API, keywordMode vaut contains, starts_with ou exact. La correspondance ignore les espaces autour du message et les majuscules, mais elle n'ignore pas les accents ni la ponctuation, et Contient correspond aussi à l'intérieur de mots plus longs. La zone « Tester » sous Mots-clés répond « Exécuté : correspondance » avec le mot-clé, ou « Non exécuté : aucun mot-clé ne correspond », pour n'importe quel exemple que vous saisissez.
| Matches | Does not match | |
|---|---|---|
| Contains "price" | What is the price? · PRICES please | How much is it? |
| Contains "oi" | Oi! · Boa noite (inside noite) | Olá |
| Starts with "menu" | Menu please | Can I see the menu? |
| Is exactly "menu" | Menu · menu with spaces around it | menu? · the menu |
| Contains "preço" | Qual o preço? | Qual o preco? |
Que fait chaque étape, et quels champs prend-elle ?
Les étapes s'exécutent de haut en bas, jusqu'à 30 dans une ligne et 60 dans une automatisation, branches comprises, et au moins une doit faire autre chose que Attendre, Arrêter, Diviser en chemins, L'IA choisit le chemin et Revenir à une étape. Une étape à branches contient une ligne d'étapes par chemin, plus une ligne Sinon, et les branches s'imbriquent sur 4 niveaux. Dans le menu « Choisir une étape », chacune affiche un nom et une courte ligne, toutes deux citées ci-dessous pour les six étapes de base. Poser une question (ask) envoie son Message avec jusqu'à 10 boutons, dont 3 s'affichent comme boutons à toucher, les autres étant listés et auxquels on répond par un numéro, attend jusqu'à 1 380 minutes la réponse et l'enregistre dans un champ du contact sous forme de texte, d'e-mail, de nombre, de téléphone ou de l'un des boutons ; une mauvaise réponse fait reposer la question jusqu'à 3 fois. L'agent répond (agent) confie le message à l'un de vos agents IA, Envoyer une image ou un fichier (send_file) envoie une image ou un PDF issu de vos fichiers, et Passer la main à une personne (handoff) met le bot en pause sur cette conversation pendant 1 à 168 heures, 24 par défaut, et vous envoie un e-mail. Diviser en chemins (condition) et L'IA choisit le chemin (ai_decide) créent des branches selon des règles ou selon le sens. L'IA enregistre des détails (ai_extract), Enregistrer sur le contact (set_field) et Étiqueter (tag) écrivent des champs et des étiquettes du contact, et Appeler une API (http_request) appelle n'importe quelle API HTTPS et conserve sa réponse JSON sous la forme {{vars.<name>...}}. Lancer une automatisation (start_automation) exécute une autre automatisation pour la même personne, sur 3 niveaux au plus, Revenir à une étape (goto) saute vers l'identifiant d'une étape pour faire une boucle, et Me notifier (notify_owner) vous envoie un e-mail, 20 par heure au plus par automatisation. Si une étape échoue, les étapes suivantes sont ignorées et l'exécution se termine en Échec. Appeler mon webhook envoie un POST JSON avec event « automation.step », dry_run, run_id, le numéro, le contact (wa_id, name), le message (id, type, text, at) et jusqu'à 10 messages récents de la conversation, signé dans X-EC-Signature comme t=<unix>,v1=<HMAC-SHA256 de « <t>.<body> »> avec le « Secret de signature » de l'étape. Son URL doit être en HTTPS public, et les redirections ne sont pas suivies.
Quelles variables les étapes peuvent-elles remplir ?
Quatre sont remplies à partir du message qui a démarré l'exécution, écrites entre doubles accolades ; {{contact.<field>}} ajoute un champ du contact (aussi contact.name et contact.phone) et {{vars.<path>}} ce que les étapes précédentes ont enregistré, comme la réponse d'une étape Appeler une API. Elles fonctionnent dans le Message de Répondre avec du texte, dans les variables du corps d'un template, dans les Instructions de Répondre avec l'IA et dans le texte d'autres étapes comme Poser une question ; dans les variables d'un template, les puces « Insérer : » les ajoutent. Une valeur inconnue, comme un profil sans nom, devient vide. Les envois de template ne transportent que les variables du corps, par position : un template à variables nommées, une image ou une variable d'en-tête, ou un bouton avec une variable ne peut donc pas encore être choisi, et une variable laissée vide fait refuser l'envoi par Meta.
- {{
first_name}} : le premier mot du nom de profil WhatsApp du client (« Prénom »). - {{name}} : le nom complet du profil (« Nom complet »).
- {{message}} : le texte du message, ou son espace réservé comme « [image] » suivi de la légende (« Son message »).
- {{phone}} : le numéro du client en chiffres internationaux, sans plus, comme 5511999998888 (« Son téléphone »).
- Lors d'un test, le client est « Client de test » et le numéro est 15550000000.
Quels sont les réglages et leurs valeurs par défaut ?
Deux réglages se trouvent sous « Avancé », le bouton à côté de l'interrupteur Activée dans l'éditeur, et l'étape IA en porte deux autres. Un champ omis prend sa valeur par défaut, dans l'éditeur comme avec create_automation. Les délais sont fixes plutôt que réglables : une réponse IA dispose de 45 secondes et un webhook de 20 secondes. Le nom d'une automatisation peut comporter jusqu'à 120 caractères. Un agent IA a ses propres réglages : messages antérieurs lus, de 0 à 40 (20 par défaut), réponse la plus longue de 100 à 4 000 tokens (800 par défaut), jusqu'à 10 appels d'outils par réponse (5 par défaut) et heures de passage de main, de 1 à 168 (24 par défaut).
Quelle automatisation répond lorsque plusieurs correspondent ?
Une seule au plus, choisie dans un ordre fixe : Contient un mot-clé d'abord, puis Premier message, puis Hors heures d'ouverture, puis Chaque message, et la plus ancienne automatisation en premier au sein d'un même type. Seules les automatisations activées et non suspendues entrent en concurrence ; ainsi, lorsque la règle par mot-clé est désactivée, ou suspendue par une clé IA refusée, l'automatisation générale répond à sa place. Deux conséquences surprennent. Un nouveau client qui écrit la nuit reçoit l'automatisation Premier message et non Hors heures d'ouverture, car Premier message est classé plus haut. Et un message auquel répond une automatisation par mot-clé n'atteint jamais un agent IA ni une étape Répondre avec l'IA sur Chaque message ; placez donc l'agent ou l'étape IA dans l'automatisation par mot-clé si vous voulez les deux. Un message qui répond à une étape Poser une question ouverte appartient à cette question, et aucune autre automatisation ne démarre dessus. Les automatisations par étiquette et par webhook démarrent à partir de leurs propres événements et ne participent pas à cet ordre.
Quelles protections sont intégrées ?
Le moteur les applique sans aucun réglage, et les motifs d'ignorance dans l'onglet Exécutions les nomment lorsqu'ils arrêtent une exécution :
- Un message que Meta livre deux fois ne démarre qu'une seule exécution : les doublons sont supprimés par identifiant de message.
- Les réactions, les statuts, les envois de l'automatisation elle-même et vos échos depuis l'application ne démarrent jamais d'exécution.
- Répondre avec du texte, Poser une question, Envoyer une image ou un fichier, Répondre avec l'IA, la réponse d'un agent et la réponse d'un webhook exigent que le dernier message du client ait moins de 24 heures ; Envoyer un template ne l'exige pas.
- Une réponse que vous tapez dans l'application WhatsApp Business suspend l'automatisation sur cette conversation, et une exécution en attente à cet endroit ignore ses étapes restantes.
- Un message plus récent qui démarre la même automatisation sur une conversation remplace l'exécution encore en attente dans une étape Attendre ; un message qui répond à une question ouverte va à cette question à la place.
- Les envois depuis un numéro sont espacés d'au moins 100 ms, soit en dessous des 20 par seconde de Meta pour les numéros Coexistence.
- Une étape en échec vous envoie un e-mail, au plus une fois par automatisation toutes les 6 heures ; une clé IA refusée suspend les automatisations utilisant ce fournisseur et envoie un seul e-mail.
Que prend l'outil create_automation ?
Le connecteur MCP compte dix-neuf outils pour les automatisations et ce qu'elles utilisent. Huit concernent les automatisations : set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs et get_automation_run. Huit concernent les agents et les fichiers : list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge et test_agent. Trois concernent les personnes : list_conversations, get_conversation et update_contact. create_automation prend connection_id (issu de list_numbers), name, enabled, trigger, steps et settings, en snake_case comme keyword_mode et max_tokens ; le camelCase est accepté aussi. Les objets d'étape sont reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} et wait {minutes}, puis ask {text, buttons, save_to, expect, retry_text, wait_minutes}, agent {agent_id, wait_seconds}, send_file {file_id, caption}, condition {paths, otherwise}, ai_decide {provider, model, instructions, paths, otherwise}, ai_extract {provider, model, fields}, set_field {key, value}, tag {action, tag}, http_request {method, url, headers, body, save_as}, start_automation {automation_id}, handoff {hours, note}, notify_owner {text}, goto {to} et stop. update_automation conserve les champs que vous omettez, et steps, lorsqu'il est fourni, remplace toute la liste. Les erreurs nomment le champ, comme "trigger.keywords: Add at least one keyword", "steps.2: Stop must be the last step of its line" ou "steps.0: save your openai API key on the Automations page first". Les clés IA ne transitent jamais par MCP. Dans l'exemple, l'attente de 1 minute permet à un client qui envoie plusieurs lignes à la fois de n'obtenir qu'une seule réponse.
{
"connection_id": "<connection_id from list_numbers>",
"name": "After-hours assistant",
"enabled": false,
"trigger": {
"type": "message_received",
"match": "outside_hours",
"hours": {
"timezone": "America/Sao_Paulo",
"days": [1, 2, 3, 4, 5, 6],
"start": "08:00",
"end": "18:00"
}
},
"steps": [
{ "type": "wait", "minutes": 1 },
{
"type": "ai_reply",
"provider": "openrouter",
"model": "google/gemini-omni-1.2-flash",
"prompt": "You are the assistant of Ana's Bakery. We are closed and open at 8:00. Answer questions about products; a person confirms orders in the morning.",
"history": 10,
"max_tokens": 600
}
],
"settings": { "takeover_hours": 4, "ai_max_per_hour": 10 }
}Erreurs courantes
- Utiliser un mot-clé de deux lettres avec Contient. « oi » correspond aussi à « noite » et « boi », donc l'automatisation répond à des messages qui ne la concernaient pas ; utilisez Est exactement, ou un mot-clé plus long.
- Ne lister que l'orthographe accentuée. La correspondance ignore les majuscules mais pas les accents, donc « preço » ne trouve pas les clients qui tapent « preco » ; ajoutez les deux.
- Croire que Premier message ignore les habitués. Il se déclenche pour tout client dont easyCoexistence n'a pas vu la conversation depuis 30 jours, donc les clients de longue date reçoivent l'accueil à leur premier message après que vous l'avez activé.
- Choisir un template qui exige une image d'en-tête ou un bouton de copie de code. Les automatisations ne remplissent que les variables du corps : l'éditeur le liste mais ne vous laisse pas le choisir, et défini via MCP, l'envoi est refusé par Meta et l'exécution échoue.
easyCoexistence exécute ces automatisations sur le numéro WhatsApp Business que vous continuez d'utiliser dans l'application, via l'API Cloud de Meta et Coexistence. Créez-les dans l'éditeur sous « Automatisations », « Nouvelle automatisation », ou laissez ChatGPT ou Claude appeler create_automation et test_automation via le connecteur MCP, qui compte plus de 30 outils. US$ 9 à US$ 0,75 par numéro et par mois, dégressif à mesure que vous ajoutez des numéros, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Une automatisation peut-elle se ramifier selon ce que dit le client ?
Oui. Diviser en chemins (condition) crée des branches selon le texte du message, un champ du contact, une étiquette, une réponse d'API antérieure ou vos heures d'ouverture, et L'IA choisit le chemin (ai_decide) choisit selon le sens, dans n'importe quelle langue, avec votre propre modèle. Chaque chemin contient sa propre ligne d'étapes, et une ligne Sinon récupère le reste. Vous pouvez aussi confier la décision à n8n ou à votre backend avec Appeler mon webhook, qui peut renvoyer un {"reply": "..."} différent pour chaque cas.
Y a-t-il une limite au nombre d'automatisations ou d'exécutions ?
Il n'y a pas de plafond d'exécutions, ni de frais supplémentaires pour elles, ni de limite au nombre d'automatisations par numéro. Les limites qui s'appliquent se font par conversation : les réponses IA par heure, la règle des 24 heures de Meta pour le texte, et la pause après que vous avez répondu depuis le téléphone.
Puis-je déplacer ou copier une automatisation vers un autre numéro ?
Déplacez-la en changeant sa Connexion dans l'éditeur, ou avec update_automation et un nouveau connection_id ; les exécutions encore en attente sur l'ancien numéro se terminent en superseded. Pour en copier une, demandez à votre IA de la lire avec list_automations et de créer le même déclencheur et les mêmes étapes sur l'autre numéro.
Que deviennent les exécutions en attente lorsque je modifie une automatisation ?
Elles poursuivent leur cours. Une exécution suspendue sur une attente reprend à l'étape suivante de l'automatisation telle qu'elle est enregistrée au moment du réveil, si bien qu'une modification peut changer ce qu'elle envoie. Pour les arrêter, désactivez l'automatisation : elles se terminent alors en Ignorée avec « Automation is off ».
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