Salesforceで電子契約の送付・締結状況を契約に戻す連携

こんなことで困っていませんか

• 電子契約サービスで契約書を送ったあと、送付の状況を契約レコードに手で入力している。[4][1]
• 締結が済んだのに、Salesforce の契約状況が古いままになっている。[4][2]
• 締結済みの契約書を電子契約サービスから取り出し、Salesforce に添付し直している。[1][5]
• いつ、誰が状況を変えたのかを、Salesforce 上でさかのぼって確かめられない。[16]

なぜ起きるのか

電子契約サービスと Salesforce は別のシステムです。相手のサービスで署名が進んでも、つなぐ設定がなければ Salesforce の項目は変わりません。[6][11]

• 標準の契約オブジェクトの [契約状況] には、標準では [ドラフト]、[承認プロセス中]、[有効] の 3 つの値しかありません。送付や署名の状況を残すには、選択リスト値か項目を用意します。[4]
• Salesforce から外部のサービスに問い合わせるには、接続先と認証の設定が要ります。Salesforce では、これを指定ログイン情報で定義します。[10][6]
• 外部のサービスから Salesforce に書き込むには、Salesforce の API を呼び出すための認証と、連携を実行するユーザーが要ります。[11][13]

直し方の選択肢

状況を Salesforce に戻す方法は、大きく三つに分かれます。相手のサービスの API で何ができるかを見て選びます。[5][6][11]

• 既製の仕組みを使う：Salesforce Contracts は DocuSign と統合されています。[エンベロープ状況の更新] で照会し、契約を [署名済み] などに移します。ほかに、AppExchange の管理パッケージを組織にインストールして使う形もあります。[5][2][1][17]
• Salesforce から定期的に問い合わせる：スケジュールトリガーフローから HTTP コールアウトで相手の API に問い合わせ、結果を項目に書き込みます。[8][6][9]
• 電子契約サービスから Salesforce に書き込む：相手のサービス側から Salesforce の REST API を呼び、契約レコードを更新します。外部 ID 項目を使うと、相手のサービスの ID で更新するレコードを特定できます。[15][11]
• 書き込む方式の認証には、外部クライアントアプリケーションと OAuth 2.0 クライアントログイン情報フローを使えます。2026年10月時点のリリースノートでは、新しい連携には外部クライアントアプリケーションが勧められています。[11][12][14]

作業の流れ

• 電子契約サービスのどの状況（送付、署名済み、拒否など）を、Salesforce のどの項目に残すかを決めます。標準の契約なら、[オブジェクトマネージャー] の [契約] で [Status (状況)] の選択リスト値を確かめます。[4]
• 相手のサービスの ID を保存する項目を契約に用意します。書き込む方式では、この項目を外部 ID として使います。[15]
• 連携専用のユーザーを作ります。ヘルプでは、連携ごとに 1 人を用意する形が勧められています。Salesforce インテグレーションユーザーライセンスを使うと、API 限定のアクセスに絞れます。[13]
• 認証を設定します。問い合わせる方式では [設定] の [指定ログイン情報] を使います。書き込む方式では [外部クライアントアプリケーションマネージャー] で外部クライアントアプリケーションを開き、[クライアントログイン情報フローを有効化] を選びます。[6][10][12]
• 問い合わせる方式では、スケジュールトリガーフローに HTTP コールアウトのアクションを置き、応答の状況を項目に書き込みます。エラーは障害パスで扱います。[8][6][7]
• 状況の変化を後から追えるように、状況の項目で項目履歴管理を有効にします。[16]

気をつけること

• 問い合わせる方式には、間隔の制約があります。Salesforce Contracts と DocuSign の例では、Salesforce の画面からスケジュールできるのは 1 時間ごとで、DocuSign の API にも 15 分以上の間隔という制限があります。[3]
• スケジュールトリガーフローが待機要素なしでコールアウトできるのは、レコードのバッチを処理し、API バージョン 63.0 以降で動く場合です。条件を満たさないときは、先に待機要素を置きます。[9]
• スケジュールトリガーフローには、24 時間あたりのインタビュー数に上限があります。25 万件か、ユーザーライセンス数に 200 を掛けた数の大きいほうです。[9]
• クライアントログイン情報フローでは、コンシューマー鍵とコンシューマーの秘密にアクセスできるユーザーやアプリケーションがアクセストークンを取得できます。秘密は定期的に変え、漏れたときは直ちに変えます。[11][12]
• 項目履歴管理は、有効にした日時より前の変更を記録しません。また、フローや Apex トリガーが、実行中のユーザーに編集権限のないオブジェクトを変えた場合、その変更は履歴に残りません。[16]
• Salesforce Contracts の状況の値を使う場合、ContractManagement ライセンスで追加される既定の値の名前は変えません。オブジェクト状態値との対応付けが壊れるためです。[4]