WhatsApp-automatisering: triggers, stappen, variabelen en limieten
easyCoexistence-automatiseringen op een WhatsApp-nummer starten vanuit een bericht dat binnenkomt, een contact dat een tag krijgt, of een aanroep vanuit je systeem. Een bericht heeft vier voorwaarden: Elk bericht, Heeft trefwoord, Eerste bericht en Buiten openingstijden. Daarna volgen stappen, tot 30 op een lijn en 60 in totaal, met vertakkingen, vragen en AI-agents. Een bericht krijgt maximaal één automatisering, waarbij trefwoordregels voorgaan.
Stappen in één lijn, 60 in totaal, vertakkingen tot 4 niveaus diep; Stoppen en Terug naar een stap kunnen alleen een lijn afsluiten.
Per automatisering tot 100 tekens per trefwoord; één is genoeg, en hoofdletters doen er niet toe.
Toegestane tekens in de Instructies van een stap Antwoorden met AI, waarvan antwoorden zijn beperkt tot 50 tot 2.000 tokens.
Langste enkele wachtstap, 23 uur, zodat de volgende tekststap nog binnen Meta's venster van 24 uur valt.
Tijd die je webhook heeft om te antwoorden voordat Mijn webhook aanroepen mislukt; een reply-veld in het antwoord wordt naar de klant gestuurd.
Bewaartermijn van runs, met elk startbericht en antwoord; berichttekst verdwijnt na de bewaartermijn die je kiest (30, 90 of 365 dagen, standaard 90).
Welke triggers en voorwaarden kan een WhatsApp-automatisering gebruiken?
De belangrijkste trigger, „Een bericht komt binnen” (message_received), wordt geactiveerd wanneer een klant naar het nummer schrijft: tekst, foto's, video, documenten, audio, stickers, locaties, contactkaarten, knop- en lijstantwoorden, en bestellingen. Een spraakbericht wordt uitgeschreven met je OpenAI- of OpenRouter-sleutel en opgeslagen als „[voice message]” gevolgd door de woorden, waar een trefwoord op kan aansluiten; zonder zo'n sleutel blijft het „[voice message]”. Reacties, statussen en systeemmeldingen starten nooit een run, en groepschats bereiken de API niet op een Coexistence-nummer. Twee andere triggers starten niet vanuit een bericht. „Een contact krijgt een tag” (tag_added) wordt geactiveerd telkens wanneer een contact dat via het nummer bereikbaar is de tag krijgt die je noemt, vanuit een flow, een AI-agent, jijzelf in Conversations of update_contact. „Je systeem roept een URL aan” (webhook_received) wordt geactiveerd wanneer je eigen systeem JSON met een telefoonnummer via POST naar de URL van de automatisering stuurt, met het geheim van de automatisering als Bearer-token, voor een nieuwe bestelling of een boeking; de body, tot 20 KB, is beschikbaar als {{vars.webhook.*}}. Bij beide is {{message}} leeg en kan een persoon die de afgelopen 24 uur niet heeft geschreven alleen een send_template krijgen. Er is geen planningstrigger. Bij de berichttrigger behandelt Buiten openingstijden de dagen die zijn aangevinkt onder „Open op” als open tussen Van en Tot, in een IANA-tijdzone zoals America/Sao_Paulo. Een Tot dat eerder is dan Van is een nachtdienst (22:00 tot 06:00), en een niet-aangevinkte dag telt de hele dag als gesloten. In de API gebruikt hours timezone, days (1 = maandag tot 7 = zondag, de dagen waarop je open bent), en start en end. Eerste bericht wordt geactiveerd wanneer easyCoexistence een record voor de chat aanmaakt: het eerste bericht van een klant nadat een automatisering voor het nummer is ingeschakeld, ook van klanten die er al lang zijn, of het eerste bericht na 30 rustige dagen. Een chat die je vanaf de telefoon hebt geopend, telt al als gezien.
Hoe werken de trefwoordmodi?
Onder „Waar het woord moet staan” is Bevat ("Overal in het bericht") de standaard, Begint met is „Aan het begin” en Is precies is „Het hele bericht”. In de API is keywordMode contains, starts_with of exact. Bij matching worden spaties rond het bericht verwijderd en worden hoofdletters genegeerd, maar accenten en leestekens niet, en Bevat komt ook voor binnen langere woorden. Het vak „Test het” onder Trefwoorden antwoordt bij elk voorbeeld dat je invoert met „Wordt uitgevoerd: overeenkomst” plus het trefwoord, of met „Wordt niet uitgevoerd: geen trefwoord komt overeen”.
| 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? |
Wat doet elke stap, en welke velden heeft hij nodig?
Stappen worden van boven naar beneden uitgevoerd, tot 30 in een lijn en 60 in een automatisering, vertakkingen inbegrepen, en ten minste één stap moet iets anders doen dan Wachten, Stoppen, Splitsen in paden, AI kiest het pad en Terug naar een stap. Een vertakkende stap heeft per pad een lijn stappen plus een lijn Anders, en vertakkingen mogen 4 niveaus diep genest zijn. In het menu „Kies een stap” toont elke stap een naam en een korte regel, voor de zes basisstappen hieronder geciteerd. Een vraag stellen (ask) stuurt zijn Bericht met tot 10 knoppen, waarvan er 3 als aantikbare knoppen verschijnen en de rest wordt opgesomd en met een nummer beantwoord, wacht tot 1.380 minuten op het antwoord en bewaart dat in een contactveld als tekst, e-mail, getal, telefoonnummer of een van de knoppen; bij een fout antwoord wordt de vraag tot 3 keer opnieuw gesteld. Agent antwoordt (agent) geeft het bericht aan een van je AI-agents, Een afbeelding of bestand versturen (send_file) verstuurt een afbeelding of PDF uit je bestanden, en Overdragen aan een persoon (handoff) pauzeert de bot op die chat gedurende 1 tot 168 uur, standaard 24, en stuurt je een e-mail. Splitsen in paden (condition) en AI kiest het pad (ai_decide) vertakken op regels of op betekenis. AI slaat gegevens op (ai_extract), Opslaan bij contact (set_field) en Tag (tag) schrijven contactvelden en tags, en Een API aanroepen (http_request) roept elke HTTPS-API aan en bewaart het JSON-antwoord als {{vars.<name>...}}. Automatisering starten (start_automation) voert een andere automatisering uit voor dezelfde persoon, maximaal 3 niveaus diep, Terug naar een stap (goto) springt naar een stap-id om te herhalen, en Mij waarschuwen (notify_owner) stuurt je een e-mail, maximaal 20 per uur per automatisering. Als een stap mislukt, worden de volgende stappen overgeslagen en eindigt de run als Mislukt. Mijn webhook aanroepen stuurt JSON via POST met event "automation.step", dry_run, run_id, het nummer, het contact (wa_id, name), het bericht (id, type, text, at) en tot 10 recente berichten van de chat. Dit wordt ondertekend in X-EC-Signature als t=<unix>,v1=<HMAC-SHA256 van „<t>.<body>”>, met het „Ondertekeningsgeheim” van de stap. De URL moet publiek HTTPS zijn, en redirects worden niet gevolgd.
Welke variabelen kunnen stappen invullen?
Vier worden ingevuld vanuit het bericht dat de run startte, geschreven in dubbele accolades; {{contact.<field>}} voegt een contactveld toe (ook contact.name en contact.phone) en {{vars.<path>}} wat eerdere stappen hebben opgeslagen, zoals het antwoord van een stap Een API aanroepen. Ze werken in het Bericht van Tekst beantwoorden, in de body-variabelen van een template, in de Instructies van Antwoorden met AI en in de tekst van andere stappen zoals Een vraag stellen. In de variabelen van een template voegen de chips „Invoegen:” ze toe. Een onbekende waarde, zoals een profiel zonder naam, wordt leeg. Template-verzendingen gebruiken alleen body-variabelen, op positie. Een template met benoemde variabelen, een headerafbeelding, een header-variabele of een knop met een variabele kan daarom nog niet worden gekozen, en een variabele die leeg blijft, laat Meta het verzenden weigeren.
- {{
first_name}}: het eerste woord van de WhatsApp-profielnaam van de klant („Voornaam”). - {{name}}: de volledige profielnaam („Volledige naam”).
- {{message}}: de tekst van het bericht, of de aanduiding ervan, zoals „[image]” plus het bijschrift („Hun bericht”).
- {{phone}}: het nummer van de klant als internationale cijfers zonder plusteken, zoals 5511999998888 („Hun telefoon”).
- In een test is de klant „Testklant” en het telefoonnummer 15550000000.
Welke instellingen zijn er, en wat zijn de standaardwaarden?
Twee instellingen staan onder „Geavanceerd”, de knop naast de Aan-schakelaar in de editor. De AI-stap heeft er nog twee van zichzelf. Een veld dat je weglaat, krijgt zijn standaardwaarde, zowel in de editor als via create_automation. Time-outs zijn vast ingesteld en niet instelbaar: een AI-antwoord krijgt 45 seconden en een webhook 20 seconden. De naam van een automatisering mag tot 120 tekens lang zijn. Een AI-agent heeft eigen instellingen: eerdere berichten die hij leest, 0 tot 40 (standaard 20), langste antwoord 100 tot 4.000 tokens (standaard 800), tot 10 toolaanroepen per antwoord (standaard 5) en uren voor overdracht, 1 tot 168 (standaard 24).
Welke automatisering antwoordt als er meerdere voorwaarden kloppen?
Hooguit één, gekozen in een vaste volgorde: eerst Heeft trefwoord, dan Eerste bericht, dan Buiten openingstijden, dan Elk bericht, en binnen dezelfde soort de oudste automatisering eerst. Alleen automatiseringen die Aan staan en niet gepauzeerd zijn, komen in aanmerking. Staat de trefwoordregel dus Uit, of is die gepauzeerd door een geweigerde AI-sleutel, dan antwoordt de catch-all in plaats daarvan. Twee gevolgen verrassen mensen. Een nieuwe klant die 's nachts schrijft, krijgt de automatisering Eerste bericht, niet die van Buiten openingstijden, omdat Eerste bericht hoger staat. En een bericht dat een trefwoordautomatisering beantwoordt, bereikt nooit een AI-agent of een stap Antwoorden met AI op Elk bericht. Zet daarom de agent of de AI-stap binnen de trefwoordautomatisering als je beide wilt. Een bericht dat een openstaande stap Een vraag stellen beantwoordt, hoort bij die vraag, en er start geen andere automatisering op. Tag- en webhookautomatiseringen starten vanuit hun eigen gebeurtenissen en doen niet mee aan deze volgorde.
Welke beveiligingen zijn ingebouwd?
De runner past deze toe zonder instelling. De redenen voor overslaan in het tabblad Runs noemen ze wanneer ze een run stoppen:
- Een bericht dat Meta twee keer levert, start één run: duplicaten worden verwijderd op basis van het bericht-id.
- Reacties, statussen, de eigen verzendingen van de automatisering en je echo's uit de app starten nooit een run.
- Tekst beantwoorden, Een vraag stellen, Een afbeelding of bestand versturen, Antwoorden met AI, het antwoord van een agent en het antwoord van een webhook vereisen dat het laatste bericht van de klant minder dan 24 uur oud is. Een template versturen niet.
- Een antwoord dat je typt in de WhatsApp Business-app pauzeert de automatisering op die chat, en een run die daar wacht, slaat de overige stappen over.
- Een nieuwer bericht dat dezelfde automatisering op een chat start, vervangt de run die nog wacht in een stap Wachten; een bericht dat een openstaande vraag beantwoordt, gaat in plaats daarvan naar die vraag.
- Verzendingen vanaf een nummer liggen minimaal 100 ms uit elkaar, onder Meta's limiet van 20 per seconde voor Coexistence-nummers.
- Een mislukte stap stuurt je een e-mail, hooguit één keer per automatisering per 6 uur. Een geweigerde AI-sleutel pauzeert de automatiseringen die die provider gebruiken en stuurt één e-mail.
Welke parameters heeft de create_automation-tool?
De MCP-connector heeft negentien tools voor automatiseringen en wat ze gebruiken. Acht zijn voor automatiseringen: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs en get_automation_run. Acht zijn voor agents en bestanden: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge en test_agent. Drie zijn voor personen: list_conversations, get_conversation en update_contact. create_automation vraagt om connection_id (uit list_numbers), name, enabled, trigger, steps en settings, in snake_case zoals keyword_mode en max_tokens; camelCase wordt ook geaccepteerd. De stapobjecten zijn reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} en wait {minutes}, daarna 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} en stop. update_automation behoudt de velden die je weglaat, en steps vervangt, indien opgegeven, de hele lijst. Fouten noemen het veld, zoals "trigger.keywords: Add at least one keyword", "steps.2: Stop must be the last step of its line" of "steps.0: save your openai API key on the Automations page first". AI-sleutels reizen nooit via MCP. In het voorbeeld zorgt de wachtstap van 1 minuut ervoor dat een klant die meerdere regels tegelijk stuurt, één antwoord krijgt.
{
"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 }
}Veelgemaakte fouten
- Een trefwoord van twee letters gebruiken met Bevat. „oi” komt ook voor in „noite” en „boi”, dus de automatisering antwoordt op berichten waarvoor ze nooit bedoeld was. Gebruik Is precies, of een langer trefwoord.
- Alleen de geaccentueerde spelling opgeven. Matching negeert hoofdletters maar niet accenten, dus „preço” mist klanten die „preco” typen. Voeg beide toe.
- Verwachten dat Eerste bericht vaste klanten overslaat. Het wordt geactiveerd voor elke klant wiens chat easyCoexistence in 30 dagen niet heeft gezien. Klanten die er al lang zijn, krijgen het welkomstbericht dus bij hun eerste bericht nadat je het hebt ingeschakeld.
- Een template kiezen dat een headerafbeelding of een kopieerknop voor code nodig heeft. Automatiseringen vullen alleen body-variabelen in. De editor toont zo'n template wel, maar laat je hem niet kiezen. Via MCP ingesteld, weigert Meta de verzending en mislukt de run.
easyCoexistence voert deze automatiseringen uit op het WhatsApp Business-nummer dat je in de app blijft gebruiken, via Meta's Cloud API en Coexistence. Bouw ze in de editor onder Automatiseringen, Nieuwe automatisering, of laat ChatGPT of Claude create_automation en test_automation aanroepen via de MCP-connector, die meer dan 30 tools heeft. Van US$ 9 tot US$ 0,75 per nummer per maand, dalend naarmate je nummers toevoegt, met een gratis proefperiode van 3 dagen.
Veelgestelde vragen
Kan een automatisering vertakken op wat de klant zegt?
Ja. Splitsen in paden (condition) vertakt op de berichttekst, een contactveld, een tag, een eerder API-antwoord of je openingstijden, en AI kiest het pad (ai_decide) kiest op betekenis, in elke taal, op je eigen model. Elk pad heeft zijn eigen lijn stappen, en een lijn Anders vangt de rest op. Je kunt de beslissing ook doorgeven aan n8n of je backend met Mijn webhook aanroepen, die voor elk geval een ander {"reply": "..."} teruggeeft.
Is er een limiet op automatiseringen of runs?
Er is geen plafond op runs en geen extra kosten ervoor, en geen limiet op het aantal automatiseringen per nummer. De limieten die gelden, zijn per chat: AI-antwoorden per uur, Meta's regel van 24 uur voor tekst, en de pauze nadat je vanaf de telefoon hebt geantwoord.
Kan ik een automatisering naar een ander nummer verplaatsen of kopiëren?
Verplaats hem door de Verbinding in de editor te wijzigen, of met update_automation en een nieuw connection_id. Runs die nog op het oude nummer wachten, eindigen als superseded. Om er een te kopiëren, vraag je je AI om hem te lezen met list_automations en dezelfde trigger en stappen op het andere nummer aan te maken.
Wat gebeurt er met wachtende runs als ik een automatisering bewerk?
Ze gaan door. Een run die op een wachtstap staat, hervat bij het volgende stapnummer van de automatisering zoals die op het moment van wakker worden is opgeslagen. Een bewerking kan dus veranderen wat er wordt verstuurd. Om ze te stoppen, zet je de automatisering op Uit: ze eindigen dan als Overgeslagen met „Automation is off”.
Lees verder
Klaar om te beginnen?
Stel WhatsApp Coexistence in enkele minuten in, niet maanden. De app blijft op je telefoon werken.
Start je gratis proefperiodeGeverifieerd op