Schrittoptionen
Die Tabellen benennen jedes Feld eines Schritts so, wie die App es beschriftet, mit dem Wert, den es enthält. Dieselbe Form nutzen die MCP-Tools und Exporte, sie ist also die Referenz für alle, die Pyn automatisieren.
Felder bei jedem Schritt
Abschnitt betitelt „Felder bei jedem Schritt“| Feld | Beschriftung in der App | Werte |
|---|---|---|
id |
Eine eindeutige ID, die Pyn vergibt. | |
title |
Schritttitel | Freitext; leer zeigt den Schritttyp. |
type |
Gewählt in Add Step | send-message, send-channel-message, invite-to-calendar-event, send-channel-invite, raise-ticket, add-message-to-context; siehe unten. |
state |
Enabled / Disabled | enabled oder disabled. Ein deaktivierter Schritt wird nie gesendet. |
schedule.type |
relative oder elapsed (After trigger) in einer Automation, absolute in einer Kampagne. |
|
schedule.offset |
Schedule | Bei relative: eine Dauer wie { "days": -7 } oder { "weeks": 2 }; negativ liegt vor dem Referenzdatum. Bei elapsed: eine positive Dauer nach dem Trigger-Moment in minutes, hours, days oder weeks, etwa { "hours": 1 }; {} ist Immediately. |
schedule.date |
Scheduled date | Bei absolute: ein Kalenderdatum, 2026-03-02. |
schedule.hour, schedule.minute |
at | 0 bis 23 und 0 bis 59. |
schedule.timezone |
in | recipient oder ein Zeitzonenname wie Australia/Sydney. |
schedule.deliverOn |
Days of Week | Einer oder mehrere von MONDAY bis SUNDAY. |
schedule.onSkippableDate |
On Non-Delivery Days | deliver-anyway, deliver-before (voriger Zustelltag) oder deliver-after (nächster Zustelltag). |
audience |
Tab Audience | lifecycle (beliebige aus current, joiner, leave, terminated), includeGroups, excludeGroups (Gruppen-IDs). Fehlt es, sind nur aktuelle Mitarbeitende gemeint. |
skipIfOverdue |
Skip if overdue at enrollment | true, um einen Schritt zu überspringen, dessen Datum beim Einschreiben einer Person schon verstrichen ist. |
reminders |
Reminders | Bis zu drei im Seitenpanel des Schritts (Add reminder verschwindet bei drei), jede mit offset (Tage nach dem Senden), enabled und einer optionalen message, die das Seitenpanel nicht setzt. Ein über die API oder einen MCP-Server geschriebener Schritt kann bis zu zehn haben. |
schedule.hour, schedule.minute, schedule.timezone, schedule.deliverOn und schedule.onSkippableDate existieren nur bei einem Zeitplan relative oder absolute. Ein Zeitplan elapsed hat nur type und offset, und ein Kampagnenschritt kann ihn nicht nutzen.
Nachrichtenschritte
Abschnitt betitelt „Nachrichtenschritte“send-message (eine Direktnachricht oder E-Mail) und send-channel-message (ein Kanalbeitrag) ergänzen:
| Feld | Beschriftung | Werte |
|---|---|---|
medium |
Durch den Schritttyp festgelegt | slack oder email. |
sender |
From | Eine Sender-ID. Fehlt sie, gilt die Vorgabe des Workspace. |
conditionalSender |
From | Eine Conditional-Sender-ID. Ein Schritt hat entweder sender oder conditionalSender, nie beides. |
recipient |
To | Ein Empfänger, siehe unten. Der Empfänger eines Kanalbeitrags ist ein Kanal. |
ccRecipients |
Cc | Empfänger, beliebig viele, hinter dem Link Cc neben To im Seitenpanel des Schritts. |
subject |
Subject | Ein einzeiliges Dokument. Bei einer E-Mail ist es der Betreff; bei einer Slack-Direktnachricht ist es der Betreff der E-Mail, die gesendet wird, wenn fallbackToEmail gesetzt ist. |
message |
Der Editor | Die komponierte Nachricht. |
body, html |
Email body | body: "html" mit dem Liquid-HTML in html für eine Raw-HTML-E-Mail; sonst ist die komponierte message der Text. Nur bei E-Mail. |
emailFormat |
Email format | left oder full-width; fehlt der Wert, gilt Centered. Gestaltet nur eine komponierte E-Mail; eine Raw-HTML-E-Mail wird so gesendet, wie sie geschrieben ist. |
hideSignature |
Include the sender’s signature (verified email senders) | true, wenn der Schalter nicht angehakt ist; fehlt der Wert, schließt die Signatur eines verifizierten E-Mail-Senders die E-Mail ab. Nur bei komponierten E-Mails. |
deactivateUnfurlLinks, deactivateUnfurlMedia |
Advanced | true, um Slack-Vorschauen abzuschalten. |
fallbackToEmail, fallbackEmailSender |
Send by email if the recipient is not in Slack und das From darunter | true, mit der ID eines E-Mail-Senders, bei einer Slack-Direktnachricht: Ein Empfänger, der nicht in Slack ist, bekommt die Nachricht per E-Mail von diesem Sender, unter dem subject des Schritts. Eine Automation lässt sich nicht veröffentlichen, solange fallbackToEmail ohne Sender und Betreff gesetzt ist. Siehe Eine Direktnachricht per E-Mail senden, wenn jemand nicht in Slack ist. |
escalations |
Escalations | Bis zu drei, jede mit offset (Tage nach dem Senden), recipient (jeder Empfänger außer einer Gruppe oder einem Conditional Recipient) und enabled. |
Empfänger
Abschnitt betitelt „Empfänger“| Form | Beschriftung | Felder |
|---|---|---|
| Relativ | Employee, Manager, Skip-level Manager, Buddy, HRBP | type: "relative", recipient einer von employee, manager, skip-manager, buddy, hrbp; optional address mit primary oder personal. |
| Eine Person | People | type: "employee", recipient die Mitarbeitenden-ID, optional address. |
| Eine Gruppe | Groups (Kampagnenschritte) | type: "group", recipient die Gruppen-ID. Jedes Mitglied bekommt den Schritt. |
| Ein Kanal | Channels | type: "channel", recipient die Kanal-ID. |
| Eine eigene E-Mail-Adresse | Custom Email Recipients | type: "custom-email", recipient die ID des eigenen E-Mail-Empfängers. |
| Ein Conditional Recipient | Conditional Recipients | type: "conditional", recipient die ID des Conditional Recipient. Wird für jede eingeschriebene Person aus seinen Regeln aufgelöst; bei Kampagnenschritten abgelehnt. |
Andere Schritttypen
Abschnitt betitelt „Andere Schritttypen“| Typ | Beschriftung in Add Step | Zusätzliche Felder |
|---|---|---|
invite-to-calendar-event |
Invite to Calendar Event | recipient (standardmäßig Employee; das Seitenpanel hat kein Steuerelement dafür); eventId (der Kalendertermin); inviteTo mit next-occurrence, next-occurrence-reference-date oder all-occurrences. |
send-channel-invite |
Add to Channel | sender; recipient (wer hinzugefügt wird); channel (die Kanal-ID); medium: "slack". |
raise-ticket |
Raise Ticket | integration (die Jira-Verbindung), project, issueType, summary (einzeilig), description; medium: "jira". Kein Empfänger. |
add-message-to-context |
Add Message to Employee Context und die anderen Zeilen unter AI & Context | recipient (wessen Kontext). |
Meilensteine von Kampagnenvorlagen
Abschnitt betitelt „Meilensteine von Kampagnenvorlagen“Eine Kampagnenvorlage ist eine Liste von Meilensteinen, jeder mit id, title, emoji, color (eine Hex-Farbe), date (ein Kalenderdatum) und steps (Schritte wie oben, mit absoluten Zeitplänen). Das Einschreiben eines Meilensteins macht daraus eine Kampagne mit diesem Datum als Referenzdatum. Siehe Campaign Templates.
Verwandte Seiten
Abschnitt betitelt „Verwandte Seiten“- Einen Schritt terminieren für die Zeitplanfelder, wie die App sie zeigt.
- Empfänger und Cc wählen für die Empfängerformen.
- Token dafür, was in
messageundhtmlsteht. - For agents für die maschinenlesbaren Ausgaben dieser Website.