HubSpotカスタム項目の作成手順

概要

競合アノテーション、勝因・失注理由、プロジェクト割り当てをCRMへ書き戻すために、SteveはHubSpotにいくつかのカスタム取引プロパティを必要とします。このページでそれを作成します。

方法は2つあり、ページ上でどちらも選べます — Steveに作成させるか、HubSpotで手動作成して後からSteveに指定するかです。

対象者: 📣 PMM／管理者。

場所: Steve → HubSpot → Field Setup Instructions（app.hiresteve.ai/hubspot/instruction）。ページタイトルは HubSpot Field Setup Instructions — Learn how to create the required custom fields for Steve integration です。

先に接続が必要です。 HubSpotが未接続の場合は、設定 → HubSpot から接続してください。

6つのプロパティ

これらは 既定値であり、必須の名前ではありません。ポータルに closed_lost_reason や competitor などの同等プロパティが既にあるなら、作成をスキップして フィールドマッピング で既存のものを指定してください。

さらに2つは作成済みです。 steve_connected_calls と steve_connected_battle_cards は認可時に自動作成されており、このページには表示されません。もし存在しない場合は、HubSpotダッシュボードに琥珀色の 「New Steve fields need to be created」 バナーと Create missing fields ボタンが表示されます。

方法A — Steveに作成させる

Automated Field Creation カードが作業を行います: 「Let Steve create the required fields automatically in your HubSpot account's deal activity group.」

1. Automated Field Creation までスクロールします。
2. 青いパネルに、実行内容が示されています。
   • プロパティは Deal Activity グループに作成される
   • すべて 取引レコード上に表示される
   • フォームとワークフローで利用可能 になる
   • 入力しやすい 単一行テキスト 型
3. 各項目について、作成前に2つの入力を編集できます。
   • Field Name — HubSpot APIで使う内部名（例: steve_channels）
   • Display Label — HubSpotの画面に表示されるラベル（例: Steve Channels）
4. ポータルの命名規則に合わせる必要がなければ、既定値のままで構いません。
5. Create Fields in HubSpot をクリックします。実行中は Creating Fields… と表示されます。
6. トーストが結果を知らせます: 「Successfully created N custom field(s)」、失敗があれば 「Failed to create N field(s)」。
7. 緑の Fields Created Successfully! アラートに、作成されたプロパティが一覧表示されます。

不足しているものだけが作成されます。 ページはHubSpotの取引プロパティを実際に確認し、まだ存在しない項目だけを一覧表示します。すべて揃っている場合は、両方のカードに All Fields Ready! と表示されます。

方法B — HubSpotで手動作成する

Manual Field Creation カードに手順が示されています: 「Follow these steps to manually create custom fields in HubSpot.」

1. HubSpotアカウントにログインし、設定（Settings） へ移動します。
2. プロパティ → 取引プロパティ（Properties → Deal Properties） を開きます。
3. 項目ごとに プロパティを作成（Create property） をクリックします。
4. ページに表示されている内部名とラベルをそのまま使用します。
5. フィールドタイプを 単一行テキスト（Single-line text） に設定します。
6. 取引アクティビティ（Deal activity） プロパティグループに割り当てます。
7. 表示のために 取引レコードに表示（Show on deal records） を有効にします。

カードには、ポータルにまだ存在しない項目が、内部名のコードチップ・表示ラベル・説明つきで一覧表示されます。Open HubSpot Settings ボタンから app.hubspot.com/settings を新しいタブで開けます。

キャプション: Manual Field Creation — 番号付きの手順と、HubSpotで使う正確な名前。

HubSpotでの作業が終わったらこのページに戻ると、不足項目の一覧が更新されます。作成したはずの項目がまだ表示される場合は、フィールドマッピング ページで Refresh Properties をクリックしてください。HubSpotが新しいプロパティをAPIに公開するまで少し時間がかかることがあります。

どちらを選ぶべきか

両方を併用しても構いません — 一部を手動で作り、残りをSteveに任せることもできます。

確認方法

HubSpot側: 設定 → プロパティ → 取引プロパティ を開き、グループ 取引アクティビティ で絞り込んでプロパティがあることを確認します。

Steve側: ページに All Fields Ready! — All required fields already exist in your HubSpot account. No additional field creation is needed. と表示されます。

次のステップ

ページ下部の Proceed to Field Mapping をクリックするか、以下へ進んでください。

• フィールドマッピングとプロパティ選択 — Steveの各項目とHubSpotプロパティを対応付けて保存する。
• 取引テーブル — マッピングした項目でできるようになること。
• トラブルシューティング — 作成に失敗した場合。