| 目的 |
ソフトフォンでの発着信に応じ、特定の通話情報をCRM(顧客管理ツール)などの外部ツールに引き渡す設定が可能です。 |
|---|---|
| 対象プラン |
|
| 用語 |
|
| ポイント |
・本機能をご利用頂く場合、「CRM連携」オプションのご契約が必要です。 |
目次
1. ご利用中のBIZTELバージョンの確認方法
※ 本マニュアルでは、BIZTELバージョン 3.2.X 以降を対象としています。
BIZTEL管理画面より「システム設定」>「ライセンス設定」>「バージョン」をご参照ください。
下図の場合、BIZTELサーバのバージョンは「3.4.23」になります。
2. CRM連携設定例
● 想定動作
着信時にお客様の発信元電話番号から、CRM上で検索を行い、検索結果を表示する。
● イメージ図
2.1 基本設定について
手順1.ソフトフォン上の「設定」をクリックします。
※ソフトフォンバージョン 3.6.X 以降をご利用のお客様は「歯車」アイコンをクリックしてください。
手順2.「CTI設定」>「基本設定」より、画像赤枠内の項目を設定します。
| 連携対象電話番号 | 着信時にCRMと連携する電話番号にチェックを入れます。 |
|---|---|
| 画面サイズ | 標準・大のいずれかにチェックします。 「表示しない」を選択した場合、着信通知が行われません。 |
※その他の項目の機能詳細は「5.「CTI設定」メニューの設定」をご参照ください。
※自身の内線番号にチェックを付けた場合、以下の場合に着信通知が動作します。
・自身の内線宛に着信があった場合
・(BIZTELバージョン3.10.0 未満のみ)モニタリング・ささやき機能により、システム番号(9999)から着信があった場合
2.2 CRM選択の設定について
手順1.「CTI設定」>「CRM連携」より画像赤枠内の項目を設定します。
※下記表を参考に必要事項を設定ください。
| 認証/検索設定 (その他CRM) |
Salesforce以外のCRMと連携する場合、この項目にチェックを入れてください。 | |
|---|---|---|
| 認証アクセス |
メソッド |
HTTP GET内部処理 標準ブラウザでGETパラメータを送信します。 HTTP POST処理 標準ブラウザでPOSTパラメータを送信します。 OSコマンド スクリプトや実行ファイルを呼び出します。 |
|
認証アクセス |
連携対象となるCRMに、「ID」「パスワード」を引数として渡し、ログインするための構文を入力します。 設定例 |
|
| 認証レスポンスフォーマット |
認証アクセスの返却値を格納するパラメータをお客様自身で変数を定義します。 ・Content-Type ヘッダの charset で指定された文字セットで評価します。 ・レスポンスフォーマットは区切りで記載します。 ・外部サーバからのレスポンスをレスポンスフォーマットに記載された書式に従って文字列を抽出し、変数に格納することが可能です。 ・返却されるContent-Typeはtext/plainで出力される必要があります。 ・エスケープ文字は非対応です。 |
|
| 検索アクセス |
メソッド |
HTTP GET内部処理 標準ブラウザでGETパラメータを送信します。 HTTP POST処理 標準ブラウザでPOSTパラメータを送信します。 OSコマンド スクリプトや実行ファイルを呼び出します。 |
|
検索アクセス |
連携対象となるCRMシステムに電話番号等のパラメータを渡し、顧客検索を行うための構文を入力します。 設定例 |
|
| 検索レスポンスフォーマット |
検索アクセスの返却値を格納するパラメータを指定します。 ・Content-Type ヘッダの charset で指定された文字セットで評価します。 ・レスポンスフォーマットは区切りで記載します。 ・外部サーバからのレスポンスをレスポンスフォーマットに記載された書式に従って文字列を抽出し、変数に格納することが可能です。 ・返却されるContent-Typeはtext/plainで出力される必要があります。 ・エスケープ文字は非対応です。 ・改行コードとして、{CRLF}、{CR}、{LF}が利用可能です。 |
|
※BIZTELバージョン 3.11.0 まで、「認証/検索設定(その他CRM)」が有効かつ「検索アクセス」の値が空欄の場合、電話帳の登録内容が着信通知に表示されません。
「認証/検索設定(その他CRM)」を利用しない場合はチェックを外してください。
レスポンス、レスポンスフォーマット例
例1)レスポンスから{NAME}、[COMPANY]の値を抽出する
レスポンス例
<html>
<head>
<meta charset="utf-8">
</head>
<body>
,BIZTEL太郎,株式会社リンク,
</body>
</html>
※{NAME}がBIZTEL太郎、{COMPANY}が株式会社リンク
レスポンスフォーマット例
,{NAME},{COMPANY},
例2)レスポンスから自身で定義した値を抽出する
レスポンス例
USERID="BIZTEL",SESSIONID="sess202303021500"
※{USERID}、{SESSIONID}を定義したとします。
レスポンスフォーマット例
USERID="{UID}",SESSIONID="{SESID}"
例3)レスポンスから自身で定義した値を抽出する
レスポンス例
USERID=BIZTEL<LF>
※{USERID}を定義したとします。
※{LF}は改行コード。
2.3 動作設定について
CRMとの連携時の詳細動作は、「動作設定」より設定を行います。
※必須項目ではありませんので、必要に応じご設定ください。
利用可能メソッド
| HTTP GET | 標準ブラウザでGETパラメータを送信します。 ※ブラウザが起動します。 |
|---|---|
| HTTP GET内部処理 | 標準ブラウザでGETパラメータを送信します。 ※ブラウザが起動しません。 |
| HTTP POST | 標準ブラウザでPOSTパラメータを送信します。 ※ブラウザが起動します。 |
| HTTP POST内部処理 | 標準ブラウザでPOSTパラメータを送信します。 ※ブラウザが起動しません。 |
| OSコマンド |
Windowsのスクリプトや実行ファイルを呼び出します。 例)C:\Program Files にある sample.exe を起動する場合 例)C:\Program Files にある sample.exe に引数 {TEL}、{CALLED} を渡して起動する場合、起動プログラムを””で括ります。 |
アクセス設定
| 着信時のアクセス設定 | |
|---|---|
| クリック時アクセス | 着信ポップアップをクリックしたタイミングで参照します。 |
| 着信時アクセス | ソフトフォンに着信したタイミングで参照します。 |
| 応答時アクセス | ソフトフォンに着信し、応答したタイミングで参照します。 |
| 応答時アクセス実行までの待機時間(秒) | 応答時アクセスを実行するまでの待機時間を指定します。 |
| 切断時アクセス | 自分が着信者の場合かつソフトフォンで通話を切断したタイミングで参照します。 |
| 応答したときのみ切断時アクセスを実行する | 切断時アクセスの実行を自分が着信に応答した場合だけに限定する場合にチェックします。 |
| 発信時のアクセス設定 | |
| 発信時アクセス | ソフトフォンで発信したタイミングで参照します。 |
| 発信応答時アクセス | ソフトフォンで発信し、発信先が応答したタイミングで参照します。 |
| 発信切断時アクセス |
自分が発信者の場合かつソフトフォンで通話を切断したタイミングで参照します。 なお、BIZTELバージョンにより動作が異なります。 BIZTELバージョン 3.11.10 未満 BIZTELバージョン 3.11.10 以降 |
| 応答したときのみ切断時アクセスを実行する | 発信先の応答に関わらず発信切断時に外部システムを動作させたい場合はチェックします。 |
| 転送時アクセス設定 | |
| 転送時アクセス | 自分が発信者の場合かつソフトフォンで転送したタイミングで参照します。 |
| 転送応答時アクセス | 自分が発信者の場合かつソフトフォンで転送し、相手が応答したタイミングで参照します。 |
| 転送完了時アクセス | 自分が発信者の場合かつソフトフォンで転送し、転送が完了したタイミングで参照します。 |
| 転送切断時アクセス |
自分が発信者の場合かつソフトフォンで転送し、転送通話が終了したタイミングで参照します。 以下パターンの場合に動作します。 |
| 応答した時のみ転送アクセスを実行する | 発信先の応答にかかわらず、転送切断時に外部システムを動作させたい場合、この項目にチェックを入れます。 |
3. 利用可能なパラメータ・関数
以下のパラメータ、関数が利用可能です。
3.1 利用可能なパラメータ
| CRMへ連携可能なパラメータ | |
|---|---|
| {TEL} |
発信者の電話番号を展開します。外線・内線ともに以下のとおり動作します。 着信時:発信元の電話番号を展開します。 発信時:ソフトフォン上で指定した通知番号を展開します。 |
| {ORIGINAL_TEL} |
最初の発信者の電話番号を展開します。 外線着信時:発信元の電話番号を展開します。 外線発信時:通知番号にかかわらず、発信者の内線番号を展開します。 内線着信時:発信元の電話番号を展開します。 内線発信時:ソフトフォン上で指定した通知番号を展開します。 ※BIZTELバージョン 3.12.10以降で利用可能です。 |
| {TELNAME} |
共有電話帳・端末電話帳から取得される発信者名を展開します。 |
| {CALLED} |
宛先電話番号を展開します。外線・内線ともに以下のとおり動作します。 着信時:発信者が発信先に指定した番号を展開します。 ※システム設定により「コールセンター着信番号表示設定」や「着信グループ着信番号表示」を「設定する」にしている場合、「着信先コールセンターまたは着信グループの内線番号」を展開します。 |
| {ORIGINAL_CALLED} |
最初の発信者が発信先に指定した電話番号を展開します。 外線着信時:システム設定の内容にかかわらず、発信者が発信先に指定した番号が展開されます。 内線着信時: 発信者が発信先に指定した番号を展開します。 ※BIZTELバージョン 3.12.10以降で利用可能です。 |
| {CALLEDNAME} | 共有電話帳・端末電話帳から取得される着信者名を展開します。 |
| {ID} | 通話のリクエストIDを展開します。 |
| {SVADDR} | サーバアドレス(https://{BIZTELサーバIP}:8000/)を展開します。 |
| {AID} | アカウントを展開します。 ※アカウントがエージェント設定を「利用する」になっている場合のみ有効 |
| {APW} | アカウントパスワードを展開します。 ※アカウントがエージェント設定を「利用する」になっている場合のみ有効 |
| {EXT} |
サインイン端末(アカウント > エージェント > サインイン端末)もしくは、 ※どちらも登録されている場合、サインイン端末が優先されます。 |
| {SFID} |
BIZTELバージョンにより動作が異なります。 BIZTELバージョン 3.9.X まで BIZTELバージョン 3.10.0 以降 |
| {SFSID} | Salesforce連携時のセッションIDを展開します。 |
| {SFAPI} | Salesforce連携時のAPIサーバ名を展開します。 |
| {DATE-YYYY} | 年(4桁)を展開します。 |
| {DATE-MM} | 月(2桁)を展開します。 |
| {DATE-DD} | 日(2桁)を展開します。 |
| {DATE-HH} | 時(2桁)を展開します。 |
| {DATE-II} | 分(2桁)を展開します。 |
| {DATE-SS} | 秒(2桁)を展開します。 |
| {BUSINESS} | 業務ラベルの名称を展開します。 ※BIZTELバージョン 3.3.20以降で利用可能です。 詳細は「1.業務ラベル」をご参照ください。 |
|
CRMから返却された値を格納するパラメータ |
|
| {COMPANY} | 連携先のCRMから取得した会社名を格納します。 |
| {NAME} | 連携先のCRMから取得した名前を格納します。 |
| {EXT_ID} |
任意コードです。 |
| {ARG1}~{ARG9} |
任意コードです。 外部CRMのプライマリキー等、任意の結果を保存します。 ※Salesforce連携では利用できません。 ※その他CRM連携では、検索アクセスで解決します。 (例:OSコマンドからVBSやPHP等を実行することで解決) |
3.2 利用可能な関数
| MD5() |
()内の文字列をMD5でハッシュ化し、大文字出力します。 |
|---|---|
| SHA256() | ()内の文字列をSHA256でハッシュ化し、大文字出力します。 例)MD5(abc) → BA7816BF8F01CFEA414140DE5DAE2223B00361A396177A9CB410FF61F20015AD |
| LOWERCASE() | ()内の文字列を小文字にします。 |
| UPPERCASE() | ()内の文字列を大文字にします。 |
4. 発信元電話番号をGoogle検索する設定例
「2.3 動作設定について」の設定を用いて、着信時に発信元電話番号をGoogle検索する設定例を紹介します。
手順1.ソフトフォンの「設定」アイコンをクリックします。
※ご利用中のソフトフォンバージョンにより、アイコン表示が異なります。
画面右上の歯車アイコン、または「設定」と記載のボタンをクリックしてください。
手順2.「CTI設定」>「基本設定」で、以下の項目を入力します。
| 連携対象番号 | 着信時に検索動作を実行する電話番号にチェックを入れます。 |
|---|---|
| 画面サイズ | 標準・大のいずれかにチェックします。 「表示しない」を選択した場合、着信通知が行われません。 |
手順3.「CTI設定」>「動作設定」で、以下の項目を入力します。
| 着信時アクセス | ソフトフォンに着信した時点でGoogle検索を行う場合、「着信時アクセス」にチェックを入れます。 |
|---|---|
| メソッド | HTTP GET を選択します。 |
| 構文 | https://www.google.com/search?q={TEL} と入力します。 |
設定完了後、連携対象番号に設定した電話番号に着信すると、発信元電話番号をGoogle上で検索するブラウザが起動します。
5. 関連マニュアル
ソフトフォンの設定内容に関するマニュアルは以下をご参照ください。
2.「ソフトフォン」メニューの設定(BIZTELバージョン 3.3.X 以降)