---
title: "Schrittoptionen"
description: "Jedes Feld, das ein Schritt haben kann, nach Schritttyp und in klaren Worten: Zeitplan, Zielgruppe, Empfänger, Sender, Nachricht, Erinnerungen, Eskalationen und die typspezifischen Einstellungen für Kalender-, Kanal- und Ticket-Schritte."
sidebar:
  order: 3
area: flows
feature: steps
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-11-13"
audience: admin
related:
  - flows/steps/schedule-a-step
  - flows/steps/choose-recipients-and-cc
  - flows/steps/reference-tokens
  - for-agents
translation:
  source: flows/steps/reference-step-options.mdx
  sourceSha: 51f856d0af86890084b3579e0a3057e8d400ced6
---

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

| 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

`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](https://support.pyn.ai/de/flows/steps/send-by-email-when-not-in-slack/). |
| `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

| 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

| 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

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](https://support.pyn.ai/de/flows/campaign-templates/).

## Verwandte Seiten

- [Einen Schritt terminieren](https://support.pyn.ai/de/flows/steps/schedule-a-step/) für die Zeitplanfelder, wie die App sie zeigt.
- [Empfänger und Cc wählen](https://support.pyn.ai/de/flows/steps/choose-recipients-and-cc/) für die Empfängerformen.
- [Token](https://support.pyn.ai/de/flows/steps/reference-tokens/) dafür, was in `message` und `html` steht.
- [For agents](https://support.pyn.ai/de/for-agents/) für die maschinenlesbaren Ausgaben dieser Website.
