Frontメッセージテンプレート変数:全フィールド、フォールバック、上限

Rama Adi
執筆者

Rama Adi

Katelin Teen
レビュー者

Katelin Teen

最終更新 2026年11月6日

専門家による検証済み
ノートパソコンを前にした二人のチームメイトと、波括弧のプレースホルダーカード、紫色のFront風ロゴ形を描いた手描きイラスト
TL;DR

Frontメッセージテンプレート変数は、{{recipient.first_name}}のように入力するプレースホルダーで、返信相手の連絡先、そのアカウント、送信するチームメイトから埋まります。{{recipient.first_name | 'there'}}のように単一引用符でフォールバックを追加してください。名前がないと変数が未入力のままになります。変数が埋まるのは最初の受信者だけで、user変数は自動返信では空白になり、テンプレートは全プランにありますが、アプリケーションオブジェクトの変数はProfessional以上が必要です。

eeselはFrontのテンプレートを挿入しませんが、テンプレートがカバーしない返信を内部コメントとして下書きできます。eesel CLIを使えば、コーディングエージェントがFrontのAPIで取得したテンプレートの文章などの承認済みの知識をアップロードし、公開前にサンプルの質問で回答をテストできます。Front連携の承認には、依然として管理者権限を持つ人が必要です。

Frontメッセージテンプレート変数とは何ですか?

これは、テンプレートが使われたときにFrontが埋めるメッセージテンプレートや署名内のプレースホルダーテキストです。Frontのヘルプセンターはこれらを、「あなたが提供した情報」に基づいて動的に埋まるものと説明し、受信者の保存済みの詳細情報やカスタムフィールドのデータから取得されるとしています。

私はeeselでヘルプデスク連携を構築していて、Frontも含まれますが、変数リストはテンプレートの中で、返信が個人的に聞こえるか定型文のように聞こえるかを静かに決める部分です。仕組みは単純です。テンプレートエディタで{{と入力するとリストが開き、変数を選びます。Frontはそれを二重波括弧で挿入し、チームメイト(またはルール)がテンプレートを使うと値が表示されます。

Frontテンプレートエディタで二重波括弧がconversation.idやrecipient.first_nameなどの変数リストを開いている様子。Frontヘルプセンターより
Frontテンプレートエディタで二重波括弧がconversation.idやrecipient.first_nameなどの変数リストを開いている様子。Frontヘルプセンターより

メッセージテンプレート自体は、Front版の定型文です。テンプレートの記事によると、テンプレートは自分専用にもチームメイトと共有にもできて、共有テンプレートは選んだ受信ボックスに限定できます。他のヘルプデスクでもマクロを使っているなら、私のFreshdesk定型文のガイドで、同じ考え方が他でどう作られているかを紹介しています。

Frontが提供する変数は何ですか?

接頭辞で分かれる4つのファミリー、recipient、account、user、appと、いくつかのIDです。以下はFrontの変数に関する記事のデフォルトリストで、保存済みの連絡先から埋まるとされています。

変数埋まる内容ドキュメントの注記
recipient.first_name連絡先の名前の最初の部分最初のスペースで分割;カンマがある場合はカンマの後がすべて
recipient.last_name名前の残りカンマがある場合はカンマの前がすべて
recipient.name連絡先のフルネーム
recipient.email、recipient.phone、recipient.twitter連絡先の詳細twitterはXのハンドル
recipient.handleこのチャネルでの連絡先のハンドルメッセージの種類による
recipient.link連絡先のリンク属性
account.name連絡先が紐づくアカウントの名前
conversation.id、conversation.public_id、conversation.ticket_id数値ID、公開ID(cnv_123abcのような形式)、チケットID
message.id、message.public_idメッセージの数値IDと公開ID
user.name、user.first_name、user.last_name、user.email、user.id送信するチームメイト自動返信では空白
surveyFrontのCSATアンケートを挿入

名前分割のルールは2回読む価値があります。Frontの例では、「Sophia Marie Carpenter」として保存された連絡先はfirst_nameが「Sophia」、last_nameが「Marie Carpenter」になり、「Carpenter, Sophia Marie」なら「Sophia Marie」と「Carpenter」になります。連絡先が「姓, 名」の形式で読み込まれている場合でも、Frontはカンマを読み取って順序を正しく処理します。

Frontの変数の接頭辞ごとに、連絡先、アカウント、送信するチームメイト、アプリケーションオブジェクトのどれから埋まるかを示す手描きの行
Frontの変数の接頭辞ごとに、連絡先、アカウント、送信するチームメイト、アプリケーションオブジェクトのどれから埋まるかを示す手描きの行

知っておくべき不一致が1つあります。同じ記事のエディタのスクリーンショットにはmessage.from_channelとrecipient.groupも載っていますが、書かれたリストには抜けています。自分のワークスペースのドロップダウンこそが信頼できる情報源なので、何かが存在しないと決めつける前にスクロールして確認してください。surveyの項目はCSATアンケートに関係し、私のAI CSATの記事が測定の側面を扱っています。

カスタムフィールド変数はどう機能しますか?

Frontでは連絡先、アカウント、チームメイトに独自のフィールドを追加でき、それぞれが変数になります。{{に続けてファミリー名を入力すると表示されます。ドキュメントによると、Customer IDという連絡先フィールドはrecipient.custom.customer_id、Account Managerというアカウントフィールドはaccount.custom.account_manager、Job Titleというチームメイトフィールドはuser.custom.job_titleとして表示されます。

誤動作を防ぐ2つのルールがあります。

  1. アカウントデータはTo欄から来ます。 FrontはコンポーザーのTo欄にいる受信者に対してカスタムアカウント変数を埋め、その受信者はあなたのContact Managerに存在し、アカウントに接続されている必要があります。
  2. アプリケーションオブジェクトは別物です。 会話に添付された第三者データ(注文、サブスクリプションなど)には{{app.と入力し、アプリケーションまたはオブジェクト名で絞り込みます。これらはコンポーザーとメッセージテンプレートのみで機能するため、署名では使えません。

アプリケーションオブジェクトには独自の制限があります。Frontのドキュメントによると、テンプレートは一度に1つのアプリケーションオブジェクトの変数しか使えず、Frontは会話に添付されたオブジェクトからそれらを埋めます。オブジェクトがない場合は警告が出ます。複数ある場合は、Frontが最初のものを選び、別のものに切り替えることもできます。

Frontのルールアクションで「Reply once using the Order shipped template」とRequested Orderオブジェクトが表示されている様子。Frontヘルプセンターより
Frontのルールアクションで「Reply once using the Order shipped template」とRequested Orderオブジェクトが表示されている様子。Frontヘルプセンターより

このスクリーンショットは自動返信のケースです。ルールが「Order shipped」テンプレートを送信し、どのオブジェクトを読むかを指定します。この方法でオブジェクトを選ぶのが、以下で扱う動的変数です。

値がない場合はどうなりますか?

変数は埋まらず、Frontはフォールバックを定義するよう案内します。変数のFAQによると、受信者の名前がContacts Managerに存在しない場合、変数は埋まらないため、パイプの後にフォールバックを書き、単一引用符で囲みます。

{{recipient.first_name | 'there'}}

連絡先に名前があるときはHi Sophia、名前がないときはHi thereが埋まる様子を示した手描きの分岐図
連絡先に名前があるときはHi Sophia、名前がないときはHi thereが埋まる様子を示した手描きの分岐図

私なら、名前だけでなく空になりうるすべての変数にフォールバックを設定します。「Hi ,」で始まるカスタマーサービスのメールテンプレートは、まさに不注意に見える小さなミスであり、トーンの工夫では後から直せない失敗です。

Frontのドキュメントは、変数に値もフォールバックもない場合にテンプレートが何を表示するか、空白のテキストか生の波括弧かを明記していません。また、フォールバックがカスタムフィールドにも同じように適用されるかも書かれていません。ルールが顧客にテンプレートを送信する前に、両方を自分宛てのメッセージでテストしてください。共有の受信ボックスを使うチームにとってテンプレートがなぜ重要かを語ったあるG2のレビュアーは、その重大さをはっきり述べています。

G2

"It would result in 2 different prices being sent sometimes, which could hurt the revenue and make us look bad."

このレビュアーが語っていたのは、2人が同じリクエストに答えてしまうことで、共有の受信ボックスとテンプレートはそれを防ぐ助けになります。私のFront共有受信ボックスの担当範囲のガイドで、担当の側面を扱っています。

Frontのテンプレート変数はどこで機能しますか?

テンプレートエディタ以外にも多くの場所で機能し、それぞれルールが異なります。場所を選んで、Frontのドキュメントがそこで何が埋まるとしているかを確認してください。

変数はどこで使われますか?

すべて埋まります。recipient、account、user、appの変数はすべてコンポーザーで機能します。appの場合、Frontは会話に添付されたオブジェクトを読み取り、ない場合は警告し、複数あれば最初のものを選びます(切り替え可能)。
ほとんど機能しますが、userは別です。Reply using message templateアクションでは、どのチームメイトも返信に紐づかないためuser変数は空白になります。app変数は、EnterpriseまたはAutopilotアドオン限定の動的変数でオブジェクトを選べば機能します。
はい、メール署名で機能します。変数はSender info欄と本文の両方で機能するため、各チームメイトが自分の名前を見られます。署名はメールチャネルのみで、app変数はコンポーザーとメッセージテンプレートのみです。
はい。件名の変数は、チームメイトがテンプレートを挿入したとき(新規メッセージと返信の両方)と、ルールが送信したときに埋まります。件名付きのテンプレートを挿入すると、以前の件名を上書きします。
2種類のみです。Sequencesは{{sequence...}}のCSV列(最大20)と{{recipient...}}のカスタムフィールドを受け付けます。フォールバックは同じ単一引用符の構文を使います。件名で{{と入力してもリストは開かないため、変数を直接書き出してください。
最初の受信者のみです。変数はリストの最初の人にだけ埋まり、各人ごとに別のコピーにはなりません。それぞれ異なる値を持つ個別のコピーが必要な場合、FrontはSequencesを案内します。

一斉送信をするならシーケンスの行が重要です。FrontのSequencesの記事はCSVからのメールマージのように機能するため、{{の習慣はそのまま使えますが、変数のリストはより狭くなります。AIによるメールの個人化を中心に作られたツールと比較しているなら、この狭さこそが検討すべき違いです。

変数付きのテンプレートはどう作りますか?

メッセージを書き、変数を入れて、適切な人が見つけられる場所に保存します。Frontの手順を簡単にまとめると次のとおりです。

  1. 歯車アイコンをクリックし、ワークスペースまたは個人の設定を選び、Templates、続けてMessagesタブを選択します。
  2. Createをクリックし、名前、任意の件名、テキストボックスを入力します。変数には{{と入力します。
  3. 必要に応じてフォルダに整理し(最大5階層まで入れ子にできます)、共有テンプレートについては、どの共有受信ボックスで使えるかを選びます。
  4. Createをクリックします。チームメイトはコンポーザーのテンプレートアイコンから、または/templateやスラッシュとテンプレート名を入力して挿入します。

まずコンポーザーで下書きを書いて、テンプレートメニューのNew from draftを使うこともできます。Frontのアドバイスは、送信前にチームメイトが編集すべきテキストをハイライトしておくことで、個人的な調整が見落とされないようにすることです。

FrontのMessagesタブにあるTemplatesページで、受信者の名前変数で始まるCSATリクエストテンプレートが一覧表示されている様子。Frontヘルプセンターより
FrontのMessagesタブにあるTemplatesページで、受信者の名前変数で始まるCSATリクエストテンプレートが一覧表示されている様子。Frontヘルプセンターより

同じ記事にあるいくつかの制限が、整理の仕方を決めます。

  • テンプレート数に厳密な上限はありませんが、大量にある場合はFrontがフォルダの利用を勧めています。
  • プライベートと共有は固定です。 一方を他方に変換することはできません。内容をコピーして作り直してください。
  • ワークスペース間の移動はできません。 テンプレートは1つのワークスペースから別のワークスペースへコピーも移動もできず、共有テンプレートはワークスペースごとに設定されます。
  • 一括でのアクセス変更はできません。 受信ボックスごとの利用可否はテンプレート単位で設定します。
  • デフォルトの送信者はありません。 テンプレートにはFrom欄がないため、コンポーザーでのチームメイトの選択が優先されます。

Templates - Create and edit権限を持つ人は、自分が開けない受信ボックスのものであっても、ワークスペース設定内のすべての共有テンプレートを見ることができます。それが気になる場合は、カスタム権限セットでこれを外すことができます。いつか移行することがあれば、私のマクロテンプレートとマクロの管理の記事が、まず今持っているものを確認する助けになります。

これはFrontの動的変数と同じものですか?

いいえ、この名前は人を混乱させます。この記事の変数はテキスト内のプレースホルダーです。Frontの動的変数は、Smart Rules、チャットボット、マクロの中で使われる別のツールです。テキスト、メール、URL、数値、チームメイト、受信ボックス、タグ、ブール値、日付、およびそれらのリストといったデータを取得・変換し、1つのルールやマクロで複数の固定された値を置き換えられるようにします。

両者をつなぐのが、上で紹介したOrder shippedのスクリーンショットです。動的変数は、自動返信がどのアプリケーションオブジェクトを読むかを選べます。Frontの動的変数に関する記事によると、これらはEnterpriseプランまたはAutopilotアドオンで利用できて、プレーンな英語の説明を変数に変えるBuild with AIというオプションも含まれます。Frontのマクロガイドには、あるマクロ用に作られた動的変数は別のマクロでは再利用できないとも書かれています。

どのFrontプランが必要ですか?

テンプレートとその変数にアップグレードは必要ありません。追加機能はさらに上のプランにあります。

機能Frontのドキュメントによるプラン
メッセージテンプレートとフォルダ全プラン
テンプレートから送信または下書きするルール全プラン;Starterは最大10ルール、Professionalは最大20ルール
アプリケーションオブジェクト(app.変数)最新のProfessional以上
CSV変数付きのSequencesProfessional以上
動的変数EnterpriseまたはAutopilotアドオン
メール下書きのAI ComposeStarter、Professional、Enterprise;チームメイト1人あたり1日200リクエストまで

Frontの料金ページでは、年払いで席ごと月額Starterが$25、Professionalが$65、Enterpriseが$105、Autopilotが会話ごと$0.39、Copilotが席ごと月額$20とされています。プランを変更すると私のFrontの料金やFrontのレビューの記事が遅れて反映されることがあるので、計画する前に確認してください。

Frontのドキュメントが書いていないことは何ですか?

探しても見つからなかったことがいくつかあります。顧客に影響するルールを作る前に、それぞれを自分で試すべきでしょう。

  • フォールバックのない未入力の変数。 空白のテキストか生の波括弧かは明記されていません。
  • 存在しない変数名。 リストにない名前を手で入力したときに何が起きるかは説明されていません。
  • 完全なリスト。 前述のとおり、スクリーンショットには書かれたリストが省く2つの変数が映っているため、テキストがプロダクトより遅れている可能性があります。
  • APIの挙動。 FrontのメッセージテンプレートAPIはテンプレートを名前、件名、HTML本文として示し、作成呼び出しはインラインCSS付きのその本文を受け取ります。APIで作成した本文内の{{ }}変数が同じ方法で解決されるかどうかは書かれていないため、1つ作って挿入して確認してください。
  • 翻訳。 AI Compose(18言語間の翻訳)のドキュメントは、下書きを後から翻訳したときに変数付きのテンプレートがどう振る舞うかを書いていません。

これらはどれも欠陥というより、境界線です。テンプレートシステムは小さく予測可能であり、それこそがほぼ全ての魅力です。

メッセージテンプレートの隣でAIはどこに収まりますか?

テンプレートは、すでに答えた質問を解決します。AIは残りを埋めます。Front自身のAI Composeは既存の下書きを編集し、スペル、トーン、長さ、翻訳のオプションを備え、Front AI CopilotはアドオンまたはEnterprise顧客向けにカスタムプロンプトで下書きします。どちらも、あなたやテンプレートが始めた下書きの上で動きます。より大きな視点が欲しいなら、私のFront AIの概観でこの分野を比較しています。

テンプレートが残す隙間はロングテールです。チームには通常、返品、請求、パスワード再設定のテンプレートがあり、その後に誰もテンプレートを書かなかった質問の列ができます。そこで下書きエージェントが役割を得る一方、そこでうまくいかなくなることもあります。顧客への返信におけるAIハルシネーションは空白の欄より悪いため、私は何かを有効にする前に下書きを過去の会話と照らしてテストします。AIによる初回返信の自動化とAIエスカレーションについての私のメモで、どこで自動化を止めるべきかを扱っています。

smavaは別のヘルプデスクで、このテンプレート優先のパターンをよく示しています。ZendeskでeeselをFront運用し、1つのエージェントがマクロライブラリを検索し、約820件のマクロとヘルプセンター記事から、プレースホルダーを埋めた該当のマクロを一語一句そのまま下書きします。下書きはApproveとRejectのボタン付きでチケットに届き、eeselが自分から送信することはありません。同じ形はFrontチームにも向いているはずです。自社のテンプレートの文言こそが信頼できる情報源のままであり、何を送るかは人が決めます。eeselがFrontのテンプレートを直接読むというドキュメントは見ていないため、Frontでの実用的な方法は、承認済みのテンプレートの文章を知識としてアップロードすることです。

Frontの受信ボックスでFrontのAIメールトリアージも使っているなら、私の負荷分散の記事が、返信が書かれる前に何が起きるかを扱っています。人員配置やキューについての質問には、サポート人員配置のためのAIをお読みください。

Frontの受信ボックスでeeselを試す

テンプレートが繰り返しの質問をすでにカバーしていても、それ以外がすべて空白の返信欄から始まるなら、eeselはFrontのその隙間のために作られています。ヘルプセンターと過去のFrontの会話を読み、新しい会話ごとに内部コメントとして返信を下書きするため、チームメイトはゼロから入力する代わりに編集できるものから始められます。まずは下書きだけで始めて、そこから広げていくことができ、テンプレートの文言を承認済みの情報源のまま保てます。

eesel AIに割り当てられたFrontの会話で、返信前に読んだ内容を示す内部コメントが表示されている様子。eeselのドキュメントより
eesel AIに割り当てられたFrontの会話で、返信前に読んだ内容を示す内部コメントが表示されている様子。eeselのドキュメントより

設定手順については、私のFrontへのAI追加のガイドとFront対eeselの比較をご覧ください。決める前に、いくつかの実際の会話でeeselを試してみてください。

よくある質問

Frontのメッセージテンプレートに変数を追加するには?
テンプレートエディタで開き波括弧を2つ、{{と入力し、表示されるリストから変数を選びます。Frontのヘルプセンターによると、このリストは保存済みの連絡先情報とカスタムフィールドのデータから埋まります。テンプレートはコンポーザーからNew from draft、または設定のTemplatesから保存します。より広い設定については、私のAI定型文のガイドをご覧ください。
顧客の名前を表すFrontメッセージテンプレート変数は何ですか?
{{recipient.first_name}}です。Frontは保存された連絡先名を最初のスペースで分割するため、「Sophia Marie Carpenter」は「Sophia」になります。名前にカンマがある場合、名はカンマの後のすべてです。名前のない連絡先には{{recipient.first_name | 'there'}}のようなフォールバックを追加してください。同じ役割を果たすFreshdeskの定型文フィールドとの違いも比較してみてください。
Frontのテンプレート変数に値がない場合はどうなりますか?
Frontのヘルプセンターによると、その変数は埋まらず、単一引用符でフォールバックを定義するよう案内されます。フォールバックのない未入力の変数が空白のテキストとして表示されるのか、生の波括弧として表示されるのかは書かれていないため、まず自分宛てにテストを送ってください。私の自動応答ルールのベストプラクティスの記事で、自動返信のテストを扱っています。
Frontメッセージテンプレート変数は自動返信でも機能しますか?
部分的にです。受信者とアカウントの変数は、ルールがテンプレートを送信するときに埋まります。送信するチームメイトを表すuser変数は、自動返信にはチームメイトが紐づいていないため空白になります。アプリケーションオブジェクトの変数はオブジェクトを選ぶために動的変数が必要で、FrontはこれをEnterpriseまたはAutopilotアドオン限定としています。AI側についてはFront AI自動返信をご覧ください。
メッセージテンプレートと変数はFrontのどのプランに含まれますか?
Frontのヘルプセンターによると、メッセージテンプレートは全プランで利用できます。アプリケーションオブジェクトには最新のProfessionalプラン以上、Sequencesにも Professional以上が必要です。Frontの料金ページでは、年払いで席ごと月額Starterが$25、Professionalが$65、Enterpriseが$105とされています。私のFrontの料金のガイドで、各プランが追加する内容を詳しく説明しています。
各受信者の名前を埋めたままFrontのテンプレートを複数の受信者に送れますか?
1つのコンポーザーメッセージからはできません。複数の受信者がいる場合、Frontの変数はリストの最初の受信者だけに対して埋まり、各人に専用のコピーが必要な場合はドキュメントがSequencesを案内します。その方法で送られたテンプレートは、Frontが持つメールマージに最も近いものです。ツールを比較検討しているなら、私のFrontの代替ツールのまとめで選択肢を比較できます。
eeselのようなAIエージェントはFrontのメッセージテンプレートを使えますか?
eeselのFront連携は、ヘルプセンターと過去の会話から内部コメントとして返信を下書きします。Frontのメッセージテンプレートを読んだり、その変数を埋めたりするというドキュメントは見つからなかったため、テンプレートはeeselが挿入するものではなく、知識としてアップロードする元material として扱うのが良いでしょう。設定についてはFrontへのAI追加をご覧ください。

Share this article