VTPLUS EXTENSIONS
IPSansanConnect｜Sansan名刺連携
Sansanの名刺を、
CRMで活用。
データ化完了済みの名刺を、CRMの顧客情報へ。
登録先・一致候補・更新方針を確認し、初回取得後は更新分も取り込めます。
Sansan → VtigerCRM取得・確認・登録／更新を、段階ごとに管理。
- 登録先を選ぶ企業＋担当者／見込客
- 候補を確認人物・会社IDや項目で照合
- 更新を設定空欄補完・名刺優先など
- 更新分を取得初回取得後の差分・定期処理
01 / REVIEW AND CHOOSE THE DESTINATION
名刺を取得し、
使い方に合う登録先へ。
名刺を取り込み待ちへ取得し、情報と反映予定項目を確認。登録先は「顧客企業＋顧客担当者」または「見込客」を選べます。氏名・部署・役職・メール・住所などを対応づけます。
CRMに登録する前に、内容を確認。
Sansanの名刺情報取り込み待ちへ取得情報・反映内容を確認
登録先 1顧客企業
＋ 顧客担当者
＋ 顧客担当者
登録先 2見込客
02 / MATCH PEOPLE AND COMPANIES CAREFULLY
同じ人・同じ会社か、
候補を確認して反映。
Sansan人物ID・会社IDの連携履歴や、メール・氏名・会社などで照合。複数候補、所属変更、より新しい名刺が反映済みの古い名刺は「要確認」にし、管理者が判断します。
判断が必要な名刺を、そのまま反映しない。
ID
同じ名刺ID再取得時も、既存の連携を利用
ID
人物ID・会社ID一意の連携先を照合
!
所属違い・複数候補・古い名刺要確認として保留 → 個別に確認
03 / SELECT THE RIGHT UPDATE POLICY
既存の顧客情報を、
どう更新するか選ぶ。
初期設定は「空欄のみ補完」。名刺の値を優先する方法や、既存項目を更新せず連携する方法も選べます。名刺側が空欄でも、CRMの入力済みの値を消しません。
現在のデータに合わせて、更新を調整。
初期設定空欄のみ補完入力済みの値を保ち、空欄を補完
名刺の値を優先空でない名刺値で対応項目を更新
既存項目を更新しない既存値を保ち、連携先を記録
04 / FETCH UPDATES AFTER THE INITIAL IMPORT
初回の取り込み後は、
更新分を取得。
対象期間の全ページを取得してから同期位置を保存し、次回は更新分を取得。定期取得と確認不要の名刺の自動反映を個別に設定でき、処理履歴・除外・再処理も管理できます。
手動で確認してから、定期処理へ。
- 1初回：指定開始日から取得開始日は名刺の更新日時が基準
- 2全ページ完了で同期位置を保存通信エラー時は完了位置を進めない
- 3次回：更新分を取得前回終了時刻から5分重ねて取得
初期状態：定期取得 OFF ／ 自動反映 OFF
図・項目・状態は説明用のイメージです。実際の画面構成とは異なります。
API・取得範囲・項目対応・定期処理・導入条件について
- 対応環境・APIと取得範囲
- VtigerCRM OSS 8.4・v7レイアウト、PHP 8.2以上のcURL・mbstring・OpenSSL、MySQL 8.0を想定。SansanのAPI利用権限とAPIキー、HTTPS通信が必要です。初期値はキー発行ユーザーの「自分の名刺」で、参照可能なすべての名刺も選べます。Sansan側の権限を超えて取得しませんが、登録後の公開範囲はCRM側で確認してください。実Sansan接続・実CRM導入は同梱報告では未検証のため、導入先で認証・応答・保存を確認します。
- 項目・名刺所有者・タグ
- 初版の対応先は文字列・メール・長文等です。日付・チェックボックス・選択リスト・関連項目は対象外。カナ、メモ、タグ、交換日、各ID等は既存のカスタム文字列項目へ対応づけられ、項目は自動作成しません。タグは文字列で、Vtiger標準タグには登録しません。企業の初期対応は会社名・URLで、直通電話を代表電話に上書きしないよう電話は初期状態では割り当てません。所有者IDまたはメールとCRM担当者の対応は新規登録に適用し、対応がなければ既定担当者を使います。既存備考は空欄時だけ補完します。
- 確認・差分取得・処理間隔
- 確認画面は15分有効で、名刺・設定・CRMデータ変更時は再確認します。削除済み連携先や見込客変換後の追随はCRM側の確認が必要です。初回開始日は交換日ではなく更新日時で、取得期間を固定してページを進めます。定期ジョブは5分間隔、新しい差分期間の取得間隔は初期15分。続きのページは次のジョブで取得し、実行時刻は標準cronに従います。大量データでは開始日・取得量・API制限に合わせた調整が必要です。
- 機能範囲・停止・保全
- CRMからSansanへの書き戻し、名刺画像、Sansanコンタクト（接触履歴）や人物API、IPLANNER CONNECTへの投稿は含みません。Sansan側の削除・非公開化・権限変更によるCRMの自動削除も行いません。APIキー等の変更では取得位置をリセットしますが、既存CRMデータや旧履歴を削除しません。無効化・アンインストールでもCRMレコードと連携データを保持します。導入時は登録対象テーブルのInnoDB構成と、既存ワークフロー・通知・必須項目・共有ルールを検証してください。
紹介対象：IPSansanConnect v1.0.0。添付パッケージの仕様に基づきます。