Trigger von Automatisierungen

Ein Trigger legt fest, wann eine Automatisierung einen Durchlauf startet. Diese Seite listet alle Trigger auf, die in jedem Kontext verfügbar sind, was sie auslöst, ihre Optionen und die Kennung, die Sie in der API dafür verwenden.

So funktionieren Trigger

• Ein Trigger pro Automatisierung in der Weboberfläche. Wählen Sie den Trigger auf der Arbeitsfläche aus und ändern Sie ihn mit Trigger type. Per API können Contact- und Email-Automatisierungen mehrere Trigger haben, sofern alle mit demselben ersten Schritt verbunden sind. Event-Automatisierungen haben genau einen.
• Die Automatisierung muss laufen. Trigger in Automatisierungen, die Entwürfe, pausiert oder gestoppt sind, werden ignoriert. Events aus der Zeit, bevor Sie eine Automatisierung starten, starten auch später keine Durchläufe.
• Durchläufe starten innerhalb von Sekunden. Emailit holt neue Events alle paar Sekunden ab.

Filter

Der Trigger Contact updated und alle E-Mail-Trigger nehmen unter Filter events (optional) einen optionalen Filter an. Jede Regel vergleicht ein Feld des Events mit einem Wert:

• Operatoren: Equals, Not equals, Contains, Not contains, Greater than, Less than, Is set, Is not set, In, Not in, Starts with und Ends with. Greater than und Less than vergleichen Zahlen. Die übrigen vergleichen Text und beachten die Groß-/Kleinschreibung.
• Abgleichmodus: All rules match oder Any rule matches.

Per API ist ein Filter { "match": "all", "rules": [{ "field": "...", "operator": "equals", "value": "..." }] } in config.filter des Triggers, wobei match auf all oder any steht. Felder sind Pfade in das Objekt des Events, zum Beispiel to oder link.url.

Kontakt-Trigger

Added to audience

Löst aus, wenn jemand einer Kontaktliste hinzugefügt wird: in der Weboberfläche (Add subscriber, Add to audience, Add contact mit Kontaktlisten), per API (Abonnent hinzufügen oder Kontakt erstellen mit audiences) oder mit der Massenaktion Add to audience. Auch das erneute Hinzufügen einer abgemeldeten Person löst ihn aus.

Er löst nicht aus für Kontakte, die durch einen Dateiimport, eine Anmeldung über die Anmelde-URL oder den Schritt Add to audience oder Create contact einer anderen Automatisierung hinzugefügt werden, und auch das erneute Einschalten von Subscribed bei einem bestehenden Abonnenten zählt nicht.

Removed from audience

Löst aus, wenn ein Abonnent gelöscht wird: Delete auf der Seite der Kontaktliste, Remove from audience, Abonnent löschen oder eine Kontaktaktualisierung, deren Liste audiences die Kontaktliste nicht mehr enthält. Das Löschen eines Kontakts löst ihn einmal für jede Kontaktliste aus, auf der der Kontakt war. Eine Abmeldung löst ihn nicht aus, weil die Person auf der Kontaktliste bleibt.

Contact updated

Löst aus, wann immer ein Kontakt in der Weboberfläche oder per API aktualisiert wird, einschließlich der Massenaktionen Unsubscribe und Resubscribe. Der Filter kann die aktuellen Werte von Email, First name, Last name, Unsubscribed und den eigenen Feldern prüfen sowie deren vorherige Werte, die als Previous email, Previous first name und so weiter aufgeführt sind. Vorherige Werte gibt es nur für die Felder, die sich geändert haben.

Um zum Beispiel darauf zu reagieren, dass ein Kontakt in den Tarif pro wechselt, fügen Sie mit All rules match zwei Regeln hinzu: custom_fields.plan Equals pro und Previous plan (previous.custom_fields.plan) Not equals pro.

Date anniversary

Wählen Sie ein Date field, also ein eigenes Feld vom Typ Datum, etwa einen Geburtstag. Einmal täglich startet Emailit einen Durchlauf für jeden Kontakt, dessen Datum Monat und Tag von heute hat, in UTC. Das Jahr spielt keine Rolle: Ein Kontakt mit 1990-04-12 erhält jedes Jahr am 12. April einen Durchlauf. Jede Automatisierung verarbeitet bis zu 10.000 Kontakte pro Tag.

Kontakt-Trigger nur per API

Die API akzeptiert außerdem contact.visits_url, contact.on_purchase und contact.on_event, aber noch löst nichts sie aus.

E-Mail-Trigger

E-Mail-Trigger lösen bei E-Mails in Ihrem Workspace aus: alles, was Sie per API oder SMTP senden, E-Mails aus Kampagnen und Automatisierungen sowie eingehende E-Mails bei Email received. Jeder Durchlauf betrifft eine E-Mail.

Der Editor listet außerdem Email accepted, Email scheduled, Email attempted und Email rejected auf. Automatisierungen mit diesen Triggern lassen sich noch nicht speichern, wählen Sie daher einen der Trigger oben. Per API können Sie außerdem email.canceled verwenden, das auslöst, wenn eine geplante oder in der Warteschlange stehende E-Mail storniert wird.

Event-Trigger

Event-Automatisierungen lassen sich vorerst nur per API erstellen.

Manual trigger

Rufen Sie den Trigger-Endpunkt einer laufenden Automatisierung auf, optional mit einem Objekt payload:

curl https://api.emailit.com/v2/automations/aut_3Mv8Xq2nKp5Lt/trigger \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "payload": { "email": "ada@example.com", "plan": "pro" } }'

Der Endpunkt gibt { "message": "Automation trigger dispatched." } zurück, oder 422, wenn die Automatisierung nicht läuft. Schritte können den Payload als {{payload.email}}, {{payload.plan}} und so weiter lesen. Emailit ergänzt den Payload um automation_id.

system.manual funktioniert auch als Trigger in Contact- und Email-Automatisierungen, die per API erstellt wurden. Geben Sie contact_id (eine con_-ID) oder email_id im Payload an, um die Automatisierung für diesen Kontakt oder diese E-Mail auszuführen.

Für Schritte verfügbare Daten

Schritteinstellungen, etwa der Empfänger von Send email oder die Werte von Edit contact, können Platzhalter enthalten, die für jeden Durchlauf ausgefüllt werden:

E-Mail-Vorlagen, die Send email sendet, verwenden Temple mit denselben Daten. Siehe Schritte.

Siehe auch