Help Scout Beaconのフォームフィールド:会話に反映されるのはどれか

Rama Adi
執筆者

Rama Adi

Katelin Teen
レビュー者

Katelin Teen

最終更新 2026年11月6日

専門家による検証済み
4つの入力欄とチャットアイコンを持つBeaconコンタクトフォームの横に立つ手描きのサポートチームメイトたち、青い図形の上にあるHelp Scoutのロゴの隣
TL;DR

Beaconのコンタクトフォームには4つの組み込み入力(名前、メール、件名、メッセージ)、任意の添付ファイル、そして最大5つのカスタムフィールドがありますが、会話に構造化データを書き込むのはカスタムフィールドだけです。カスタムフィールドにはPlusまたはProが必要で、まず接続されたInboxに存在している必要があり、ラベルではなくフィールドIDでプレフィルされます。ドロップダウンの一つをルーティング用の質問にすれば、workflowがタグ付けと割り当てを行えます。eesel CLIを使えば、コーディングエージェントが先にeeselをHelp Scoutに接続してテストの質問を送ることができますが、接続の承認はHelp Scoutの管理者が行う必要があります。

Beaconのコンタクトフォームはどんなフィールドに対応していますか?

Help ScoutのBeaconコンタクト設定には6つのスイッチがあり、フォームは多くの人が思うより小さいです。メールは常に必須です。名前と件名は任意のトグルです。添付ファイルとカスタムフィールドも任意です。訪問者が入力するそれ以外のものはすべてメッセージ本文に入ります。

Ask for a name、Ask for a subject、Allow attachments、Show Custom Fields (5 maximum)、Show photosのトグルを示すBeaconコンタクトフォーム設定、Help ScoutのBeaconコンタクト設定ガイドより
Ask for a name、Ask for a subject、Allow attachments、Show Custom Fields (5 maximum)、Show photosのトグルを示すBeaconコンタクトフォーム設定、Help ScoutのBeaconコンタクト設定ガイドより
フィールドデフォルトで有効?刺さるルールHelp Scoutでどうなるか
メール常に必須Require emailを無効にした場合のみチャットでスキップされる会話上の顧客のメール
名前トグル有効にすると必須; identifyを呼ぶと非表示顧客名
件名トグル有効にすると必須; プレフィル可能会話の件名
メッセージ常に自由記述、prefill呼び出しのtext最初のスレッド
添付ファイルトグルメッセージごとに最大3ファイル、各10MBまでスレッド上の添付ファイル
カスタムフィールドトグル最大5件表示、Inboxと同じ名前会話のカスタムフィールド

サポートリードの実際の混乱を防ぐ2つの詳細があります。まず、名前または件名を有効にすると、Help Scoutはそれぞれを必須にするため、「任意の件名」という設定は存在しません。次に、フォームから開始された会話は、Beaconが接続されているInboxに届くため、選んだInboxがどのカスタムフィールドを利用できるかを決めます。まだツールを選んでいる場合は、私のHelp ScoutレビューとHelp Scoutの機能ガイドが残りの部分をカバーしています。

Beaconでカスタムフィールドを使えるHelp Scoutのプランはどれですか?

カスタムフィールドはPlusとProの機能です。Help Scoutのカスタムフィールドガイドは、PlusとProプランで利用できると述べており、スマートコンタクトフォームの記事もBeaconについて同じことを繰り返しています。コンタクト設定ページには、Custom Fieldsアドオンを持つアカウントも表示できると書かれていますが、現在の料金ページの項目には対応するものが見つからなかったため、Standardプランでそれらを使いたい場合はHelp Scoutに確認してください。

プラン料金ページでの価格Beaconのカスタムフィールド
Free5ユーザー、1 Inbox、1 Docsサイトドキュメントに記載なし
Standardユーザーあたり月25ドルドキュメントに記載なし
Plusユーザーあたり月45ドルあり、フォームで最大5件
Proユーザーあたり月75ドルあり、フォームで最大5件

価格はHelp Scoutのページに表示されているユーザーあたりの代表的な料率で、月額と年額のトグルがあるため、ご自身の請求期間を確認してください。私のHelp Scoutの料金の記事はチーム全体の料金を算出しています。Plusはまた、Help Scoutが高度なworkflowを置く場所でもあり、それがこのセットアップのうちルーティングを担う半分です。

カスタムフィールドは会話のフィールドにどう対応しますか?

フィールドごとに1対1です。Inboxでフィールドを作成し、Beaconでそれにチェックを入れると、訪問者の回答は会話上の同じフィールドに保存されます。独立した「フォームフィールド」オブジェクトは存在しないため、上限はInbox側から来ます。

Name Request Type、Type Dropdown、Requiredトグル、Order Inquiry、Account Access、Otherのオプションを示すHelp Scoutの新しいカスタムフィールド画面、Help Scoutのカスタムフィールドガイドより
Name Request Type、Type Dropdown、Requiredトグル、Order Inquiry、Account Access、Otherのオプションを示すHelp Scoutの新しいカスタムフィールド画面、Help Scoutのカスタムフィールドガイドより

データがきれいに届くかどうかを決める事実を、すべてHelp Scoutのカスタムフィールドガイドから挙げます。

  • Inboxごとに10フィールド、フォームには5つ。 各Inboxは最大10個のカスタムフィールドを持てますが、Beaconはそのうち最大5つしか表示できません。
  • 5つのタイプ。 ドロップダウン(最大100オプション)、1行、複数行、数値、日付です。数値と日付のフィールドは入力を検証します。
  • 必須はInboxに従います。 フィールドがInboxで必須なら、Beaconフォームでも必須になります。
  • 名前は顧客に見えます。 フィールド名は訪問者が見るものであり、名前に使える特殊文字は!、.、,だけです。
  • フィールドは1つのInboxに属します。 会話を別のInboxに移動すると、そこに同じ名前のフィールドがあってもカスタムフィールドのデータは引き継がれません。Help Scoutは事前にデータ損失の警告を表示します。
  • タイプは変更できず、削除は取り消せません。 フィールドの名前変更やドロップダウンのオプション編集はできますが、タイプの切り替えはできず、削除されたフィールドはすべての会話でデータを失います。
  • Admin権限で作成します。 デフォルトでは、管理者とアカウント所有者だけがフィールドを追加・編集できます。

Inboxに紐づくというルールは、私なら付箋に書いておくものです。2つのブランドを2つのInboxで運用し、一方を他方に統合するチームは、すべての「Product line」の回答を静かに失います。共有メールボックス1つで十分かどうか検討しているなら、共有Inbox対チケットシステムと最良の共有Inboxツールの比較が役立ちます。他のヘルプデスクにも別名で同じ概念があり、FreshdeskのチケットフィールドやZendeskのカスタムチケットフィールドがその例です。

Request Type、Account URL、Rush Service、Lease Number、必須のAccount Numberの横にチェックの入ったProduct Lineドロップダウンを示すBeaconのShow Custom Fieldsリスト、Help Scoutのスマートコンタクトフォーム記事より
Request Type、Account URL、Rush Service、Lease Number、必須のAccount Numberの横にチェックの入ったProduct Lineドロップダウンを示すBeaconのShow Custom Fieldsリスト、Help Scoutのスマートコンタクトフォーム記事より

フォームデータを読むだけでなく、ルーティングに使うにはどうすればいいですか?

カスタムフィールド単体では、サイドバーのラベルに過ぎません。値はHelp Scoutのスマートコンタクトフォーム記事の第2のステップから生まれます。つまり、フィールドを探して動作するworkflowです。その記事の例では、顧客がTiesのプロダクトラインを選んだ会話にタグを付けており、同じ記事はworkflowがユーザーやチームへの割り当て、別のInboxへの移動、自動返信の送信もできると述べています。

Product line、Account URL、Subjectのチップが会話のCustom Fieldsカードに流れ込み、その後タグ付けと割り当てを行うworkflow、そして適切な担当者またはAIエージェントへ渡る様子を示す、Beaconフォームの手描きフロー
Product line、Account URL、Subjectのチップが会話のCustom Fieldsカードに流れ込み、その後タグ付けと割り当てを行うworkflow、そして適切な担当者またはAIエージェントへ渡る様子を示す、Beaconフォームの手描きフロー

私のルールは、最初のドロップダウンを好奇心のための質問ではなく、ルーティングのための質問にすることです。「お問い合わせの種類:注文に関する質問、アカウントアクセス、その他」はworkflowに3つの明確な分岐を与えます。「どこで当社を知りましたか」は何もさせません。このドロップダウンをInbox側の必須フィールドと組み合わせれば、すべての送信が仕分けされた状態で届きます。自動チケット割り当てのガイドとインテリジェントルーティングの概要は、ラベルができた後にすべきことをカバーしており、チケットトリアージは判断が必要な部分をカバーしています。

自由記述のフィールドは別物です。1行の「Account URL」はサイドバーを読む人間には有用ですが、workflowはそれに基づいて確実に分岐できないため、自由記述はコンテキストとして、ドロップダウンはルーティングとして扱ってください。

JavaScript APIでBeaconフォームをプレフィルするにはどうすればいいですか?

Beacon('prefill', ...)を使います。Help Scoutの開発者ドキュメントによると、name、email、subject、メッセージ本文(text)、カスタムフィールド(fields)を事前入力でき、identifyとは異なり、名前とメールは表示され編集可能なままです。

JavaScript
Beacon('prefill', {
  name: 'Steve Aoki',
  email: 'steve@aoki.com',
  subject: 'Need help with invoice',
  text: 'Hello, I need some help with my invoice',
  fields: [
    { id: 5678, value: 1234 },      // dropdown: field ID, option ID
    { id: 5679, value: '2026-11-06' }, // date: YYYY-MM-DD
    { id: 5680, value: 'Question' }    // single, multi line or number: string
  ]
})

落とし穴は、すべて同じBeacon JavaScript APIリファレンスからのものです。

  • フィールドはラベルではなくIDで一致します。 Help Scoutでカスタムフィールドを開いたときのURLでフィールドIDを見つけてください。Help Scoutは、手動でのマッピングは手間がかかるものの、ラベルが変わっても機能し続けると述べています。
  • ドロップダウンにはオプションIDも必要です。 ページのマークアップでdata-option-idを調べることで取得できるため、ドロップダウンのプレフィルは最も厄介なケースです。
  • フィールドはBeaconの設定であらかじめチェックされている必要があります。 フォームに追加していないフィールドをプレフィルしても何も起きません。
  • プレフィルされたカスタムフィールドはデフォルトで非表示です。 訪問者に見せて修正させたい場合は、Beacon('config')でshowPrefilledCustomFields: trueを設定してください。
  • 値はメッセージが送信されると消えます。 次のメッセージのためにprefillを再実行してください。
  • 添付ファイルもプレフィルできます。 最大3つのJavaScriptのFileオブジェクトを渡せます。
  • configは追加はできても、作り出すことはできません。 customFieldsEnabledとallowAttachmentsは、Beaconの設定で既に有効になっている場合のみAPI経由で有効にできます。またshowNameとshowSubjectはfalseからtrueへの切り替えのみ可能です。
identifyが名前とメールをフィールド非表示のまま処理し、prefillが件名・メッセージ・カスタムフィールドを処理し、session-dataが訪問メモのみを処理するという3つの呼び出しから成るBeaconコンタクトフォームの手描き図。プレフィルされた値は送信後に消えるという注記付き
identifyが名前とメールをフィールド非表示のまま処理し、prefillが件名・メッセージ・カスタムフィールドを処理し、session-dataが訪問メモのみを処理するという3つの呼び出しから成るBeaconコンタクトフォームの手描き図。プレフィルされた値は送信後に消えるという注記付き

identify、prefill、session-dataはいつ使うべきですか?

これらは3つの異なる問題を解決するもので、混同することがフォームデータが失われる最も一般的な原因です。データがどこに行き着くべきかに合ったものを選んでください。

このデータはどのBeacon呼び出しで扱うべきですか?

identifyを使う顧客プロファイルを作成・更新し、フォーム上の名前とメールのフィールドを非表示にします。「名前を聞く」が必須の場合、渡す名前は有効である必要があります。スペースだけの名前は400エラーを返すためです。
prefillでカスタムフィールドを使うInboxにドロップダウンを追加し、Beaconでチェックを入れ、ページから既にトピックが分かっている場合はフィールドIDとオプションIDでプレフィルします。その後workflowがそれに基づいてルーティングできます。
Customer Propertyとともにidentifyを使うまずHelp Scoutでプロパティを作成し、その正確なIDをidentifyに渡します。Customer PropertyはStandard、Plus、Proで使えるため、カスタムフィールドが使えない場合でもプランのデータをカバーできます。
session-dataを使うその会話だけの訪問メモに最大20個の属性と値のペアを追加します。顧客プロファイルには同期されませんが、workflowはそれでも見つけて対応できます。

このウィジェットはHelp ScoutのJavaScript APIリファレンスと高度なBeaconカスタマイズガイドに従っています。私が最も有用だと思うのは3番目のケースです。Standardプランのチームはカスタムフィールドを表示できませんが、identify経由でplan: 'Pro'をCustomer Propertyに渡すことができ、それによって会話を引き継ぐ誰にとっても顧客のプロファイル上にその階層が保持されます。デバイスをまたいで会話の全履歴が必要な場合、Secure Modeはサーバー側のキーでidentify呼び出しに署名します。詳しくはBeacon Secure Modeのドキュメントと私のHelp Scout APIのメモをご覧ください。

サポートリードが知っておくべき制限と落とし穴は何ですか?

想定される失敗の多くは、次の5つのいずれかから来ており、そのすべてが静かに起こります。

  1. フィールドは存在するが、Beaconで一度もチェックされていない。 フォームは問題なく見えますが、訪問者には何も表示されません。
  2. Inboxの必須フィールドが送信をブロックする。 必須はBeaconに引き継がれるため、Inboxに新しい必須フィールドを追加すると、Beaconフォームが一夜にして入力しづらくなる可能性があります。
  3. Inboxが変わった。 会話が移動した、またはInboxが統合され、カスタムフィールドの回答が消えてしまった。
  4. ラベルが編集された。 フィールドの名前変更は安全ですが、オプションIDを推測したプレフィルは安全ではなく、削除されたオプションはマッピングを壊します。
  5. 自由記述が構造として扱われた。 入力された値に対するworkflowの条件は、訪問者がたまたま入力した内容にしか一致しません。

製品の関連領域も知っておく価値があります。Beaconのモードは、訪問者が最初にフォームを見るかDocsを見るかを決め、私のHelp ScoutセルフサービスガイドはDocs側をカバーしています。ライブチャットが有効な場合、コンタクトフォームはフォールバックとなり、コンタクト設定ガイドによればオフにはできません。チャットとフォームが一体化したBeaconでは、軽量なチャットバブルの設計と良いハンドオフの実践が、フィールドの一覧と同じくらい重要です。

BeaconのフォームデータにAIエージェントはどこで関わりますか?

フォームが仕事を終えた後、エージェントはそれが生み出したものを使えます。eeselはHelp Scoutのメールボックス内で動作するAIヘルプデスクのチームメイトで、そのセットアップドキュメントは実行できるアクションを挙げています。返信の下書きを残す、返信を送る、内部メモを残す、タグを追加・削除する、会話のステータス・担当者・Inbox・件名を更新する、です。そのトリガー「顧客が新しい会話を開く」はどのInboxでも発火します。Help Scoutによれば、フォームのメッセージは接続されたInboxに会話として届くため、フォーム送信は通常の新しい会話として届くはずですが、信頼する前に一度テストすることをお勧めします。

ここで正直な限界を述べます。eeselが文書化しているHelp Scoutのアクションには、カスタムフィールドの設定や編集は含まれていません。実用的なパターンはルーティングのセクションと同じです。Help Scoutのworkflowにドロップダウンをタグへ変換させ、エージェントにはタグ、メモ、下書きに対して動かせてください。Beaconフォームにとってこれは良い分担です。workflowが決定論的な部分を処理し、エージェントが返信を処理するからです。私のAIトリアージとHelp Scout AIの記事がこれを詳しく掘り下げています。

私が持っている最も近い実例は別のヘルプデスクのものなので、そのまま述べます。オンラインの法的文書会社であるDokument 24は、Zendesk上でeeselを運用しています。メールとコンタクトフォームの問い合わせはZendeskに届き、2026年8月8日から9月8日の間にeeselはチームのために約680件のチケットを準備し、そのうち約430件を商品別にタグ付けし、すべての返信は人が送信するための内部メモとして残されました。これはProduct dropdownを持つBeaconフォームと同じ形です。同じ考え方は、Zendesk向けの私のデータ取得フォームとWebフォームチャネルの記事にも登場し、ZendeskのプレチャットフォームはBeaconのidentifyとprefillの相当品です。

コーディングエージェント向けには、eesel CLIでnpx @eesel/cli integrations connect helpscout_v2を実行して接続オプションを表示し、自動化設定を管理できます。またeesel chatで先にテストの質問を投げられます。メールボックスの接続には、依然としてHelp Scoutの管理者またはアカウント所有者がブラウザでAuthorizeをクリックする必要があります。

Beaconフォームで避けるべき間違いは何ですか?

  • 聞きすぎること。 名前と件名は有効にすると必須になるため、スイッチを増やすたびにフォームを離脱する理由が増えます。workflowが実際に使う一つの質問だけを聞いてください。
  • 内部名を見せること。 フィールド名は顧客に見えるため、「Tier 2 bucket」はそのまま訪問者に見える文言になってしまいます。
  • テスト送信を省くこと。 ステージングページで実際にメッセージを送信し、Custom Fieldsカードとworkflowの結果を確認してください。
  • 自由記述でルーティングすること。 ルーティングにはドロップダウン、コンテキストには1行フィールドを使ってください。
  • 承認が重要だということを忘れること。 カスタマーサポートの承認ワークフローで論じているように、どのエージェントも返信の下書きを残すから始め、回答が信頼できるようになるまで返信を送るはオフにしてください。

関連するHelp Scoutのセットアップについては、私のスヌーズした会話、保存済み返信の管理、チケットの誘導回避に関するメモが次に読むべきもので、ファーストコンタクト解決は整理された受付がなぜ効果を生むのかを説明しています。

Help Scoutのメールボックスでeeselを試す

Beaconフォームが既に会話をタグ付けされた割り当て済みのキューに仕分けているなら、Help Scout向けeeselが次に追加すべき層です。あなたのDocsサイトと過去の会話を読み取り、タグ付けされたキューごとに返信を作成し、送信を有効にするまで人をループに保ちます。eeselを試すには、7日間100の無料クレジットがあり、その後の有料プランは500クレジットで月299ドルから始まり、チケットまたはチャット1件が1クレジットです(eeselの料金)。選択肢を比較しているなら、私のHelp Scout向けベストAIのまとめをご覧ください。

キャンセル後の請求についてHelp Scoutの会話に内部メモを投稿し、質問に答えてその出典となったDocsページを示すeesel、eeselのHelp Scoutセットアップドキュメントより
キャンセル後の請求についてHelp Scoutの会話に内部メモを投稿し、質問に答えてその出典となったDocsページを示すeesel、eeselのHelp Scoutセットアップドキュメントより

よくある質問

Help Scout Beaconのコンタクトフォームにはどんなフィールドがありますか?
メールは常に必須で、名前、件名、添付ファイル(最大3件、各10MBまで)、最大5つのカスタムフィールドを有効にできます。それ以外はすべて本文に入ります。名前と件名は有効にすると必須になります。残りの機能についてはHelp Scoutの機能のガイドをご覧ください。
Beaconにカスタムフィールドを追加できるHelp Scoutのプランはどれですか?
Help Scoutのドキュメントによると、カスタムフィールドはPlusとProプランで利用できます。料金ページ上ではPlusは45ドル/ユーザー/月です。他の料金帯についてはHelp Scoutの料金の記事をご覧ください。
Help Scout Beaconのコンタクトフォームをプレフィルするにはどうすればいいですか?
Beacon('prefill', {...})をname、email、subject、text、fieldsとともに呼び出します。カスタムフィールドはフィールドIDで一致し、ドロップダウンにはオプションIDも必要です。プレフィルされた値はメッセージ送信後に消えます。開発者向けの詳細はHelp Scout APIのガイドをご覧ください。
BeaconのカスタムフィールドはHelp Scoutの会話に表示されますか?
はい。訪問者の回答は会話のサイドバーに表示されるのと同じカスタムフィールドに保存され、workflowはそれに基づいてタグ付け、割り当て、移動ができます。フィールドは1つのInboxに属するため、会話を移動するとそのデータは失われます。並べ替えた後の対応についてはチケットトリアージをご覧ください。
Beaconのidentifyとprefillの違いは何ですか?
identifyは顧客プロファイルを作成・更新し、名前とメールのフィールドを非表示にします。一方prefillはフォームフィールドを埋めますが、それらは表示され編集可能なままです。session-dataはその会話だけにメモを追加します。Zendeskのプレチャットフォームも似た仕組みです。
eeselはBeaconフォームからHelp Scoutのカスタムフィールドを読み取ったり設定したりできますか?
eeselが文書化しているHelp Scoutのアクションは、返信の下書きと送信、内部メモ、タグ、ステータス・担当者・Inbox・件名の更新を含みますが、カスタムフィールドは含みません。Help Scoutのworkflowにドロップダウンをタグへ変換させ、eeselにそのタグで動かせてください。Help Scoutの連携とHelp Scout向けベストAIのまとめもご覧ください。
Beaconのカスタムフィールドがフォームに表示されないのはなぜですか?
そのフィールドが接続されたInboxに存在すること、Beaconの設定でShow Custom Fieldsにチェックを入れたこと、プランにカスタムフィールドが含まれていることを確認してください。プレフィルされたカスタムフィールドはshowPrefilledCustomFieldsがtrueでない限り非表示のままです。設定のAI面についてはHelp Scout AIの記事をご覧ください。

Share this article