1. MiiTel Support
  2. MiiTel
  3. サービス連携
  4. Salesforce との連携
  1. MiiTel Support
  2. MiiTel
  3. Salesforce との連携
  4. Step 1: Salesforce 連携 - 基本設定
  1. MiiTel Support
  2. MiiTel
  3. Salesforce との連携
  4. Step 1: Salesforce 連携 - 基本設定

Step 1: Salesforce 連携 - 基本設定

  • sfdc
  • サンドボックス
  • SFDC
  • sales
  • 管理者向け設定・機能

MiiTel と Salesforce オブジェクトの「取引先責任者 (Contacts)」「取引先 (Accounts)」「リード (Leads)」を連携することができます (「個人取引先」も連携可能)。

連携後、MiiTel Phone で発信、着信した電話番号と一致する Salesforce レコードの「取引先名」「取引先担当者名」が 連絡先 に登録されます。登録された連絡先は、応対履歴、応対履歴一覧 にも反映されます。

  • 「取引先責任者」「取引先」「リード」以外のオブジェクトは連携できません。
  • Salesforce の「電話型の標準項目」に登録された電話番号と一致するレコード情報を連絡先に登録します (「カスタム項目」は非対応)。
  • 一致する電話番号が複数オブジェクトに登録されている場合、「取引先責任者」「取引先」 「リード」の優先順位で連携します。
  • 一致する電話番号が、同一オブジェクトの複数レコードに登録されている場合、最終更新日が最新のレコードと連携します。
  • 連携には、Salesforce の REST API を利用します。
  • MiiTel が利用する Salesforce API バージョンは 51.0 です。API のバージョンは、Salesforce の Edition および API バージョンを確認する方法 でご確認ください。

目次

連携可能な Salesforce エディション

Salesforce の REST API を利用しているため、以下の Salesforce のエディションで連携可能です。詳細は、MiiTel と連携可能な Salesforce のエディションをご参照ください。

  • Enterprise Edition
  • Unlimited Edition
  • Developer Edition
  • Salesforce Platform Starter
  • Salesforce Platform Plus
Professional Edition, Essential Edition では連携できません。

連携方法

新規に連携する場合は、「Salesforce ID で認証 (推奨)」で連携してください。
「ID とパスワード認証」から「Salesforce ID で認証 (推奨)」に変更する場合は、事前に「参考: 認証方法による違い」を確認してください。
連携する Salesforce ユーザ について以下を確認してください。
  • Salesforce API を利用可能 (API を利用してログインができる)
  • リード、取引先責任者、取引先のすべて、または参照したいレコードへの参照権限
  • Salesforce 活動履歴連携 を設定する場合は、以下権限も必要
    • ToDo (API 参照名: Task) の編集権限
    • 活動 (API 参照名: Activity) の編集権限
    • 活動履歴内容を登録するフィールドの編集権限
  • 活動履歴任命先設定をする場合、以下権限も必要
    • MiiTel ユーザーと紐付けする Salesforce ユーザレコードの参照権限
  • 「ID とパスワードで認証」から「Salesforce ID で認証 (推奨)」に変更する場合は、事前に「参考: 認証方法による違い」を確認してください。
  1. 管理者権限を持つアカウントで MiiTel Admin にログインします。
  2. [外部連携] > [Salesforce] > [基本設定] タブを選択します。
  3. [Salesforce ID で認証 (推奨)] を選択します。
  4. [Salesforce と連携する] をクリックします

OAuth1.png

  1. Salesforce ユーザ で Salesforce にログインします (Salesforce にログイン済みの場合は「アクセスを許可しますか？」という画面が表示されます。表示されているアカウントを確認後、[許可] をクリックしてください)。
  2. Salesforce のレコード情報を連絡先に取得したくない場合は、[連絡先の取得を行わない] にチェックを入れて [保存] をクリックします。
接続に失敗した場合は、外部連携エラーログ を確認しエラー内容を確認してください。また、よくあるエラーメッセージ と対処方法も確認ください。

  • 「取引先責任者」「取引先」「リード」の「電話型の標準項目」に登録された電話番号をクリックして発信した場合、クリックしたレコード情報が MiiTel Analytics の連絡先に登録されます。
  • 連絡先の連携では、通話毎に Salesforce API を最大 3 回コールします。

連携解除方法

[連携を解除する] をクリックすると MiiTel と Salesforce の連携を解除できます。

sfdc_disconnect.png

 

  • Salesforce にシングルサインオン (SSO) 設定がされている場合、Salesforce ID とパスワードでログインできる Salesforce ユーザ を連携に利用してください。
  • 連携する Salesforce ユーザ について以下を確認してください。
    • Salesforce API を利用可能 (API を利用してログインができる)
    • 多要素認証を使用している場合、「API ログインの多要素認証」が無効
    • リード、取引先責任者、取引先のすべて、または参照したいレコードへの参照権限
  • Salesforce 活動履歴連携 を設定する場合は、以下権限も必要 
    • ToDo (API 参照名: Task) の編集権限
    • 活動 (API 参照名: Activity) の編集権限
    • 活動履歴内容を登録するフィールドの編集権限
  • 活動履歴任命先設定 (Salesforce ユーザーと MiiTel ユーザーを紐付け)をする場合、以下権限も必要
    • MiiTel ユーザーと紐付けする Salesforce ユーザレコードの参照権限
  1. 管理者権限を持つアカウントで MiiTel Admin にログインします。
  2. [外部連携] > [Salesforce] > [基本設定] タブを選択します。
  3. [ID とパスワードで承認] を選択します。
  4. 以下の各項目を設定後、[接続をテストして保存] をクリックします。

OAth2.png

1Salesforce のユーザー名: 連携に使用する Salesforce ユーザー名を設定

2パスワード: 1 に設定した Salesforce ユーザー名のパスワードを設定

3Salesforce のセキュリティトークン: Salesforce から取得したセキュリティートークンを設定します。

Salesforce 側で接続元 IP アドレスの制限をしていない場合、セキュリティトークンの入力が必要です。詳しくは、Salesforce のセキュリティトークンの確認方法をご参照ください。

4連絡先の設定:

連絡先を一括取得する : 応対履歴と一致する電話番号を持つ Salesforce のレコード情報を MiiTel Analytics の連絡先に登録するタイミングを設定。連絡先へ登録が完了すると応対履歴と応対履歴一覧に取引先会社名と取引担当者名が表示される。

  • オン: 毎日 23 時頃に登録 (当日分の応対履歴の電話番号をと一致する Salesforce レコードを検索し、 MiiTel 連絡先へインポートする。既に MiiTel 連絡先に登録がある場合、Salesforce レコード情報が上書きされる)
  • オフ: 通話終了後 (連絡先に Salesforce レコード情報登録後も履歴作成時に Salesforce レコード情報が上書きされる)

連絡先の取得を行わない: MiiTel Analytics の連絡先に Salesforce のレコード情報を登録しない場合、チェックを入れる。

接続に失敗した場合は、外部連携エラーログを確認しエラー内容を確認してください。また、よくあるエラーメッセージと対処方法も確認ください。
  • 連絡先の連携では、以下のとおり Salesforce API をコールします。
    • 連絡先を一括で取得する設定の場合 : 電話番号に紐づく情報を取得する際、その日の応対履歴の件数分 x 最大 3 回 API をコールします。
      （取引先責任者、取引先、リードの順番で 3 つのオブジェクトを参照し該当の電話番号を持つレコードを検索します。そのため、電話番号がリードに登録されている場合は、3 つのオブジェクトを参照するため最大 3 回 API をコールします）
    • 通話終了後に連絡先を取得する場合 : 通話毎に最大 3 回 API をコールします。
  • 連携設定の解除が必要な場合は、サポートまでご相談ください。

連絡先取得方法変更時の留意点

連絡先取得方法を変更する場合、必ず [パスワード]、[Salesforce のセキュリティトークン] を入力し [接続をテストして保存] をクリックしてください。 

参考: 認証方法による違い

認証方法により、以下が異なります。「ID とパスワード認証」から「Salesforce ID で認証 (推奨)」に変更する場合は、事前に確認してください。

 

Salesforce ID で認証
(推奨)

 ID とパスワードで認証
連携する Salesforce ユーザ の「API ログインの多要素認証」設定 「有効」「無効」どちらも可能 「無効」にする
シングルサインオン (SSO) が要求される Salesforce ユーザによる連携 対応 非対応

連絡先に登録する対象 Salesforce レコード
  • クリック to コール による発信の場合
    クリックしたレコードの情報が MiiTel 連絡先に登録される *1
  • クリック to コール以外の発信、および着信の場合
    取引先責任者、取引先、リードの優先順位で該当電話番号を持つレコード情報が連絡先に登録される     

取引先責任者、取引先、リードの優先順位で該当電話番号を持つレコード情報が連絡先に登録される
応対メモの登録タイミング (活動履歴連携設定した場合)
  • MiiTel Phone からの応対メモ保存時
  • 音声分析完了時 *2
  • 応対履歴からの応対メモ変更時
  • MiiTel Phone からの応対メモ保存時
  • 応対履歴からの応対メモ変更時

サウンド再生中に通話終了した不在着信履歴を手動による Salesforce 活動履歴登録した場合の活動履歴の登録内容
  • 件名: [着信 (不在)] 設定された件名
  • 通話種別: 着信
  • コメント: 着信 (不在)
  • 件名: [不在] 設定された件名
  • 通話種別: ブランク
  • コメント: 不在
連絡先の取得設定
  • 通話終了後に取得 (デフォルト)
  • 取得しない
  • 一括取得 *3
  • 通話終了後に取得 (デフォルト)
  • 取得しない
操作ログ あり なし
連携解除 可能 サポートへ依頼

 *1 Salesforce 上で クリック to コール した場合の連絡先連携について

「ID とパスワードで認証」では、クリックしたレコードの情報ではなく、「取引先責任者」「取引先」「リード」の優先順位で、該当電話番号が登録されているレコードの情報が、連絡先に登録されます。
「Salesforce ID で認証 (推奨)」では、クリックしたレコードが「取引先責任者」「取引先」「リード」の場合、クリックしたレコードの情報が、MiiTel 連絡先に登録されます。

 *2 Salesforce 活動履歴の応対メモ登録タイミングについて
「Salesforce ID 認証 (推奨)」では、MiiTel Phone からの応対メモ保存時に加え、音声分析が完了したタイミングでも Salesforce 活動履歴の応対メモ登録を実施します。なお、Salesforce 活動履歴連携 設定画面の「コメント」に「音声認識結果 ( {SPEECH_RECOGNITION_SUMMARY}、{SPEECH_RECOGNITION})」の設定がない場合も実施します。

*3 「ID とパスワードで認証」で「連絡先を一括取得する」設定している場合
「Salesforce ID で認証 (推奨)」では、「連絡先を一括取得する」ことはできません。「ID とパスワードで認証」で「連絡先を一括取得する」を設定していた場合、「Salesforce ID で認証 (推奨)」に変更後、自動的に「通話終了後に取得する」に変更されます。

Salesforce 連携設定変更に関する FAQ

Q 1. Salesforce 連携方法を「ID とパスワードで認証」から「Salesforce ID で認証 (推奨)」に変更するにはどうすればいいですか？

A. 以下手順で変更を行ってください。

  1. Salesforce からログアウトする (連携方法の切り替えを行うユーザが複数ユーザで Salesforce にログインしている場合はすべてからログアウトする)
  2. MiiTel Admin > 外部連携 > Salesforce で、「Salesforce ID で認証」を選択
  3. 「Salesforce と連携する」ボタンをクリック
  4. Salesforce のログイン画面が表示される
  5. Salesforce に連携用ユーザでログインする

Q 2. Salesforce に複数ユーザでログインしている場合に「Salesforce ID で認証 (推奨)」設定を行うと連携に使用したい Salesforce ユーザが連携に使用されません。どのようにすればいいですか？

A. Salesforce からログアウト後、「Salesforce ID で認証 (推奨)」設定を行ってください。

 

Q3. Salesforce 連携設定方法変更時に、現在 Salesforce 連携に使用している Salesforce ユーザを別アカウントに切り替えた場合、既存の活動履歴連携と任命先連携に影響はありますか？

A. 影響はありません。 ただし、Salesforce ユーザの権限などの違いにより活動履歴連携に失敗する可能性もあります。そのため、変更後は外部連携エラーログを確認してください。 また、外部連携エラー発生のメール通知設定もあわせて確認してください。

 

Q4. Salesforce 連携設定方法変更時に、現在 Salesforce 連携に使用している Salesforce ユーザを別アカウントに切り替えるにはどうすればいいですか？

A. Salesforce からログアウトします。その後、「Salesforce ID で認証 (推奨)」設定を選択して画面の手順に沿って設定を行います。既存の活動履歴連携と任命先連携は維持されます。

 

Q5. Salesforce 連携設定方法変更時、MiiTel Phone の通話になにかしらの影響はありますか？

A. 当作業中で通話に影響が発生することはありません。

オプション設定: 外部連携エラー発生のメール通知設定

何かしらの原因で Salesforce 連携およびその他の外部連携にエラーが生じた場合、あらかじめ設定したメールアドレスでエラー発生通知メールを受けることができます。

設定は、「外部連携エラー発生のメール通知設定」をご確認ください。

 

次へ：Step 2: Salesforce 活動履歴登録

この記事は役に立ちましたか？

Salesforce との連携

関連記事

Salesforce との連携