> ## 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.

# SFA連携

SFA連携では、外部SFAの会社・取引・コンタクト情報をStockworkに取り込み、商談ログやコールログのAI要約を外部SFAへ活動として登録できます。

営業活動の記録をStockworkだけで完結させず、既存のSFAにも履歴を残したい場合に設定します。

## 始める前に

* Stockwork側で接続設定を行うには、**管理者** ロールが必要です。
* 連携先SFA側で、管理者権限またはAPI連携用の権限を持つアカウントを用意します。
* どのSFAを正しい顧客・案件データの管理元にするかを決めておきます。
* 会社・取引・コンタクトのどの項目をStockworkで使うかを確認しておきます。

<Warning>
  SFAから取り込んだ項目は、連携先の権限やプロパティ設定によって編集できない場合があります。Stockwork側で入力・更新したい項目は、事前にSFA側の権限と書き戻し可否を確認してください。
</Warning>

## 連携方法

### 1. レコード取り込み（プル型）

外部SFAに登録されている会社、取引、コンタクトなどのレコードをStockworkに取り込み、Stockwork側にも同じレコードを作成します。外部SFAを顧客・案件データの管理元として使い、Stockworkでは録音・録画、商談ログ、AI要約と紐づけて利用します。

| SFA側の情報       | Stockwork側の情報 | 主な用途                     |
| ------------- | ------------- | ------------------------ |
| 会社・顧客・取引先     | 会社            | 顧客企業の基本情報を参照します          |
| 取引・商談・案件      | 取引            | 商談ログや商談音声の紐付け先として使います    |
| コンタクト・担当者・リード | コンタクト         | 相手先担当者やコールログの紐付け先として使います |

### 2. プロパティ連携

金額、ステージ、確度、独自項目など、SFA側の項目をStockworkのプロパティとして扱います。SFA連携プロパティを設定すると、一覧、詳細、フィルタービュー、ダッシュボードなどで外部SFAの項目を確認できます。

プロパティ連携には、読み取り専用と書き込み可能の2種類があります。

| 種類     | Stockworkでの扱い                    | 使い分け                               |
| ------ | -------------------------------- | ---------------------------------- |
| 読み取り専用 | SFA側の値を表示します。Stockwork側では編集できません | 金額など、SFA側の値を正として参照したい項目に向いています     |
| 書き込み可能 | Stockwork側で編集した値をSFA側にも反映します     | ステージなど、Stockwork側で頻繁に更新する項目に向いています |

1つのプロパティを複数のSFAに同時連携することはできません。詳しい設定方法は [プロパティ](/guide/crm/properties) を確認してください。

### 3. 活動の記録

Stockworkで作成した商談ログやコールログのAI要約を、外部SFAの活動履歴として登録します。商談後にSFAへ議事録や要約を転記する作業を減らしたい場合に使います。

| Stockworkの画面 | 登録できる連携先                                  | 登録内容                |
| ------------ | ----------------------------------------- | ------------------- |
| 商談ログ         | Salesforce、HubSpot、eセールスマネージャー、HotProfile | 商談内容、AI要約、次回アクションなど |
| コールログ        | Salesforce、HubSpot                        | 通話内容、AI要約、対応履歴など    |

SFAへの活動登録ボタンは、対象のログに取引やコンタクトが紐づいていて、連携先SFAに登録できる状態のときに表示されます。ワークフローを設定すると、AI要約完了後のSFA活動登録を自動化できます。

## 連携先ごとの違い

<Tabs>
  <Tab title="Salesforce">
    | 項目                | 内容                              |
    | ----------------- | ------------------------------- |
    | Stockworkに取り込む情報  | 取引先、商談、コンタクト                    |
    | Stockworkから登録する情報 | 活動の記録、ToDo、行動                   |
    | 初期設定で用意するもの       | Connected App、コンシューマ鍵、コンシューマ秘密鍵 |
    | プロパティ連携の対象        | 会社、取引、コンタクト                     |

    [Salesforceの設定手順を見る](/guide/integrations/salesforce)
  </Tab>

  <Tab title="HubSpot">
    | 項目                | 内容                      |
    | ----------------- | ----------------------- |
    | Stockworkに取り込む情報  | 会社、取引、コンタクト             |
    | Stockworkから登録する情報 | Meeting、Call            |
    | 初期設定で用意するもの       | サービスキー、アクセストークン、必要なスコープ |
    | プロパティ連携の対象        | 会社、取引、コンタクト             |

    [HubSpotの設定手順を見る](/guide/integrations/hubspot)
  </Tab>

  <Tab title="eセールスマネージャー">
    | 項目                | 内容                |
    | ----------------- | ----------------- |
    | Stockworkに取り込む情報  | 顧客、案件、担当者         |
    | Stockworkから登録する情報 | 活動履歴              |
    | 初期設定で用意するもの       | APIベースURL、APIトークン |
    | プロパティ連携の対象        | 会社、取引             |

    [eセールスマネージャーの設定手順を見る](/guide/integrations/esales-manager)
  </Tab>

  <Tab title="HotProfile">
    | 項目                | 内容                     |
    | ----------------- | ---------------------- |
    | Stockworkに取り込む情報  | クライアント、案件、リード          |
    | Stockworkから登録する情報 | 報告（日報）                 |
    | 初期設定で用意するもの       | APIベースURL、顧客 ID、API キー |
    | プロパティ連携の対象        | 会社、取引、コンタクト            |

    [HotProfileの設定手順を見る](/guide/integrations/hotprofile)
  </Tab>
</Tabs>

<Tip>
  連携先ごとに、SFA側で使う用語とStockwork上の用語が異なります。会社、取引、コンタクトのどれに対応するかを確認してから設定すると、同期後の確認がしやすくなります。
</Tip>

## トラブルシューティング

| 状態              | 確認すること                                             |
| --------------- | -------------------------------------------------- |
| 接続テストに失敗する      | 認証情報、API利用権限、SFA側で発行したキーやスコープを確認します                |
| 同期してもデータが表示されない | 初回同期または完全同期を実行し、表示条件やフィルターを確認します                   |
| プロパティが表示されない    | Stockwork側で対象プロパティが登録されているか、SFA側の項目に参照権限があるかを確認します |
| 活動登録ボタンが表示されない  | ログに取引やコンタクトが紐づいているか、AI要約が完了しているかを確認します             |
| 活動登録に失敗する       | SFA側の書き込み権限、必須項目、担当者や報告者の紐付けを確認します                 |

## 関連ページ

* [Salesforce](/guide/integrations/salesforce)
* [HubSpot](/guide/integrations/hubspot)
* [eセールスマネージャー](/guide/integrations/esales-manager)
* [HotProfile](/guide/integrations/hotprofile)