IVRの機能を利用して外部CRMと連携を行います。

BIZTELサーバと外部CRMとのサーバ連携を行う機能となります。

お客様からの着信がBIZTELサーバに入った際にIVR機能を用いて、音声認識もしくは、プッシュ操作後(プッシュ操作なし設定も可能)に外部CRMのWebAPIを実行し、APIの結果に基づき音声ガイダンスを流したり、会員専用コールセンターへ着信をさせたりすることが可能です。

【外部CRM】
外部CRMとは顧客管理のためのシステムとなり、各CRMベンダーより提供されているサービスとしてSalesforce、Kintoneなどがあります。

【WebAPI】

インターネットを経由した標準的なWeb技術を利用した各サービス(BIZTELでは外部CRM)と連携するためのCRM側のインターフェースとなります。 各CRMごとにWebAPIで用いるパラメーターは異なっており、それぞれのCRMサービスで仕様を公開しています。

・本機能をご利用頂くには、「API連携IVR」のオプション契約が必要です。
※外部連携先の基本契約ライセンスの追加・変更等が必要な場合がございます。
　お客様の契約状況によって異なりますので、詳しくはこちらのフォームよりお問い合わせください。

・OAuth認証を用いてWebAPIへ連携する場合は、「オプション」 > 「OAuthアカウント」の事前登録が必要となります。

・API連携IVRをSalesforceで利用するにはOAuth認証が必須となります。

※「連携オプション」>「Salesforceアカウント設定」はSalesforce履歴連携メニュー用となり、API連携IVRには対応しておりません。

※「連携オプション」>「音声認識連携」は音声認識連携メニュー用(発着信履歴・コールセンター履歴に音声認識結果のテキストデータを表示する機能)となり、API連携IVR(音声認識)には対応しておりません。

着信した業務ラベルを取得します。
※業務ラベルの詳細は「1.業務ラベル」を参照ください。
※BIZTELバージョン 3.4.0 以降で利用可能です。

変数展開結果の文字列に対して、引数の開始位置から開始するように前部分を切り落とします。

例）
{CALLED.START(3)}と入力した場合、CALLEDの値が 09012341234 とすると、「12341234」が得られる

※BIZTELバージョン 3.7.20 以降、正数のみ利用可能です。

変数展開結果の文字列に対して、文末から引数の文字数の文字を削除します。

例）
{CALLED.END(4)}と入力した場合、CALLEDの値が 09012341234 とすると、「0901234」が得られる

※BIZTELバージョン 3.7.20 以降で利用可能です。
※正数のみ利用可能です。

変数展開結果の文字列に対して、左から引数の値の文字を抽出します。

例）{CALLED.LEFT(3)}と入力した場合、CALLEDの値が 09012341234 とすると、「090」が得られる

※BIZTELバージョン 3.7.20 以降で利用可能です。
※正数のみ利用可能です。

変数展開結果の文字列に対して、右から引数の値の文字を抽出します。

例）{CALLED.LEFT(3)}と入力した場合、CALLEDの値が 09012341234 とすると、「1234」が得られる

※BIZTELバージョン 3.7.20 以降で利用可能です。
※正数のみ利用可能です。

日付形式の文字列に対して日付形式の変更や、日付の変更を実施する
PHP の date_format()と、2 個めの引数が設定されていれば modify()を適用する

・format の入力形式は下記とする
https://www.php.net/manual/ja/function.date.php

・modify の入力形式は下記を参考にすること
https://www.php.net/manual/ja/function.strtotime.php

※上記いずれの引数は半角英数字、半角スペース、以下の記号 / : . + - のみ使用することができる
上記参考リンク内で指定されている形式でも↑の文字以外のものは使用できない

URL内で変数展開を実施する場合、変数展開される文字列に自動でURLエンコードが実施される。
そのエンコードを回避する為に RAW() 変数を使用。

変数展開時の内容をエスケープ処理済みの文字列にすることが可能です。

標準API連携

外部CRMとのAPI連携を利用する場合に選択します。

チャットボット連携（DEC Support）

チャットボット（DEC Support）とのAPI連携を利用する場合に選択します。
※「チャットボット連携」のオプション契約が必要です。
※チャットボット連携の詳細は「1.チャットボット連携」を参照ください。

以下から、入力種別を選択します。
ダイヤル入力　：ユーザがダイヤル入力でIVRを操作する際に選択します。
音声認識（※）：ユーザが音声でIVRを操作する際に選択します。
入力なし　　　：IVRの入力を必要としない場合に選択します。

※BIZTELバージョン 3.3.0 以降で利用可能です。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。
※BIZTELバージョン 3.7.0 以降、音声認識を選択した場合に「操作ガイダンス」の設定で「選択なし」を選択可能です。

ユーザ入力値の桁数上限を指定します。
１ ~ 30桁で指定します。
※受付入力種別で「ダイヤル入力」を選択している場合に表示されます。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

ユーザ入力値に対してパターンチェックを正規表現で指定します。
※受付入力種別が「入力なし」の場合、ダイヤル入力をスキップしてAPIリクエストを行います。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

IVRに対して、音声で回答可能な時間（秒）を設定します。
※音声認識連携のオプション契約が必要です。
※受付入力種別で「音声認識」を選択している場合に表示されます。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

以下から、入力種別を選択します。
ダイヤル入力　：ユーザがダイヤル入力でIVRを操作する際に選択します。
音声認識（※）：ユーザが音声でIVRを操作する際に選択します。
入力なし　　　：IVRの入力を必要としない場合に選択します。

※BIZTELバージョン 3.3.0 以降で利用可能です。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

ユーザ入力値の桁数上限を指定します。
１ ~ 30桁で指定します。
※受付入力種別で「ダイヤル入力」を選択している場合に表示されます。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

IVRに対して、音声で回答可能な時間（秒）を設定します。
※音声認識連携のオプション契約が必要です。
※受付入力種別で「音声認識」を選択している場合に表示されます。
※BIZTELバージョン 3.6.0 以降では、新規作成時の画面内で設定します。

API実行後、返却されたレスポンスコードに対して、エラー判定する正規表現を設定します。

※未入力の場合、400～599をエラー判定します。

振り分け分岐の条件を「レスポンスボディ内の文字列と指定正規表現とのマッチ」と
する場合の正規表現を指定します。

※BIZTELバージョン 3.8.12 まで、255文字以内での入力となります。
※BIZTELバージョン 3.8.20 以降、1,000文字以内での入力となります。

APIレスポンス値を変数化して保持する場合にチェック対象とする正規表現を指定します。

（PHPのPCRE正規表現形式）

具体的には、正規表現パターン内のサブパターン（正規表現内で()で囲まれた箇所、
グループ）箇所を順次抽出し、データベースに格納します。
データベースに格納されたデータは同一の通話内であれば以降の API の変数展開箇所にて
使用可能です。

例：顧客情報レコード ID を取得する API を実施し ID を取得、
　　以降の API でその ID を使用し顧客情報レコードを更新する

※●変数抽出パターンの補足があります。

※BIZTELバージョン 3.8.12 まで、255文字以内での入力となります。
　BIZTELバージョン 3.8.20 以降、1,000文字以内での入力となります。
※BIZTELバージョン 3.9.0 以降、変数抽出パターンにおいて変数展開文字列の利用が可能です。

該当のIVRを経由する場合に業務ラベルを付与することが可能です。
※BIZTELバージョン 3.7.0 以降で表示される項目です。
※業務ラベルを設定する場合、業務ラベルの関連先紐づけされます。
　詳細は「2.業務ラベル（BIZTELバージョン 3.5.0 以降）」を参照ください。

API連携後に流すガイダンスの形式を指定します。
※「リアルタイム音声合成」のオプション契約時のみ表示されます。

API連携後ガイダンスを動的に流す場合に合成の基となるテキストを指定します。
作成済みのガイダンス以外に「ユーザ入力値」や「APIレスポンス値」が格納された
IVR変数を利用して、動的なガイダンスを流すことができます。

※半角スペース、全角スペースのみでの登録はできませんのでご注意ください。

転送

指定の転送先へ転送することが可能です。

着信ルール

設定した共通着信ルールを動作させる事が可能です。

操作ガイダンスに戻る

再度、操作ガイダンスを再生します。

IVRエラー判定

操作エラーの1回として判定します。
※BIZTELバージョン 3.4.10 以降で選択可能です。

動作させる着信ルールを選択します。

※選択時の動作で「着信ルール」を選択すると表示されます。

格納データはサブパターンの順番に９個までデータが格納され、
以降の API連携IVRの処理実行における変数展開時に{CODE1}〜{CODE9}の文字列を指定すると使用可能です。
変数抽出パターンに記載の例だと{CODE1}に"Name"が、{CODE2}に"TestValue"が格納されます。

変数抽出パターンを作成するためには、外部CRMのWebAPIから得られる実際のレスポンスボディデータを確認する必要があります。
Postman などの API 実行ソフトウェアで外部CRMのWebAPIを実行すると、レスポンスボディ内容を取得可能です。

※取得したレスポンスボディ内容に対して、正規表現を適用した結果を見られる正規表現チェッカー等のサイトで動作確認しながら変数抽出パターンを作成してください。
正規表現チェッカーを参照する。