始める前に
- Stockwork 側で接続設定を行うには 管理者 ロールが必要です。
- Salesforce 側では次の準備物を用意します。
- Salesforce 組織の システム管理者 権限を持つアカウント
- 連携用の 外部クライアントアプリケーション
- コンシューマ鍵（Client ID）
- コンシューマ秘密鍵（Client Secret）
- Salesforce から取り込んだ項目を Stockwork 側で表示・編集するには、必要なプロパティを Stockwork に登録しておきます。
Salesforce と接続する
1. Stockwork でコールバック URL を確認する
- Stockwork の 設定 > 組織設定 > 外部連携 > Salesforce を開きます。
- 接続設定 に表示される コールバックURL（Salesforce Connected Appの設定で使用） をコピーします。
2. Salesforce で外部クライアントアプリケーションを作成する
- Salesforce の 設定 を開きます。
- 左メニューの アプリケーション を開きます。
- 外部クライアントアプリケーション > 外部クライアントアプリケーションマネージャー を開きます。
- 作成 をクリックします。
- 外部クライアントアプリケーション名、API 参照名、取引先責任者メールなど、必須項目を入力します。
- OAuthを有効化 にチェックを入れます。
- Stockwork でコピーした URL を コールバック URL に貼り付けます。
- 利用可能な OAuth 範囲 から、少なくとも次の2つを 選択した OAuth 範囲 に追加します。
- 追加した OAuth 範囲を確認し、作成 をクリックします。
- 作成後、発行された コンシューマー鍵 と コンシューマーの秘密 の コピー をクリックし、Stockwork に入力する値を控えます。
3. Stockwork に接続情報を登録する
- Stockwork の 設定 > 組織設定 > 外部連携 > Salesforce に戻ります。
- コンシューマ鍵 (Client ID) に、Salesforce でコピーしたコンシューマー鍵を入力します。
- コンシューマ秘密鍵 (Client Secret) に、Salesforce でコピーしたコンシューマーの秘密を入力します。
- 保存 をクリックします。
- Salesforceと連携する をクリックします。
- Salesforce の認証画面でログインし、許可 をクリックします。
- Stockwork に戻り、接続状態が 接続済み になっていることを確認します。
- 接続テスト をクリックし、認証情報が有効であることを確認します。
4. 同期設定とユーザー突合
- 自動同期を利用する場合は、自動同期 の 全取引（新規含む）の情報を自動更新する をオンにします。
- 必要に応じて、手動同期 で 差分同期（推奨） または 完全同期 を選び、手動同期を実行 をクリックします。
- Salesforce の担当者を Stockwork のユーザーに紐づけたい場合は、ユーザー突合を設定します。
5. カスタムオブジェクトを利用する場合
標準オブジェクトをそのまま使う場合、この設定は不要です。Salesforce でカスタムオブジェクトを商談・会社・コンタクトとして使っている場合のみ、カスタムオブジェクト設定 を開いて設定します。 Salesforce 側で作成したカスタムオブジェクトの詳細画面を開きます。 詳細画面で API 参照名 を確認します。
同期の仕組み
Salesforce 連携では、同期の対象を大きく3つに分けて考えます。1. レコード取り込み（プル型）
Salesforce 上の取引先・商談・コンタクトを Stockwork に取り込み、Stockwork 側にも同じレコードを作成します。Salesforce を顧客・案件データの管理元として使い、Stockwork では商談音声、商談ログ、AI 要約と紐づけて扱います。
Stockwork 側：Salesforceから取り込んだ会社レコード
Stockwork 側：Salesforceから取り込んだ取引レコード
Salesforce 側：同期元の取引先レコード
- 自動同期は 3 時間ごと（日本時間の 0 時・3 時・6 時・9 時・12 時・15 時・18 時・21 時）に実行されます。
- 手動同期は 差分同期（推奨） と 完全同期 の 2 種類から選べます。通常は差分同期を利用してください。
- 取引詳細・会社詳細・コンタクト詳細の Salesforce 情報カードから、個別レコードを再同期できます。
2. プロパティ連携
金額、ステージ、確度、独自項目など、Salesforce 側の項目を Stockwork に取り込みます。Stockwork 側で表示・編集するには、対象の Salesforce 項目を Stockwork の プロパティ に登録します。
Stockwork 側：プロパティ一覧でSalesforce連携対象を確認します
たとえば、金額はSalesforce側の値を参照できれば十分な場合が多いため、読み取り専用で運用できます。一方、ステージは商談ログやAI提案をもとにStockwork側で更新することが多いため、書き込み可能にしておくとSalesforce側の更新まで一連で行えます。
3. 活動の記録
Stockwork の商談ログを Salesforce の Task または Event として、Salesforce の商談に紐づけて登録できます。商談後にSFAへ議事録や要約を転記する作業を機械化したい場合に使います。
Stockwork 側：商談ログ詳細でSalesforceロゴ付きの連携ボタンをクリックします
商談ログ詳細で Salesforce ロゴ付きの 連携 をクリックすると、AI 要約を Salesforce の活動として商談に登録できます。コールログ詳細で Salesforce 登録 をクリックすると、AI 要約を Salesforce の Task としてコンタクトに登録できます。
登録方法は、手動登録と自動登録の2種類があります。
商談ログの手動登録では、次の活動タイプを選択できます。
ワークフローで指定できるのは 活動の記録 と 新規行動 です。商談後のSFA登録を機械化したい場合は、自動登録を設定します。