> ## Documentation Index > Fetch the complete documentation index at: https://docs.stockwork.ai/llms.txt > Use this file to discover all available pages before exploring further. # HubSpot HubSpot 連携では、HubSpot の取引・会社・コンタクトを Stockwork に取り込み、商談ログやコールログの AI 要約を HubSpot 側の活動として登録できます。 Stockwork 上で商談内容を整理しながら、HubSpot 側にも顧客接点の履歴を残したい場合に利用します。 ## 始める前に * Stockwork 側で接続設定を行うには **管理者** ロールが必要です。 * HubSpot 側では次の準備物を用意します。 * **スーパー管理者** 権限を持つ HubSpot アカウント * 連携用の **サービスキー** と、そのアクセストークン * HubSpot から取り込んだ項目を Stockwork 側で表示・編集するには、必要なプロパティを Stockwork に登録しておきます。 ## HubSpot と接続する ### 1. HubSpot でサービスキーを作成する 1. HubSpot の右上にある **設定** を開きます。 2. 左メニューの **開発** で **キー** を開き、**サービスキー** を選択します。 HubSpot の設定からサービスキーを開く 3. **サービスキーを作成** をクリックします。 サービスキーを作成ボタン 4. **名前** に、Stockwork 連携用だと分かる名前を入力します。 5. **新しいスコープを追加** をクリックします。 サービスキー名を入力しスコープ追加を開く 6. 検索欄で必要なスコープを検索し、チェックを入れて **更新** をクリックします。 必要なスコープを検索して追加する 7. 以下のスコープをすべて追加します。 | スコープ | 用途 | | ------------------------------------------------------------------------------------- | ---------- | | `crm.objects.companies.read` / `crm.objects.companies.write` | 会社の読み書き | | `crm.objects.contacts.read` / `crm.objects.contacts.write` | コンタクトの読み書き | | `crm.objects.deals.read` / `crm.objects.deals.write` | 取引の読み書き | | `crm.objects.owners.read` | 担当者情報の取得 | | `crm.schemas.companies.read` / `crm.schemas.contacts.read` / `crm.schemas.deals.read` | プロパティ定義の取得 | 8. 追加したスコープを確認し、右上の **作成** をクリックします。 スコープを確認してサービスキーを作成する 9. 作成されたサービスキーの **コピー** をクリックし、アクセストークンを控えます。 サービスキーをコピーする `write` 系スコープが不足していると、接続テストは成功しても取引・会社・コンタクトへの書き戻しや Meeting / Call 登録が失敗します。上記のスコープをすべて追加してください。 ### 2. Stockwork に接続する 1. Stockwork の **設定 > 組織設定 > 外部連携 > HubSpot** を開きます。 2. **アクセストークン** を入力し、**保存** をクリックします。 HubSpot のアクセストークンを保存する 3. **接続テスト** をクリックし、HubSpot への疎通を確認します。成功すると接続ステータスが「接続済み」に切り替わります。 HubSpot の接続テストを実行する HubSpot の接続済みステータスを確認する 4. 自動同期を利用する場合は、**自動同期** をオンにします。 HubSpot の自動同期を設定する 5. HubSpot の担当者を Stockwork のユーザーに紐づけたい場合は、ユーザー突合を設定します。 HubSpot ユーザーと Stockwork ユーザーを対応づける ユーザー突合を設定すると、HubSpot の owner 情報をもとに Stockwork 側の担当者を自動で紐づけやすくなります。メールアドレスなどで自動突合した後、必要な行だけ手動で調整できます。 ## 同期の仕組み HubSpot 連携では、同期の対象を大きく3つに分けて考えます。 ### 1. レコード取り込み（プル型） HubSpot 上の取引・会社・コンタクトを Stockwork に取り込み、Stockwork 側にも同じレコードを作成します。HubSpot を顧客・案件データの管理元として使い、Stockwork では商談音声、商談ログ、AI 要約と紐づけて扱います。 HubSpotから取り込んだ会社レコードをStockworkで確認する画面 HubSpotから取り込んだ取引レコードをStockworkで確認する画面 HubSpot側の取引レコード画面 | HubSpot | Stockwork | 主な用途 | | ------- | --------- | ----------------------- | | 会社 | 会社 | 顧客企業の基本情報を参照します | | 取引 | 取引 | 商談ログや商談音声の紐付け先として使います | | コンタクト | コンタクト | コールログや担当者情報の紐付け先として使います | * 自動同期は 3 時間ごと（日本時間の 1 時・4 時・7 時・10 時・13 時・16 時・19 時・22 時）に実行されます。 * 手動同期は **差分同期**（前回同期以降の変更のみ）と **完全同期**（全件再取得）の 2 種類から選べます。通常は差分同期を利用してください。 * 取引・会社詳細ページの HubSpot 情報カードから、個別レコードを再同期できます。 ### 2. プロパティ連携 金額、ステージ、確度、独自項目など、HubSpot 側のプロパティを Stockwork に取り込みます。Stockwork 側で表示・編集するには、対象の HubSpot プロパティを Stockwork の [プロパティ](/guide/crm/properties) に登録します。 HubSpotと同期しているプロパティをStockworkのプロパティ一覧で確認する画面 HubSpotへ同期するプロパティの同期モードを選択する画面 プロパティ連携には、読み取り専用と書き込み可能の2種類があります。 | 種類 | Stockworkでの扱い | 使い分け | | ------ | ------------------------------------- | ----------------------------------- | | 読み取り専用 | HubSpot の値を表示します。Stockwork 側では編集できません | 金額など、HubSpot 側の値を正として参照したい項目に向いています | | 書き込み可能 | Stockwork 側で編集した値を HubSpot 側にも反映します | ステージなど、Stockwork 側で頻繁に更新する項目に向いています | たとえば、金額はHubSpot側の値を参照できれば十分な場合が多いため、読み取り専用で運用できます。一方、ステージは商談ログやAI提案をもとにStockwork側で更新することが多いため、書き込み可能にしておくとHubSpot側の更新まで一連で行えます。 書き込み可能にするには、HubSpot 側のサービスキーに `write` 系スコープが必要です。スコープが不足している場合、接続テストは成功してもプロパティの書き戻しに失敗することがあります。 ### 3. 活動の記録 Stockwork の商談ログを HubSpot の Meeting として、HubSpot の取引画面に紐づけて登録できます。商談後にSFAへ議事録や要約を転記する作業を機械化したい場合に使います。 商談ログ詳細画面でHubSpotロゴ付きの連携ボタンをクリックする画面 HubSpotミーティング登録ダイアログで登録内容を確認する画面 HubSpotの取引画面で登録されたアクティビティを確認する画面 | Stockwork | HubSpot | 内容 | | --------- | ------- | --------------------------- | | 商談ログ | Meeting | 商談ログのAI要約を取引の活動として登録します | | コールログ | Call | コールログのAI要約をコンタクトの活動として登録します | 商談ログ詳細で HubSpot ロゴ付きの **連携** をクリックすると、AI 要約を HubSpot の Meeting として取引に登録できます。コールログ詳細で HubSpot ロゴ付きの **連携** をクリックすると、AI 要約を HubSpot の Call としてコンタクトに登録できます。 登録方法は、手動登録と自動登録の2種類があります。 | 登録方法 | 操作 | 向いている場面 | | ---- | ----------------------------------------------------- | ------------------------------ | | 手動登録 | 商談ログ詳細またはコールログ詳細で HubSpot ロゴ付きの **連携** をクリックします | 登録前に要約内容を確認してからHubSpotへ反映したい場合 | | 自動登録 | [ワークフロー](/guide/workflows) の **SFA 活動登録** アクションを設定します | AI要約完了後のSFA登録を毎回自動化したい場合 | 手動登録は、担当者が内容を確認したうえでHubSpotへ登録する運用です。自動登録は、ワークフロー条件に一致したログを自動でHubSpotへ登録する運用です。商談後のSFA登録を機械化したい場合は、自動登録を設定します。 ## トラブルシューティング | 症状 | 主な原因と対処 | | ------------------------------- | ------------------------------------------------------------------------------------------ | | 接続テストで **401 Unauthorized** が返る | アクセストークンが誤っているか、無効化されています。HubSpot 側でトークンを再発行してください | | 接続テストは成功するのに同期でエラーになる | サービスキーのスコープ不足の可能性が高いです。上記のスコープがすべて有効か確認し、追加後は Stockwork でトークンを保存し直します | | 特定のプロパティだけ書き戻せない | 対象プロパティの `write` スコープ（例: `crm.objects.deals.write`）が付与されていない、または HubSpot 側で読み取り専用に設定されています | | 商談ログの登録に失敗する | 商談ログに紐づく取引が HubSpot 連携済みか、要約が完了しているかを確認してください | | コールログの登録に失敗する | コールログに紐づくコンタクトが HubSpot 連携済みか、要約が完了しているかを確認してください | | 一覧に取引が現れない | **完全同期** を一度実行してから、フィルターや表示条件を確認してください | ## 関連ページ * [取引](/guide/crm/deals) * [コンタクト](/guide/crm/contacts) * [プロパティ](/guide/crm/properties) * [ワークフロー](/guide/workflows)