---
title: "トークン"
description: "メッセージに入れられるすべてのトークン、Pynがそこに何を埋めるか、値がないときに代わりに表示されるテキスト、そして日付と名前の書式。"
sidebar:
  order: 3
area: flows
feature: steps
appPath: /flows/home
lastVerified: 2026-11-15
version: "2026-10-23"
audience: admin
related:
  - flows/steps/format-a-message
  - flows/steps/choose-recipients-and-cc
  - flows/automations/enroll-from-a-spreadsheet
  - integrations/hibob/field-mapping
intercom:
  - id: "6024180"
    title: List of supported tokens
    url: https://intercom.help/pyn/en/articles/6024180-list-of-supported-tokens
    note: Pyn 1 article
  - id: "6010962"
    title: Add personalization tokens
    url: https://intercom.help/pyn/en/articles/6010962-add-personalization-tokens
    note: Pyn 1 article
  - id: "6005713"
    title: Personalize your content using tokens and custom senders
    url: https://intercom.help/pyn/en/articles/6005713-personalize-your-content-using-tokens-and-custom-senders
    note: Pyn 1 article
  - id: "6023197"
    title: Personalize your Buddy Pyns with Tokens
    url: https://intercom.help/pyn/en/articles/6023197-personalize-your-buddy-pyns-with-tokens
    note: Pyn 1 article
translation:
  source: flows/steps/reference-tokens.mdx
  sourceSha: e10e1379be5cfe5ae62f7a0ec7a37e8c261fc545
---

トークンは、メッセージが1人の受信者向けに整形されるときにPynが置き換える目印です。エディターで`@`を入力すると挿入できます。Raw HTMLメールやRaw HTML Blockでは、`{{ principal.preferredName }}`のようにLiquidタグとして書きます。`principal`トークンはエンロールされた従業員について、`recipient`トークンはメッセージを受け取る人についてのものです。従業員宛てのメッセージでは、この2人は同じ人です。

値がないとき、トークンには下の表にあるフォールバックのテキストが表示されます。トークンに独自のフォールバックを設定した場合はそちらが使われます。名前、部署、役職はDirectoryの[従業員](https://support.pyn.ai/ja/directory/employees/)レコードから取得されます。

## エディターのトークン

| トークン | 値 | フォールバック |
| --- | --- | --- |
| `date.reference` | エンロールメントの基準日 | reference date |
| `principal.preferredName` | 呼び名。なければ表示名の最初の単語 | Employee |
| `principal.firstName` | 表示名（または正式名）の最初の単語 | Employee |
| `principal.preferredFullName` | 呼び名と、表示名から取った姓 | Employee |
| `principal.legalName` | 正式名。なければ表示名 | Employee |
| `principal.jobTitle` | 役職 | Job Title |
| `principal.department` | 部署 | department |
| `principal.location` | 勤務地 | location |
| `principal.startDate` | 入社日 | start date |
| `principal.startDate.dayAfter` | 入社日の翌日 | start date |
| `principal.startDate.nextBusinessDay` | 入社日の次の平日 | start date |
| `principal.tenure` | 送信時点での勤続開始日（または入社日）からの満年数。「1 year」「3 years」 | tenure |
| `principal.birthday` | 日と月で表した誕生日。例：「28 Jul」 | Birthday |
| `principal.nextBirthday` | 基準日以降の次の誕生日 | next Birthday |
| `principal.nextAnniversary` | 基準日以降の次の入社記念日 | next Anniversary |
| `principal.managerName` | マネージャーの表示名 | Manager |
| `principal.managerPreferredName` | マネージャーの呼び名 | Manager |
| `principal.managerEmail` | マネージャーの勤務先メールアドレス | manager email |
| `principal.buddy.name` | バディの表示名 | Buddy |
| `principal.buddy.preferredName` | バディの呼び名 | Buddy |
| `principal.buddy.preferredFullName` | バディの呼び名と姓 | Buddy |
| `principal.buddy.email` | バディの勤務先メールアドレス | buddy email |
| `principal.buddy.startDate.nextBusinessDay` | バディの入社日の次の平日 | start date |
| `principal.hrbp.name` | HRビジネスパートナーの表示名 | HRBP |
| `principal.hrbp.preferredName` | HRビジネスパートナーの呼び名 | HRBP |
| `principal.hrbp.preferredFullName` | HRビジネスパートナーの呼び名と姓 | HRBP |
| `principal.hrbp.email` | HRビジネスパートナーの勤務先メールアドレス | HRBP email |
| `recipient.preferredName`、`recipient.firstName`、`recipient.preferredFullName`、`recipient.legalName` | 上と同じで、受信者について | Employee |
| `recipient.department`、`recipient.location` | 上と同じで、受信者について | department, location |
| `recipient.startDate` | 受信者の入社日 | start date |
| `recipient.birthday`、`recipient.nextBirthday`、`recipient.nextAnniversary` | 上と同じで、受信者について | Birthday, next Birthday, next Anniversary |
| `recipient.surveyLink` | 受信者のレコードに保存されたリンク。リンクとして表示されるか、何も表示されません | |

メールの**Subject**で使えるトークンはこれより少なく、プリンシパルと受信者それぞれの呼び名、誕生日、次の誕生日、次の記念日です。Jiraチケットの**Summary**と**Description**では12個の`principal`トークンが使えます。`principal.department`、`principal.email`、`principal.employeeNumber`、`principal.jobTitle`、`principal.legalName`、`principal.location`、`principal.managerEmail`、`principal.managerName`、`principal.name`、`principal.preferredFullName`、`principal.preferredName`、`principal.startDate`です。

## Raw HTML用のトークン

Raw HTMLメールや[Raw HTML Block](https://support.pyn.ai/ja/flows/steps/format-a-message/#raw-html-block)では、上のすべてのトークンをLiquid名で解決できるほか、次のトークンも使えます。

| トークン | 値 | フォールバック |
| --- | --- | --- |
| `company.name` | ワークスペースの会社名 | company |
| `date.today` | 送信日 | today |
| `date.tomorrow` | 送信日の翌日 | tomorrow |
| `principal.name`、`recipient.name` | 表示名 | Employee |
| `principal.email`、`recipient.email` | 勤務先メールアドレス | email address |
| `principal.personalEmail`、`recipient.personalEmail` | 個人メールアドレス | personal email address |
| `principal.endDate`、`recipient.endDate` | 退職日 | end date |
| `principal.city`、`principal.country`、`recipient.city`、`recipient.country` | 市区町村と国 | city, country |
| `recipient.jobTitle` | 受信者の役職 | Job Title |
| `recipient.tenure` | 送信時点での受信者の勤続開始日（または入社日）からの年数。最も近い年に丸められ、`1 year`または`N years`と表示されます | tenure |

Pynが知らないLiquid名は、書かれたままメールに残ります。

## カスタムトークンと従業員フィールドのトークン

- `custom.<column>`：その人をエンロールするのに使ったメールマージ用スプレッドシートの列で、キャメルケースで名付けられます（`Start Location`は`custom.startLocation`になります）。**Insert widget**、**Custom Token**で挿入します。フォールバックは列名です。値のない**Custom Token Block**には、設定したフォールバックが表示されるか、何も表示されません。[スプレッドシートからエンロールする](https://support.pyn.ai/ja/flows/automations/enroll-from-a-spreadsheet/)を参照してください。
- 従業員フィールドのトークン：従業員レコードの任意のフィールドで、**Insert token**、**Employee Field**で選び、プリンシパルまたは受信者に適用します。フォールバックは任意で入力できます。フォールバックがないと、値のないフィールドには何も表示されません。

## 書式

- 日付は受信者のロケールで、曜日、日、月、年の順に表示されます。例：「Thu, 22 Oct 2026」。誕生日は日と月で表示されます。
- `date.today`と`date.tomorrow`は配信のスケジュール時刻から取られます。送信時刻のないプレビューではフォールバックが表示されます。
- 勤続年数は満年数に丸められるため、11か月の人は「1 year」と表示されます。
- 太字や色付きの範囲の中にあるトークンは、その書式を保ちます。

## Pynがもう埋めない名前

Pyn Classicの次の名前は受け付けられますが、何も表示されません。`date.nextBusinessDay`、すべての`manager.*`トークン（代わりに`principal.managerName`、`principal.managerPreferredName`、`principal.managerEmail`を使います）、`principal.homeAddress`、`principal.employeeNumber`、`principal.employmentType`、`principal.mobilePhone`、`principal.brand`、`principal.buddy.jobTitle`、`principal.buddy.location`、`principal.buddy.startDate`、`principal.buddy.startDate.dayAfter`、`principal.returnsFromLeaveOn`、それらに対応する`recipient`トークン、そして`recipient.startDate.dayAfter`と`recipient.startDate.nextBusinessDay`です。

## 関連ページ

- [メッセージの書式を整える](https://support.pyn.ai/ja/flows/steps/format-a-message/)：トークン、カスタムトークン、従業員フィールドの挿入についてです。
- [受信者とCcを選ぶ](https://support.pyn.ai/ja/flows/steps/choose-recipients-and-cc/)：各ステップでプリンシパルと受信者が誰になるかについてです。
- [スプレッドシートからエンロールする](https://support.pyn.ai/ja/flows/automations/enroll-from-a-spreadsheet/)：カスタムトークンの列についてです。
- [HiBobのフィールドマッピング](https://support.pyn.ai/ja/integrations/hibob/field-mapping/)：HiBobを接続しているときに各トークンの裏にあるBobのフィールドについてです。
