Hilfe & Wissen Welche Automation-Vorlagen gibt es und wie verwende ich sie?

Welche Automation-Vorlagen gibt es und wie verwende ich sie?

Mit den Automation-Vorlagen in kajomi MAIL können Sie Newsletter-Prozesse, Benachrichtigungen, Webhooks und Datenimporte ohne eigenes Programmieren einrichten. Diese Übersicht erklärt die 27 verfügbaren Vorlagen aus dem Automation-Template-Katalog, ihre Auslöser und die jeweiligen Konfigurationsfelder.

Wie lege ich eine Automation mit einer Vorlage an?

  1. Öffnen Sie in kajomi MAIL den Bereich Autom./DOI und klicken Sie auf Automation hinzufügen.
  2. Wählen Sie die gewünschte Vorlage. Je nach Vorlage handelt es sich um eine eventgesteuerte, zeitgesteuerte, Webhook- oder E-Mail-Hook-Automation.
  3. Füllen Sie die angezeigten Felder aus. Die Feldnamen und Standardwerte finden Sie weiter unten bei jeder Vorlage.
  4. Bei zeitgesteuerten Automationen legen Sie einen Cron-Zeitplan fest. Passen Sie die Ausführungshäufigkeit an die Vorlage an.
  5. Prüfen Sie den erzeugten Code sowie alle Parameter und aktivieren Sie die Automation erst nach einem Test.

Hinweis: Eine E-Mail, die Sie in einer Automation auswählen möchten, muss in der Versandplanung als Vorlage gespeichert worden sein. Eine Vorlage ausschließlich im E-Mail-Builder genügt hierfür nicht.

Welche Automation-Typen gibt es?

Typ Auslöser Anzahl im Katalog
Ereignis (event) Ein passendes An- oder Abmeldeereignis 11
Zeitplan (cron) Automatisch anhand des festgelegten Cron-Zeitplans 12
HTTP-Aufruf (webhook) Aufruf eines zugehörigen Webhook-Endpunkts 3
Eingehende E-Mail (emailhook) Eingang einer E-Mail an die Hook-Adresse 1

Was bedeuten die Feldtypen?

Feldtyp Bedeutung
List Auswahl eines Verteilers (Listen-ID).
Template Auswahl einer gespeicherten Mailing-/Versandvorlage.
ConfirmTemplate Auswahl einer DOI-/Bestätigungsmailvorlage.
Userfield Auswahl eines Empfängerfeldes, z. B. user1.
@Userfield Optionales Userfeld (im Salesforce-Template).
EMail E-Mail-Adresse.
HTTPURL Webadresse für einen HTTP-Aufruf.
HTTPMethod HTTP-Methode, etwa GET oder POST.
Userselection Empfängerselektion (Auswahlbedingung).
Marker Markername zum Ausschließen bereits angeschriebener Empfänger.
date Datumswert.
str Textzeichenfolge.
int Ganze Zahl.
bool Wahrheitswert true/false.
dict Objekt bzw. Schlüssel-Wert-Zuordnung.
list Liste von Werten.
["list", "List"] Liste von Verteilern.
["list", "Template"] Liste von Mailing-Vorlagen.

In den folgenden Tabellen bedeutet — in der Spalte „Standard“: Im gelieferten Template ist kein Default-Wert hinterlegt (null). Das heißt nicht automatisch, dass das Feld optional ist.

Übersicht aller 27 Vorlagen

Nr. Vorlage Typ
1 DOI (Double-Opt-In) event
2 Welcome Mail (Willkommensmail) event
3 Birthday Mailing (Geburtstagsmailing) cron
4 Last Newsletter (letzten Newsletter versenden) event
5 Notification on subscribe (Anmeldebenachrichtigung) event
6 Notification on unsubscribe (Abmeldebenachrichtigung) event
7 Webhook on subscribe (Webhook bei Anmeldung) event
8 Webhook on unsubscribe (Webhook bei Abmeldung) event
9 Welcome Mail after x days (zeitversetzte Willkommensmail) cron
10 Redoi Mail after x days (erneute DOI-Anfrage) cron
11 Bonuscodes notification (Gutscheincode-Warnung) cron
12 Subscribe to more than one list (Mehrfachanmeldung nach DOI) event
13 DOI only if Userfield has value (bedingte DOI-Mail) event
14 Add user with ref in List (Webhook-Anmeldung) webhook
15 SOVENDUS LEADS (Sovendus-Kontakte importieren) webhook
16 Add email to global blacklist (globale Sperrliste) event
17 Add email to local blacklist (verteilerbezogene Sperrliste) event
18 Delete all unsubscribed users after x days (Abgemeldete löschen) cron
19 Subscribe to more than one list (Webhook-Mehrfachanmeldung) webhook
20 Delete templist older than (Temporäre Listen bereinigen) cron
21 Delete mailings older than (inaktive Mailings löschen) cron
22 Series/Drips of mailings (mehrstufige Mailfolge) cron
23 PromptMail for newsletter subscription (E-Mail-Hook) emailhook
24 Send E-Mail at a specific date (datumsgesteuerter Versand) cron
25 Pull data from Salesforce (Salesforce-Synchronisierung) cron
26 Check SSL for hostname and send an email (SSL-Warnung) cron
27 RSS Feed – Newsletter bei neuen Artikeln cron

Die Automation-Vorlagen im Detail

Vorlage 1

DOI (Double-Opt-In)

Typ: event · Template-ID: 1

Definition und Benutzung

Versendet eine Double-Opt-In-Bestätigungsmail, wenn sich ein noch nicht bestätigter Empfänger über ein Anmeldeformular anmeldet.

Die Vorlage reagiert auf KMSignup mit action=sub. Sie prüft, ob der Bestätigungsstatus (cnf) 0 oder 4 ist und die Anmeldung zum gewählten Verteiler gehört. Anschließend wird die ausgewählte DOI-Mail als Transaktionsmail verschickt.

Typischer Anwendungsfall

Ein neuer Newsletter-Abonnent soll zur Bestätigung seiner E-Mail-Adresse eine DOI-Nachricht erhalten.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id ConfirmTemplate ID einer Double-Opt-In-Bestätigungsvorlage (ConfirmTemplate). —

Wichtige Hinweise

  • Wählen Sie eine passende Bestätigungsvorlage (ConfirmTemplate), nicht einfach eine beliebige Newsletter-Mail.
  • Die Automation verschickt die DOI-Nachricht. Der Bestätigungslink muss in der verwendeten Mailvorlage korrekt eingerichtet sein.

Vorlage 2

Welcome Mail (Willkommensmail)

Typ: event · Template-ID: 2

Definition und Benutzung

Versendet eine Willkommensmail nach erfolgreicher Anmeldung bzw. DOI-Bestätigung.

Die Vorlage reagiert auf das Signup-Ereignis sub mit Label coi oder auf das Ereignis doi und prüft den ausgewählten Verteiler. Die hinterlegte Versandvorlage wird anschließend als Transaktionsmail gesendet.

Typischer Anwendungsfall

Nach einer bestätigten Newsletter-Anmeldung soll automatisch eine Begrüßungsnachricht verschickt werden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Die Mailvorlage muss in der Versandplanung als Vorlage verfügbar sein.

Vorlage 3

Birthday Mailing (Geburtstagsmailing)

Typ: cron · Template-ID: 3

Definition und Benutzung

Versendet ein Mailing an Empfänger, deren Geburtstag am Ausführungstag liegt.

Beim zeitgesteuerten Aufruf wird eine Empfängerauswahl mit today() == birthday() und birthdate != "" gebildet. Zusätzlich filtert das Template nach dem Bestätigungsstatus cnf=1 und startet das Mailing mit der hinterlegten Vorlage.

Typischer Anwendungsfall

Täglich am Morgen einen Geburtstagsgruß an bestätigte Empfänger senden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Führen Sie diese Vorlage möglichst nur einmal täglich aus: Im hinterlegten Code gibt es keine zusätzliche Sperre gegen wiederholte Ausführung am selben Geburtstag.
  • Das Geburtsdatum muss im Empfängerdatensatz gepflegt sein.

Vorlage 4

Last Newsletter (letzten Newsletter versenden)

Typ: event · Template-ID: 4

Definition und Benutzung

Schickt neuen bestätigten Abonnenten eine Kopie eines bereits versendeten Newsletters.

Nach dem DOI-/COI-Ereignis sucht die Vorlage im angegebenen Verteiler nach einem bereits versendeten, nicht-transaktionalen Mailing mit einer Empfängerzahl oberhalb von size (size > ..., status > 1). Das gefundene Mailing wird als virtuelle Vorlage (VIRT) an den neuen Empfänger geschickt.

Typischer Anwendungsfall

Neue Abonnenten sollen den letzten regulären Newsletter nachträglich bekommen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
size int Mindestanzahl von Empfängern des gesuchten letzten Mailings (Vergleich ist >). —

Wichtige Hinweise

  • size ist eine Mindestgröße als strenger Vergleich: Die gefundene Versandgröße muss größer als der konfigurierte Wert sein.
  • Wenn kein passendes Mailing gefunden wird, erfolgt kein Versand.

Vorlage 5

Notification on subscribe (Anmeldebenachrichtigung)

Typ: event · Template-ID: 5

Definition und Benutzung

Versendet eine Benachrichtigung an eine festgelegte E-Mail-Adresse, sobald sich ein Empfänger bestätigt anmeldet.

Bei KMSignup/doi oder sub mit Label coi wird eine Transaktionsmail an die konfigurierte email im Verteiler send_listnum verschickt. Der angemeldete Empfänger wird als event_user übergeben.

Typischer Anwendungsfall

Ein internes Team soll über neue bestätigte Newsletter-Anmeldungen informiert werden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List Verteiler, dessen Anmeldung überwacht wird. —
email EMail E-Mail-Adresse, an die die Benachrichtigung versendet wird. —
send_listnum List Verteilerzuordnung für den Benachrichtigungsempfänger. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • listnum ist der überwachte Verteiler; send_listnum ist der Verteiler-Kontext des Benachrichtigungsempfängers.
  • Stellen Sie sicher, dass die Empfängeradresse für den vorgesehenen Transaktionsversand zulässig ist.

Vorlage 6

Notification on unsubscribe (Abmeldebenachrichtigung)

Typ: event · Template-ID: 6

Definition und Benutzung

Informiert eine festgelegte E-Mail-Adresse über eine Newsletter-Abmeldung.

Reagiert auf KMSignup mit action=unsub im ausgewählten Verteiler. Danach wird eine Transaktionsmail an die konfigurierte Adresse im Verteiler send_listnum gesendet; der abgemeldete Empfänger wird als event_user mitgegeben.

Typischer Anwendungsfall

Eine interne Adresse erhält eine Nachricht, sobald sich jemand aus einem bestimmten Verteiler abmeldet.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List Verteiler, dessen Abmeldung überwacht wird. —
email EMail E-Mail-Adresse, an die die Benachrichtigung versendet wird. —
send_listnum List Verteilerzuordnung für den Benachrichtigungsempfänger. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Überprüfen Sie den Betreff bzw. Inhalt Ihrer Benachrichtigungsvorlage: Im Quellcode wird als technische Beschreibung auch bei der Abmeldung Notification on subscribe verwendet.

Vorlage 7

Webhook on subscribe (Webhook bei Anmeldung)

Typ: event · Template-ID: 7

Definition und Benutzung

Ruft bei einer bestätigten Anmeldung eine externe URL auf.

Die Vorlage reagiert auf KMSignup mit doi oder sub/coi im ausgewählten Verteiler. Mit call_url sendet sie eine Anfrage an url mit method, params, dem Benutzerobjekt und der Verteiler-ID. form_fields wird als Argument to_string übergeben.

Typischer Anwendungsfall

Einen neuen bestätigten Kontakt an einen externen Dienst oder ein CRM melden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
url HTTPURL Zieladresse für den ausgehenden HTTP-Aufruf. —
method HTTPMethod HTTP-Methode für den ausgehenden Request, z. B. POST. —
params dict Dictionary mit zusätzlichen Request-Parametern. —
form_fields bool Wird als Boolean to_string an call_url weitergegeben. true

Wichtige Hinweise

  • Prüfen Sie beim Zielsystem, welche HTTP-Methode und welche Parameter benötigt werden.
  • Nutzen Sie für externe Webhooks eine abgesicherte HTTPS-Adresse und übertragen Sie nur erforderliche personenbezogene Daten.

Vorlage 8

Webhook on unsubscribe (Webhook bei Abmeldung)

Typ: event · Template-ID: 8

Definition und Benutzung

Ruft beim Abmelden eines Empfängers eine externe URL auf.

Die Vorlage reagiert auf KMSignup mit action=unsub für den gewählten Verteiler. Sie übergibt URL, Methode, Parameter, Benutzerobjekt und Listen-ID an call_url; der Wert von form_fields wird als to_string weitergereicht.

Typischer Anwendungsfall

Abmeldungen an ein verbundenes CRM oder ein anderes externes System melden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
url HTTPURL Zieladresse für den ausgehenden HTTP-Aufruf. —
method HTTPMethod HTTP-Methode für den ausgehenden Request, z. B. POST. —
params dict Dictionary mit zusätzlichen Request-Parametern. —
form_fields bool Wird als Boolean to_string an call_url weitergegeben. true

Wichtige Hinweise

  • Das Zielsystem muss eine Abmeldung bzw. Sperrung korrekt verarbeiten, damit abgemeldete Empfänger nicht erneut angeschrieben werden.

Vorlage 9

Welcome Mail after x days (zeitversetzte Willkommensmail)

Typ: cron · Template-ID: 9

Definition und Benutzung

Versendet eine Mail nach einer bestimmten Anzahl von Tagen seit der Anmeldung.

Bei jedem geplanten Lauf werden Empfänger mit dateadd nach startdate und älter als days Tage ausgewählt. Eine Blacklist-Selektion über marker_unique_for_this_mail schließt bereits markierte Empfänger aus. Nach dem Versand wird der Marker für die Mailing-Empfänger gesetzt.

Typischer Anwendungsfall

Drei Tage nach einer Anmeldung soll eine zweite Begrüßungsmail versendet werden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
startdate date Stichtag, ab dem angemeldete Empfänger berücksichtigt werden. —
days int Tage zwischen Anmeldung und geplanter Willkommensmail. —
marker_unique_for_this_mail Marker Eindeutiger Marker, der bereits angeschriebene Empfänger ausschließt. —
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Verwenden Sie je Mailfolge einen eindeutigen Marker, damit Empfänger nicht mehrfach dieselbe Mail erhalten.
  • Im vorliegenden Template ist kein expliziter cnf=1-Filter enthalten. Prüfen Sie vor der Aktivierung, ob Ihre Versandregeln und die Auswahl nur zulässige Empfänger einschließen.

Vorlage 10

Redoi Mail after x days (erneute DOI-Anfrage)

Typ: cron · Template-ID: 10

Definition und Benutzung

Versendet nach einer Wartezeit erneut eine DOI-Nachricht an unbestätigte Empfänger.

Der Cron-Lauf wählt Empfänger anhand von startdate, Mindestalter days und cnf=0 aus. Ein eindeutiger Marker schließt bereits angeschriebene Kontakte aus; nach dem Mailing wird er gesetzt.

Typischer Anwendungsfall

Noch nicht bestätigte Anmeldungen einmalig an die Bestätigung erinnern.

Konfigurationsfelder

Feld Typ Beschreibung Standard
startdate date Stichtag, ab dem angemeldete Empfänger berücksichtigt werden. —
days int Anzahl Tage bis zum erneuten DOI-Versand. —
marker_unique_for_this_mail Marker Eindeutiger Marker, der bereits angeschriebene Empfänger ausschließt. —
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Wählen Sie als template_id die passende DOI-Erinnerungsmail.
  • Verwenden Sie pro Reminder einen separaten Marker und prüfen Sie Ihre rechtlichen Anforderungen an Erinnerungsmails.

Vorlage 11

Bonuscodes notification (Gutscheincode-Warnung)

Typ: cron · Template-ID: 11

Definition und Benutzung

Benachrichtigt eine festgelegte Adresse, wenn nur noch wenige unverbrauchte Gutscheincodes verfügbar sind.

Beim Cron-Lauf wird über determine_bonuscode_size(bonuscode_type) die verbleibende Anzahl abgefragt. Ist der Wert kleiner oder gleich bonuscode_size, wird eine Transaktionsmail an email gesendet. Typ und verbleibende Anzahl werden über add_fields übergeben.

Typischer Anwendungsfall

Bei weniger als oder genau zehn verfügbaren Gutscheincodes soll eine Warnung eintreffen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
bonuscode_type str Kennung des zu überprüfenden Gutscheincode-Typs. —
bonuscode_size int Warnschwelle für die Zahl verbleibender Gutscheincodes (<=). —
email EMail E-Mail-Adresse, an die die Benachrichtigung versendet wird. —
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Der Code enthält keine automatische Einmal-Sperre. Solange der Schwellenwert erreicht ist, kann bei jedem Cron-Lauf eine weitere Nachricht gesendet werden.
  • Nutzen Sie im E-Mail-Template die übergebenen Zusatzfelder für Gutscheintyp und Restanzahl.

Vorlage 12

Subscribe to more than one list (Mehrfachanmeldung nach DOI)

Typ: event · Template-ID: 12

Definition und Benutzung

Überträgt einen bestätigten Kontakt aus einem Kontrollverteiler in mehrere freigegebene Verteiler.

Nach dem passenden Anmelde-/Bestätigungsereignis liest der Code ein JSON-Objekt aus userfield und daraus die Liste unter key. Für Einträge aus allowed werden Benutzer in den jeweiligen Verteiler kopiert und dort auf cnf=1 gesetzt. Anschließend setzt der Code cnf im Kontrollverteiler auf 0.

Typischer Anwendungsfall

Ein Anmeldeformular erlaubt die Auswahl mehrerer Interessengebiete, die jeweils einem eigenen Verteiler entsprechen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
userfield Userfield Empfängerfeld, aus dem ein JSON-Objekt oder ein Vergleichswert gelesen wird. —
key str Schlüssel innerhalb eines JSON-Objekts, unter dem die Verteilerliste steht. —
allowed ["list", "List"] Liste der Verteiler-IDs, für die eine Anmeldung erlaubt ist. —

Wichtige Hinweise

  • Das Userfeld muss ein gültiges JSON-Objekt mit einer Liste unter dem konfigurierten Schlüssel enthalten.
  • Die Rücksetzung des Status im Kontrollverteiler (cnf=0) ist Teil des gelieferten Codes. Berücksichtigen Sie dies in Ihrem DOI-Prozess.

Vorlage 13

DOI only if Userfield has value (bedingte DOI-Mail)

Typ: event · Template-ID: 13

Definition und Benutzung

Sendet eine DOI-Mail nur, wenn ein bestimmtes Userfeld exakt den vorgegebenen Wert hat.

Bei KMSignup/sub mit cnf 0 oder 4 prüft die Vorlage zusätzlich den Verteiler und str(user.get(userfield, "")) == value. Nur bei einem Treffer wird die Bestätigungsvorlage versendet.

Typischer Anwendungsfall

Eine andere Bestätigungsmail je nach Quelle, Merkmal oder Formularvariante versenden.

Konfigurationsfelder

Feld Typ Beschreibung Standard
userfield Userfield Zu prüfendes Empfängerfeld. —
value str Wert, dem der Inhalt des Userfeldes entsprechen muss. —
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id ConfirmTemplate ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —

Wichtige Hinweise

  • Der Wertvergleich ist exakt. Achten Sie auf Schreibweise, Leerzeichen und Groß-/Kleinschreibung.

Vorlage 14

Add user with ref in List (Webhook-Anmeldung)

Typ: webhook · Template-ID: 14

Definition und Benutzung

Fügt einen Empfänger per Webhook in einen Verteiler ein.

Die Automation übernimmt die übermittelten request["arguments"] als Benutzerdaten, setzt refurl auf den konfigurierten Referenzwert und ergänzt ipaddr aus request["remote_ip"], sofern dieses Feld fehlt. Danach wird add_user(listnum, user) aufgerufen.

Typischer Anwendungsfall

Ein eigenes Webformular oder ein externes System meldet Kontakte per GET- oder POST-Aufruf an.

Konfigurationsfelder

Feld Typ Beschreibung Standard
ref str Referenzangabe, die als refurl gespeichert wird. —
listnum List ID des betroffenen oder überwachten Verteilers. —

Wichtige Hinweise

  • Öffentliche Webhooks müssen gegen unerwünschte oder missbräuchliche Aufrufe abgesichert werden.
  • Der Code ergänzt keinen ausdrücklichen Double-Opt-In-Prozess; richten Sie erforderliche Bestätigungen separat ein.

Vorlage 15

SOVENDUS LEADS (Sovendus-Kontakte importieren)

Typ: webhook · Template-ID: 15

Definition und Benutzung

Übernimmt über einen Webhook übermittelte Leads von Sovendus in einen kajomi-Verteiler.

Der Code liest die Request-Parameter für Referenz, Vorname, Nachname, E-Mail-Adresse, IP-Adresse und Anrede. Herr wird auf sex=1 und Frau auf sex=2 abgebildet. Zwei Compliance-Werte werden mit base64_decode dekodiert und in die konfigurierten Userfelder geschrieben.

Typischer Anwendungsfall

Über Sovendus gewonnene Anmeldungen einschließlich Compliance-Informationen speichern.

Konfigurationsfelder

Feld Typ Beschreibung Standard
compliancetext Userfield Userfeld, in dem die dekodierte Einwilligungsinformation gespeichert wird. —
compliancetimestamp Userfield Userfeld für den dekodierten Compliance-Zeitstempel. —
listnum List ID des betroffenen oder überwachten Verteilers. —

Wichtige Hinweise

  • Stellen Sie sicher, dass compliancetext und compliancetimestamp auf geeignete Userfelder zeigen.
  • Die Vorlage übernimmt die Daten aus dem Request. Prüfen Sie die Absicherung des Webhooks und Ihre Einwilligungs-/DOI-Anforderungen.

Vorlage 16

Add email to global blacklist (globale Sperrliste)

Typ: event · Template-ID: 16

Definition und Benutzung

Setzt eine E-Mail-Adresse nach einer Abmeldung auf die globale Blacklist.

Bei KMSignup mit action=unsub wird add_email_to_blacklist(user.get("email"), listnum=0) aufgerufen.

Typischer Anwendungsfall

Eine Abmeldung soll nicht nur für den konkreten Verteiler, sondern global beachtet werden.

Konfigurationsfelder: Keine. Die Vorlage benötigt keine zusätzlichen Eingaben.

Wichtige Hinweise

  • Globale Wirkung: Im Code wird die Blacklist mit listnum=0 aufgerufen.
  • Keine zusätzlichen Konfigurationsfelder.

Vorlage 17

Add email to local blacklist (verteilerbezogene Sperrliste)

Typ: event · Template-ID: 17

Definition und Benutzung

Setzt eine E-Mail-Adresse nach einer Abmeldung auf die lokale Blacklist ihres Verteilers.

Bei KMSignup mit action=unsub wird add_email_to_blacklist(user.get("email"), listnum=user.get("list")) aufgerufen.

Typischer Anwendungsfall

Eine E-Mail-Adresse soll nur in dem Verteiler gesperrt werden, aus dem sie sich abmeldet.

Konfigurationsfelder: Keine. Die Vorlage benötigt keine zusätzlichen Eingaben.

Wichtige Hinweise

  • Verteilerbezogene Wirkung: Anders als Vorlage 16 wird die Listen-ID des Empfängers verwendet.
  • Keine zusätzlichen Konfigurationsfelder.

Vorlage 18

Delete all unsubscribed users after x days (Abgemeldete löschen)

Typ: cron · Template-ID: 18

Definition und Benutzung

Löscht abgemeldete Benutzer nach einer konfigurierten Anzahl von Tagen.

Der Cron-Code führt delete_users mit einer Selektion aus: cnf == 4 und last_cnf_changed_date älter oder gleich NOW() - days.

Typischer Anwendungsfall

Abgemeldete Kontakte nach einer definierten Aufbewahrungsfrist aus dem System entfernen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
days int Tage seit der letzten Änderung des Bestätigungsstatus. —

Wichtige Hinweise

  • Achtung: Löschvorgang. Testen Sie die Selektion und Ihre Aufbewahrungsregeln, bevor Sie die Automation aktivieren.
  • Laut Template-Beschreibung können gelöschte Kontakte bei einem späteren regulären Import erneut importiert werden.

Vorlage 19

Subscribe to more than one list (Webhook-Mehrfachanmeldung)

Typ: webhook · Template-ID: 19

Definition und Benutzung

Meldet einen über einen signierten Webhook übermittelten Kontakt für mehrere zugelassene Verteiler an.

Die Vorlage ruft check_signature(request) auf, liest aus listnums ein JSON-Objekt und daraus die Verteiler-IDs unter key. Sie akzeptiert nur Werte aus allowed, entfernt das Feld für die Verteilerwahl aus den Benutzerdaten und führt für jede freigegebene Liste add_user aus. Die Antwort wird als HTTP 200 mit einem eigenen JSON-Body festgelegt.

Typischer Anwendungsfall

Ein eigenes Signup-Formular soll mehrere Verteiler über einen einzigen signierten Aufruf bedienen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnums Userfield Userfeld, das ein JSON-Objekt mit Ziel-Verteiler-IDs enthält. —
key str Schlüssel innerhalb eines JSON-Objekts, unter dem die Verteilerliste steht. —
allowed ["list", "List"] Liste der Verteiler-IDs, für die eine Anmeldung erlaubt ist. —

Wichtige Hinweise

  • Diese Variante ist webhookgesteuert. Für die eventgesteuerte Variante nach der Anmeldung siehe Vorlage 12.
  • Ungültige oder nicht freigegebene Listen-IDs werden übersprungen. Fehler bei einzelnen add_user-Aufrufen werden laut Code abgefangen.
  • Die Vorlage gibt unter anderem id: -1 und listnum: -1 als Antwortwerte zurück; dies sind keine IDs der tatsächlich angelegten Abonnements.

Vorlage 20

Delete templist older than (Temporäre Listen bereinigen)

Typ: cron · Template-ID: 20

Definition und Benutzung

Löscht temporäre Listen eines bestimmten Typs, die älter als eine festgelegte Anzahl von Tagen sind.

Der Cron-Code ruft delete_templists_by_selection mit einer Auswahl auf, die den Typ in der Beschreibung und das Erstellungsdatum created berücksichtigt.

Typischer Anwendungsfall

Alte Whitelists und Blacklists regelmäßig bereinigen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
type str Typ der zu löschenden temporären Liste. —
days int Mindestalter temporärer Listen in Tagen. —

Wichtige Hinweise

  • Nach Template-Beschreibung sind whitelist, blacklist oder both mögliche Werte für type.
  • Die Beschreibung nennt maximal 1.000 temporäre Listen pro Aufruf. Prüfen Sie den Umfang vor dem Löschen.

Vorlage 21

Delete mailings older than (inaktive Mailings löschen)

Typ: cron · Template-ID: 21

Definition und Benutzung

Löscht alte inaktive Mailings.

Die Selektion für delete_mailings_by_selection prüft status == 0 und datesent älter oder gleich NOW() - days.

Typischer Anwendungsfall

Alte, nicht aktive Mailings regelmäßig entfernen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
days int Mindestalter inaktiver Mailings in Tagen. —

Wichtige Hinweise

  • Achtung: Löschvorgang. Betroffen sind Mailings mit status == 0; prüfen Sie die Definition dieses Status in Ihrem Mandanten.
  • Sichern Sie gegebenenfalls benötigte Inhalte oder Statistiken vor der Aktivierung.

Vorlage 22

Series/Drips of mailings (mehrstufige Mailfolge)

Typ: cron · Template-ID: 22

Definition und Benutzung

Versendet eine Reihe von Mailing-Vorlagen mit konfigurierbaren Tagen Abstand.

Der Cron-Lauf iteriert über template_ids und bildet für jede Stufe eine Selektion anhand von dripNumberField, dripLastDate und daysBetweenMailings. Für die erste Stufe kommt startSelection hinzu. Es werden nur Empfänger mit cnf=1 ausgewählt. Nach erfolgreichem Mailing-Aufruf werden Stufennummer und letzter Versandtag in den Userfeldern aktualisiert.

Typischer Anwendungsfall

Eine Onboarding-Serie mit drei Nachrichten alle sieben Tage.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
dripNumberField Userfield Userfeld für die Nummer der nächsten Stufe der Mailfolge. user1
dripLastDate Userfield Userfeld mit dem Datum des letzten Mailings innerhalb der Serie. user2
daysBetweenMailings int Mindestabstand in Tagen zwischen zwei Mailings. 28
startSelection Userselection Empfängerselektion für den Einstieg in die erste Stufe. 1
template_ids ["list", "Template"] Geordnete Liste von Versandvorlagen-IDs. []

Wichtige Hinweise

  • Verwenden Sie zwei geeignete Userfelder, um Schritt und Datum dauerhaft zu speichern.
  • Die Reihenfolge von template_ids bestimmt die Reihenfolge der Mailings.
  • Die Standardwerte sind user1, user2, 28, 1 und eine leere Vorlagenliste.

Vorlage 23

PromptMail for newsletter subscription (E-Mail-Hook)

Typ: emailhook · Template-ID: 23

Definition und Benutzung

Bearbeitet eine eingehende E-Mail als Newsletter-Anmeldeanfrage.

Die Automation parst die eingehende Mail, prüft die E-Mail-Adresse und sucht nach x_kjm_sig= im Text- oder HTML-Inhalt. Abhängig vom Ergebnis wird ein Kontakt angelegt, eine bestehende Anmeldung aktualisiert oder eine „Already in list“-Mail verschickt. Ohne entsprechenden Signaturhinweis wird redirect_mail() aufgerufen.

Typischer Anwendungsfall

Ein Empfänger kann eine Newsletter-Anmeldung über eine eingehende E-Mail auslösen.

Konfigurationsfelder

Feld Typ Beschreibung Standard
email_to_save Userfield Userfeld zum Speichern der eingehenden Original-E-Mail. —
listnum List Zielverteiler für die E-Mail-Anmeldung. —
template_id_already_subscribed Template Mailvorlage für Empfänger, die bereits angemeldet sind. —

Wichtige Hinweise

  • Das Feld email_to_save speichert laut Quellcode die gesamte eingehende E-Mail. Nutzen Sie dafür ein geeignetes Textfeld und beachten Sie Datenschutz und Aufbewahrung.
  • Für diese Vorlage wird ein emailhook benötigt; sie wird nicht durch einen Cron-Zeitplan ausgelöst.

Vorlage 24

Send E-Mail at a specific date (datumsgesteuerter Versand)

Typ: cron · Template-ID: 24

Definition und Benutzung

Versendet unterschiedliche Vorlagen an zuvor im Userfeld hinterlegten Terminen.

Ein Userfeld enthält Datums-/Template-Kombinationen. Bei einem Cron-Lauf wird für jede konfigurierte template_id geprüft, ob der aktuelle Tag mit dem gespeicherten Muster übereinstimmt. Für bestätigte Empfänger (cnf=1) wird dann ein Mailing gestartet.

Typischer Anwendungsfall

An einem bestimmten Datum erhält ein Empfänger eine passende Erinnerungs- oder Informationsmail.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
datesTemplateIdUserfield Userfield Userfeld mit Datum-/Template-Kombinationen. user1
template_ids ["list", "Template"] Geordnete Liste von Versandvorlagen-IDs. []

Wichtige Hinweise

  • Die Template-Beschreibung nennt als Format beispielsweise 2024-10-10:11T,2024-11-01:10T (Datum und Template-ID).
  • Nur einmal pro Tag ausführen. Die gelieferte Beschreibung warnt ausdrücklich vor doppelten oder ausbleibenden Sendungen bei anderer Ausführungsfrequenz.
  • Die ID muss sowohl im Userfeldwert als auch in template_ids vorkommen.

Vorlage 25

Pull data from Salesforce (Salesforce-Synchronisierung)

Typ: cron · Template-ID: 25

Definition und Benutzung

Lädt Daten über die Salesforce-API und startet damit einen kajomi-Empfängerimport.

Die Vorlage holt über OAuth-Client-Credentials ein Salesforce-Zugriffstoken, führt eine SOQL-Abfrage mit sf_table, sf_fields_mapping und sf_where aus und folgt gegebenenfalls nextRecordsUrl. Die Datensätze werden in CSV-Daten umgewandelt und mit create_import/update_import in den Verteiler importiert.

Typischer Anwendungsfall

Kontakte oder Abonnements aus Salesforce regelmäßig in einen kajomi-Verteiler synchronisieren.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
salesforce_url HTTPURL Basis-URL der Salesforce-Instanz. —
client_id str OAuth-Client-ID für die Salesforce-Verbindung. —
client_secret str OAuth-Client-Secret für die Salesforce-Verbindung. —
sf_fields_mapping dict Dictionary mit Zuordnung von Salesforce-Feldnamen zu kajomi-Feldnamen. —
sf_table str Salesforce-Objekt bzw. Tabelle der SOQL-Abfrage. —
sf_where str WHERE-Bedingung für die SOQL-Abfrage. —
is_live bool Steuert Live- bzw. Staging-Verarbeitung. true
unique_field str Eindeutiges Zielfeld für die Importsynchronisierung. email
mode_import str Importmodus, z. B. sync. sync
userfield_guid @Userfield Optionales kajomi-Userfeld, in das eine erzeugte GUID eingetragen werden kann. —
lastname_empty str Textmarkierung, die als leerer Nachname behandelt werden soll. [Unknown]
status_field str Salesforce-Feldname für den Anmeldestatus. vlocity_cmt__Status__c
lastname_field str Salesforce-Feldname für den Nachnamen. vlocity_cmt__ServiceContactId__r.LastName

Wichtige Hinweise

  • sf_fields_mapping ordnet Salesforce-Spalten kajomi-Zielfeldern zu.
  • is_live=false schreibt laut Code E-Mail-Adressen für die Staging-Verwendung um.
  • Für status_field ist eine Zuordnung nach cnf hinterlegt (Active → 1, sonst 2), wenn das Feld entsprechend gemappt ist.
  • Sicherheitsrelevant: client_secret ist ein Zugangsschlüssel. Speichern und teilen Sie solche Daten nur über geeignete Berechtigungen.
  • Testen Sie SOQL-Selektion, Feldmapping und Importmodus zunächst mit einem kleinen Datensatz.

Vorlage 26

Check SSL for hostname and send an email (SSL-Warnung)

Typ: cron · Template-ID: 26

Definition und Benutzung

Überprüft Hostnamen aus einem Verteiler auf die verbleibende SSL-Zertifikatslaufzeit und versendet Warnungen.

Für alle Empfänger im ausgewählten Verteiler liest die Vorlage Hostname, Datum der letzten Prüfung und den zuletzt gespeicherten Resttagewert. get_ssl_expiry_days ermittelt die verbleibenden Tage. Ist der Wert in days_list enthalten und verschieden vom zuletzt gespeicherten Wert, wird eine Transaktionsmail versendet; Prüfdatum und Restwert werden aktualisiert.

Typischer Anwendungsfall

30, 14, 7 oder 0 Tage vor Zertifikatsablauf eine Benachrichtigung erhalten.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —
hostname_field Userfield Userfeld mit dem Hostnamen. user1
last_checked_date_field Userfield Userfeld für das Datum der letzten Zertifikatsprüfung. user2
last_expiry_day Userfield Userfeld für die zuletzt ermittelte Resttagezahl. user3
days_list list Liste der Resttage, bei denen benachrichtigt werden soll. —

Wichtige Hinweise

  • Beispiel für days_list: [-1, 0, 7, 14, 30].
  • -1 steht laut Beschreibung für einen SSL-Fehler bzw. den tatsächlichen Tag -1. Bei Ausnahmen (z. B. Timeout) überspringt der Code den Host.
  • Verwenden Sie für Hostname, Prüfdatum und Resttage drei verschiedene geeignete Userfelder.

Vorlage 27

RSS Feed – Newsletter bei neuen Artikeln

Typ: cron · Template-ID: 27

Definition und Benutzung

Prüft einen RSS-Feed und startet ein Mailing, wenn neue Beiträge seit dem letzten passenden Versand vorhanden sind.

Der Cron-Lauf ruft den RSS-Feed ab, begrenzt die gelesenen Artikel über max_articles und sammelt bis zu max_articles_show Beiträge, deren Veröffentlichungsdatum neuer ist als der letzte passende Newsletter. Wenn noch kein Mailing gefunden wurde, gilt article_since_when als Startdatum. Bei mindestens einem neuen Beitrag wird ein Mailing mit einer virtuellen Kopie der gewählten Vorlage ausgelöst.

Typischer Anwendungsfall

Bei neuen Artikeln aus einem Blog oder Nachrichtendienst automatisch einen Newsletter starten.

Konfigurationsfelder

Feld Typ Beschreibung Standard
listnum List ID des betroffenen oder überwachten Verteilers. —
template_id Template ID der zu versendenden E-Mail-Vorlage; bei DOI die passende Bestätigungsvorlage. —
rss_feed_url HTTPURL URL des RSS-Feeds. —
max_articles int Maximalzahl der beim RSS-Abruf untersuchten Beiträge. 20
max_articles_show int Maximalzahl der in das Mailing übernommenen neuen Beiträge. 10
description str Bezeichnung zur Unterscheidung und Wiedererkennung des Mailings. RssFeedAutomation
article_since_when str Anfangsdatum, falls noch kein passendes zuvor versendetes Mailing existiert. 2025-03-13
users_selection Userselection Empfängerselektion für das erzeugte Mailing. 1

Wichtige Hinweise

  • description dient der Wiedererkennung des letzten durch diese Automation erzeugten Mailings. Wählen Sie eine möglichst eindeutige Bezeichnung.
  • Die Artikel werden im Zusatzfeld feed_items bereitgestellt. Die Versandvorlage muss diese Daten entsprechend darstellen.
  • Der mitgelieferte Standard für article_since_when ist 2025-03-13; setzen Sie bei neuem Einsatz ein passendes Startdatum.

Praxisbeispiele

Mehrere Verteiler über ein Formular auswählen (Vorlage 12 oder 19)

Angenommen, ein Feld user1 enthält die ausgewählten Verteiler als JSON-Objekt:

{"type": [7, 9]}

Konfigurieren Sie userfield (bzw. listnums bei Vorlage 19) als user1, key als type und allowed als [7, 9]. Vorlage 12 verarbeitet die Anmeldung eventgesteuert nach dem entsprechenden Signup-Ereignis; Vorlage 19 verarbeitet einen signierten Webhook.

SSL-Warnungen an definierten Tagen (Vorlage 26)

Tragen Sie bei days_list etwa [-1, 0, 7, 14, 30] ein. Eine Warnung wird nur verschickt, wenn die aktuelle Resttagezahl auf dieser Liste steht und sich vom gespeicherten Wert unterscheidet. Drei Userfelder speichern Hostname, Prüfdatum und Resttage.

Feste Versandtermine im Empfängerfeld (Vorlage 24)

2026-11-01:21T,2026-12-01:22T

Dabei steht links das Datum und nach dem Doppelpunkt die Mailvorlagen-ID. Beide IDs müssen auch in template_ids stehen. Planen Sie diesen Cron-Job einmal täglich ein.

RSS-Newsletter mit neuen Beiträgen (Vorlage 27)

Tragen Sie den RSS-Feed unter rss_feed_url ein. Mit max_articles begrenzen Sie die geprüften Einträge und mit max_articles_show die in das Mailing übernommenen neuen Artikel. Die Daten stehen Ihrer Versandvorlage über feed_items zur Verfügung.

Häufige Fragen

Warum kann ich meine Mail nicht als Automation-Vorlage auswählen?
Die Mail muss innerhalb der Versandplanung als Vorlage gespeichert sein. Eine reine Vorlage im E-Mail-Builder reicht nicht aus.

Wann sollte ich event statt cron wählen?
event reagiert auf Ereignisse wie Anmeldung oder Abmeldung. cron wird entsprechend einem Zeitplan ausgeführt, etwa täglich um 09:00 Uhr.

Was passiert, wenn defaultValue leer ist?
Das Template liefert keinen voreingestellten Wert. Welche Eingabe erforderlich ist, hängt von der jeweiligen Vorlage ab.

Kann eine Automation bei jedem Lauf erneut E-Mails auslösen?
Ja. Prüfen Sie insbesondere zeitgesteuerte Vorlagen ohne eigene Einmal-Sperre, etwa das Geburtstagsmailing und die Gutscheincode-Warnung. Für andere Vorlagen werden Marker oder gespeicherte Userfeldwerte verwendet.

Was sollte ich vor dem Aktivieren von Lösch-Automationen beachten?
Kontrollieren Sie die betroffene Selektion und prüfen Sie, welche Daten archiviert oder aufbewahrt werden müssen. Die Vorlagen 18, 20 und 21 entfernen Datensätze automatisch.