Salesforce 接続の設定
ソクミツと Salesforce を安全に接続する手順です。組織の管理者権限と、Salesforce 側のシステム管理者権限が必要です。
接続の画面は「管理 → データ連携 → Salesforce」です (管理のメニューは管理者にだけ表示されます)。
事前準備
- Salesforce 連携が使えるプランのご契約 (ご契約のプランによっては使えません。プラン一覧と料金 を見てください)
- Salesforce 側のシステム管理者権限
- Salesforce に外部クライアントアプリケーションを作れること(システム管理者権限)
- 送り先にするオブジェクト・項目(標準・カスタムのどちらでも)
初回接続はサポートが伴走します。まず お問い合わせ からご連絡ください。
接続に使う Salesforce ユーザー(重要)
接続は 組織に 1 本 です。管理者が 1 人接続すれば、他のメンバーが見積や案件を保存したときも同じ接続で Salesforce に送られます。メンバーごとに接続する必要はありません。
その代わり、Salesforce への書き込みはすべて 接続時に承認した Salesforce ユーザー として行われます。
- Salesforce 側でレコードの作成者・所有者は、そのユーザーになります
- そのユーザーが 凍結・無効化・パスワード変更・権限縮小 されると、組織全体の連携が止まります
- 退職などで個人アカウントが無効化されると、気づかないうちに同期が止まることがあります
そのため、個人のアカウントではなく 連携専用のユーザー(Integration User) で接続することをおすすめします。
- プロファイルまたは権限セットで、ソクミツが読み書きするオブジェクト・項目に権限を付ける
- ライセンスは「Salesforce Integration」ライセンス(API 専用)でも構いません。API アクセスと対象オブジェクトの権限があれば動きます
- パスワードの定期変更の対象から外すか、変更したら再接続する運用にする
接続後、「Salesforce 連携」画面の「接続設定」を開くと、「承認ユーザー」に誰で接続しているかが表示されます。画面を開いたときに接続先へ問い合わせ、承認ユーザーが凍結・無効化されていれば「接続に問題があります」と表示されます。
接続手順
1. Salesforce 側の準備
Salesforce に、ソクミツが接続に使う 外部クライアントアプリケーション を作り、その コンシューマー鍵 と 秘密 をソクミツに登録します。作り方とコールバック URL は「Salesforce 連携」画面に手順付きで表示されます。本番と Sandbox は別々に登録します。
2. ソクミツ側で接続開始
「管理 → データ連携 → Salesforce」を開きます。画面は 3 つのステップに分かれていて、ひとつ終わると次が表示されます。
- 「Salesforce 連携を有効にする」のスイッチをオンにする (データの送信・取り込みを始めるスイッチです。先に認証情報の登録・接続・項目マッピングを済ませ、最後にオンにしても構いません)
- 「Salesforce 側アプリの認証情報を登録する」で、コンシューマー鍵と秘密を入れて「認証情報を登録」(Sandbox のときは「Sandbox 環境として登録・接続する」をオン)
- 「Salesforce に接続」ボタンをクリック
3. Salesforce 認証
ブラウザが Salesforce のログイン画面に切り替わります。接続に使う Salesforce ユーザー (連携専用ユーザーを推奨) でログインして承認します。
4. 権限確認
ソクミツがアクセスする項目が表示されます。
- API によるデータの読み書き(承認ユーザーの権限の範囲で)
- ログインしていない間も接続を続けるための更新トークン
内容を確認して「許可」をクリック。
5. 接続完了
ソクミツに戻り、「接続中」と表示されていれば成功です。
6. 送り先の設定
「Salesforce 連携」画面の「項目マッピング」の「設定を開く」で、顧客・案件・見積をそれぞれ Salesforce のどのオブジェクト・項目へ送るかを決めます。送り先を設定するまで、ソクミツから Salesforce へは何も送られません。 設定のしかたは Salesforce の項目マッピングと同期ジョブ を見てください。
既存データの扱い
- ソクミツ → Salesforce: 連携を始める前からある顧客・案件・見積は、「管理 → データ連携 → 同期ジョブ」の「同期を開始」(初回の一括同期) でまとめて送れます
- Salesforce → ソクミツ: Salesforce の顧客のレコードは、顧客の画面の「Salesforce から取り込み」で検索して 1 件ずつ取り込めます
接続の解除
連携を止めたい場合は、「Salesforce 連携」画面の「詳細設定」を開き、「接続を解除」を押します。確認のため「DISCONNECT」と入力してから「解除する」を押します。解除後は Salesforce への送信が止まりますが、すでに送ったレコードは Salesforce に、取り込んだデータはソクミツに残ります。
一時的に止めたいだけなら、「接続設定」を開き、「Salesforce 連携を有効にする」をオフにする方法もあります。止めている間も、項目マッピングなどの設定は変更できます (テスト送信はできません)。止めている間に保存した変更は、オンに戻しても自動では送られません。送るには、そのデータを保存し直すか、初回の一括同期を使ってください。
トラブル
接続できない
- Salesforce 側で必要な設定が完了しているか確認
- IP 制限がある場合はソクミツのアクセス元 IP を許可リストに追加
- サポートまでお問い合わせください
認証情報の期限切れ
長期間ご利用がない場合、Salesforce 側で接続情報が無効になることがあります。「接続設定」を開き、「Salesforce で再認証」から再度認証してください。
「接続に問題があります」と表示される
接続時に承認した Salesforce ユーザーが凍結・無効化されているか、認証が失効しています。Salesforce 側でそのユーザーの状態を確認し、解除できない場合は別のユーザー(連携専用ユーザーを推奨)で「Salesforce で再認証」してください。接続が切れていた間の変更は、同じ Salesforce 組織につなぎ直すと送られます。送れなかったものは 同期ジョブ で確かめ、再試行できます。