Contents
SansanとSalesforceのAPI連携で実現する業務効率化
中小企業ではCRMツールの連携が業務のスピードアップに直結します。Sansan API 連携 方法 Salesforceを理解することで、商談管理や顧客情報の共有を自動化できます。本記事ではOAuth2.0認証からエラーメッセージ対応まで、実務で使える技術情報を一気に解説します。
OAuth2.0認証設定の手順とポイント
API連携を開始するにはまずOAuth2.0の設定が不可欠です。両プラットフォームでの認証フローは異なるものの、基本的なプロセスに共通点があります。以下で具体的な手順や注意点を解説します。
開発者アカウントの登録フロー
- Sansan側: 「アプリケーション管理」ページから新規登録を行い、クライアントIDとシークレットを生成します。
- Salesforce側: 「開発者コンソール」で「OAuth認証設定」にアクセスし、許可されたエンドポイント（例:
/services/oauth2/token）を指定します。
クライアントID・シークレットの取得方法
| プラットフォーム | 取得手順 | 注意点 |
|---|---|---|
| Sansan | 管理画面 → アプリケーション → 新規作成 | シークレットは初期表示のみ。再発行が必要な場合は「リセット」ボタンを使用 |
| Salesforce | 開発者コンソール → OAuth認証 → 設定変更 | APIアクセス権を持つユーザーアカウントでの操作が必須 |
クライアントシークレットは絶対に外部に漏らさないでください。社内でのみ保管可能な暗号化された環境で管理してください。
データマッピングにおける実務上の注意点
連携の成功率を高めるには、Sansan API 連携 方法 Salesforceで対応するデータタイプを明確に定義することが重要です。以下では具体的な選定基準とトラブルシューティングを解説します。
連携対象フィールドの選定基準
- 必須項目: 商談名、顧客氏名、担当者情報（Salesforce側の「Account」および「Contact」オブジェクト）
- 選択項目: メモ欄や関連付いた商談履歴（データ量が膨大な場合、API呼び出し回数を減らすためフィルタリングが必要）
型変換時のトラブルシューティング
| Sansanの型 | Salesforceの型 | 変換に注意すべき点 |
|---|---|---|
| 文字列（例: 「2026/07/08」） | 日付型（Date） | フォーマットが「YYYY/MM/DD」でない場合、変換エラーが発生 |
| 数値（例: 1.5） | カスタムフィールド（Number） | 小数点以下を無視する設定がある場合は事前に確認 |
データ型の不一致は、「400 Bad Request」などのHTTPステータスコードとしてエラーが返されるため、事前テスト必須です。
APIエンドポイント一覧と利用シーン
Sansan APIとSalesforce REST APIそれぞれに代表的なエンドポイントがあります。以下に主要なものを比較します。
連携必須な主要エンドポイント
| プラットフォーム | エンドポイント | 機能例 |
|---|---|---|
| Sansan | /api/v2/contacts |
連絡先情報の取得・更新 |
| Salesforce | /services/data/v58.0/sobjects/Contact |
顧客データへのアクセス |
レート制限対策のベストプラクティス
- Sansan: 同一IPアドレスあたり、1分間に最大30回のAPI呼び出し（無料プラン）
- Salesforce: 管理者権限で「API利用量監視」を有効にし、ピーク時に分散処理を実施
レート制限を超えると「429 Too Many Requests」というエラーレスポンスが返されるため、非同期処理やバッチ処理を活用するべきです。
セキュリティ強化のための実践的設定
API連携におけるセキュリティは、中小企業でも見落とせないポイントです。特にデータ漏洩リスクを回避する対策が必要です。
HTTPS通信の必須性
- すべてのAPI通信でHTTPSが必須（Sansan/Salesforce共通）
- SSL/TLS証明書の有効期限を定期的に確認し、更新を忘れずに
APIキーのローテーションポリシー
- 月次での再発行: セキュリティ体制に応じて、クライアントID・シークレットを毎月変更
- ロールベースのアクセス制限: 特定の業務目的ごとに専用キーを割り当て（例: 「商談同期専用」と「顧客情報取得専用」）
キーの漏洩が発覚した場合は、すぐにサードパーティツールを使わず、各プラットフォームの管理画面から即時無効化を行ってください。
よく発生するエラーメッセージと解決法
現場で実際に起きたケースをもとに、代表的なエラーの対処法を解説します。
認証失敗時のステータスコード対応
- 401 Unauthorized: クライアントID・シークレットに誤りがあるか、有効期限が切れている
- 解決策: キーを再発行し、環境変数または設定ファイルで更新
- 403 Forbidden: アプリケーションのAPI権限が不足している
- 解決策: Salesforce側で「オブジェクトアクセス権」を追加する
データ型不整合の見分け方
エラーメッセージ例: {"error": "Invalid field type: String cannot be converted to Integer"}
- 原因: SalesforcеにInteger型として定義されたフィールドにSansan側で文字列を送信している
- 解決策: データ変換ロジックを追加し、型チェック処理（例:
is_numeric()関数）を実装
補足情報とまとめ
本記事ではSansan API 連携 方法 Salesforceの技術的ノウハウを網羅しました。OAuth設定やセキュリティ対策、エラーメッセージの解釈など、実務で即活用できる情報を提供しています。
- OAuth2.0の初期設定は複雑ですが、手順通り進めれば実現可能です
- データマッピングには「本当に必要な情報」に絞り込む意識が重要です
- セキュリティ対策は定期的な見直しを忘れずに
無料でSansan-Salesforce連携相談