Salesforce連携のAPI呼び出しと同期エラーの管理
更新日時 2025年5月27日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
|
|
|
|
|
HubSpot と Salesforce の連携 で同期エラーが発生し、データが同期されない場合があります。Salesforce連携設定でこうした同期エラーを特定して解決することができます。
API呼び出し上限を調整
- HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。左側のサイドバーメニューで、[連携]>[接続されたアプリ]の順に進みます。
- 接続アプリのリストで[Salesforce] をクリックします。
- [同期の健全性 ]タブの[ API呼び出し使用]セクションで、過去24時間以内に使用したAPI呼び出し数を確認します。[Salesforceによって制限]の数値は、Salesforceの設定に基づいて実行できるAPI呼び出しの回数です。HubSpotに割り当て可能なコール数を調整するには、[ HubSpotに割り当て済み ]フィールドを編集します。
Salesforce同期エラーを表示
- HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。左側のサイドバーメニューで、[連携]>[接続されたアプリ]の順に進みます。
- 接続アプリのリストで[Salesforce] をクリックします。
- [同期の健全性 ]タブの [同期エラー]で、各エラータイプのカードと、現在のエラー数と影響を受けたレコード数が表示されます。エラータイプのカードをクリックすると、右側のパネルにエラーの詳細が表示されます。各エラータイプと解決方法に関する推奨事項をご覧ください。
- エラーの詳細を表示するには、[ エラーのタイプ]列のinfo 情報アイコンをクリックします。
- 個々のレコードに対してアクションを実行するには、[ 影響を受けたレコード ]列の[[#]レコード]をクリックし、[ アクション ] > [HubSpot レコードの一時ビューを作成]をクリックして、影響を受けたレコードの絞り込みビューを作成します。
- エラーが解決したら、エラーリストに戻ります。解決したエラーの左側にあるチェックボックスを選択し、[再同期]をクリックします。
- エラーをエクスポートするには、エラーリストの左上にある[ エラーをエクスポート(CSV) ]をクリックします。

Salesforce同期エラータイプ
関連付け
関連付けエラーの例
- 関連付けの上限に達しました
- アカウントが同期されるのを待機しています
エラーの意味
レコードの同期が実行されない理由として、レコードがまだHubSpotの会社に同期されていないSalesforce取引先に関連付けられているため、またはHubSpotのレコードの関連付け上限に達したレコードに関連付けられていることが考えられます。
エラーを解決する方法
関連付け上限に達しましたというエラーを解決するには、関連付けられたレコードの一部を削除するか、別のSalesforceレコードに関連付けてから、同期を続行します。
「 アカウントが同期されるのを待機しています」というエラーを解決するには、 Salesforce アカウントのインポートを実行することをお勧めします。
カスタムコード
カスタムコードエラーの例
- Salesforce の自動化
- コンタクト ID がありません
- Salesforceカスタムフィールド検証ルール
- Salesforceフロー
エラーの意味
レコードの同期が実行されない理由として、Salesforceアカウントでの自動化、フロー、または検証ルールによって発生した問題が考えられます
エラーを解決する方法
これらのエラーはSalesforceで発生しているため、Salesforce管理者と協力してSalesforceのカスタムコードで問題を解決することをお勧めします。
重複
重複エラーの例
- Eメールがすでに使用中です
- Salesforce重複ルール
エラーの意味
EメールアドレスがHubSpotコンタクトレコードにすでに存在しているか、 Salesforceの重複の削除ルールが原因で、SalesforceのリードまたはコンタクトをHubSpotに同期できません。
エラーを解決する方法
「Eメールはすでに使用中です 」というエラーを解決するには、既存のHubSpotコンタクトからEメールアドレスを削除します。
Salesforce重複ルールエラーを解決するには、 Salesforceで設定された重複の削除一致ルールを確認することをお勧めします。
権限
権限エラーの例
- アクセス権が不十分かSalesforceレコードが欠落しています
- Salesforce フィールド権限
- Salesforceのアクセス権が不十分です
エラーの意味
HubSpotで加えられた変更がSalesforceに同期されない理由として、Salesforceの必須のフィールドまたはオブジェクトへのアクセス権が接続ユーザーにないことが考えられます。
エラーを解決する方法
ほとんどの場合、「 アクセス権が不十分です」または「Salesforce レコードがありません」というエラーは、連携が誤った値で Salesforce フィールドを更新しようとしたり、正しくない関連付けを作成しようとしたときに発生します。
Salesforce フィールド権限エラーを解決するには、Salesforce 連携ユーザーが Salesforce のフィールドに対する「読み取り」権限と「編集」権限を持っていることを確認します。
「 Salesforceのアクセス権が不足しています 」というエラーは、Salesforce連携ユーザーがSalesforceのユーザー権限のためにSalesforceでアクションを実行できない場合に発生します。Salesforce で Salesforce 連携ユーザー権限を確認することをお勧めします。
選択リスト
選択リストエラーの例
- Salesforce選択リストオプションがありません
- 都道府県または国の値が一致しません
- オプションが一致しません
- 所有者が無効である
- 制限された選択リスト値
- 非アクティブな商談ステージ
- Salesforce所有者が同期されていません
- オプションの上限を超えました
- 既定のセールスプロセスが使用できません
- 商談ステージが欠落しているか無効です
エラーの意味
レコードの同期が実行されない理由として、HubSpotとSalesforceの選択リストフィールドの値が一致していないことが考えられます。このエラーは、あるシステムの選択リストが他のシステムの既存の値に一致しない場合、選択リストが上限に達した場合、または渡された値が有効でない場合に発生することがあります。
エラーを解決する方法
「都道府県または国の値が一致しません 」というエラーを解決するには、次の要件が満たされていることを確認することをお勧めします。
- HubSpotの [国 ]プロパティーオプションの内部値が、Salesforceの [都道府県]および[国/地域]選択リスト設定 の既存の [国 ]オプションに一致する必要があります。
- 都道府県 の値は、Salesforce のレコードの 国 値の [使用可能な都道府県/都道府県] オプションとして存在している必要があります。また、HubSpotの [都道府県 ]プロパティーオプションの内部値が、Salesforceの既存の [都道府県 ]オプションと一致している必要があります。
オプションが一致しません というエラーを解決するには、HubSpotのプロパティーオプションの内部値に一致するようにSalesforceフィールドオプションの内部名/API名を更新することをお勧めします。
「 Salesforce担当者が無効です 」というエラーを解決するには、Salesforceの アクティブ ユーザーであるユーザーにHubSpotレコードを再割り当てします。
[制限された選択リスト値] エラーは、Salesforce の項目で [ 選択リストを値セットで定義された値に制限 する] 設定を有効にしている場合に発生します。Salesforceでこのオプションが有効になっている場合、HubSpotからSalesforceに同期しようとしている値がSalesforce選択リストのオプションとして存在している必要があります。[選択リストをSalesforceの値 セットで定義された値に制限 ]をオフにして、すべての値をHubSpotからSalesforceに同期できるようにすることをお勧めします。
非アクティブな商談ステージエラーは、商談ステージが 無効な Salesforceの商談がHubSpotに同期しようとしたときに発生します。このエラーを解決するには、Salesforce の商談ステージを 有効に変更するか、商談を有効ステージに移動します。
Salesforce 所有者が同期されていません というエラーを解決するには、Salesforce で Salesforce ユーザーの [ユーザー タイプ ] が [標準]、[ パワー パートナー]、または [ゲスト ] に設定されていることを確認します。
「オプションの上限を超え ました」というエラーを解決するには、HubSpotとSalesforceで、チームが使用していない余分なプロパティーオプションを削除することをお勧めします。また、マッピングされた全てのプロパティーに対応するフィールドタイプがあることも確認してください。
ほとんどの場合、「 既定のセールスプロセス利用不可」エラーは、 レコードタイプが欠落している状態でSalesforce 商談がHubSpotに同期しようとしたときに発生します。 Salesforce でレコードタイプを有効にしているが、使用していない場合や、 レコードタイプのない Salesforce 商談がある場合は、Salesforce と協力してすべての レコードタイプ を無効にするか、新しい レコードタイプを作成することをお勧めします。
「 商談ステージが欠落しているか無効 です」というエラーを解決するには、HubSpotパイプラインにSalesforceの商談ステージ値が存在していることを確認します。
プロパティーのマッピング
プロパティーマッピングエラーの例
- 型の不一致
- Salesforce IDがありません
- 無効なSalesforce ID
エラーの意味
レコードの同期は実行されない理由として、HubSpotのプロパティーとSalesforceのフィールドとの間のマッピングが一致していないことが考えられます。このエラーは、プロパティーとフィールドのタイプに互換性がないこと、以前存在していたプロパティーまたはフィールドがなくなったこと、またはSalesforceの参照フィールドのマッピングを作成する必要があることにより発生する場合があります。
エラーを解決する方法
タイプの不一致 エラーを解決するには、HubSpotのプロパティータイプとSalesforceのフィールドタイプに互換性があることを確認します。Salesforceに同期できるHubSpotのプロパティーフィールドタイプの詳細をご確認ください。
Salesforce IDがありませんという エラーは、HubSpotが既存のSalesforce ID以外の値をSalesforceの参照/参照フィールドに同期しようとしたときに発生します。
「Salesforce IDが無効 です」エラーを解決するには、 Salesforceで設定したカスタム検証ルールを確認することをお勧めします。
プロパティー値
プロパティー値エラーの例
- 文字列が長すぎます
- Eメールが無効です
- 必須の国がありません
- 無効な値
- 担当者の割り当て
- 制限された一意の値
- 必須の値が欠落しています
エラーの意味
レコードの同期が実行されない理由として、レコードに無効なプロパティー値が含まれていることが考えられます。通常、こうしたエラーを修正するには、エラーの影響を受けた個々のレコードを更新する必要があります。
エラーを解決する方法
文字列が長すぎますという エラーを解決するには、SalesforceまたはHubSpotでフィールド値を短くするか、Salesforceでフィールドの文字数制限を引き上げてください。
「Eメールが無効です」エラーを解決するには、HubSpotに同期しようとしているSalesforceレコードでEメールアドレスの形式を更新します。
「必須の国がありません 」というエラーを解決するには、次の要件が満たされていることを確認することをお勧めします。
- HubSpotの[国]プロパティーオプションの内部値が、Salesforceの[都道府県]および[国/地域]選択リスト設定の既存の[国]オプションに一致する必要があります。
- 都道府県の値は、Salesforce のレコードの 国 値の [使用可能な都道府県/都道府県] オプションとして存在している必要があります。また、HubSpotの[都道府県]プロパティーオプションの内部値が、Salesforceの既存の[都道府県]オプションと一致している必要があります。
無効な値のエラーを解決するには、プロパティー値に関するHubSpotの要件を満たすようにSalesforceレコードのプロパティー値を更新することをお勧めします。
ほとんどの場合、「 担当者の割り当て 」エラーは、HubSpotのアクティビティーがSalesforceのToDoとしてSalesforceに同期され、HubSpotがそのToDoをSalesforceのキューの担当者に割り当てようとしたときに発生します。
「一意の値が制限されています」エラーを解決するには、Salesforceで設定した重複の削除の一致ルールを確認することをお勧めします。
「必須の値が欠落しています」というエラーを解決するには、HubSpotで必須とマークされているプロパティーについて、Salesforceのレコードに値を追加します。
その他
不明なエラーが原因で、レコードの同期が実行されないことがあります。ご不明な点などがございましたら、HubSpotサポートまでごコンタクトください。
注: 一度に100個のSalesforceエラーを一括で再同期することができます。100個を超えるエラーを同期するには、Salesforceから レコードをインポート するか、 マッピングされたプロパティーを更新します。
同期エラー通知を設定する
- HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。左側のサイドバーメニューで、[連携]>[接続されたアプリ]の順に進みます。
- 接続アプリのリストで[Salesforce] をクリックします。
- [同期の健全性 ]タブをクリックします。
- [同期エラー] セクションで、[通知を管理] をクリックします。
- ダイアログボックスで、[通知をオンにする ]スイッチをオンに切り替えます。
- 通知頻度を設定するには、[即座]、[日次]、または [週次]の横にあるラジオボタンを選択します。
- [保存]をクリックします。