トークン
トークンは、メッセージが1人の受信者向けに整形されるときにPynが置き換える目印です。エディターで@を入力すると挿入できます。Raw HTMLメールやRaw HTML Blockでは、{{ principal.preferredName }}のようにLiquidタグとして書きます。principalトークンはエンロールされた従業員について、recipientトークンはメッセージを受け取る人についてのものです。従業員宛てのメッセージでは、この2人は同じ人です。
値がないとき、トークンには下の表にあるフォールバックのテキストが表示されます。トークンに独自のフォールバックを設定した場合はそちらが使われます。名前、部署、役職はDirectoryの従業員レコードから取得されます。
エディターのトークン
Section titled “エディターのトークン”| トークン | 値 | フォールバック |
|---|---|---|
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用のトークン
Section titled “Raw HTML用のトークン”Raw HTMLメールや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名は、書かれたままメールに残ります。
カスタムトークンと従業員フィールドのトークン
Section titled “カスタムトークンと従業員フィールドのトークン”custom.<column>:その人をエンロールするのに使ったメールマージ用スプレッドシートの列で、キャメルケースで名付けられます(Start Locationはcustom.startLocationになります)。Insert widget、Custom Tokenで挿入します。フォールバックは列名です。値のないCustom Token Blockには、設定したフォールバックが表示されるか、何も表示されません。スプレッドシートからエンロールするを参照してください。- 従業員フィールドのトークン:従業員レコードの任意のフィールドで、Insert token、Employee Fieldで選び、プリンシパルまたは受信者に適用します。フォールバックは任意で入力できます。フォールバックがないと、値のないフィールドには何も表示されません。
- 日付は受信者のロケールで、曜日、日、月、年の順に表示されます。例:「Thu, 22 Oct 2026」。誕生日は日と月で表示されます。
date.todayとdate.tomorrowは配信のスケジュール時刻から取られます。送信時刻のないプレビューではフォールバックが表示されます。- 勤続年数は満年数に丸められるため、11か月の人は「1 year」と表示されます。
- 太字や色付きの範囲の中にあるトークンは、その書式を保ちます。
Pynがもう埋めない名前
Section titled “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です。
- メッセージの書式を整える:トークン、カスタムトークン、従業員フィールドの挿入についてです。
- 受信者とCcを選ぶ:各ステップでプリンシパルと受信者が誰になるかについてです。
- スプレッドシートからエンロールする:カスタムトークンの列についてです。
- HiBobのフィールドマッピング:HiBobを接続しているときに各トークンの裏にあるBobのフィールドについてです。