> ## 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.
# eセールスマネージャー
eセールスマネージャー連携では、eセールスマネージャー Remix の顧客・案件・担当者を Stockwork に取り込み、商談ログの AI 要約を eセールスマネージャー側の活動履歴として登録できます。
Stockwork 上で商談内容を整理しながら、eセールスマネージャー側にも営業活動の履歴を残したい場合に利用します。
## 始める前に
* Stockwork 側で接続設定を行うには **管理者** ロールが必要です。
* eセールスマネージャー側では次の準備物を用意します。
* REST API を利用できる契約プラン
* 連携用の **APIベースURL**
* 連携用の **APIトークン**
* API 呼び出し用アカウントに、対象の顧客・案件・担当者・活動履歴を参照および更新できる権限
* eセールスマネージャーから取り込んだ項目を Stockwork 側で表示・編集するには、必要なプロパティを Stockwork に登録しておきます。
## eセールスマネージャーと接続する
### 1. APIベースURLを用意する
Stockwork には、eセールスマネージャー Remix の REST API に接続するための **APIベースURL** が必要です。
1. eセールスマネージャーにログインします。
2. ブラウザのURLを確認し、`/esales-pc#` より前のURLをコピーします。
3. コピーしたURLの末尾に `/rest/v1` を付けます。
例：
| 確認するURL | Stockworkに入力するAPIベースURL |
| ------------------------------------------------------ | --------------------------------------------------- |
| `https://[サブドメイン].softbrain.co.jp/[テナントID]/esales-pc#` | `https://[サブドメイン].softbrain.co.jp/[テナントID]/rest/v1` |
### 2. APIトークンを発行する
1. eセールスマネージャーの管理画面で、**システムの設定 > 外部システムとの連携** を開きます。
2. **その他** タブをクリックします。
3. **eセールスマネージャーAPIトークン設定** で、必要に応じて備考欄に `Stockwork連携用` などの用途を入力します。
4. **発行** をクリックします。
5. 発行された **登録APIトークン** をコピーします。
6. 必要に応じて **設定完了** をクリックします。
7. API 呼び出し用アカウントに、同期対象の顧客・案件・担当者・活動履歴を参照および更新できる権限があることを確認します。
APIトークンは Stockwork から eセールスマネージャーAPIを呼び出すための認証情報です。共有範囲を限定し、不要になったトークンはeセールスマネージャー側で削除してください。
### 3. Stockwork に接続する
1. Stockwork の **設定 > 組織設定 > 外部連携 > eセールスマネージャー** を開きます。
2. **APIベースURL** に、用意したAPIベースURLを入力します。
3. **APIトークン** に、eセールスマネージャーで発行した登録APIトークンを入力し、**保存** をクリックします。
4. **接続テスト** をクリックし、eセールスマネージャーへの疎通を確認します。成功すると接続ステータスが **接続済み** に切り替わります。
5. 自動同期を利用する場合は、**自動同期** をオンにします。
6. **活動履歴 デフォルト設定** で、活動履歴の **本文書込み先カラム(デフォルト)** を設定します。未設定時の初期値は **詳細内容 (デフォルト)** です。eセールスマネージャー側で活動履歴用の書込み先項目を設定している場合は、その項目名を選択し、**保存** をクリックします。
7. eセールスマネージャーの社員を Stockwork のユーザーに紐づけたい場合は、ユーザー突合を設定します。
ユーザー突合を設定すると、eセールスマネージャーの社員情報をもとに Stockwork 側の担当者や活動履歴の報告者を紐づけやすくなります。メールアドレスなどで自動突合した後、必要な行だけ手動で調整できます。
## 同期の仕組み
eセールスマネージャー連携では、同期の対象を大きく3つに分けて考えます。
| eセールスマネージャー | Stockwork | 方向 |
| ----------- | --------- | ---------------------------------------- |
| 顧客 | 会社 | eセールスマネージャー → Stockwork（プロパティごとに書き戻し設定可） |
| 案件 | 取引 | eセールスマネージャー → Stockwork（プロパティごとに書き戻し設定可） |
| 担当者 | コンタクト | eセールスマネージャー → Stockwork（プロパティごとに書き戻し設定可） |
| 活動履歴 | 商談ログの登録先 | Stockwork → eセールスマネージャー |
### 1. レコード取り込み（プル型）
eセールスマネージャー上の顧客・案件・担当者を Stockwork に取り込み、Stockwork 側にも対応するレコードを作成します。eセールスマネージャーを顧客・案件データの管理元として使い、Stockwork では商談音声、商談ログ、AI 要約と紐づけて扱います。
| eセールスマネージャー | Stockwork | 主な用途 |
| ----------- | --------- | --------------------- |
| 顧客 | 会社 | 顧客企業の基本情報を参照します |
| 案件 | 取引 | 商談ログや商談音声の紐付け先として使います |
| 担当者 | コンタクト | 顧客側の担当者情報として参照します |
* 自動同期は 3 時間ごと（日本時間の 1 時 30 分・4 時 30 分・7 時 30 分…と 3 時間おき）に実行されます。
* 手動同期は **差分同期（推奨）** と **完全同期** の 2 種類から選べます。通常は差分同期を利用してください。
* 取り込まれた顧客情報は会社詳細、案件情報は取引詳細で確認できます。
### 2. プロパティ連携
案件フェーズ、金額、確度、顧客属性など、eセールスマネージャー側の項目を Stockwork に取り込みます。Stockwork 側で表示・編集するには、対象の eセールスマネージャー項目を Stockwork の [プロパティ](/guide/crm/properties) に登録します。
初回設定では、Stockwork の各プロパティと eセールスマネージャー側の項目を、1項目ずつ手動で紐づける必要があります。**設定 > 組織設定 > プロパティ** で対象のプロパティを編集し、**eセールスマネージャーへ同期する** をオンにして、対象に応じた項目を選択します。紐づけていないプロパティは同期されません。
| Stockwork のプロパティ | 選択する項目 |
| ---------------- | --------------- |
| 会社 | **eSM 顧客プロパティ** |
| 取引 | **案件プロパティ** |
| コンタクト | **eSM 名刺プロパティ** |
プロパティ連携には、読み取り専用と書き込み可能の2種類があります。
| 種類 | Stockworkでの扱い | 使い分け |
| ------ | ---------------------------------------- | ----------------------------------------- |
| 読み取り専用 | eセールスマネージャーの値を表示します。Stockwork 側では編集できません | eセールスマネージャー側の値を正として参照したい項目に向いています |
| 書き込み可能 | Stockwork 側で編集した値を eセールスマネージャー側にも反映します | ステージや次回アクションなど、Stockwork 側で更新したい項目に向いています |
eセールスマネージャー連携でプロパティ連携できる対象は、会社・取引・コンタクトです。ただし、商品・社員・部署に由来する項目は読み取り専用に固定され、書き込み可能を選択できません。
書き込み可能にするには、eセールスマネージャー側で対象カラムが更新可能であり、API 呼び出し用アカウントに更新権限が必要です。権限が不足している場合、接続テストは成功してもプロパティの書き戻しに失敗することがあります。
### 3. 活動の記録
Stockwork の商談ログを eセールスマネージャーの活動履歴として、eセールスマネージャーの案件に紐づけて登録できます。商談後にSFAへ議事録や要約を転記する作業を機械化したい場合に使います。
| Stockwork | eセールスマネージャー | 内容 |
| --------- | ----------- | ------------------------- |
| 商談ログ | 活動履歴 | 商談ログのAI要約を案件の活動履歴として登録します |
商談ログ詳細で eセールスマネージャー ロゴ付きの **連携** をクリックすると、AI 要約を eセールスマネージャーの活動履歴として案件に登録できます。
登録方法は、手動登録と自動登録の2種類があります。
| 登録方法 | 操作 | 向いている場面 |
| ---- | ----------------------------------------------------- | --------------------------------------- |
| 手動登録 | 商談ログ詳細で eセールスマネージャー ロゴ付きの **連携** をクリックします | 登録前に要約内容や活動設定を確認してからeセールスマネージャーへ反映したい場合 |
| 自動登録 | [ワークフロー](/guide/workflows) の **SFA 活動登録** アクションを設定します | AI要約完了後のSFA登録を毎回自動化したい場合 |
手動登録では、ダイアログで次の項目を設定します。
| 項目 | 内容 |
| --------- | --------------------------- |
| 含める分析結果 | eセールスマネージャーに登録するAI要約を選びます |
| 報告者 | eセールスマネージャーの社員から選択します |
| 業務タイプ | eセールスマネージャー側のマスターデータから選択します |
| 進捗状況 | eセールスマネージャー側のマスターデータから選択します |
| 活動内容 | eセールスマネージャー側のマスターデータから選択します |
| 本文書込み先カラム | 活動履歴本文を書き込むテキストカラムを選びます |
手動登録は、担当者が内容を確認したうえでeセールスマネージャーへ登録する運用です。自動登録は、ワークフロー条件に一致したログを自動でeセールスマネージャーへ登録する運用です。商談後のSFA登録を機械化したい場合は、自動登録を設定します。
eセールスマネージャーへの活動履歴登録は、商談ログが eセールスマネージャー連携済みの取引に紐づいている場合に利用できます。コールログからの登録には対応していません。
## トラブルシューティング
| 症状 | 主な原因と対処 |
| --------------------- | ---------------------------------------------------------------------------- |
| 接続テストが失敗する | **APIベースURL** のテナント部分、**APIトークン** の誤り、または API 利用権限の不足を確認してください |
| 接続テストは成功するのに同期でエラーになる | API 呼び出し用アカウントに、顧客・案件・担当者・項目定義を参照する権限があるか確認してください |
| 特定の案件だけ同期されない | 差分同期の対象外になっている可能性があります。**完全同期** を実行して取り込み直します |
| 特定のプロパティだけ書き戻せない | 対象カラムが更新可能か、Stockwork 側のプロパティが書き込み可能になっているかを確認してください |
| 商談ログの登録に失敗する | 商談ログに紐づく取引が eセールスマネージャー連携済みか、AI要約が完了しているかを確認してください |
| 活動履歴登録の報告者を選べない | ユーザー突合、または eセールスマネージャー側の社員情報が取得できているかを確認してください |
| 活動履歴の本文が想定したカラムに入らない | **活動履歴 デフォルト設定** の **本文書込み先カラム(デフォルト)**、または登録ダイアログ内の **本文書込み先カラム** を確認してください |
## 関連ページ
* [SFA連携](/guide/initial-setup/sfa-integration)
* [会社](/guide/crm/accounts)
* [取引](/guide/crm/deals)
* [コンタクト](/guide/crm/contacts)
* [プロパティ](/guide/crm/properties)
* [ワークフロー](/guide/workflows)