Salesforce 連携をする前に、以下を確認してください。

Salesforce エディション

連携には Salesforce の REST API を利用するため、ご利用の Salesforce 組織が以下いずれかのエディションである必要があります。

• Enterprise Edition
• Unlimited Edition
• Developer Edition

詳細は以下を確認してください。

Salesforce API バージョン

51.0

API のバージョンは「Salesforce の Edition および API バージョンを確認する方法」を確認してください。

連携する Salesforce ユーザーに必要なアクセス権

連携する Salesforce ユーザーに必要なアクセス権は以下のとおりです。

必要なアクセス権 (すべての連携設定で共通)

• Salesforce API の利用: 可能 (「API の有効化」アクセス権の付与)
• 以下オブジェクトへの参照権限、かつ参照したいレコードへの参照権限

表示ラベル	API 参照名	種別	アクセス権
取引先責任者	Contact	標準	参照
取引先	Account	標準	参照
リード	Lead	標準	参照
ユーザー	User	標準	参照

• 以下標準項目への参照権限

＜取引先責任者オブジェクト＞

表示ラベル	API 参照名	種別	アクセス権
電話	Phone	標準	参照
携帯	MobilePhone	標準	参照
取引先名	AccountId	標準	参照
名前	Name	標準	参照

＜取引先オブジェクト＞

表示ラベル	API 参照名	種別	アクセス権
電話	Phone	標準	参照
取引先名	Name	標準	参照

＜リードオブジェクト＞

表示ラベル	API 参照名	種別	アクセス権
電話	Phone	標準	参照
携帯	MobilePhone	標準	参照
会社名	Company	標準	参照
名前	Name	標準	参照

連絡先の取得を設定する場合

連絡先の取得を設定する場合、必要なアクセス権は以下のとおりです。

• 必要なアクセス権 (すべての連携設定で共通) 記載のアクセス権

活動履歴連携を設定する場合

活動履歴連携を設定する場合、必要なアクセス権は以下のとおりです。

• 必要なアクセス権 (すべての連携設定で共通) 記載のアクセス権
• Salesforce プロファイル > 一般ユーザー権限 > ToDo の編集 権限
•  [ToDo] オブジェクトのレコードへの編集権限
• 以下項目への編集権限

＜ToDo (API 参照名: Task) レコード＞

表示ラベル	API 参照名	種別	アクセス権
件名	Subject	標準	編集
状況	Status	標準	参照
コメント	Description	標準	編集
割り当て先	OwnerId	標準	編集
名前	Whold	標準	編集
関連先	WhatId	標準	参照
ToDo のサブ集別	TaskSubtype	標準	編集
期日	ActivityDate	標準	編集
通話時間	NameCallDurationInSeconds	標準	参照
通話種別	CallType	標準	参照
通話オブジェクト ID	CallObject	標準	参照

＜活動 (API 参照名: Activity) レコード＞

	データ型	種別	アクセス権
[ダイヤル開始時刻] を登録する項目	日付/時刻	カスタム	編集
[通話開始時刻] を登録する項目	日付/時刻	カスタム	編集
[通話終了時刻] を登録する項目	日付/時刻	カスタム	編集
[タグ] を登録する項目	選択リスト (複数選択)	カスタム	編集

活動履歴任命先を設定する場合

活動履歴任命先を設定する場合、必要なアクセス権は以下のとおりです。

• 必要なアクセス権 (すべての連携設定で共通) 記載のアクセス権

API コール数

1 応対履歴 (1 通話) に対し、MiiTel は 以下のとおり API をコールします。

• Salesforce レコードの検索 (取得): 1 回 (連絡先の取得有無に関わらず 1 回)
• 活動履歴の作成: 1 回
• 活動履歴の更新:
  • 音声分析完了時:
    • 以下のいずれかを Salesforce 活動履歴連携で設定している場合: 1 回 (いずれの設定もない場合は 0 回)
      • タグ
      • 文字起こし結果 (フィラー除く) {SPEECH_RECOGNITION}
      • 文字起こし結果 (要約文) {SPEECH_RECOGNITION_SUMMARY}
      • 通話中のコメント {COMMENT}
      • 応対の議事録 {SUMMARY_WITH_GPT}
  • 議事録作成完了時:
    • • Salesforce 活動履歴連携で以下を設定している場合: 1 回
        • 応対の議事録 {SUMMARY_WITH_GPT}
  • MiiTel Phone 通話終了時のタグ登録画面からタグ登録時: 1 回
  • MiiTel Phone 応対履歴からのタグ変更時: 変更のたびに 1 回
  • MiiTel Analytics 応対履歴からのタグ変更時: 変更のたびに 1 回
  • MiiTel Phone で関連先を指定した時:
    • 内線、外線転送しなかった場合: 2 回
    • 内線、外線転送した場合: 2 回 + (転送した回数 x 1 回)

例 1: 連絡先を取得した場合

設定:

• Salesforce 連携の基本設定で「連絡先の取得」を有効にしている
• Salesforce 活動履歴連携を無効にしている

API コール数: 

• 合計 1 回
  • Salesforce レコードの検索 (取得): 1 回

例 2: 通話終了後、MiiTel Phone でタグを登録した場合

設定:

• Salesforce 連携の基本設定で「連絡先の取得」を有効、または、無効にしている
• Salesforce 活動履歴連携を有効にしている
  
  • 設定項目の「タグ」を設定している
  • 「コメント」に {SPEECH_RECOGNITION_SUMMARY} を設定している

操作:

• 通話終了後、MiiTel Phone のタグ登録画面からタグを登録する
• MiiTel Phone で関連先を指定しない

API コール数:

• 合計 4 回
  • Salesforce レコードの検索(取得): 1 回
  • 活動履歴の作成: 1 回
  • 活動履歴の更新 (音声分析完了時): 1 回
  • 活動履歴の更新 (MiiTel Phone 通話終了時のタグ登録時): 1 回

例 3: 通話終了後、議事録を作成した場合

設定:

• Salesforce 連携の基本設定で「連絡先の取得」を有効、または、無効にしている
• Salesforce 活動履歴連携を有効にしている
  
  • 「コメント」に {SUMMARY_WITH_GPT} を設定している

操作:

• 議事録を作成する

API コール数:

• 合計 4 回
  • Salesforce レコードの検索(取得): 1 回
  • 活動履歴の作成: 1 回
  • 活動履歴の更新: 1 回 (音声分析完了時)
  • 活動履歴の更新: 1 回 (議事録作成完了時)

例 4: 通話終了後、議事録が作成されなかった場合 (通話時間が短かった場合など)

設定:

• Salesforce 連携の基本設定で「連絡先の取得」が有効、または、無効にしている
• Salesforce 活動履歴連携が有効にしている
  
  • 「コメント」に {SUMMARY_WITH_GPT} を設定している

操作:

• 議事録を作成しようとしたが、作成できなかった (通話時間 1 分未満と短かったなどの理由でエラーが発生した)

API コール数:

• 合計 3 回
  • Salesforce レコードの検索(取得): 1 回
  • 活動履歴の作成: 1 回
  • 活動履歴の更新: 1 回 (音声分析完了時)

MiiTel が作成する Salesforce レコードの容量

Salesforce 連携した MiiTel は、 Salesforce に活動履歴レコードを作成します。
1 活動履歴レコードの容量は 2KB です。
詳細は Salesforce サポートページ「Salesforce レコードサイズの概要」を確認してください。