名前変数を使うと、usersの属性（例：first name）からデータを取得してIntercomのメッセージやテンプレートをパーソナライズできます。このガイドでは名前変数の使い方、よくある問題と解決策を説明し、スムーズで個別化された顧客対応を実現します。
各顧客向けにメッセージやテンプレートをパーソナライズしましょう。
動的コンテンツで顧客エンゲージメントを向上させましょう。
名前データがない場合の不自然な挨拶を避けましょう。
名前変数の使い方
テンプレートやmacroでメッセージをパーソナライズする
macroやメッセージテンプレートで
#fnまたは{{first_name|fallback:"ENTER FALLBACK HERE"}}を使い、名前がない場合はフォールバックを表示して顧客のfirst nameを挿入します。HTMLメールでは
{{ first_name | fallback:"ENTER FALLBACK HERE" }}を使って名前をパーソナライズします。名前がない場合に表示するフォールバックを設定してください。Intercomのワークスペースで、テキストエディタのプレースホルダーオプションから変数を選択し、名前属性を挿入・カスタマイズします。
投稿メッセージをカスタマイズする
投稿を編集モードで開きます。
名前を表示したい場所にカーソルを置きます。
テキストメニューから「first name」属性を挿入します。
黄色の注意アイコンをクリックしてフォールバック値（例：「Hey there」）を設定します。
変更を保存して、usersが名前またはフォールバックの挨拶を見られるようにします。
macroで名前変数を使う
アクションメニューを開き、macroを作成します。
macroのテキストをカスタマイズし、属性を挿入 → First nameを選択します。
macroを使うには、返信時に
SHIFT + #を押して保存したmacroを選択します。
トラブルシューティングとベストプラクティス
よくある問題と解決策
usersのfirst nameが異なって表示される場合：これは通常、名前がIntercomのデフォルトの名前属性ではなくカスタム属性から取得されている場合に起こります。ワークフローでデフォルトの名前属性を使っているか確認してください。
名前属性が空白の場合：名前属性はusersの作成や更新時に必須ではありません。設定されていなければ空のままです。usersの記録を保存する際は必ず名前を提供してください。
APIレスポンスに名前があるのにIntercomで見えない場合：ウェブサイトや統合からのPingリクエストで空の名前フィールドが送信されると、既存のusersの名前が空白で上書きされることがあります。Pingリクエストに正しい名前を含めてください。
新しい会話の最初のWorkflowメッセージで名前変数が空白の場合：同じブラウザセッション内の前の会話で顧客の名前が既にわかっていても起こることがあります。"customer opens a new conversation in the Messenger"でトリガーされるWorkflowメッセージは、Intercom JavaScript SDKがユーザーを識別し名前を書き込む前に発火することがあり、その瞬間は
{{Name}}の値がまだ利用できず空白になります。ユーザー情報が保存されると、同じ会話内の後続メッセージで名前が利用可能になります。最初のメッセージで{{Name}}が間に合う保証はないため、変数にフォールバック値を設定し、挨拶が自然に読めるようにしてください。iOS usersがIntercomで「User」と表示される場合：iOS usersがメールやuser IDで識別されていない場合、Intercomは「User m4m2」などのプレースホルダー識別子を割り当てます。ログイン時にメールや一意のuser IDを渡してusersを識別してください。
投稿が実際の名前ではなく「Hi First Name」と挨拶する場合：これは挨拶がハードコードされている場合に起こります。Intercomの動的な"first name"属性とフォールバックオプションを使いましょう。
「Send separately」が有効な複数受信者へのメール送信時、名前変数は個々の受信者の名前をパーソナライズしません。代わりにフォールバック値か空白が表示されることがあります。
ベストプラクティス
カスタム設定が必要な場合を除き、常にデフォルトの"first name"属性を使いましょう。
名前データがない場合に備え、すべてのコミュニケーションでフォールバック値を設定して一貫性を保ちましょう。
SDKでは、メールアドレスなど安定した識別子を使ってできるだけ早くusersを識別してください。
API設定を定期的に見直し、空のフィールドによる上書きを防ぎましょう。
よくある質問
なぜusersのfirst nameがIntercomで異なって表示されるのですか？
これは通常、名前がデフォルトの名前属性ではなくカスタム属性から取得されている場合に起こります。正確性を保つためにデフォルトの"first name"属性を使ってください。
なぜ名前属性が時々空白になるのですか？
名前属性は必須ではありません。設定されていなければ空白のままです。Intercomに連絡先を保存する際は必ず名前を提供してください。
なぜAPIレスポンスに名前があるのにIntercomで見えないのですか？
空の名前フィールドを含むPingリクエストが既存の名前を上書きすることがあります。Pingリクエストには必ず正しい名前を含めてください。
なぜiOS usersがIntercomで「User」と表示されるのですか？
iOS usersがメールやuser IDで識別されていない場合、Intercomはプレースホルダー識別子を割り当てます。ログイン時にメールアドレスなどでusersを識別してください。
なぜ投稿が「Hi First Name」と挨拶したのですか？
これは挨拶がハードコードされている場合に起こります。実際の名前を表示するには、動的属性とフォールバックを使いましょう。