コンテンツにスキップ
PynPyn

トークン

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

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

トークン 値 フォールバック
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 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 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です。