---
title: "Stapopties"
description: "Elk veld dat een stap kan hebben, per staptype, in gewone woorden: planning, doelgroep, ontvanger, sender, bericht, herinneringen, escalaties en de specifieke instellingen voor agenda-, kanaal- en ticketstappen."
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
---

De tabellen noemen elk veld van een stap zoals de app het labelt, met de waarde die het bevat. Dezelfde vorm gebruiken de MCP-tools en exports, dus dit is het naslagwerk voor wie Pyn automatiseert.

## Velden op elke stap

| Veld | Label in de app | Waarden |
| --- | --- | --- |
| `id` | | Een uniek id dat Pyn toekent. |
| `title` | Step title | Vrije tekst; leeg toont het staptype. |
| `type` | Gekozen in **Add Step** | `send-message`, `send-channel-message`, `invite-to-calendar-event`, `send-channel-invite`, `raise-ticket`, `add-message-to-context`; zie hieronder. |
| `state` | **Enabled** / **Disabled** | `enabled` of `disabled`. Een uitgeschakelde stap wordt nooit verstuurd. |
| `schedule.type` | | `relative` of `elapsed` (**After trigger**) in een automation, `absolute` in een campaign. |
| `schedule.offset` | **Schedule** | Voor `relative`: een duur zoals `{ "days": -7 }` of `{ "weeks": 2 }`; negatief is vóór de referentiedatum. Voor `elapsed`: een positieve duur na het triggermoment in `minutes`, `hours`, `days` of `weeks`, zoals `{ "hours": 1 }`; `{}` is **Immediately**. |
| `schedule.date` | **Scheduled date** | Voor `absolute`: een kalenderdatum, `2026-03-02`. |
| `schedule.hour`, `schedule.minute` | **at** | 0 tot 23 en 0 tot 59. |
| `schedule.timezone` | **in** | `recipient`, of de naam van een tijdzone zoals `Australia/Sydney`. |
| `schedule.deliverOn` | **Days of Week** | Een of meer van `MONDAY` tot `SUNDAY`. |
| `schedule.onSkippableDate` | **On Non-Delivery Days** | `deliver-anyway`, `deliver-before` (vorige bezorgdag) of `deliver-after` (volgende bezorgdag). |
| `audience` | Tabblad **Audience** | `lifecycle` (een of meer van `current`, `joiner`, `leave`, `terminated`), `includeGroups`, `excludeGroups` (groeps-id's). Ontbreekt het veld, dan alleen huidige medewerkers. |
| `skipIfOverdue` | **Skip if overdue at enrollment** | `true` om een stap over te slaan waarvan de datum al voorbij is wanneer iemand wordt ingeschreven. |
| `reminders` | **Reminders** | Maximaal drie in het zijpaneel (**Add reminder** verdwijnt bij drie), elk met `offset` (dagen na verzending), `enabled` en een optioneel `message` dat het zijpaneel niet instelt. Een stap die via de API of een MCP-server is geschreven kan er tot tien hebben. |

`schedule.hour`, `schedule.minute`, `schedule.timezone`, `schedule.deliverOn` en `schedule.onSkippableDate` bestaan alleen op een `relative`- of `absolute`-planning. Een `elapsed`-planning heeft alleen `type` en `offset`, en een campaignstap kan die niet gebruiken.

## Berichtstappen

`send-message` (een direct message of e-mail) en `send-channel-message` (een kanaalbericht) voegen toe:

| Veld | Label | Waarden |
| --- | --- | --- |
| `medium` | Vastgelegd door het staptype | `slack` of `email`. |
| `sender` | **From** | Een sender-id. Ontbreekt het veld, dan de standaard van de workspace. |
| `conditionalSender` | **From** | Een conditional-sender-id. Een stap heeft óf `sender` óf `conditionalSender`, nooit beide. |
| `recipient` | **To** | Een ontvanger, zie hieronder. De ontvanger van een kanaalbericht is een kanaal. |
| `ccRecipients` | **Cc** | Ontvangers, een willekeurig aantal, achter de link **Cc** naast **To** in het zijpaneel. |
| `subject` | **Subject** | Een document van één regel. Op een e-mail is dit het onderwerp; op een Slack-direct message het onderwerp van de e-mail die wordt verstuurd wanneer `fallbackToEmail` is ingesteld. |
| `message` | De editor | Het opgestelde bericht. |
| `body`, `html` | **Email body** | `body: "html"` met de Liquid-HTML in `html` voor een Raw HTML-e-mail; anders is het opgestelde `message` de inhoud. Alleen voor e-mail. |
| `emailFormat` | **Email format** | `left` of `full-width`; ontbreekt het veld, dan **Centered**. Bepaalt alleen de lay-out van een opgemaakte e-mail; een Raw HTML-e-mail wordt verstuurd zoals geschreven. |
| `hideSignature` | **Include the sender's signature (verified email senders)** | `true` wanneer de schakelaar is uitgevinkt; ontbreekt het veld, dan sluit de handtekening van een geverifieerde e-mailsender de e-mail af. Alleen voor een opgemaakte e-mail. |
| `deactivateUnfurlLinks`, `deactivateUnfurlMedia` | **Advanced** | `true` om Slack-previews uit te schakelen. |
| `fallbackToEmail`, `fallbackEmailSender` | **Send by email if the recipient is not in Slack**, en de **From** eronder | `true`, met het id van een e-mailsender, op een Slack-direct message: een ontvanger die niet in Slack zit krijgt het bericht per e-mail van die sender, onder het `subject` van de stap. Een automation kan niet worden gepubliceerd zolang `fallbackToEmail` is ingesteld zonder sender en onderwerp. Zie [Een direct message per e-mail versturen wanneer iemand niet in Slack zit](https://support.pyn.ai/nl/flows/steps/send-by-email-when-not-in-slack/). |
| `escalations` | **Escalations** | Maximaal drie, elk met `offset` (dagen na verzending), `recipient` (elke ontvanger behalve een groep of een conditional recipient) en `enabled`. |

## Ontvangers

| Vorm | Label | Velden |
| --- | --- | --- |
| Relatief | **Employee**, **Manager**, **Skip-level Manager**, **Buddy**, **HRBP** | `type: "relative"`, `recipient` een van `employee`, `manager`, `skip-manager`, `buddy`, `hrbp`; optioneel `address` met `primary` of `personal`. |
| Een persoon | **People** | `type: "employee"`, `recipient` het medewerkers-id, optioneel `address`. |
| Een groep | **Groups** (campaignstappen) | `type: "group"`, `recipient` het groeps-id. Elk lid ontvangt de stap. |
| Een kanaal | **Channels** | `type: "channel"`, `recipient` het kanaal-id. |
| Een custom e-mailadres | **Custom Email Recipients** | `type: "custom-email"`, `recipient` het id van de custom email recipient. |
| Een conditional recipient | **Conditional Recipients** | `type: "conditional"`, `recipient` het id van de conditional recipient. Wordt voor elke ingeschreven medewerker bepaald uit de regels van de conditional recipient; geweigerd op campaignstappen. |

## Andere staptypen

| Type | Label in **Add Step** | Extra velden |
| --- | --- | --- |
| `invite-to-calendar-event` | **Invite to Calendar Event** | `recipient` (standaard **Employee**; het zijpaneel heeft er geen bediening voor); `eventId` (de agenda-afspraak); `inviteTo` met `next-occurrence`, `next-occurrence-reference-date` of `all-occurrences`. |
| `send-channel-invite` | **Add to Channel** | `sender`; `recipient` (wie wordt toegevoegd); `channel` (het kanaal-id); `medium: "slack"`. |
| `raise-ticket` | **Raise Ticket** | `integration` (de Jira-koppeling), `project`, `issueType`, `summary` (één regel), `description`; `medium: "jira"`. Geen ontvanger. |
| `add-message-to-context` | **Add Message to Employee Context** en de andere rijen onder **AI & Context** | `recipient` (wiens context). |

## Mijlpalen van campaigntemplates

Een campaigntemplate is een lijst mijlpalen, elk met `id`, `title`, `emoji`, `color` (een hexadecimale kleur), `date` (een kalenderdatum) en `steps` (stappen zoals hierboven, met absolute planningen). Een mijlpaal inschrijven maakt er een campaign van met die datum als referentiedatum. Zie [Campaign Templates](https://support.pyn.ai/nl/flows/campaign-templates/).

## Gerelateerd

- [Een stap inplannen](https://support.pyn.ai/nl/flows/steps/schedule-a-step/) voor de planningsvelden zoals de app ze toont.
- [Ontvangers en Cc kiezen](https://support.pyn.ai/nl/flows/steps/choose-recipients-and-cc/) voor de vormen van ontvangers.
- [Tokens](https://support.pyn.ai/nl/flows/steps/reference-tokens/) voor wat er in `message` en `html` komt.
- [For agents](https://support.pyn.ai/nl/for-agents/) voor de machineleesbare uitvoer van deze site.
