---
title: "ステップのオプション"
description: "ステップが持ちうるすべてのフィールドを、ステップの種類ごとにわかりやすい言葉で：スケジュール、オーディエンス、受信者、送信者、メッセージ、リマインダー、エスカレーション、そしてカレンダー、チャンネル、チケットのステップに固有の設定。"
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
---

以下の表は、ステップが持つ各フィールドをアプリでのラベルとともに、保持する値とあわせて示します。MCPツールとエクスポートが使うのも同じ形なので、Pynを自動化する人のためのリファレンスです。

## すべてのステップにあるフィールド

| フィールド | アプリでのラベル | 値 |
| --- | --- | --- |
| `id` | | Pynが割り当てる一意のid。 |
| `title` | ステップのタイトル | 自由なテキスト。空ならステップの種類が表示されます。 |
| `type` | **Add Step**で選択 | `send-message`、`send-channel-message`、`invite-to-calendar-event`、`send-channel-invite`、`raise-ticket`、`add-message-to-context`。下記を参照してください。 |
| `state` | **Enabled** / **Disabled** | `enabled`または`disabled`。無効なステップが送信されることはありません。 |
| `schedule.type` | | オートメーションでは`relative`または`elapsed`（**After trigger**）、キャンペーンでは`absolute`。 |
| `schedule.offset` | **Schedule** | `relative`では`{ "days": -7 }`や`{ "weeks": 2 }`のような期間。負の値は基準日より前です。`elapsed`では、トリガーの時点から後の正の期間を`minutes`、`hours`、`days`、`weeks`で指定します（例：`{ "hours": 1 }`）。`{}`は**Immediately**です。 |
| `schedule.date` | **Scheduled date** | `absolute`では暦日。`2026-03-02`。 |
| `schedule.hour`、`schedule.minute` | **at** | 0から23と0から59。 |
| `schedule.timezone` | **in** | `recipient`、または`Australia/Sydney`のようなタイムゾーン名。 |
| `schedule.deliverOn` | **Days of Week** | `MONDAY`から`SUNDAY`のうち1つ以上。 |
| `schedule.onSkippableDate` | **On Non-Delivery Days** | `deliver-anyway`、`deliver-before`（前の配信日）、または`deliver-after`（次の配信日）。 |
| `audience` | **Audience**タブ | `lifecycle`（`current`、`joiner`、`leave`、`terminated`のうち任意のもの）、`includeGroups`、`excludeGroups`（グループのid）。ないときは在籍中の従業員のみです。 |
| `skipIfOverdue` | **Skip if overdue at enrollment** | 誰かがエンロールされた時点で日付が過ぎているステップをスキップするには`true`。 |
| `reminders` | **Reminders** | ステップのサイドパネルでは3件まで（3件で**Add reminder**が消えます）。それぞれ`offset`（送信後の日数）、`enabled`、そしてサイドパネルでは設定しない任意の`message`を持ちます。APIやMCPサーバー経由で書かれたステップは10件まで持てます。 |

`schedule.hour`、`schedule.minute`、`schedule.timezone`、`schedule.deliverOn`、`schedule.onSkippableDate`は、`relative`または`absolute`のスケジュールにだけ存在します。`elapsed`のスケジュールが持つのは`type`と`offset`だけで、キャンペーンのステップでは使えません。

## メッセージのステップ

`send-message`（ダイレクトメッセージまたはメール）と`send-channel-message`（チャンネル投稿）には次が加わります。

| フィールド | ラベル | 値 |
| --- | --- | --- |
| `medium` | ステップの種類で固定 | `slack`または`email`。 |
| `sender` | **From** | 送信者のid。ないときはワークスペースの既定です。 |
| `conditionalSender` | **From** | 条件付き送信者のid。ステップが持つのは`sender`か`conditionalSender`のどちらか一方で、両方は持ちません。 |
| `recipient` | **To** | 受信者。下記を参照してください。チャンネル投稿の受信者はチャンネルです。 |
| `ccRecipients` | **Cc** | 受信者の一覧で、数は任意です。ステップのサイドパネルでは**To**の横の**Cc**リンクの先にあります。 |
| `subject` | **Subject** | 1行のドキュメント。メールでは件名です。Slackのダイレクトメッセージでは、`fallbackToEmail`が設定されているときに送られるメールの件名です。 |
| `message` | エディター | 作成されたメッセージ。 |
| `body`、`html` | **Email body** | Raw HTMLメールでは`body: "html"`とし、LiquidのHTMLを`html`に入れます。それ以外では作成された`message`が本文です。メールのみ。 |
| `emailFormat` | **Email format** | `left`または`full-width`。ない場合は**Centered**です。作成メッセージのメールのレイアウトだけを決め、Raw HTMLメールは書かれたとおりに送られます。 |
| `hideSignature` | **Include the sender's signature (verified email senders)** | スイッチのチェックを外すと`true`。ない場合は、検証済みメール送信者の署名がメールの末尾に入ります。作成メッセージのメールのみ。 |
| `deactivateUnfurlLinks`、`deactivateUnfurlMedia` | **Advanced** | Slackのプレビューを止めるには`true`。 |
| `fallbackToEmail`、`fallbackEmailSender` | **Send by email if the recipient is not in Slack**と、その下の**From** | Slackのダイレクトメッセージで、`true`とメール送信者のid。Slackにいない受信者には、その送信者から、ステップの`subject`を件名としてメッセージがメールで送られます。送信者と件名がないまま`fallbackToEmail`が設定されている間は、オートメーションを公開できません。[Slackにいない人にダイレクトメッセージをメールで送る](https://support.pyn.ai/ja/flows/steps/send-by-email-when-not-in-slack/)を参照してください。 |
| `escalations` | **Escalations** | 3件まで。それぞれ`offset`（送信後の日数）、`recipient`（グループと条件付き受信者を除く任意の受信者）、`enabled`を持ちます。 |

## 受信者

| 形 | ラベル | フィールド |
| --- | --- | --- |
| 相対 | **Employee**、**Manager**、**Skip-level Manager**、**Buddy**、**HRBP** | `type: "relative"`、`recipient`は`employee`、`manager`、`skip-manager`、`buddy`、`hrbp`のいずれか。任意の`address`は`primary`または`personal`。 |
| 個人 | **People** | `type: "employee"`、`recipient`は従業員のid、任意の`address`。 |
| グループ | **Groups**（キャンペーンのステップ） | `type: "group"`、`recipient`はグループのid。すべてのメンバーがステップを受け取ります。 |
| チャンネル | **Channels** | `type: "channel"`、`recipient`はチャンネルのid。 |
| カスタムメールアドレス | **Custom Email Recipients** | `type: "custom-email"`、`recipient`はカスタムメール受信者のid。 |
| 条件付き受信者 | **Conditional Recipients** | `type: "conditional"`、`recipient`は条件付き受信者のid。エンロールされた従業員ごとにそのルールから解決されます。キャンペーンのステップでは拒否されます。 |

## その他のステップの種類

| 種類 | **Add Step**でのラベル | 追加のフィールド |
| --- | --- | --- |
| `invite-to-calendar-event` | **Invite to Calendar Event** | `recipient`（既定は**Employee**。サイドパネルにはそのためのコントロールがありません）、`eventId`（カレンダーイベント）、`inviteTo`は`next-occurrence`、`next-occurrence-reference-date`、`all-occurrences`のいずれか。 |
| `send-channel-invite` | **Add to Channel** | `sender`、`recipient`（追加される人）、`channel`（チャンネルのid）、`medium: "slack"`。 |
| `raise-ticket` | **Raise Ticket** | `integration`（Jiraの接続）、`project`、`issueType`、`summary`（1行）、`description`、`medium: "jira"`。受信者はありません。 |
| `add-message-to-context` | **Add Message to Employee Context**と他の**AI & Context**の行 | `recipient`（誰のコンテキストか）。 |

## キャンペーンテンプレートのマイルストーン

キャンペーンテンプレートはマイルストーンの一覧で、それぞれ`id`、`title`、`emoji`、`color`（16進数の色）、`date`（暦日）、`steps`（上記のステップ。絶対スケジュール付き）を持ちます。マイルストーンをエンロールすると、その日付を基準日とするキャンペーンになります。[キャンペーンテンプレート](https://support.pyn.ai/ja/flows/campaign-templates/)を参照してください。

## 関連ページ

- [ステップをスケジュールする](https://support.pyn.ai/ja/flows/steps/schedule-a-step/)：アプリに表示されるとおりのスケジュールのフィールドについてです。
- [受信者とCcを選ぶ](https://support.pyn.ai/ja/flows/steps/choose-recipients-and-cc/)：受信者の形についてです。
- [トークン](https://support.pyn.ai/ja/flows/steps/reference-tokens/)：`message`と`html`の中に入るものについてです。
- [For agents](https://support.pyn.ai/ja/for-agents/)：このサイトの機械可読な出力についてです。
