Zum Inhalt springen
PynPyn

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.

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.

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.
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.
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).

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.