---
title: "メッセージの書式を整える"
description: "メッセージエディターの使い方：見出し、リスト、リンク、配置、名前や日付を埋めるトークン、画像、ファイル、動画、Slackでのプリンシパル・同僚・チャンネル全体へのメンション、一部の人にだけ表示される条件付きセクション、メールのデザインされた一部分のためのRaw HTML Block、そしてデザインされたメールのためのRaw HTMLです。"
sidebar:
  order: 2
area: flows
feature: steps
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-11-09"
audience: admin
screenshots:
  - id: flows-steps-editor-widgets
    caption: Widgetsメニューを開いたメッセージエディター。
related:
  - flows/steps/reference-tokens
  - library/media/insert-media-in-a-message
  - flows/steps/add-a-button-to-a-message
  - flows/steps/preview-and-send-a-test
intercom:
  - id: "16814757"
    title: Format Your Message (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16814757-format-your-message-pyn-2
    note: replaces
  - id: "16814823"
    title: Mention the Principal in Slack Messages and Channels (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16814823-mention-the-principal-in-slack-messages-and-channels-pyn-2
    note: replaces
  - id: "16857906"
    title: Embed a YouTube Video (Pyn 2)
    url: https://intercom.help/pyn/en/articles/16857906-embed-a-youtube-video-pyn-2
    note: replaces
  - id: "13872876"
    title: Add visual content to your message (Pyn 2)
    url: https://intercom.help/pyn/en/articles/13872876-add-visual-content-to-your-message-pyn-2
    note: draws on
  - id: "6005675"
    title: Format your Pyn (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6005675-format-your-pyn-pyn-1
    note: "Pyn 1 article, kept for reference"
  - id: "6010960"
    title: Embed a YouTube video (Pyn 1)
    url: https://intercom.help/pyn/en/articles/6010960-embed-a-youtube-video-pyn-1
    note: "Pyn 1 article, kept for reference"
  - id: "8214468"
    title: Add a mailto link
    url: https://intercom.help/pyn/en/articles/8214468-add-a-mailto-link
    note: "Pyn 1 article, kept for reference"
  - id: "6005747"
    title: Create Conditional Sections
    url: https://intercom.help/pyn/en/articles/6005747-create-conditional-sections
    note: "Pyn 1 article, kept for reference"
translation:
  source: flows/steps/format-a-message.mdx
  sourceSha: 90e38f1d8714764c4a63b06eecd0b289386d068a
---

すべてのメール、ダイレクトメッセージ、チャンネル投稿は同じエディターで書きます。エディターはメッセージを受信者に見えるおおよその形で表示し（SlackのステップではSlackのアバターとタイムスタンプ付き）、その媒体が対応する書式だけを保ちます。Slackには配置がないため、そのボタンはSlackでは隠れます。

![Widgetsメニューを開いたメッセージエディター。](https://support.pyn.ai/media/flows/steps/flows-steps-editor-widgets.png)

## テキスト

テキストを選択してツールバーを使うと、太字、斜体、下線、**Heading**、**Subheading**、**Blockquote**、箇条書きと番号付きリスト、リンク（Webアドレスまたは`mailto:`）、そしてメールでは左・中央・右の配置が使えます。元に戻すとやり直しもツールバーにあります。**Expand editor**（エディターの上の矢印アイコン）を選ぶと全画面のエディターで書け、閉じると戻ります。

## トークン

1. 値を入れたい場所で`@`を入力します。トークンの一覧が開くので、入力を続けて絞り込みます。たとえば`@pref`で`principal.preferredName`です。

2. トークンを選びます。ピルとして表示されます。`principal`トークンはエンロールされた従業員について、`recipient`トークンはメッセージを受け取る人について、`date.reference`はエンロールメントの基準日です。

3. 一覧にないフィールドには、ツールバーの**Insert token**、続いて「**Employee Field…**」を選びます。**Employee Field**ダイアログで**Select an employee field**を選び、**Apply to**で**Principal of automation**（既定）と**Recipient of message**のどちらに適用するかを選び、フィールドが空のときに表示する「**Fallback (Optional)**」を入力して、**Insert**を選びます。

4. メールマージ用スプレッドシートの列には、**Insert widget**、続いて**Custom Token**を選び、列名（例：`startLocation`）を入力します。置いたトークンを選ぶと、**Plain Text**と**Bulleted List**を切り替えられます。**Custom Token Block**は複数行の値を独立した段落やリストとして表示します。

[トークン](https://support.pyn.ai/ja/flows/steps/reference-tokens/)には、すべてのトークンと、値がないときにPynが代わりに使うテキスト（名前がないときの`Employee`など）が載っています。

## メディア

**Insert media**（画像のアイコン）を選ぶと、コンピューターから画像、GIF、動画をアップロードするか、[メディア](https://support.pyn.ai/ja/library/media/)から選べます。挿入した画像を選ぶと、配置やサイズを変更できます。YouTubeまたはVimeoのリンクを単独の行に貼り付けると、埋め込みプレーヤーになります。[メッセージにメディアを挿入する](https://support.pyn.ai/ja/library/media/insert-media-in-a-message/)でアップロードの手順を説明しています。

## ウィジェット

**Insert widget**（パズルのアイコン）には対話的な部品が集まっています。**Avatar**（写真。挿入したウィジェットを選び、**Show the avatar of**で**Principal**、**Principal's Buddy**、**Principal's Manager**、**Recipient**を選びます）、**Custom Token**と**Custom Token Block**、**Embed Form**、**Link Button**、**Mention Principal**、**Link to Library Content**、そしてメールでは**Raw HTML Block**です。ボタンとフォームは[メッセージにボタンを追加する](https://support.pyn.ai/ja/flows/steps/add-a-button-to-a-message/)で説明しています。

**Mention Principal**はSlackのステップでだけ提供されます。[人やチャンネルをメンションする](#人やチャンネルをメンションする)を参照してください。

## 人やチャンネルをメンションする

Slackのステップでは、メッセージの送信時にメンションが本物のSlack通知になります。ダイレクトメッセージでもチャンネルへの投稿でも、3つの形が使えます。

**エンロールされた従業員**。**Insert widget**、**Mention Principal**の順に選びます。**@Principal**のピルが挿入され、エンロールされた従業員への本物のSlackメンションになるので、「Please welcome @Principal to the team」でその人に通知が届きます。メッセージを送るSlackワークスペースにその従業員のメンバーがいない場合、ピルは代わりにその人の名前（たとえば「@Jane Doe」）として送信されます。

**同僚（Slackユーザー名で）**。`@`に続けて相手のSlackユーザー名をプレーンテキストで入力します（たとえば`@jane.doe`）。`@`を入力するとトークンの一覧が開くので、Escapeキーを押すか別の場所をクリックして閉じると、入力したテキストがそのまま残ります。メッセージの送信時に、Pynはそのユーザー名を送信者のSlackワークスペースのメンバーと大文字と小文字を区別せずに照合し、その人へのメンションに置き換えます。ユーザー名はSlackプロフィールの`@name`であり、表示名ではありません。誰にも一致しないユーザー名（Slackワークスペースを離れた人を含む）は入力したままメッセージに残り、メッセージはそのまま送信されます。メールアドレスがメンションとして扱われることはありません。ユーザー名はリンクテキストの中に入れないでください。リンク内で一致したユーザー名はリンクの対象から外れます。

**チャンネルの全員**。`@here`、`@channel`、`@everyone`をプレーンテキストで入力します。PynはそれぞれをSlackのブロードキャストとして送信するため、Slackで直接入力したときと同じように、その言葉が対象とする人たちにSlackが通知します。`here`や`channel`という名前のメンバーに照合されることはなく、リンクの中ではリンクテキストのまま残ります。

**Preview**では、ユーザー名とブロードキャストは入力したとおりに表示されます。**Send a test to yourself**はすべてのメンションを解決したうえでSlack経由でメッセージを送るので、ユーザー名が一致するかを確かめる方法になります。[プレビューしてテストを送信する](https://support.pyn.ai/ja/flows/steps/preview-and-send-a-test/)を参照してください。

## 条件付きセクション

条件付きセクションは、メッセージの一部を特定の人にだけ表示します。たとえば、1通の歓迎メールの中にAustinオフィス向けの駐車場の段落を入れる場合です。

1. セクションを置く位置にカーソルを置き、ツールバーの**Conditional section**（じょうごのアイコン）を選びます。**Conditional Section**ダイアログが開きます。

2. 「**Name (Optional)**」を付け、**Apply to**で**Recipient of message**（既定）と**Principal of automation**のどちらに対して照合するかを選びます。

3. ステップのオーディエンスと同じように**Lifecycle**、**Included**、**Excluded**を設定し、**Audience Preview**を確認して、**Update**を選びます。

4. セクションの中に書きます。もう一度選ぶと、ルールを変更したり**Remove**で削除したりできます。

その人が一致しないセクションの内容は、その人のメッセージからも、個人向けの**Preview**からも除かれます。ライフサイクルとグループの一致の仕組みは[ステップのオーディエンスを設定する](https://support.pyn.ai/ja/flows/steps/set-a-step-audience/)を参照してください。

## メールのためのRaw HTML

ワークスペースでRaw HTMLメールが有効な場合、ステップの**Advanced**タブを開いて**Email body**を**Raw HTML**にすると、Pynが書かれたとおりに送らなければならない完全にデザインされたテンプレートが使えます。本文は**HTML**フィールドになります。そこにマークアップを書き、トークンにはLiquidの出力タグ（例：`{{ principal.preferredName }}`）を使います。Pynはテーマやスタイルを一切適用せず、HTMLは200,000文字まで、無効なLiquidがあるとオートメーションは公開できず、Pynが解決できない名前はそのままメールに残ります。**Preview**は選んだ従業員向けにHTMLを表示し、**Send a test to yourself**は本番の送信と同じように送ります。Raw HTMLメールが有効でないワークスペースのRaw HTMLステップは、送信時にバウンスします。同じタブの**Email format**の選択（**Left**、**Centered**、**Full width**）と「**Include the sender's signature (verified email senders)**」のスイッチは作成メッセージにだけ適用され、**Email body**が**Raw HTML**になると表示されなくなります。Raw HTMLメールは送信者の署名なしで送られます。[メールのステップを追加する](https://support.pyn.ai/ja/flows/steps/add-an-email-step/)を参照してください。

Liquidの条件は、1通のメールの中でオフィスなどに応じて文面を変えます。Pynはメッセージを整形するときに、受信者ごとに`{% if %}`、`{% elsif %}`、`{% else %}`、そして`{% when %}`付きの`{% case %}`を評価し、1つの`when`に複数の値を列挙できます。これらは、作成メッセージでしか使えない**Conditional section**の代わりになります。

```html
{% if employeeField.recipient.location == "Warsaw" %}
  <p>Parking is on level -1.</p>
{% elsif employeeField.recipient.location == "Tbilisi" %}
  <p>Bring your passport on your first day.</p>
{% else %}
  <p>Your manager will share the office details.</p>
{% endif %}

{% case employeeField.recipient.location %}
  {% when "Tbilisi", "Limassol" %}
    <p>Your desk is booked through the office app.</p>
  {% else %}
    <p>Ask reception for a desk.</p>
{% endcase %}
```

値は必ず`==`、`!=`、または`case`で比較するか、`!= blank`で従業員フィールドに値があるかを確認してください。`{% if employeeField.recipient.location %}`のようにトークン単体を判定すると常にtrueになります。値がないときはフォールバック（従業員フィールドでは空のテキスト、`custom.`トークンでは列名）に置き換えられるからです。

> **Tip:** **Composed message**と**Raw HTML**を切り替えると本文が置き換わるので、残したいものは先にコピーしてください。

## Raw HTML Block

ワークスペースでRaw HTMLメールが有効な場合、メールのステップの**Insert widget**に、バナーや署名など、作成メールのデザインされた一部分のための**Raw HTML Block**が加わります。SlackのステップやLibraryのコンテンツでは提供されません。

ブロックはメールの中の1つのブロックです。メールはPynの既定のメールレイアウト（幅600ピクセルまでの中央寄せの列）を保ち、ブロックのHTMLは前後のブロックの間に独立した行として置かれます。[メールのためのRaw HTML](#メールのためのraw-html)は、代わりに本文全体を置き換え、そのレイアウトなしで送ります。

1. ブロックを置く位置にカーソルを置き、**Insert widget**、続いて**Raw HTML Block**を選びます。

2. **HTML**フィールドにマークアップを貼り付けるか書きます。トークンと条件は[メールのためのRaw HTML](#メールのためのraw-html)と同じLiquidです。たとえば`{{ principal.preferredName }}`と`{% if %}`です。

3. **Save**を選びます。無効なLiquidはフィールドの下に表示され、修正するまでブロックは保存できません。

エディターにはブロックのHTMLがトークンを書いたままの形で表示され、ブロックを選ぶと変更できます。**Preview**と**Send a test to yourself**はトークンを埋めます。PynはHTMLを書かれたとおりに送り、整形式かどうかを確認しません。閉じられていないタグはメールの残りの部分のレイアウトを壊すことがあるので、先にテストを送ってください。

- 各ブロックは200,000文字までです。
- ブロックはメールのプレーンテキスト版からは除かれます。
- ブロック内のリンクはトラッキングされません。クリックしても**Clicked**や**Actioned**にはなりません。トラッキング付きのリンクには**Link Button**を使ってください。
- **Conditional section**の中のブロックは、セクションが一致する人にだけ送られます。
- Raw HTMLメールが有効でないワークスペースでRaw HTML Blockを含むメールは、Raw HTMLメールと同じく送信時にバウンスします。

## 関連ページ

- [トークン](https://support.pyn.ai/ja/flows/steps/reference-tokens/)：すべてのトークンとそのフォールバックについてです。
- [メッセージにメディアを挿入する](https://support.pyn.ai/ja/library/media/insert-media-in-a-message/)：画像のサイズとウイルススキャンについてです。
- [メッセージにボタンを追加する](https://support.pyn.ai/ja/flows/steps/add-a-button-to-a-message/)：Link Button、Link to Library Content、Embed Formについてです。
- [プレビューしてテストを送信する](https://support.pyn.ai/ja/flows/steps/preview-and-send-a-test/)：公開前に結果を確認するにはこちらです。
