AnmeldenKostenlose Testphase starten
Meta Tech Provider

WhatsApp-Automatisierung: Referenz zu Triggern, Schritten, Variablen und Limits

Automatisierungen von easyCoexistence auf einer WhatsApp-Nummer starten mit einer eingehenden Nachricht, einem Kontakt, der ein Tag erhält, oder einem Aufruf Ihres Systems. Eine Nachricht hat vier Treffer: Jede Nachricht, Hat Schlüsselwort, Erste Nachricht und Außerhalb der Öffnungszeiten. Danach folgen Schritte, bis zu 30 in einer Linie und 60 insgesamt, mit Verzweigungen, Fragen und KI-Agenten. Eine Nachricht bekommt höchstens eine Automatisierung, Schlüsselwortregeln zuerst.

30 steps

Schritte in einer Linie, insgesamt 60, bis zu 4 Ebenen tief verschachtelte Verzweigungen; Stoppen und Zu einem Schritt zurück können nur eine Linie beenden.

30 keywords

Pro Automatisierung bis zu 100 Zeichen je Schlüsselwort; eines genügt, und Groß- und Kleinschreibung spielt keine Rolle.

20,000

Zeichen, die in den Anweisungen eines Schritts „Mit KI antworten“ erlaubt sind, dessen Antworten auf 50 bis 2,000 Tokens begrenzt sind.

1,380 min

Längster einzelner Warte-Schritt: 23 Stunden, damit der nächste Textschritt noch im 24-Stunden-Fenster von Meta liegt.

20 seconds

Zeit, die Ihr Webhook zum Antworten hat, bevor Meinen Webhook aufrufen fehlschlägt; ein Feld reply in der Antwort wird an den Kunden gesendet.

30 days

Aufbewahrung von Läufen, mit jeder auslösenden Nachricht und Antwort; Nachrichtentext wird nach der gewählten Aufbewahrungsdauer gelöscht (30, 90 oder 365 Tage, standardmäßig 90).

Welche Trigger und Treffer kann eine WhatsApp-Automatisierung nutzen?

Der Haupt-Trigger, „Eine Nachricht kommt an“ (message_received), feuert, wenn ein Kunde der Nummer schreibt: Text, Fotos, Videos, Dokumente, Audio, Sticker, Standorte, Kontaktkarten, Antworten auf Buttons und Listen sowie Bestellungen. Eine Sprachnachricht wird mit Ihrem OpenAI- oder OpenRouter-Schlüssel in Text umgesetzt und als „[voice message]“ gefolgt von den Worten gespeichert, auf die ein Schlüsselwort passen kann; ohne einen solchen Schlüssel bleibt sie „[voice message]“. Reaktionen, Status und Systemhinweise starten nie einen Lauf, und Gruppenchats erreichen die API auf einer Coexistence-Nummer nicht. Zwei weitere Trigger starten nicht von einer Nachricht. „Ein Kontakt erhält ein Tag“ (tag_added) feuert jedes Mal, wenn ein auf der Nummer erreichbarer Kontakt das von Ihnen genannte Tag erhält, aus einem Flow, von einem KI-Agenten, von Ihnen in Conversations oder per update_contact. „Ihr System ruft eine URL auf“ (webhook_received) feuert, wenn Ihr eigenes System JSON mit einer Telefonnummer per POST an die URL der Automatisierung sendet, mit dem Geheimnis der Automatisierung als Bearer-Token, etwa für eine neue Bestellung oder eine Buchung; der Body, bis zu 20 KB, steht als {{vars.webhook.*}} zur Verfügung. Bei beiden ist {{message}} leer, und eine Person, die in den letzten 24 Stunden nicht geschrieben hat, kann nur ein send_template erhalten. Es gibt keinen Zeitplan-Trigger. Beim Nachrichten-Trigger behandeln Öffnungszeiten die unter „Geöffnet am“ angehakten Tage als geöffnet zwischen Von und Bis, in einer IANA-Zeitzone wie America/Sao_Paulo. Liegt das Bis vor dem Von, ist es eine Nachtschicht (22:00 bis 06:00), und ein nicht angehakter Tag gilt den ganzen Tag als geschlossen. In der API erhalten die Öffnungszeiten timezone, days (1 = Montag bis 7 = Sonntag, die Tage, an denen Sie geöffnet sind) sowie start und end. Erste Nachricht feuert, wenn easyCoexistence einen Datensatz für den Chat anlegt: die erste Nachricht eines Kunden, seit eine Automatisierung für die Nummer eingeschaltet wurde, auch bei langjährigen Kunden, oder die erste nach 30 ruhigen Tagen. Ein Chat, den Sie vom Telefon aus geöffnet haben, gilt bereits als gesehen.

Every message (any)Runs on whatever the customer writes, when no more specific automation matched.
Has keyword (keyword)Runs when the message holds one of up to 30 keywords, in one of three modes.
First message (first_message)Runs on a chat easyCoexistence has not seen, or after 30 days without a message from that customer.
After hours (outside_hours)Runs while you are closed: Timezone, Open on days, and From and To in 24-hour HH:MM.

Wie funktionieren die Schlüsselwort-Modi?

Unter „Wo das Wort stehen muss“ ist Enthält („Irgendwo in der Nachricht“) der Standard, Beginnt mit ist „Am Anfang“ und Ist genau ist „Die ganze Nachricht“. In der API lautet keywordMode contains, starts_with oder exact. Der Abgleich entfernt Leerzeichen um die Nachricht herum und ignoriert Groß- und Kleinschreibung, ignoriert aber keine Akzente oder Satzzeichen, und Enthält trifft auch innerhalb längerer Wörter. Das Testfeld unter Schlüsselwörtern zeigt für jeden eingegebenen Beispieltext „Läuft: Treffer“ mit dem Schlüsselwort oder „Läuft nicht: kein Schlüsselwort trifft zu“.

MatchesDoes not match
Contains "price"What is the price? · PRICES pleaseHow much is it?
Contains "oi"Oi! · Boa noite (inside noite)Olá
Starts with "menu"Menu pleaseCan I see the menu?
Is exactly "menu"Menu · menu with spaces around itmenu? · the menu
Contains "preço"Qual o preço?Qual o preco?

Was macht jeder Schritt, und welche Felder braucht er?

Schritte laufen von oben nach unten, bis zu 30 in einer Reihe und 60 in einer Automatisierung, Verzweigungen eingeschlossen, und mindestens einer muss etwas anderes tun als Warten, Stoppen, In Pfade aufteilen, KI wählt den Pfad und Zu einem Schritt zurück. Ein verzweigender Schritt enthält pro Pfad eine Reihe von Schritten plus eine Reihe Sonst, und Verzweigungen lassen sich 4 Ebenen tief verschachteln. Im Menü „Schritt wählen“ hat jeder einen Namen und eine kurze Zeile, die beide unten für die sechs Basisschritte zitiert werden. Eine Frage stellen (ask) sendet ihre Nachricht mit bis zu 10 Buttons, von denen 3 als antippbare Buttons erscheinen und weitere aufgelistet und per Nummer beantwortet werden, wartet bis zu 1380 Minuten auf die Antwort und speichert sie in einem Kontaktfeld als Text, E-Mail, Zahl, Telefonnummer oder als einen der Buttons; auf eine falsche Antwort wird die Frage bis zu 3 Mal erneut gestellt. Agent antwortet (agent) übergibt die Nachricht an einen Ihrer KI-Agenten, Bild oder Datei senden (send_file) sendet ein Bild oder PDF aus Ihren Dateien, und An einen Menschen übergeben (handoff) pausiert den Bot in diesem Chat für 1 bis 168 Stunden, standardmäßig 24, und schickt Ihnen eine E-Mail. In Pfade aufteilen (condition) und KI wählt den Pfad (ai_decide) verzweigen nach Regeln oder nach Bedeutung. KI speichert Details (ai_extract), In Kontakt speichern (set_field) und Tag (tag) schreiben Kontaktfelder und Tags, und Eine API aufrufen (http_request) ruft jede HTTPS-API auf und behält ihre JSON-Antwort als {{vars.<name>...}}. Automatisierung starten (start_automation) führt für dieselbe Person eine andere Automatisierung aus, höchstens 3 Ebenen tief, Zu einem Schritt zurück (goto) springt zu einer Schritt-ID, um eine Schleife zu bilden, und Mich benachrichtigen (notify_owner) schickt Ihnen eine E-Mail, höchstens 20 pro Stunde und Automatisierung. Schlägt ein Schritt fehl, werden die folgenden Schritte übersprungen und der Lauf endet als Fehlgeschlagen. Meinen Webhook aufrufen sendet JSON per POST mit event „automation.step“, dry_run, run_id, der Nummer, dem Kontakt (wa_id, name), der Nachricht (id, type, text, at) und bis zu 10 letzten Nachrichten des Chats. Die Signatur steht in X-EC-Signature als t=<unix>,v1=<HMAC-SHA256 von „<t>.<body>“> und wird mit dem Signaturgeheimnis des Schritts gebildet. Die URL muss öffentlich über HTTPS erreichbar sein, Weiterleitungen werden nicht gefolgt.

Reply with text (reply_text)"Send a fixed message": a Message of up to 4,096 characters, with variables.
Send a template (send_template)"Send an approved template": Template name, Language code, up to 20 body variables by position.
Reply with AI (ai_reply)"Your AI writes the reply": Provider, Model, Instructions, Earlier messages it reads, Longest reply (tokens).
Call my webhook (call_webhook)"Hand off to n8n or your backend": a Webhook URL; {"reply": "..."} returned within 20 seconds is sent.
Wait (wait)"Pause before the next step": 1 to 1,380 Minutes; your reply from the phone skips the rest.
Stop (stop)"End the automation": allowed only as the last step of its line.

Welche Variablen können Schritte füllen?

Vier werden aus der Nachricht gefüllt, die den Lauf gestartet hat, in doppelten geschweiften Klammern geschrieben; {{contact.<field>}} fügt ein Kontaktfeld hinzu (auch contact.name und contact.phone) und {{vars.<path>}} das, was frühere Schritte gespeichert haben, etwa die Antwort eines Schritts Eine API aufrufen. Sie funktionieren im Text von Mit Text antworten, in den Body-Variablen einer Vorlage, in den Anweisungen von Mit KI antworten und im Text anderer Schritte wie Eine Frage stellen. In den Variablen einer Vorlage fügen die Chips „Einfügen:“ sie hinzu. Ein unbekannter Wert, etwa ein Profil ohne Namen, wird leer. Vorlagen-Sendungen tragen nur Body-Variablen, nach Position. Daher kann eine Vorlage mit benannten Variablen, einem Header-Bild, einer Header-Variable oder einem Button mit Variable noch nicht gewählt werden, und eine leer gelassene Variable führt dazu, dass Meta den Versand ablehnt.

  • {{first_name}}: das erste Wort des WhatsApp-Profilnamens des Kunden („Vorname“).
  • {{name}}: der volle Profilname („Vollständiger Name“).
  • {{message}}: der Text der Nachricht oder ihr Platzhalter wie „[image]“ plus Bildunterschrift („Nachricht des Kunden“).
  • {{phone}}: die Nummer des Kunden als internationale Ziffern ohne Pluszeichen, etwa 5511999998888 („Telefon des Kunden“).
  • Im Test heißt der Kunde „Testkunde“ und die Telefonnummer ist 15550000000.

Welche Einstellungen gibt es und was sind die Standardwerte?

Zwei Einstellungen stehen unter „Erweitert“, dem Button neben dem Ein-Schalter im Editor, und der KI-Schritt hat zwei eigene. Ein weggelassenes Feld bekommt seinen Standardwert, im Editor wie über create_automation. Zeitlimits sind fest statt einstellbar: Eine KI-Antwort hat 45 Sekunden, ein Webhook 20 Sekunden. Der Name einer Automatisierung darf bis zu 120 Zeichen lang sein. Ein KI-Agent hat eigene Einstellungen: frühere Nachrichten, die er liest, 0 bis 40 (standardmäßig 20), längste Antwort 100 bis 4000 Token (standardmäßig 800), bis zu 10 Tool-Aufrufe pro Antwort (standardmäßig 5) und Stunden der Übergabe, 1 bis 168 (standardmäßig 24).

Pause on a chat after I answer it (hours)takeoverHours, 0 to 168, default 4. 0 turns the pause off; a reply still ends a waiting step.
AI replies per chat per hour, at mostaiMaxPerHour, 1 to 60, default 10, counted per chat in a one-hour window.
Earlier messages it readshistory, 0 to 20, default 10, from the messages kept for that chat.
Longest reply (tokens)maxTokens, 50 to 2,000, default 600. An answer that reaches it stops there.
The On and Off switchenabled, default true: a new automation saves On, in the editor and through create_automation.
Try itSamples of up to 2,000 characters, 60 tests per hour in the dashboard.

Welche Automatisierung antwortet, wenn mehrere passen?

Höchstens eine, in fester Reihenfolge gewählt: zuerst Hat Schlüsselwort, dann Erste Nachricht, dann Außerhalb der Öffnungszeiten, dann Jede Nachricht. Innerhalb derselben Art gewinnt die älteste Automatisierung. Nur Automatisierungen, die eingeschaltet und nicht pausiert sind, konkurrieren. Ist die Schlüsselwort-Regel aus oder durch einen abgelehnten KI-Schlüssel pausiert, antwortet daher die Auffangregel „Jede Nachricht“. Zwei Folgen überraschen Leute. Ein neuer Kunde, der nachts schreibt, bekommt die Automatisierung Erste Nachricht und nicht die für Außerhalb der Öffnungszeiten, weil Erste Nachricht höher rangiert. Und eine Nachricht, die eine Schlüsselwort-Automatisierung beantwortet, erreicht weder einen KI-Agenten noch einen Schritt Mit KI antworten bei Jede Nachricht. Setzen Sie deshalb den Agenten oder den KI-Schritt in die Schlüsselwort-Automatisierung, wenn Sie beides wollen. Eine Nachricht, die einen offenen Schritt Eine Frage stellen beantwortet, gehört zu dieser Frage, und keine andere Automatisierung startet damit. Tag- und Webhook-Automatisierungen starten durch ihre eigenen Ereignisse und nehmen an dieser Reihenfolge nicht teil.

Welche Schutzmechanismen sind eingebaut?

Der Runner wendet diese ohne Einstellung an. Die Überspringgründe im Tab Läufe nennen sie, wenn sie einen Lauf stoppen:

  • Eine Nachricht, die Meta doppelt zustellt, startet nur einen Lauf: Duplikate werden anhand der Nachrichten-ID verworfen.
  • Reaktionen, Status, die eigenen Sendungen der Automatisierung und Ihre Echos aus der App starten nie einen Lauf.
  • Mit Text antworten, Eine Frage stellen, Bild oder Datei senden, Mit KI antworten, die Antwort eines Agenten und die Antwort eines Webhooks brauchen eine letzte Kundennachricht, die jünger als 24 Stunden ist. Vorlage senden braucht sie nicht.
  • Eine Antwort, die Sie in der WhatsApp-Business-App tippen, pausiert die Automatisierung für diesen Chat, und ein dort wartender Lauf überspringt seine restlichen Schritte.
  • Eine neuere Nachricht, die dieselbe Automatisierung im selben Chat startet, ersetzt den Lauf, der dort noch in einem Schritt Warten wartet; eine Nachricht, die eine offene Frage beantwortet, geht stattdessen an diese Frage.
  • Sendungen von einer Nummer liegen mindestens 100 ms auseinander, unter Metas Grenze von 20 pro Sekunde für Coexistence-Nummern.
  • Ein fehlgeschlagener Schritt schickt Ihnen eine E-Mail, höchstens einmal pro Automatisierung alle 6 Stunden. Ein abgelehnter KI-Schlüssel pausiert die Automatisierungen dieses Anbieters und sendet eine E-Mail.

Was nimmt das Tool create_automation entgegen?

Der MCP-Connector hat neunzehn Tools für Automatisierungen und das, was sie nutzen. Acht sind für Automatisierungen: set_inbound_mode, list_automations, create_automation, update_automation, delete_automation, test_automation, list_automation_runs und get_automation_run. Acht sind für Agenten und Dateien: list_agents, list_files, create_agent, update_agent, delete_agent, add_agent_knowledge, delete_agent_knowledge und test_agent. Drei sind für Personen: list_conversations, get_conversation und update_contact. create_automation nimmt connection_id (aus list_numbers), name, enabled, trigger, steps und settings, in snake_case wie keyword_mode und max_tokens; camelCase wird ebenfalls akzeptiert. Die Schritt-Objekte sind reply_text {text}, send_template {name, language, params}, ai_reply {provider, model, prompt, history, max_tokens}, call_webhook {url} und wait {minutes}, dann 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} und stop. update_automation behält die Felder, die Sie weglassen, und steps ersetzt, wenn angegeben, die ganze Liste. Fehler nennen das betroffene Feld, etwa „trigger.keywords: Add at least one keyword“, „steps.2: Stop must be the last step of its line“ oder „steps.0: save your openai API key on the Automations page first“. KI-Schlüssel gehen nie über MCP. Im Beispiel sorgt das 1-minütige Warten dafür, dass ein Kunde, der mehrere Zeilen auf einmal schickt, nur eine Antwort bekommt.

create_automation arguments: an after-hours AI assistant, saved Off to test first
{
  "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 }
}

Häufige Fehler

  • Ein zweibuchstabiges Schlüsselwort mit Enthält verwenden. „oi“ passt auch auf „noite“ und „boi“, daher antwortet die Automatisierung auf Nachrichten, die sie nie erreichen sollten. Nutzen Sie Ist genau oder ein längeres Schlüsselwort.
  • Nur die Schreibweise mit Akzent auflisten. Der Abgleich ignoriert Groß- und Kleinschreibung, aber nicht Akzente, daher verfehlt „preço“ Kunden, die „preco“ tippen. Tragen Sie beide ein.
  • Erwarten, dass Erste Nachricht Stammkunden auslässt. Sie greift für jeden Kunden, dessen Chat easyCoexistence seit 30 Tagen nicht gesehen hat. Langjährige Kunden bekommen die Begrüßung also bei ihrer ersten Nachricht, nachdem Sie sie eingeschaltet haben.
  • Eine Vorlage wählen, die ein Header-Bild oder einen Button zum Kopieren des Codes braucht. Automatisierungen füllen nur Body-Variablen, daher listet der Editor sie, lässt sie aber nicht wählen. Über MCP eingerichtet, lehnt Meta den Versand ab und der Lauf schlägt fehl.
Mit EasyCoexistence

easyCoexistence führt diese Automatisierungen auf der WhatsApp-Business-Nummer aus, die Sie weiter in der App nutzen, über Metas Cloud API und Coexistence. Erstellen Sie sie im Editor unter Automatisierungen, Neue Automatisierung, oder lassen Sie ChatGPT oder Claude create_automation und test_automation über den MCP-Connector aufrufen, der mehr als 30 Tools hat. Von US$ 9 bis US$ 0.75 pro Nummer und Monat, sinkend mit jeder weiteren Nummer, die ersten 3 Tage kostenlos.

Häufig gestellte Fragen

Kann eine Automatisierung danach verzweigen, was der Kunde sagt?

Ja. In Pfade aufteilen (condition) verzweigt nach dem Nachrichtentext, einem Kontaktfeld, einem Tag, einer früheren API-Antwort oder Ihren Öffnungszeiten, und KI wählt den Pfad (ai_decide) entscheidet nach Bedeutung, in jeder Sprache, auf Ihrem eigenen Modell. Jeder Pfad hat seine eigene Reihe von Schritten, und eine Reihe Sonst fängt den Rest auf. Sie können die Entscheidung auch n8n oder Ihrem Backend über Meinen Webhook aufrufen überlassen, das für jeden Fall eine andere {"reply": "..."} zurückgeben kann.

Gibt es eine Begrenzung für Automatisierungen oder Läufe?

Es gibt keine Obergrenze für Läufe, keine Zusatzgebühr dafür und keine Begrenzung, wie viele Automatisierungen eine Nummer hat. Die geltenden Grenzen gelten pro Chat: KI-Antworten pro Stunde, Metas 24-Stunden-Regel für Text und die Pause, nachdem Sie vom Telefon aus geantwortet haben.

Kann ich eine Automatisierung auf eine andere Nummer verschieben oder kopieren?

Verschieben Sie sie, indem Sie ihre Verbindung im Editor ändern oder mit update_automation und einer neuen connection_id. Läufe, die noch auf der alten Nummer warten, enden als ersetzt. Zum Kopieren bitten Sie Ihre KI, sie mit list_automations zu lesen und denselben Trigger und dieselben Schritte auf der anderen Nummer anzulegen.

Was passiert mit wartenden Läufen, wenn ich eine Automatisierung bearbeite?

Sie laufen weiter. Ein Lauf, der auf einem Warten steht, setzt beim Aufwachen mit der Schrittnummer fort, wie die Automatisierung dann gespeichert ist. Daher kann eine Änderung verändern, was er sendet. Um sie zu stoppen, schalten Sie die Automatisierung aus: Dann enden sie als Übersprungen mit „Automation is off“.

Weiterlesen

Bereit für den Start?

Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.

Kostenlose Testphase starten

Verifiziert am