ワークスペースをExample CRMに接続して、連絡先、会社、取引データを自動で同期します。このガイドでは統合の有効化、同期設定の構成、よくある問題のトラブルシューティングを説明します。
開始前に
統合を有効にする前に、以下を確認してください。
要件 | 詳細 |
管理者アクセス | 統合を有効にするには、ワークスペースの管理者または所有者である必要があります。 |
Example CRMアカウント | チームプラン以上の有効なアカウント |
APIアクセスの有効化 | Example CRMの設定 > 開発者 > APIアクセスで有効にしてください。 |
ドメインの確認 | メール活動を同期するには、送信ドメインの確認が必要です。 |
データマッピング計画 | 重複を避けるため、最初の同期前にどのフィールドをマッピングするか決めてください。 |
ステップ1：統合を見つける
設定 > 統合に移動します。
統合ディレクトリで「Example CRM」を検索します。
接続をクリックします。
表示されたらExample CRMの認証情報でサインインしてください。
要求された権限を承認します。
ステップ2：同期する内容を選択
接続後、同期するオブジェクトを選択します。オブジェクトごとに同期動作と更新間隔が異なります。
オブジェクト | 同期方向 | デフォルトの更新間隔 | 備考 |
連絡先 | 双方向 | 5分 | デフォルトでメールアドレスで照合 |
会社 | 双方向 | 15分 | ドメイン名で照合 |
取引 / 商談 | 一方向（CRMからアプリへ） | 15分 | 高度な同期が有効でない限り読み取り専用 |
メモ | 一方向（アプリからCRMへ） | リアルタイム | 「共有可能」とタグ付けされたメモのみ同期 |
タスク | 双方向 | 10分 | タスク同期アドオンが必要 |
カスタムオブジェクト | 設定可能 | 設定可能 | エンタープライズプランのみ利用可能 |
ステップ3：フィールドマッピングの設定
フィールドマッピングはシステム間のデータの対応を決定します。誤ったマッピングは重複や欠落の主な原因です。
ソースフィールド（例：CRM） | 宛先フィールド | データ型 | 必須 |
| 名 | テキスト | はい |
| 姓 | テキスト | はい |
| 主要メール | メール | はい |
| 電話番号 | 電話 | いいえ |
| 担当者 | 参照 | いいえ |
| ライフサイクルステージ | 列挙型 | いいえ |
| 取引金額 | 通貨 | いいえ |
| 最終活動日 | 日付 | いいえ |
| （未マッピング） | テキスト | いいえ |
統合 > Example CRM > フィールドマッピングでカスタムマッピングを追加できます。未マッピングのフィールドは同期時に無視されますが、将来のマッピングに利用可能です。
ステップ4：同期ルールの設定
同期ルールはシステム間で許可されるデータを制御し、不要な上書きを防ぎます。
ルール | 有効時の動作 | 無効時の動作 |
競合時に上書きする | 最新更新のレコードが優先される | 既存のアプリデータは上書きされません |
削除されたレコードを同期する | どちらかのシステムで削除すると両方で削除される | 削除は両システムで手動で行う必要があります |
重複する連絡先を統合する | メールアドレスで一致するものを自動統合する | 重複は手動確認のためにフラグ付けされる |
過去データを同期する | 初回同期時に最大24ヶ月分の履歴を遡って同期する | 以降は新しい活動のみ同期される |
チームで制限する | 選択したチームが所有するレコードのみ同期する | 所有権に関係なくすべてのレコードを同期する |
ステップ5：連携を有効にする
オブジェクトの選択、フィールドマッピング、同期ルールを確認してください。
同期を有効にするをクリックしてください。
初回同期はデータ量により数分から数時間かかる場合があります。
初回同期完了時に通知が届きます。
同期ステータスの参照
ステータス | 意味 | 対応が必要 |
アクティブ | 同期は正常に実行されています | なし |
一時停止中 | 管理者によって手動で同期が一時停止されました | 連携設定から再開してください |
エラー – 認証 | API認証情報が期限切れまたは取り消されました | 連携を再接続してください |
エラー – レート制限 | Example CRMへのリクエストが多すぎます | 自動再試行を待つか、サポートに連絡してください |
エラー – マッピングの競合 | 必須フィールドが未マッピングまたは不一致です | フィールドマッピング設定を確認してください |
部分的 | 一部のオブジェクトは同期され、他は失敗しました | 詳細は同期ログを確認してください |
よくある問題
連絡先が同期されない 連絡先に有効で重複しないメールアドレスがあるか確認してください。メールアドレスがない連絡先はデフォルトでスキップされます。
重複した会社が表示される これは通常、会社の照合がドメインではなく名前に依存していることを意味します。フィールドマッピングで既存レコードのドメインフィールドが入力されているか確認してください。
同期が「初期化中」で止まっている 大規模アカウント（5万件以上）は初回同期に数時間かかることがあります。12時間以上経過している場合は、ワークスペースIDを添えてサポートに連絡してください。
同期後に一部のフィールドが空白になる ステップ3でフィールドがマッピングされているか確認してください。未マッピングのフィールドは元データに関わらず常に空白になります。
連携を無効にする
設定 > 連携 > Example CRMに移動してください。
切断をクリックします。
以前に同期したデータを保持するか削除するかを選択します。
切断を確認します。
切断しても、明示的にそのオプションを選択しない限り、既に同期された記録は削除されません。
関連する記事
Example CRMでのAPIアクセス設定
重複レコードの管理
同期ログとエラーコードの理解
高度な同期アドオンの概要
コンテンツ
