# Salesforce・HubSpotとつなぐ (/docs/external-crm)

<AppLink path="/crm-sync" label="Salesforce・HubSpot連携を開く" />

**始める前に:** 既存CRMで連携を許可できるアカウントと、Sotto側の管理者を確認します。連携する項目と、値が食い違ったときに優先するCRMを決めておきます。

## 接続と取り込み [#接続と取り込み]

「Salesforce / HubSpot 連携」画面は、企業・担当者・商談を、既存のCRMと同期できます。
外部CRMの更新は、書き戻し設定と承認した変更の内容に従います。接続カードの下の「承認した変更を HubSpot / Salesforce へ反映する」がオンだと、Sotto で承認した変更だけを接続している CRM へ書き込みます。オフにすると、承認しても書き込まず、変更は Sotto の中にだけ残ります。変えられるのは管理者だけなので、開始前に管理者と確認してください。

1. プロバイダのカードで「HubSpot を接続」（または Salesforce）を押し、相手側の認可画面で許可します。
2. 戻ってきたら「HubSpotから取り込む」を押します。反映前に差分をプレビューで確認できます。
3. 画面上部の「承認待ち / 名寄せが必要 / 反映済み」と、「接続状況」（接続・最終書き戻し）で状態を見ます。

### 書き戻し提案 [#書き戻し提案]

sotto 側で承認した更新は「書き戻し提案」カードになります。「変更前 → 変更後」「信頼度」「理由」を読み、「HubSpotへ反映」を押すと相手側に反映されます。
「書き戻し履歴」に反映済み・見送り・失敗が並び、失敗したものは再試行できます。

### 名寄せ [#名寄せ]

相手側の既存レコードとどれが同じか曖昧なときは「既存レコードに紐づけますか？（紐づけない場合は新規作成）」と聞かれます。候補から選ぶか、紐づけずに新規作成します。

### 運用ルール [#運用ルール]

取り込みと書き戻しの向きを確認してください。「参照のみ / CRM優先 / Sotto優先 / 双方向」の設定や項目の対応づけにより、反映する先が変わります。

受信箱で承認したときに自動で書き戻された場合は「〜 にも自動で書き戻しました」、失敗した場合は「〜 への書き戻しに失敗しました（CRM共存モードで再試行できます）」と表示されます。

過去のデータをまとめて移す「CRM移行センター」は管理者向けです。[管理者向け: 設定・移行・セキュリティ](/docs/admin)を参照してください。

## 同期で止まったとき [#同期で止まったとき]

「同期履歴・エラー」で失敗した対象と理由を確認します。再試行のボタンがある場合だけ再実行し、権限や項目の対応の修正を求められた場合は先に設定を直します。再試行する前に、外部CRMへ反映済みかどうかも確認してください。

解決しないときは[問い合わせに必要な情報](/docs/support)を添えて連絡してください。