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?
- Öffnen Sie in kajomi MAIL den Bereich Autom./DOI und klicken Sie auf Automation hinzufügen.
- Wählen Sie die gewünschte Vorlage. Je nach Vorlage handelt es sich um eine eventgesteuerte, zeitgesteuerte, Webhook- oder E-Mail-Hook-Automation.
- Füllen Sie die angezeigten Felder aus. Die Feldnamen und Standardwerte finden Sie weiter unten bei jeder Vorlage.
- Bei zeitgesteuerten Automationen legen Sie einen Cron-Zeitplan fest. Passen Sie die Ausführungshäufigkeit an die Vorlage an.
- 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
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
sizeist 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
listnumist der überwachte Verteiler;send_listnumist 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 subscribeverwendet.
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_iddie 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
compliancetextundcompliancetimestampauf 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=0aufgerufen. - 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: -1undlistnum: -1als 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,blacklistoderbothmögliche Werte fürtype. - 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_idsbestimmt die Reihenfolge der Mailings. - Die Standardwerte sind
user1,user2,28,1und 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_savespeichert 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
emailhookbenö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_idsvorkommen.
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_mappingordnet Salesforce-Spalten kajomi-Zielfeldern zu.is_live=falseschreibt laut Code E-Mail-Adressen für die Staging-Verwendung um.- Für
status_fieldist eine Zuordnung nachcnfhinterlegt (Active→1, sonst2), wenn das Feld entsprechend gemappt ist. - Sicherheitsrelevant:
client_secretist 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]. -1steht 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
descriptiondient der Wiedererkennung des letzten durch diese Automation erzeugten Mailings. Wählen Sie eine möglichst eindeutige Bezeichnung.- Die Artikel werden im Zusatzfeld
feed_itemsbereitgestellt. Die Versandvorlage muss diese Daten entsprechend darstellen. - Der mitgelieferte Standard für
article_since_whenist2025-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.