HubSpotのバトルカードリンク

概要

SteveでHubSpotの取引に競合をアノテーションすると、対応する バトルカード がHubSpotへそのまま公開されます — 取引プロパティとして、そして取引のアクティビティタイムライン上のノートとして。HubSpotで仕事をしている営業担当は、Steveを開かなくても普段の画面で競合情報を得られます。

すべてのリンクは取引ごとに固有で追跡可能なため、どの取引が実際にバトルカードの閲覧につながったかが分かります。

対象者: 🎯 HubSpotでリンクを読む営業担当 · 📣 設定と数値を見るPMM。

HubSpot上での見え方

取引の2箇所に表示されます。

ノートがあることで、サイドバーだけでなく取引のプレビューにもリンクが表示されます。

実行方法

1. 取引テーブル を開きます。
2. 取引に プロジェクトを割り当て ます。割り当てるまで競合セレクターは無効です — 「Assign a project first to annotate competitors.」
3. Competitors セルを開き、そのプロジェクトから競合を1つ以上選びます。
4. これだけです。トーストで 「Competitors updated successfully」 と表示され、HubSpotにリンクが現れます。

一括操作バーから競合をまとめて割り当てた場合も、選択したすべての取引で同じ同期が実行されます。

そのワンクリックの裏側

1. 取引のプロジェクト内で 各競合名を競合レコードに解決します。そのプロジェクトに属さない競合は無視されます。
2. 競合ごとに 取引固有の共有UUID を取得または作成します — 同じ競合でも取引が違えば別のリンクになります。
3. https://app.hiresteve.ai/shared/<uuid>/competitor 形式の公開URLを組み立てます。
4. 短縮リンクが構成されている環境ではURLを短縮します。短縮に失敗した場合はリンクを落とさず、フルURLにフォールバックします。
5. 競合名: URL の行を結合し、steve_connected_battle_cards 取引プロパティへ書き込みます。
6. 同じ内容で取引アクティビティタイムラインにノートを作成します。その取引にSteveのノートが既にある場合は、重複させずにその場で更新します。HubSpot側でノートが削除されていた場合は新しく作成します。

競合を解除したとき

取引からすべての競合を外す、またはプロジェクトの割り当てを解除すると、SteveはHubSpotタイムラインからバトルカードのノートを削除し、その参照をクリアします。プロパティはHubSpot側の履歴としてそのまま残します。

閲覧数の追跡

各リンクが取引固有のUUIDを持つため、閲覧はサーバー側で正確にその取引へ紐づけられます。URLに追跡用のクエリパラメータは含まれないので、誰かに削除される心配もありません。

取引テーブルの BC Views 列には、その取引のバトルカードリンクが開かれた回数が表示されます。99回を超えると 99+、ゼロの場合はダッシュです。Columns メニューから表示を切り替えられます。

Connected Battle Cards 列にはリンクそのものが、競合ごとに1つずつクリック可能な形で並びます。

前提条件

トラブルシューティング

次のステップ

• 取引テーブル — アノテーションを行う場所。
• 取引サジェスト — 競合をまずAIに提案させる。
• フィールドマッピング — 競合プロパティのマッピング。