2. コンテンツにスキップ

2. 事前準備

BIZTEL連携機能を利用する為の事前準備について記します。

2.1 BIZTELの設定

以下の連携機能を実現するために必要なBIZTELの設定内容を記します。
なお、設定はBIZTELのWEB管理画面から管理者権限のユーザーで操作してください。

1.通話記録のプロセス登録
2.顧客情報の紐づけ
3.通話記録編集画面の表示

上記の順番で設定を進めていくことで段階的に連携機能が利用可能となります。

例：「1.通話記録の登録」の設定を実施した時点では「1.通話記録の登録」のみ利用可能ですが、「2.顧客情報の紐づけ」まで設定することで「1.通話記録の登録」と「2.顧客情報の紐づけ」の二つの機能を利用することが可能となります。

利用用途に応じて必要な設定まで実施してください。

2.1.1 通話記録のプロセス登録

BIZTELを介した通話について、通話終了時にSenju Service Managerに連携し、プロセス管理に通話記録レコードとして登録します。

2.1.1.1 所属エージェントの設定

コールセンター制御を利用するにあたり、必要な所属エージェントの設定を行います。
例として受電時に外線に対して電話がかかるように設定します。

以下の画面からアカウントのステータス変更を行ってください。

設定画面
[コールセンター　>　コールセンター　>　所属エージェント]

  • 以下の項目名称を変更します。

    項目名称 項目値
    ステータス 受付可
    サインイン端末 外線番号を指定する
    外線番号 例) 08012345678

2.1.1.2 APIカスタム項目設定

Senju Service Managerとの連携に必要な項目の設定を行います。

以下の画面から設定を行ってください。

設定画面
[コールセンター　>　コールセンター　>　APIカスタム項目]

  • SSMWEBAPI連携を実施する以下の設定を行います。

    項目名称 項目値（例） Senju Service Manager連携対象項目
    SSM_USERNAME 例) ssmtest01 ユーザーID
    SSM_PASSWORD 例) ssmtest01 ユーザーパスワード
    PROCESS_TYPE_ID 例) 01000001 登録対象となるプロセス管理の画面 (01000001～01000103)
    SYSTEM_NAME 例) SSM初期システム システム名
    STATUS 例) 新規 ステータス
    VOICE_URL 例)https://xxxxxxxxxxxx.u.biztel.jp:8000/monitor_link/ BIZTEL録音ファイル共通URL
    ※BIZTELの契約に応じて設定してください。

2.1.1.3 コールアクション設定

コールアクション連携制御を利用するにあたり、必要なアクション設定を行います。

以下の画面から設定を行ってください。

設定画面
[オプション　>　連携オプション　>　コールアクション連携]

  • 以下のコールアクション（着信応答実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage
    連携対象項目
    イベント種別 着信応答
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/auth/login
    メソッド GET
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ {
    "username":"{QUEUE_VALUE_SSM_USERNAME}",
    "password":"{QUEUE_VALUE_SSM_PASSWORD}"
    }    		 ユーザーID
    ユーザーパスワード
    タイムアウト判定（秒） 10
    変数抽出パターン /"access_token":"(?P<ACCESS_TOKEN>.*)",/ アクセストークン
    メモ SSMログインAPI連携

  • 以下のコールアクション（着信応答実行順2）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage
    連携対象項目
    イベント種別 着信応答
    実行順 2
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/ci_types/{QUEUE_VALUE_CI_TYPE_ID}/items?ci_target={QUEUE_VALUE_CI_TARGET}&tel_number={TEL} QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
    TEL：着信電話番号
    メソッド GET
    リクエストヘッダ Accept: application/json
    Authorization:Bearer
    リクエストヘッダボディ
    タイムアウト判定（秒） 10
    変数抽出パターン /"ci_id":\s*"(?P<CI_ID>[^"]*)".*?"system_name":\s*"(?P<SYSTEM_NAME>[^"]*)"/ SYSTEM_NAME：システム名
    CI_ID：構成アイテムID
    メモ 複数の構成アイテム情報の取得API連携

  • 以下のコールアクション（録音完了実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage
    連携対象項目
    イベント種別 録音完了／音声認識連携完了
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes/{RESPONSE_PROCESS_ID}/progresses QUEUE_VALUE_PROCESS_TYPE_ID：プロセス管理画面ID
    RESPONSE_PROCESS_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ 例)
    {
    "title": "通話情報",
    "content": "{VOICE_LOG}",
    "text_1": "{TEL}",
    "text_2": "{ANSWER_NO}",
    "text_3": "{EXTEN_NO}",
    "text_4": "{CALL_SEC}",
    "textarea_1": "{QUEUE_VALUE_VOICE_URL}{ID}",
    "response_target": "{AGENT_NAME}",
    "response_date": "{START_TIME.DATE_FORMAT(Y)}{START_TIME.DATE_FORMAT(m)}{START_TIME.DATE_FORMAT(d)}",
    "response_time": "{START_TIME.DATE_FORMAT(H)}{START_TIME.DATE_FORMAT(i)}{START_TIME.DATE_FORMAT(s)}",
    "progress_date_text_1": "{END_TIME.DATE_FORMAT(Y)}{END_TIME.DATE_FORMAT(m)}{END_TIME.DATE_FORMAT(d)}",
    "progress_time_text_1": "{END_TIME.DATE_FORMAT(H)}{END_TIME.DATE_FORMAT(i)}{END_TIME.DATE_FORMAT(s)}"
    }    		 VOICE_LOG：音声テキスト化データ
    TEL：発信電話番号
    ANSWER_NO：着信電話番号
    EXTEN_NO：内線番号
    CALL_SEC：通話時間
    AGENT_NAME：着信アカウント名
    START_TIME：通話開始時間
    END_TIME通話終了時間
    タイムアウト判定（秒） 10
    メモ プロセス経過の登録API連携

  • 以下のコールアクション（録音完了実行順2）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目
    イベント種別 録音完了／音声認識連携完了
    実行順 2
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes/{RESPONSE_PROCESS_ID}/progresses QUEUE_VALUE_PROCESS_TYPE_ID：プロセス管理画面ID
    RESPONSE_PROCESS_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer
    リクエストヘッダボディ 例)
    {
    "title": "通話情報",
    "rich_text": "{VOICE_LOG}",
    "text_1": "{TEL}",
    "text_2": "{ANSWER_NO}",
    "text_3": "{EXTEN_NO}",
    "text_4": "{CALL_SEC}",
    "textarea_1": "{QUEUE_VALUE_VOICE_URL}{ID}",
    "response_target": "{AGENT_NAME}",
    "response_date": "{START_TIME.DATE_FORMAT(Y)}{START_TIME.DATE_FORMAT(m)}{START_TIME.DATE_FORMAT(d)}",
    "response_time": "{START_TIME.DATE_FORMAT(H)}{START_TIME.DATE_FORMAT(i)}{START_TIME.DATE_FORMAT(s)}",
    "progress_date_text_1": "{END_TIME.DATE_FORMAT(Y)}{END_TIME.DATE_FORMAT(m)}{END_TIME.DATE_FORMAT(d)}",
    "progress_time_text_1": "{END_TIME.DATE_FORMAT(H)}{END_TIME.DATE_FORMAT(i)}{END_TIME.DATE_FORMAT(s)}"
    }    		 VOICE_LOG：音声テキスト化データ
    TEL：発信電話番号
    ANSWER_NO：着信電話番号
    EXTEN_NO：内線番号
    CALL_SEC：通話時間
    AGENT_NAME：着信アカウント名
    START_TIME：通話開始時間
    END_TIME通話終了時間
    タイムアウト判定（秒） 10
    メモ プロセス経過の登録API連携

2.1.2 顧客情報の紐づけ

BIZTELを介した通話について、着信元電話番号を保持する顧客情報を構成管理から検索し、 プロセス管理の通話記録レコードに紐づけます。

仕様補足

「2.1.1 通話記録のプロセス登録」から継続実施する場合、各設定の追加設定列に〇がついている箇所について追加・更新してください。

2.1.2.1 所属エージェントの設定

コールセンター制御を利用するにあたり、必要な 所属エージェントの設定を行います。
例として受電時に外線に対して電話がかかるように設定します。

以下の画面からアカウントのステータス変更を行ってください。

設定画面
[コールセンター　>　コールセンター　>　所属エージェント]

  • 以下の項目名称を変更します。

    項目名称 項目値 追加設定
    ステータス 受付可
    サインイン端末 外線番号を指定する
    外線番号 例) 08012345678

2.1.2.2 APIカスタム項目設定

Senju Service Managerとの連携に必要な項目の設定を行います。

以下の画面から設定を行ってください

設定画面
[コールセンター　>　コールセンター　>　APIカスタム項目]

  • SSMWEBAPI連携を実施する以下の設定を行います。

    項目名称 項目値（例） Senju Service Manager連携対象項目 追加設定
    SSM_USERNAME 例) ssmtest01 ユーザーID
    SSM_PASSWORD 例) ssmtest01 ユーザーパスワード
    CI_TARGET now 取得対象となる構成アイテムの区分
    ※"now"を指定してください。    		 ○
    CI_TYPE_ID 例) 04000001 取得対象となる構成アイテムが属する画面のID(04000001～04000050) ○
    PROCESS_TYPE_ID 例) 01000001 登録対象となるプロセス管理の画面 (01000001～01000103)
    SYSTEM_NAME 例) SSM初期システム システム名
    STATUS 例) 新規 ステータス
    VOICE_URL 例)https://xxxxxxxxxxxx.u.biztel.jp:8000/monitor_link/ BIZTEL録音ファイル共通URL
    ※BIZTELの契約に応じて設定してください。

2.1.2.3 コールアクション設定

コールアクション連携制御を利用するにあたり、必要なアクション設定を行います。
以下の画面から設定を行ってください。

設定画面
[オプション　>　連携オプション　>　コールアクション連携]

  • 以下のコールアクション（着信応答実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 着信応答
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/auth/login
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ {
    "username":"{QUEUE_VALUE_SSM_USERNAME}",
    "password":"{QUEUE_VALUE_SSM_PASSWORD}"
    }    		 ユーザーID
    ユーザーパスワード
    タイムアウト判定（秒） 10
    変数抽出パターン /"access_token":"(?P<ACCESS_TOKEN>.*)",/ アクセストークン
    メモ SSMログインAPI連携

  • 以下のコールアクション（着信応答実行順2）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 着信応答 ○
    実行順 2 ○
    API連携種別 マニュアル ○
    URL https://biztel001.ssm.com:49152/api/ci_types/{QUEUE_VALUE_CI_TYPE_ID}/items?ci_target={QUEUE_VALUE_CI_TARGET}&tel_number={TEL} QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
    TEL：着信電話番号    		 ○
    メソッド GET ○
    リクエストヘッダ Accept: application/json
    Authorization:Bearer    		 ○
    リクエストヘッダボディ ○
    タイムアウト判定（秒） 10 ○
    変数抽出パターン /"ci_id":\s*"(?P<CI_ID>[^"]*)"/ CI_ID：構成アイテムID ○
    メモ 複数の構成アイテム情報の取得API連携 ○

  • 以下のコールアクション（着信応答実行順3）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 着信応答
    実行順 3
    判定用コード {RESPONSE_CI_ID} RESPONSE_CI_ID：構成アイテムID ○
    判定評価パターン /^.+$/
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes QUEUE_VALUE_PROCESS_TYPE_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer
    リクエストヘッダボディ 例)
    {
    "system_name":"{QUEUE_VALUE_SYSTEM_NAME}",
    "status":"{QUEUE_VALUE_STATUS}",
    "title":"
    {START_TIME.DATE_FORMAT(m)}月{START_TIME.DATE_FORMAT(d)}日{START_TIME.DATE_FORMAT(H)}時{START_TIME.DATE_FORMAT(i)}分に通話（着信）",
    "tel_number":"{TEL}",
    "related_config_1":[{
    "related_config_1_ci_type_id":"{QUEUE_VALUE_CI_TYPE_ID}",
    "related_config_1_ci_id":"{RESPONSE_CI_ID}",
    "related_config_1_ci_system":"{QUEUE_VALUE_SYSTEM_NAME}"
    }]
    }    		 QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
    RESPONSE_CI_ID：構成アイテムID
    QUEUE_VALUE_SYSTEM_NAME：システム名    		 ○
    タイムアウト判定（秒） 10
    変数抽出パターン /"process_id":\s*"(?P<PROCESS_ID>[^"]*)"/ RESPONSE_PROCESS_ID：プロセスID
    メモ プロセスの登録API連携
    (関連構成登録あり)

  • 以下のコールアクション（着信応答実行順4）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 着信応答 ○
    実行順 4 ○
    判定用コード {RESPONSE_CI_ID} RESPONSE_CI_ID：構成アイテムID ○
    判定評価パターン /^$/ ○
    API連携種別 マニュアル ○
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes QUEUE_VALUE_PROCESS_TYPE_ID：プロセスID ○
    メソッド POST ○
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer    		 ○
    リクエストヘッダボディ 例)
    {
    "system_name": "{QUEUE_VALUE_SYSTEM_NAME}",
    "status": "{QUEUE_VALUE_STATUS}",
    "title":"
    {START_TIME.DATE_FORMAT(m)}月{START_TIME.DATE_FORMAT(d)}日{START_TIME.DATE_FORMAT(H)}時{START_TIME.DATE_FORMAT(i)}分に通話（着信）",
    "tel_number":"{TEL}"
    }    		 QUEUE_VALUE_SYSTEM_NAME：システム名 ○
    タイムアウト判定（秒） 10 ○
    変数抽出パターン /"process_id":\s*"(?P<PROCESS_ID>[^"]*)"/ RESPONSE_PROCESS_ID：プロセスID ○
    メモ プロセスの登録API連携
    (関連構成登録なし)    		 ○

  • 以下のコールアクション（録音完了実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 録音完了／音声認識連携完了
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/auth/login
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ {
    "username":"{QUEUE_VALUE_SSM_USERNAME}",
    "password":"{QUEUE_VALUE_SSM_PASSWORD}"
    }    		 ユーザーID
    ユーザーパスワード
    タイムアウト判定（秒） 10
    変数抽出パターン /"access_token":"(?P<ACCESS_TOKEN>.*)",/ アクセストークン
    メモ SSMログインAPI連携

2.1.3 通話記録編集画面の表示

BIZTELを介した通話について、受話時にBIZTELのアカウント名を元にしてSenju Service Managerの該当ユーザーが開いているWEBブラウザでプロセス管理の通話記録レコードの編集画面を表示します。

仕様補足

「2.1.2 顧客情報の紐づけ」から継続実施する場合、各設定の追加設定列に〇がついている箇所について追加・更新してください。

2.1.3.1 所属エージェントの設定

コールセンター制御を利用するにあたり、必要な 所属エージェントの設定を行います。
例として受電時に内線に対して電話がかかるように設定します。

以下の画面からアカウントのステータス変更を行ってください。

設定画面
[コールセンター　>　コールセンター　>　所属エージェント]

  • 以下の項目名称を変更します。

    項目名称 項目値 追加設定
    ステータス 受付可 ○
    サインイン端末 該当の内線番号を指定する
    例) 0123：モバイル端末    		 ○

仕様補足

プロセスの編集画面を表示する機能は、電話を受話したサインイン端末に紐づくBIZTELのユーザーアカウント名をSenju Service Managerに連携して、同じ文字列のユーザーIDを持つユーザーがログインしている場合に、そのユーザーのWEBブラウザ上で編集画面の表示を行います。

制限事項

プロセスの編集画面を表示する機能を利用する場合は、電話を受話したサインイン端末に紐づくBIZTELのユーザーアカウント名をSenju Service Managerに連携するためにコールセンターの応答イベントを使用します。このため、後述のコールアクション設定のイベント種別を「着信応答」から「コールセンター応答」に変更する必要があります。

制限事項

プロセスの編集画面を表示する機能を利用する場合は、コールセンターの応答イベントを使用するため、サインイン端末を内線番号に指定する必要があります。外線番号を指定したサインイン端末が所属するコールセンターでの利用はサポート対象外となります。
なお、外線番号を指定したサインイン端末のエージェントが受話した場合、後述の「コールセンター応答」のコールアクション連携が起動せず、その場合のみ通話履歴の登録およびプロセスの編集画面の表示が行われません。

2.1.3.2 APIカスタム項目設定

Senju Service Managerとの連携に必要な項目の設定を行います。

以下の画面から設定を行ってください。

設定画面
[コールセンター　>　コールセンター　>　APIカスタム項目]

  • SSMWEBAPI連携を実施する以下の設定を行います

    項目名称 項目値（例） Senju Service Manager連携対象項目 追加項目
    SSM_USERNAME 例) ssmtest01 ユーザーID
    SSM_PASSWORD 例) ssmtest01 ユーザーパスワード
    CI_TARGET now 取得対象となる構成アイテムの区分
    ※"now"を指定してください。
    CI_TYPE_ID 例) 04000001 取得対象となる構成アイテムが属する画面のID(04000001～04000050)
    PROCESS_TYPE_ID 例) 01000001 登録対象となるプロセス管理の画面 (01000001～01000103)
    SYSTEM_NAME 例) SSM初期システム システム名
    STATUS 例) 新規 ステータス
    VOICE_URL 例)https://xxxxxxxxxxxx.u.biztel.jp:8000/monitor_link/ BIZTEL録音ファイル共通URL
    ※BIZTELの契約に応じて設定してください。

2.1.3.3 コールアクション設定

コールアクション連携制御を利用するにあたり、必要なアクション設定を行います。

以下の画面から設定を行ってください。

設定画面
[オプション　>　連携オプション　>　コールアクション連携]

  • 以下のコールアクション（コールセンター応答 実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 コールセンター応答 ○
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/auth/login
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ {
    "username":"{QUEUE_VALUE_SSM_USERNAME}",
    "password":"{QUEUE_VALUE_SSM_PASSWORD}"
    }    		 ユーザーID
    ユーザーパスワード
    タイムアウト判定（秒） 10
    変数抽出パターン /"access_token":"(?P<ACCESS_TOKEN>.*)",/ アクセストークン
    メモ SSMログインAPI連携

  • 以下のコールアクション（コールセンター応答実行順2）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 コールセンター応答 ○
    実行順 2
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/ci_types/{QUEUE_VALUE_CI_TYPE_ID}/items?ci_target={QUEUE_VALUE_CI_TARGET}&tel_number={TEL} QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
    TEL：着信電話番号
    メソッド GET
    リクエストヘッダ Accept: application/json
    Authorization:Bearer
    リクエストヘッダボディ
    タイムアウト判定（秒） 10
    変数抽出パターン /"ci_id":\s*"(?P<CI_ID>[^"]*)"/ CI_ID：構成アイテムID
    メモ 複数の構成アイテム情報の取得API連携

  • 以下のコールアクション（コールセンター応答実行順3）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 コールセンター応答 ○
    実行順 3
    判定用コード {RESPONSE_CI_ID} RESPONSE_CI_ID：構成アイテムID
    判定評価パターン /^.+$/
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes QUEUE_VALUE_PROCESS_TYPE_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer
    リクエストヘッダボディ 例)
    {
    "system_name": "{QUEUE_VALUE_SYSTEM_NAME}",
    "status": "{QUEUE_VALUE_STATUS}",
    "title":"
    {START_TIME.DATE_FORMAT(m)}月{START_TIME.DATE_FORMAT(d)}日{START_TIME.DATE_FORMAT(H)}時{START_TIME.DATE_FORMAT(i)}分に通話（着信）",
    "tel_number":"{TEL}",
    "related_config_1": [{
    "related_config_1_ci_type_id": "{QUEUE_VALUE_CI_TYPE_ID}",
    "related_config_1_ci_id": "{RESPONSE_CI_ID}",
    "related_config_1_ci_system": "{QUEUE_VALUE_SYSTEM_NAME}"
    }]
    }    		 QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
    RESPONSE_CI_ID：構成アイテムID
    QUEUE_VALUE_SYSTEM_NAME：システム名
    タイムアウト判定（秒） 10

  • 以下のコールアクション（コールセンター応答実行順4）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加設定
    イベント種別 コールセンター応答 ○
    実行順 4
    判定用コード {RESPONSE_CI_ID} RESPONSE_CI_ID：構成アイテムID
    判定評価パターン /^$/
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes QUEUE_VALUE_PROCESS_TYPE_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer
    リクエストヘッダボディ 例)
    {
    "system_name": "{QUEUE_VALUE_SYSTEM_NAME}",
    "status": "{QUEUE_VALUE_STATUS}",
    "title":"
    {START_TIME.DATE_FORMAT(m)}月{START_TIME.DATE_FORMAT(d)}日{START_TIME.DATE_FORMAT(H)}時{START_TIME.DATE_FORMAT(i)}分に通話（着信）",
    "tel_number":"{TEL}"
    }    		 QUEUE_VALUE_SYSTEM_NAME：システム名
    タイムアウト判定（秒） 10
    変数抽出パターン /"process_id":\s*"(?P<PROCESS_ID>[^"]*)"/ RESPONSE_PROCESS_ID：プロセスID
    メモ プロセスの登録API連携
    (関連構成登録なし)

  • 以下のコールアクション（コールセンター応答実行順5）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 コールセンター応答 ○
    実行順 5 ○
    API連携種別 マニュアル ○
    URL https://biztel001.ssm.com /ssm/api/ProcessEdit/send ○
    メソッド POST ○
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer    		 ○
    リクエストヘッダボディ 例)
    {
    "AccountID": "{AGENT_ACCOUNT}",
    "DataType": "{QUEUE_VALUE_PROCESS_TYPE_ID}",
    " AccessToken":"{RESPONSE_ACCESS_TOKEN}",
    " Url":"{RESPONSE_ACCESS_URL}"
    }    		 AGENT_ACCOUNT：BIZTELで受話したユーザーのアカウントID
    QUEUE_VALUE_PROCESS_TYPE_ID：プロセス管理画面ID
    RESPONSE_ACCESS_URL：アクセスURL
    RESPONSE_ACCESS_TOKEN：アクセストークン    		 ○
    タイムアウト判定（秒） 10 ○
    変数抽出パターン ○
    メモ プロセス編集画面表示のAPI連携 ○

  • 以下のコールアクション（録音完了実行順1）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 録音完了／音声認識連携完了
    実行順 1
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/auth/login
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    リクエストヘッダボディ {
    "username":"{QUEUE_VALUE_SSM_USERNAME}",
    "password":"{QUEUE_VALUE_SSM_PASSWORD}"
    }    		 ユーザーID
    ユーザーパスワード
    タイムアウト判定（秒） 10
    変数抽出パターン /"access_token":"(?P<ACCESS_TOKEN>.*)",/ アクセストークン
    メモ SSMログインAPI連携

  • 以下のコールアクション（録音完了実行順2）連携情報を新規登録します。

    項目名称 項目値 Senju Service Manage連携対象項目 追加項目
    イベント種別 録音完了／音声認識連携完了
    実行順 2
    API連携種別 マニュアル
    URL https://biztel001.ssm.com:49152/api/process_types/{QUEUE_VALUE_PROCESS_TYPE_ID}/processes/{RESPONSE_PROCESS_ID}/progresses QUEUE_VALUE_PROCESS_TYPE_ID：プロセス管理画面ID
    RESPONSE_PROCESS_ID：プロセスID
    メソッド POST
    リクエストヘッダ Content-Type:application/json
    Authorization:Bearer
    リクエストヘッダボディ 例)
    {
    "title": "通話情報",
    "rich_text": "{VOICE_LOG}",
    "text_1": "{TEL}",
    "text_2": "{ANSWER_NO}",
    "text_3": "{EXTEN_NO}",
    "text_4": "{CALL_SEC}",
    "textarea_1": "{QUEUE_VALUE_VOICE_URL}{ID}",
    "response_target": "{AGENT_NAME}",
    "response_date": "{START_TIME.DATE_FORMAT(Y)}{START_TIME.DATE_FORMAT(m)}{START_TIME.DATE_FORMAT(d)}",
    "response_time": "{START_TIME.DATE_FORMAT(H)}{START_TIME.DATE_FORMAT(i)}{START_TIME.DATE_FORMAT(s)}",
    "progress_date_text_1": "{END_TIME.DATE_FORMAT(Y)}{END_TIME.DATE_FORMAT(m)}{END_TIME.DATE_FORMAT(d)}",
    "progress_time_text_1": "{END_TIME.DATE_FORMAT(H)}{END_TIME.DATE_FORMAT(i)}{END_TIME.DATE_FORMAT(s)}"
    }    		 VOICE_LOG：音声テキスト化データ
    TEL：発信電話番号
    ANSWER_NO：着信電話番号
    EXTEN_NO：内線番号
    CALL_SEC：通話時間
    AGENT_NAME：着信アカウント名
    START_TIME：通話開始時間
    END_TIME通話終了時間
    タイムアウト判定（秒） 10
    メモ プロセス経過の登録API連携

2.2 Senju Service Managerの設定

BIZTEL連携機能を利用するにあたり、Senju ServiceManagerで連携用のユーザーを新規作成する必要があります。

2.2.1 通話記録のプロセス登録

2.2.1.1 BIZTEL連携用のユーザー設定

BIZTEL連携機能の際に通話記録を登録する連携用ユーザーの設定を行います。

以下の画面からアカウントの新規登録を行ってください。

新規登録画面
[管理者メニュー　>　ユーザー　>　ユーザーマスタ管理　>　新規登録]

  • 以下のユーザーを新規登録します。

    項目名称 項目値
    ユーザーID 例) user1
    画面ポリシー 全画面利用可能
    アカウント区分 サービスデスクユーザー(固定)
    社員番号 例) user1
    氏名 例) ユーザー1
    システム×職責 例) SSM初期システム－全機能利用可能

制限事項

ここで登録したSenju Service ManagerのユーザーIDはBIZTELのAPIカスタム項目にあらかじめ設定したユーザー情報と合わせてください。

2.2.1.2 BIZTEL連携用のプロセス管理レイアウトの設定

BIZTEL連携の際に、通話記録を登録するプロセスに、必要な項目をレイアウト配置します。

以下の画面から画面レイアウトを設定してください。

設定画面
[管理者メニュー　>　画面　>　レイアウト定義　>　サービスデスク画面レイアウト　>　サービスデスク画面レイアウト一覧　>　プロセスビュー]

詳細レイアウト（項目）タブを選択して、必要な項目をレイアウト配置します。

親ブロックに下記の項目を配置してください。

項目名称
システム名
ステータス
タイトル
（社外申請者情報）電話番号

BIZTELから連携される情報は以下の通り連携されます。 情報内容に応じて各項目のラベルを変更して、レイアウトを更新してください。

項目名称 BIZTEL連携情報名 ラベル名
システム名 QUEUE_VALUE_SYSTEM_NAME：システム名 例）システム
ステータス QUEUE_VALUE_STATUS：ステータス 例）ステータス
タイトル START_TIME：通話開始時間 例）タイトル
(社外申請者情報)電話番号 TEL：発信電話番号 例）発信電話番号

詳細レイアウト（項目）タブを選択して、必要な項目をレイアウト配置します。
経過情報ブロックに下記の経過項目を配置してください。

項目名称
タイトル
対応日
対応時刻
対応先
内容
テキスト1
テキスト2
テキスト3
テキスト4
日付テキスト1
時刻テキスト1
テキストエリア1

BIZTELから連携される情報は以下の通り連携されます。
情報内容に応じて各項目のラベルを変更して、レイアウトを更新してください。

項目名称 BIZTEL連携情報名 ラベル名
タイトル 通話情報 ※固定値 例）タイトル
対応日 START_TIME：通話開始時間 例）通話開始日
対応時刻 START_TIME：通話開始時間 例）通話開始時刻
対応先 AGENT_NAME：着信アカウント名 例）電話対応者
経過内容(リッチテキスト) VOICE_LOG：音声テキスト化データ 例）内容
テキスト1 TEL：発信電話番号 例）発信電話番号
テキスト2 ANSWER_NO：着信電話番号 例）着信電話番号
テキスト3 EXTEN_NO：内線番号 例）内線番号
テキスト4 CALL_SEC：通話時間 例）通話時間
日付テキスト1 END_TIME：通話終了時間 例）通話終了日
時刻テキスト1 END_TIME：通話終了時間 例）通話終了時刻
テキストエリア1 QUEUE_VALUE_VOICE_URL：録音URL
ID：録音ID		 例）録音ファイルURL

2.2.2 顧客情報の紐づけ

2.2.2.1 BIZTEL連携用のユーザー設定

「2.2.1 通話記録のプロセス登録」から変更ありません。

2.2.2.2 BIZTEL連携用のプロセス管理レイアウトの設定

BIZTEL連携の際に、通話記録を登録するプロセスに、必要な項目をレイアウト配置します。
以下の画面から画面レイアウトを設定してください。

設定画面
[管理者メニュー　>　画面　>　レイアウト定義　>　サービスデスク画面レイアウト　>　サービスデスク画面レイアウト一覧　>　プロセスビュー]

詳細レイアウト（項目）タブを選択して、必要な項目をレイアウト配置します。
親ブロックに下記の項目を配置してください。

項目名称
システム名
ステータス
タイトル
（社外申請者情報）電話番号
関連構成1

BIZTELから連携される情報は以下の通り連携されます。
情報内容に応じて各項目のラベルを変更して、レイアウトを更新してください。

項目名称 BIZTEL連携情報名 ラベル名 追加設定
システム名 QUEUE_VALUE_SYSTEM_NAME：システム名 例）システム
ステータス QUEUE_VALUE_STATUS：ステータス 例）ステータス
タイトル START_TIME：通話開始時間 例）タイトル
(社外申請者情報)電話番号 TEL：発信電話番号 例）発信電話番号
関連構成1 QUEUE_VALUE_CI_TYPE_ID：構成管理画面ID
RESPONSE_CI_ID：構成アイテムID
QUEUE_VALUE_SYSTEM_NAME：システム名		 例）顧客情報 ○

経過情報ブロックに下記の経過項目を配置してください。

項目名称
タイトル
対応日
対応時刻
対応先
内容
テキスト1
テキスト2
テキスト3
テキスト4
日付テキスト1
時刻テキスト1
テキストエリア1

BIZTELから連携される情報は以下の通り連携されます。
情報内容に応じて各項目のラベルを変更して、レイアウトを更新してください。

項目名称 BIZTEL連携情報名 ラベル名 追加項目
タイトル 通話情報 ※固定値 例）タイトル
対応日 START_TIME：通話開始時間 例）通話開始日
対応時刻 START_TIME：通話開始時間 例）通話開始時刻
対応先 AGENT_NAME：着信アカウント名 例）電話対応者
経過内容(リッチテキスト) VOICE_LOG：音声テキスト化データ 例）内容
テキスト1 TEL：発信電話番号 例）発信電話番号
テキスト2 ANSWER_NO：着信電話番号 例）着信電話番号
テキスト3 EXTEN_NO：内線番号 例）内線番号
テキスト4 CALL_SEC：通話時間 例）通話時間
日付テキスト1 END_TIME：通話終了時間 例）通話終了日
時刻テキスト1 END_TIME：通話終了時間 例）通話終了時刻
テキストエリア1 QUEUE_VALUE_VOICE_URL：録音URL
ID：録音ID		 例）録音ファイルURL

2.2.2.3 BIZTEL連携用の構成情報設定

BIZTEL連携の際に、電話番号に紐づく顧客レコードを構成管理に登録します。

以下の画面から構成アイテムの新規登録を行ってください。

新規登録画面
[通常メニュー　>　構成管理　>　構成管理アイテム　>　新規登録]

  • 以下の構成アイテムを新規登録します。

    項目名称 項目値
    構成アイテムID 例) BIZTEL_item1
    構成アイテム名 例) BIZTEL連携顧客1
    システム 例) SSM初期システム
    構成変更日 例) 2025/03/01
    構成変更時刻 例) 1200
    システム×職責 例) SSM初期システム－全機能利用可能
    会社名 例) 会社1
    組織名 例) 組織1
    氏名 例) ユーザー1
    電話番号 例) 08012345678 ※BIZTEL側の連絡電話番号

仕様説明

ユーザーズガイドの「2.4.9 構成管理を使用する」を参照して、該当の構成管理レコードを承認反映し、現在の構成の構成管理データとして登録してください。

2.2.3 通話記録編集画面の表示

2.2.3.1 BIZTEL連携用のユーザー設定

「2.2.1 通話記録のプロセス登録」から変更ありません。

2.2.3.2 BIZTEL連携用のプロセス管理レイアウトの設定

「2.2.2 顧客情報の紐づけ」から変更ありません。

2.2.3.3 BIZTEL連携用の構成情報設定

「2.2.2 顧客情報の紐づけ」から変更ありません。

2.2.3.4 通話記録編集画面の表示のための初期設定

BIZTEL連携で通話記録を登録したプロセス編集画面をポップアップする機能を利用するために、WebSocket機能の設定をします。

Senju Service Managerの画面で制御情報「WebSocket機能利用設定」を「利用する」に設定をします。

・[管理者メニュー　>　制御情報　>　制御情報　>　共通　>　共通]

管理項目名
WebSocket機能利用設定

上記の設定の完了後、WEBサーバーのIISを再起動します。

次にAPI連携機能ガイド「6.7 サーバーマネージャーの設定」を参照して Senju Service ManagerのWEBサーバーのサーバーマネージャーから WebSocketプロトコルの役割を追加してください。

最後に「5.3 WEBアプリケーションの設定変更」の「8. アクセスURLの取得には以下を設定します。」を参照してSSMWEBAPIでアクセスURL項目を取得できるように設定し、 Apacheを再起動します。

2.2.3.5 BIZTELエージェントと紐づくログインアカウントの作成

BIZTEL連携機能の際に通話記録編集画面を表示するユーザーの設定を行います。
以下の画面からアカウントの新規登録を行ってください。

新規登録画面
[管理者メニュー　>　ユーザー　>　ユーザーマスタ管理　>　新規登録]

  • 以下のユーザーを新規登録します。

    項目名称 項目値
    ユーザーID 例) user2
    画面ポリシー 全画面利用可能
    アカウント区分 サービスデスクユーザー(固定)
    社員番号 例) user2
    氏名 例) ユーザー2
    システム×職責 例) SSM初期システム－全機能利用可能

制限事項

ここで登録するSenju Service Managerの「ユーザーID」はBIZTEL側で応答が可能なエージェントの「アカウント」と合わせてください。

登録完了後、作成したユーザーでSenju Service Managerにログインをしてください。
画面の左上にBIZTEL連携のアイコンが緑色で表示されていることが確認できれば、WebSocketの設定は完了です。