API | BIZTEL / Just another WordPress site Fri, 16 Oct 2026 09:36:04 +0000 ja hourly 1 https://wordpress.org/?v=5.3.26 業務改善の第一歩を学ぶ 【第4章】Postmanを使う準備をしよう! /blog/2026/06/25/19139/ /blog/2026/06/25/19139/#respond Thu, 25 Jun 2026 03:00:10 +0000 /?p=19139 「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用 […]]]>

「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用した様々な機能実装にチャレンジし、センター運営の新たな可能性を拡げる活動をしています。

ですが、「そもそもAPIって?」「なんだか難しそう…」と思う方も多いのではないでしょうか。

そこで、この「業務改善の第一歩を学ぶ」シリーズでは、「BIZTEL API使ってみた」の記事で数々の機能実装に挑戦している田中 美穂さんが、APIの基礎から応用までわかりやすく解説します。

今回は、【第4章】Postmanを使う準備をしよう! です。

はじめに

こんにちは!BIZTEL開発部門の田中です。
この記事をご覧いただき、ありがとうございます!

前回の第3章では、APIリファレンス(説明書)の読み方を解説しました。

今回の第4章では、次の第5章でOpenAIのAPIを実行するためにPostmanを使う準備をしていきます。

具体的には、以下の作業をしていきます。

  • APIテストツール「Postman」のインストールと設定
  • OpenAIのAPIリファレンスの読み方を確認
  • OpenAIの事前準備(アカウント登録とAPIキー発行)

では、一緒に学んでいきましょう!

なぜ、生成AIを使うの?

第2章・第3章で活用した、東京都オープンデータAPIは「データを取得する」だけのAPIでした。OpenAIをはじめとした生成AIのAPIは、それに加え「AIに仕事をさせる」ことができます。

例えば…

  • 📞 通話内容を要約させる
  • 🏷 問い合わせ内容を自動で分類する
  • ✉ お客さまへの返信文を下書きさせる
  • 💡 知りたいことを質問して教えてもらう

「BIZTEL API使ってみた」シリーズでも、BIZTELのコールアクション機能とOpenAI APIを活用した、業務効率化のアイデアをご紹介しています。
本記事でも、代表的な生成AIサービスである「
OpenAI API」を使って練習していこうと思います。

Postmanのインストールと設定

生成AIのAPIを試すには、ブラウザだけでは難しいため、PostmanというAPIテストツールを使います。

Postmanには、デスクトップアプリとWebアプリがありますが、今回は「Webアプリ」を使用していきます。

以下の手順に従って、「Webアプリ版Postman」をインストールし、設定していきましょう。

💡Postmanとは?
APIが正しく動作するかを簡単にテストしたり、開発したりするためのツールです。
APIリファレンスに書かれた情報を画面に入力するだけで、APIを実行できます。

手順

1. Postman公式サイトからインストーラーをダウンロードし、インストールします。

2. インストールが完了したら、Postmanを起動します。

3. Postmanを初めて使用する場合は、アカウントを作成します。既にアカウントがある場合は、ログインをしてください。

4. 日本語に変更するために、歯車マーク>Settings をクリックします。

5. 表示テーマは、歯車マーク>設定>テーマからお好みのスタイルに変更可能です。

6. Postmanで利用できるショートカットキーの設定が可能です。必要に応じて設定してみてください。

Postmanの機能は多岐にわたりますが、一旦基本設定は以上になります。

OpenAIのAPIリファレンスを読んでみよう

第3章で学んだ「APIリファレンスの基本要素」を参考に、OpenAIのAPIリファレンスを確認していきましょう。

1.  リファレンスページを開く

以下をコピーして、Webブラウザで開いてください。

https://platform.openai.com/docs/api-reference/introduction


下のようなAPIリファレンスページが表示されていると思います
(必要に応じて、右クリックで「日本語に翻訳」を選択し、日本語ページにしてください)。

2. 認証情報を確認する

まずは、「認証情報」から確認していきましょう。Authenticationをクリックしてください。

「認証にAPIキーを使用する」と記載があります。では、どうやって使うのでしょうか。

APIキー:Authorization: Bearer YOUR_API_KEY

💡「使用する」とは?
ここで言う「使用する」とは、後ほどPostmanの画面で実際に入力するということです。今の段階では、「認証にはAPIキーが必要だ」ということだけ覚えておいてください。Postmanのどの画面に入力するかは、次章で具体的に説明します。

3. 「Chat Completions API」の基本要素を確認

OpenAIは、画像生成用・音声認識用といった用途に応じて複数のAPIを提供しています。今回使うのは「Chat Completions」というテキストでやり取りするためのAPIです。
以下のURLをWebブラウザで開き、Chat Completionsの基本要素を確認していきます。

https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create


◼︎基本要素の整理 (OpenAI Chat Completions APIの場合)

第3章で確認した「東京オープンデータAPI」と同じように、「OpenAI Chat Completions API」も基本要素を見ていきましょう。

リクエスト例(下の画像)にある、「-H」の後に続く文字列が「リクエストヘッダ情報」、「-d」 の後に続く文字列が「リクエストボディ情報」を指しています。


用語

OpenAI API 設定値

参考)東京都オープンデータAPIとの差異

リクエストURL

https://api.openai.com/v1/chat/completions

-

認証情報

あり(Authorization: Bearer YOUR_API_KEY)

なし(誰でも使える)

メソッド

POST(データを送信)

GET(データを取得)

リクエストヘッダ

Content-Type: application/json

-

リクエストボディ

あり(JSON形式。詳細は次章で解説します)

なし(検索条件をURLに含める)

レスポンス

JSON形式で返されます

-


東京都オープンデータAPIは「検索条件をURLに付けてデータを取りに行く」イメージでしたが、
OpenAI APIは「AIへの指示をボディに入れて送り、返事をもらう」イメージです。

OpenAIの事前準備

OpenAIのAPIを使うためには、アカウント登録後、事前にクレジットカード登録とAPIキーの発行が必要です。

手順の詳細は、BIZTELブログ をご参照ください!

・クレジットカード登録
初回登録時は無料クレジットが付与される場合もありますが、継続して使う予定がある場合は最低 $5 以上をクレジットで購入してください。

・APIキー発行

第4章の振り返り

・Postmanの準備
APIテストツール「Postman」をインストールし、基本設定を行いました。
・OpenAI APIリファレンスの読み方
第3章で学んだ基本要素をOpenAIのAPIリファレンスに当てはめて「Chat Completions API」の構成を確認しました。
・OpenAIの事前準備
OpenAIのアカウント登録後、クレジット購入・APIキーの発行を行いました。

まとめ

第4章では、次の第5章でOpenAIのAPIを実行するための準備を整えました。あわせて、OpenAI APIのAPIリファレンスの読み方も確認しました。

次はいよいよ、Postmanを使ってOpenAIのAPIを実行し、AIからの返事を受け取りましょう。

]]>
/blog/2026/06/25/19139/feed/ 0
業務改善の第一歩を学ぶ 【第3章】APIリファレンスの読み方を学ぼう! /blog/2026/05/13/18182/ /blog/2026/05/13/18182/#respond Wed, 13 May 2026 03:00:02 +0000 /?p=18182 「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用 […]]]>

「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用した様々な機能実装にチャレンジし、センター運営の新たな可能性を拡げる活動をしています。

ですが、「そもそもAPIって?」「なんだか難しそう…」と思う方も多いのではないでしょうか。

そこで、この「業務改善の第一歩を学ぶ」シリーズでは、「BIZTEL API使ってみた」の記事で数々の機能実装に挑戦している田中 美穂さんが、APIの基礎から応用までわかりやすく解説します。

今回は、【第3章】APIリファレンスの読み方を学ぼう! です。


- biztel.jp

- biztel.jp

はじめに

こんにちは!BIZTEL開発部門の田中です。
この記事をご覧いただき、ありがとうございます!

第1章で、API(Application Programming Interface)とは「異なるソフトウェアやシステムが互いに通信し、データや機能をやり取りするための仕組み」であることをお話ししました。
また、第2章では「クライアント」と「サーバー」が重要な役割を担っていることやリクエストとレスポンスの流れ、さらにAPIメソッドの種類などの概要をお伝えしました。

今回の第3章では、「APIリファレンス(説明書)の読み方」を解説していきます。
新しいツールのインストールは不要で、ブラウザだけで進められます。

では、一緒に学んでいきましょう!

APIリファレンスとは

APIリファレンスとは、「APIの使い方(仕様)など、必要な情報が詳しく書かれた説明書」のようなものです。

家電製品を操作する時も、取扱説明書をみながら操作しますよね。
APIも同じように「APIリファレンス」という取扱説明書があるのです。

APIを効果的に利用するには、APIリファレンスを正しく把握することが重要です。まずは、リファレンスに記載されている基本要素について理解していきましょう。

◼︎APIリファレンスの基本要素
APIリファレンスには、主に以下の情報が記載されています。まずは、これらの基本要素を把握することからはじめましょう。
今すぐに全てを覚える必要はありません!「APIの説明書にこれらの項目がある」ということだけ知っておけばOKです!

カテゴリ 用語 意味 例
リクエスト リクエストURL
(必須)
APIリクエストを送信するための完全なURL https://api.openai.com/v1/chat/completions
認証情報
(多くは必須だが、認証なしの場合もある)

APIを利用する際に必要な認証キーやトークン

Authorization: Bearer YOUR_API_KEY
メソッド
(必須)
APIリクエストの種類を示すラベル GET・POST・PUT・DELETE など
リクエストヘッダ
(必須)
リクエストを送信する際に含める必要のある追加情報 Content-Type: application/json
リクエストボディ
(メソッドがGETの場合など、指定なしのケースもある)

データの追加や更新時に必要な情報など、リクエスト内容を記載する

{ "param1": "value1", "param2": "value2" }
レスポンス レスポンス APIから返される応答の形式や内容
APIによって、JSON・XMLなど形式は異なる

{ "status": "success", "data": [...] }

APIリファレンスの理解を深めよう

「東京都オープンデータAPI」を例に基本要素を確認

APIリファレンスの基本要素の理解を深めるために、第2章のAPIを使ってみようで使用した「東京都オープンデータAPI」を例として見ていきましょう。

◼︎リクエストURLの構造
以下は、第2章で使用した「リクエストURL」の一例です。

https://api.data.metro.tokyo.lg.jp/v1/Event?ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%E4%BB%B6.ex%3A%E6%96%99%E9%87%91_%E8%A6%81%E5%90%A6=0&ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%E4%BB%B6.ex%3A%E4%BA%88%E7%B4%84%E7%94%B3%E8%BE%BC_%E8%A6%81%E5%90%A6=0&limit=100


東京都オープンデータAPIのリクエストURLは、BaseURL(赤文字)とエンドポイント(青文字)とクエリパラメータ(紫文字)で構成されています。
リクエストURLの構造を理解するためには、この「BaseURL」「エンドポイント」「クエリパラメータ」について把握しておく必要があります。

項目

意味

例

BaseURL
(必須)

API全体の共通部分となるURLです。すべてのエンドポイントの基礎となります。

https://api.data.metro.tokyo.lg.jp/v1

エンド
ポイント
(必須)

BaseURLに続く、アクセスしたい特定のリソースやアクションを指定する部分です。

/Event

クエリパラメータ
(※1)

リクエストに追加情報を提供するキーと値のペア。エンドポイントの後の「?」に続きます。

ex:参加条件.ex:料金_要否=0

※1 クエリパラメータが必要かどうかは、APIによって異なります。必ずAPIリファレンスを確認してください。今回の東京都のオープンデータAPIでは、検索条件を絞り込むために使用しています。

東京都オープンデータAPIの実行画面にも、「BaseURL」「/●●●(エンドポイント)」の情報が表示されています。

【補足】URLに表示される文字列はなぜ違う?- URLエンコードについて -
東京都オープンデータAPIを実行して表示されたリクエストURLを見て、「あれ?」と思った方もいるかもしれません。

⚫︎クエリパラメータに指定した値
「ex:参加条件.ex:料金_要否=0」

⚫︎実際にブラウザのURLに表示された値
「ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%E4%BB%B6.ex%3A%E6%96%99%E9%87%91_%E8%A6%81%E5%90%A6=0」

リクエストURL内のエンドポイントの後の「?」に続く、クエリパラメータの文字列が異なっています。ですが、中身は同じです。

これは「URLエンコード」と呼ばれる自動変換によるものです。
インターネットのURLには、日本語や一部の記号(例えば「:」など)は、そのまま使えない決まりがあるため、ブラウザやAPIツールが自動的に変換しています。

例えば、手紙を海外宛に送る時、日本語で記載された宛名では届けることができません。アルファベットなどに変換して書く必要がありますよね。

「URLエンコード」もこれと同じ仕組みです!
ただし、自分で変換する必要はありません。ブラウザやAPIツールが自動的に変換してくれます。

(参考)変換の対応例

変換前

変換後

:

%3A

料金

%E6%96%99%E9%87%91

ex:参加条件.ex:料金_要否=0

ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%
E4%BB%B6.ex%3A%E6%96%99%E9%87%91_%
E8%A6%81%E5%90%A6=0

基本要素のまとめ

「東京都オープンデータAPI」の場合

第3章で紹介した「東京都オープンデータAPI」を基本要素に当てはめると、以下のようになります。

用語

設定値

リクエストURL

https://api.data.metro.tokyo.lg.jp/v1/Event?ex%3A参加............

認証情報

なし
※本APIは、誰でも利用できる「公開API」のため認証不要

メソッド

GET

リクエスト
ヘッダ

Content-Type: application/json

リクエスト
ボディ

なし
※GETリクエストの場合、リクエストボディは使用されません。
※本APIは、クエリパラメータをURLに含めてリクエストするため、リクエストボディはありません。

レスポンス

JSON形式で返されます。

 
ポイント💡
第2章では「Try it out」ボタンを押して、パラメータを入力して「Execute」を押しただけですが、裏側ではこの基本要素に沿ったリクエストが送信されていました。

第3章の振り返り

  • APIリファレンスとは
    • APIリファレンスは、APIの使い方が詳しく書かれた説明書です。
  • APIリファレンスの基本要素
    • APIリファレンスには、「リクエストURL」「認証情報」「メソッド」「リクエストヘッダ」「リクエストボディ」「レスポンスの形式や内容」といった基本要素が記載されています。
  • リクエストURLの構造
    • リクエストURLは、BaseURL + エンドポイント + クエリパラメータで構成されています。
  • URLエンコード
    • 日本語や記号は、URL上で自動的に変換(URLエンコード)されますが、中身は同じです。変換は自身で行う必要はありません。
  • 具体例:東京都オープンデータAPIの利用
    • 第2章で体験した「東京都オープンデータAPI」を基本要素に当てはめて、APIリファレンスの読み方を確認しました。

まとめ

第3章では、APIリファレンスの基本要素と読み方について学びました。

「東京都オープンデータAPI」を例に、リクエストURLの構造やURLエンコードについても学びました。

次の第4章では、Postmanを使って生成AI(OpenAI)のAPIを実行する方法を見ていきましょう。

]]>
/blog/2026/05/13/18182/feed/ 0
BIZTEL API使ってみた vol.18レポート取得APIとGASで分析業務を簡略化したい /blog/2026/03/25/18223/ /blog/2026/03/25/18223/#respond Wed, 25 Mar 2026 03:00:05 +0000 /?p=18223 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと コールセン […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

コールセンター運営において、呼量や応対状況を継続的に把握し、ちょっとした変化を早期に捉えることは、運営改善の第一歩です。

「BIZTEL API使ってみた vol.13」では、BIZTELの「レポート取得API」と「Excelマクロ」を連携し、コールセンター管理者の分析業務を簡易化する仕組みにチャレンジしました。


- biztel.jp

今回は第2弾として、「レポート取得API」と「GAS(Google Apps Script)」を活用し、ボタンひとつで必要なレポート情報をGoogleスプレッドシートへ自動集計する仕組みをご紹介します。

BIZTELは、管理画面上でコールセンターの着信数や放棄呼数、通話時間などのレポート集計ができますが、ユーザが自社の求める形式でデータを集計・加工する場合は、「管理画面にログインし、CSVをダウンロードしてExcelへ取り込む」という手作業が必要なため、分析を始めるまでに時間と手間がかかってしまうという課題がありました。

今回の仕組みを活用すれば、以下のレポートがボタンひとつでスプレッドシートに取り込むことができます。
・指定した期間のレポート
・前日分のレポート(定期的に自動で取得)
・最大1ヵ月分の「日次&期間全体」で集計したレポート

集計作業を徹底的に効率化し、本来注力すべき「分析や議論」といった業務に時間を割けるよう改善に取り組んでみましょう!

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回の仕組みの実装には、BIZTELのバージョンが3.10.0以上である必要があります。

BIZTELで必要なオプション

・レポート取得API
※詳細は「8.レポート取得API(コールセンターレポート:着信)」をご覧ください。
※今回の仕組みでは、BIZTELの標準機能「コールセンターレポート」で取得できる「サマリーレポート」と「日時・曜日別レポート」のみが出力可能です。

BIZTEL以外に必要なもの

・Googleアカウント
・Googleスプレッドシート
・Google Apps Script(本記事内で紹介する、BIZTELのレポート情報を出力する「サンプルGAS」)

※注意点※
・BIZTELサーバで「IPアクセス制御」機能を設定している場合、今回紹介する仕組みは利用できません。
・業務データを扱うため、会社が管理する Google Workspace アカウントでの利用を推奨します。各企業のセキュリティポリシーに従ってご利用ください。
・掲載しているコードはサンプルであり、動作を保証するものではありません。 
・コードの内容解説や、カスタマイズ(修正)に関する技術的なサポートは行っておりませんので、ご注意ください。 
・本コードの解読・カスタマイズ(修正)には、Google Apps Script を読み書きできる知識が必要です。

動作の全体像

Before
分析用のExcelデータを準備するには、以下のステップを検索条件ごとに繰り返す必要があります。
 ・BIZTEL管理画面へのログイン
 ・レポート画面からのレポート生成
 ・CSVをダウンロードして、CSVをExcelへ取り込む

After
本仕組みを利用することで、以下が解決できます。
 ・Beforeの「Excelデータ準備」に必要なステップを省くことができる
 ・期間内集計と期間内日次集計が可能になる(集計工数の削減)
 ・前日分の集計を定期実行することが可能となる(自動化)

今回の仕組みを利用した出力結果の一例
期間内集計(1ヵ月)と期間内日次集計を実施した場合の出力結果の一例をご紹介します。
まず、メールでレポート取得が完了した旨の通知が届きます。

メール内のURLからレポートにアクセスすると、目次が表示されます。

スプレッドシートのタブごとに、「期間内集計(1ヵ月分)」や「期間内日次集計(1日分)」などの結果が表示されます。

<期間内集計(1ヵ月)>

<期間内日次集計(1日分)>

設定の実践

BIZTEL 事前準備

APIトークンを発行する

レポート取得APIを利用して履歴を取得するため、ロールが「システム管理者」以上のアカウントで、BIZTEL管理画面にログイン後、APIトークンを発行します。設定の詳細は「1.APIトークン」をご参照ください。

※取得できるレポートは、アカウントのリソース権限設定によって異なります。

Googleスプレッドシート 事前準備

1.サンプルGASのコピーとGAS実行の権限付与

自組織が利用するワークスペースの任意の場所にコピーして、基本設定を行っていきます。
「サンプルGAS:【サンプル】BIZTELレポート取得」
を開き、「コピーを作成」をクリックします。すると、ご自身の GoogleドライブにサンプルGASのコピーが作成されます。
※業務データを扱うため、ご自身のGoogleドライブ内から自組織のGoogle Workspace の任意の場所に移動させてからの使用を推奨しています。

サンプルGASを開き、BIZTEL>基本設定をクリックします。

認証を求められるので、OKをクリックします。

認証させるアカウントを選択します。

全選択をして「続行」ボタンをクリックします。これで、GAS実行の権限付与は完了です。

2.基本設定

スプレッドシートのメニューから、BIZTEL>基本設定をクリックし、BIZTELからレポートを取得するための基本情報を設定します。

項目名

必須

説明

BIZTELサーバURL

○

利用中のBIZTELサーバのURLを設定します。
(例)https://s210999999999.u.biztel.jp

APIトークン

○

BIZTEL事前準備で発行した「BIZTEL APIトークン」を貼り付けます。

レポート通知先メールアドレス

○

処理完了通知を受け取るメールアドレスを指定します。

エラー通知先メールアドレス

○

処理中エラーになった場合の通知を受け取るメールアドレスを指定します。

マスキング設定

ー

マスキングしたい項目を指定し、「*」で出力することができます。セキュリティの理由で、特定の情報を伏せたい場合に有効です。この設定は、複数選択が可能です。

現状は、以下の3つのみマスキングが可能

  • コールセンター名 (コールセンターの名称)
  • 業務ラベル名 (業務を識別するラベル名)
  • 内線番号 (内線電話番号)

レポート出力先フォルダID

ー

「期間全体+日次」と「前日自動集計」の場合のみ、指定したフォルダに格納できます。

指定しない場合は、GAS実行者のマイドライブに格納されます。フォルダIDの確認方法は、格納先フォルダのURLからご判断ください。

(例)https://drive.google.com/drive/folders/フォルダID

※「指定期間のみ」を選択して実行する場合は、実行中のスプレッドシートに上書きされます。 


利用方法

共通設定:検索条件を設定する

「コールセンターレポート_サマリーレポート」を実行したい場合
「CCレポート_サマリ」のシートを開き、「2.サマリーレポートの取得の2.3 リクエストパラメータ」を参照しながら枠内に必要な条件を設定します。

「コールセンターレポート_日時・曜日別レポート」を実行したい場合
「CCレポート_日時曜日別」のシートを開き、集計単位は「3.日時・曜日別レポートの取得の3.3 リクエストパラメータ」を参照し、そのほかの値は「2.サマリーレポートの取得の2.3 リクエストパラメータ」を参照して、枠内に必要な条件を設定します。

ケース1:「期間指定」で実行したい場合

検索条件設定後、メニュー>BIZTELをクリックして、実行したいレポートを選択します。

ケース2:「期間全体の集計」と「日次集計」の両方を実行したい場合

検索条件設定後、メニュー>BIZTELをクリックして、実行したいレポートを選択します。なお、期間として設定できる日数は1ヵ月(31日間)が最大値です。

ケース3:「前日のデータ」を自動取得したい場合

検索条件設定後、メニュー>BIZTELをクリックして、実行したいレポートを選択します。「前日データ自動取得トリガー(両方)」は、「前日データ自動取得トリガー(サマリ)」と「前日データ自動取得トリガー(日時曜日別)」の両方を設定します。トリガーは、デフォルトで「毎朝6時から7時」の間に自動実行される設定になっています。

補足①:トリガーの実行時間の変更方法
メニュー>拡張機能>Apps Script をクリックします。

左の目覚まし時計マークをクリックして、該当のトリガーの鉛筆マークから実行時間を変更します。

「時刻を選択」から変更して、保存してください。以下の画像の場合は、午前6時から7時の間で実行されますが、プルダウンで時間を変更することができます。

補足②:前日データ取得の実行トリガーを解除したい場合
メニュー>BIZTELをクリックして、設定されている解除対象のトリガーレポートを選択します。

共通設定:処理結果の通知設定をする

処理結果は、GASの実行者からメールで通知されます。

メールタイトル

送信先

説明

【BIZTEL】成功:CCレポート_XXXX

レポート通知先メールアドレス

期間指定/期間全体+日次で実行して、正常に処理された場合

【BIZTEL】成功:CCレポート_XXXX 前日データ

レポート通知先メールアドレス

前日データを自動取得して、正常に処理された場合

【BIZTEL】注意:CCレポート_XXXX

レポート通知先メールアドレス

レポート情報の出力は正常に終了したが、指定したフォルダに配置できなかった場合

【BIZTEL】失敗:CCXXXXレポート

エラー通知先メールアドレス

レポート情報の取得/出力が正常に処理できなかった場合


<成功メール>
メールに記載されているレポートURLにアクセスして、出力結果をご確認ください。
以下のメールは、期間全体+期間内日次集計の例です。

レポートURLは、以下の3つのシートで構成されています。
①目次

②期間全体集計
指定した期間内のサマリ情報が出力されます。

③期間内日次集計
指定した期間内の日次のサマリー情報が出力されます。

<注意メール>
レポートURLから、出力されたレポートにアクセスすることはできますが、BIZTEL>基本設定で指定したフォルダに配置できていないため、フォルダIDや権限を確認をした上で、再度実行してください。

<失敗メール>
エラーの原因が表示されているので、内容を確認の上、再度実行してください。
以下のサンプルは、サービスレベル目標時間(秒)に範囲外の時間が指定されていることを意味しています。サービスレベル目標時間の値を確認して再度実行してください。

振り返り・まとめ

今回挑戦した仕組みにより、集計作業が自動化され、「分析や改善のアイデア出し」に時間を使える環境が実現しました!

前日分のデータはトリガーで設定した時間に自動取得され、今月の着信状況など特定期間の集計もボタンひとつで一気に取得できます。 「昨日の振り返り」から「月間の推移分析」まで、必要なデータが最小限の手間で揃うので、分析にかけるスピードと精度はぐっと上がるはずです。

設定はスプレッドシートに基本情報を入力するだけです。
まずは、GASサンプルをコピーして、必要なレポートが簡単に生成される便利さをぜひ体験してみてください!

編集後記

今回は、BIZTELの「レポート取得API」と「GAS(Google Apps Script)」を利用した、レポート集計作業の簡易化の仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2026/03/25/18223/feed/ 0
業務改善の第一歩を学ぶ 【第2章】APIの仕組みとは?概要を解説! /blog/2026/01/06/17844/ /blog/2026/01/06/17844/#respond Tue, 06 Jan 2026 03:00:15 +0000 /?p=17844 「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用 […]]]>

「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用した様々な機能実装にチャレンジし、センター運営の新たな可能性を拡げる活動をしています。

ですが、「そもそもAPIって?」「なんだか難しそう…」と思う方も多いのではないでしょうか。

そこで、この「業務改善の第一歩を学ぶ」シリーズでは、「BIZTEL API使ってみた」の記事で数々の機能実装に挑戦している田中 美穂さんが、APIの基礎から応用までわかりやすく解説します。

今回は、【第2章】APIの仕組みとは?概要を解説! です。

前回の記事はこちら


- biztel.jp

はじめに

こんにちは!BIZTEL開発部門の田中です。
この記事をご覧いただき、ありがとうございます!

第1章で、API(Application Programming Interface)は、異なるソフトウェアやシステムが互いに通信し、データや機能をやり取りするための仕組みということを学びました。

この仕組みには、クライアントとサーバーが重要な役割を担っています。また、APIリクエスト(※1)にはさまざまな種類があり、それぞれが特定の役割を果たします。

※1 APIリクエスト:あるシステムから別のソフトウェアやシステムに対して、データ・機能の提供を要求すること。

第2章では、以下の流れに沿って「APIの仕組み」を学んでいきましょう!

  1. クライアントとサーバーの関係
  2. リクエストとレスポンスの流れ
  3. メソッド

クライアントとサーバーの関係

先ほど紹介した通り、APIとは「異なるソフトウェアやシステムが互いに通信し、データや機能をやり取りするための仕組み」です。

そして、その仕組みには「クライアント」と「サーバー」が重要な役割を担っています。では、その役割とは何でしょうか?

例えば、あなたが図書館の本を予約し、それを受け取りに行ったとします。あなたが、「この予約した本を貸してください」と言うと、図書館の職員がその本を持ってきて、貸してくれます。このとき、あなたがお願いする人(クライアント)で、職員がお願いをきいてくれる人(サーバー)となります。

APIを動かすときには、お願いする人(クライアント)と、その願いを叶えてくれる人(サーバー)が必要ということです。

以下の図は、クライアントとサーバーの関係を示しています。

  1. クライアント(API利用者)が「○○サービスの▲▲に関する情報が欲しい」とお願いします。
  2. サーバー(API提供者)がそのお願いを受け取り、内部で必要な処理を行います。
  3. 処理が完了したら、サーバーは結果をクライアントに返します。

レストランで例えると、以下のようになります。

  • クライアント:APIを利用してデータやサービスをリクエストする側。これは、レストランで料理を注文するお客さまのイメージです。
  • サーバー:APIで受け付けたリクエストに応じて、データやサービスを提供する側。これは、注文のあった料理を調理し、提供するレストランのスタッフ(ウェイターやクック)のイメージです。

リクエストとレスポンスの流れ

次に、APIにおけるリクエストとレスポンスの流れを見てみましょう。
リクエストとは、クライアントがサーバーに送るお願いのことです。
また、レスポンスとは、サーバーがクライアントに返す応答
のことを指します。

クライアントからリクエストが出ると、サーバーがリクエスト内容に応じて処理を行い、クライアントにレスポンスを返します。

例えば、クライアントが「現在の東京の天気に関する情報がほしい」とリクエストした場合、サーバーは「今日は晴れです」とレスポンスを返すというような流れです。

レストランで例えると、以下のようになります。

  • リクエスト:お客さんがウェイターに「野菜炒め(ごはん少なめ、副菜は豆腐)がほしい」と言う
  • レスポンス:ウェイターがお客さんに「野菜炒め(ごはん少なめ、副菜は豆腐)」を提供する

では次に、「リクエストの種類」について、見ていきましょう!

メソッド

リクエストにはいくつか種類があり、それらを総称して「メソッド」といいます。
メソッドは、APIを通じてサーバーに「何をしたいか」を伝えるための指示です。各メソッドには、特定の役割があります。

以下は、代表的なメソッドの種類と役割をまとめた表です。

APIの基本的な仕組みを理解することは、APIを効果的に利用するための重要なステップです。次は、実際にAPIを使ってみましょう。

APIを使ってみよう

ここまで説明続きでしたが、次は実際にAPIを動かして理解を深めていきます。

Webブラウザ(Chromeなど)を用意できる環境であれば、すぐに実践できます。準備ができたら、ぜひ一緒にやってみましょう!

手順

1. APIのページを開く

Webブラウザを開き、以下のURLをコピー&ペーストしてください。

https://portal.data.metro.tokyo.lg.jp/opendata-api/


今回利用するのは、東京都が公開している
オープンデータAPIです。以下のWebページが表示されればOKです。

2. 興味のあるデータを選択する

ページに表示されている「新型コロナコールセンター相談件数」や「公共施設一覧」などの項目から興味のあるデータをクリックします。私は、東京都のイベント一覧に興味があるので「東京都イベント一覧情報」を取得してみようと思います。

3. APIを試してみる

「東京都イベント一覧情報」の詳細ページが開きます。右上の「Try it out」ボタンをクリックします。

「Parameters」の入力欄が編集可能になります。「Parameters」とは、APIに送る追加情報のことです。ここでは、これを検索条件として利用し、東京都のイベント一覧情報を絞り込むための条件を指定します。

今回は、無料かつ予約不要のイベントを検索するために、「料金_要否」に0を、「予約申込_要否」に0を設定して検索してみましょう。

設定が完了したら、ページ下部の「Execute」ボタンをクリックします。


4. 実行結果を確認

実行結果が、下部に表示されます。

サーバーからのレスポンスは JSON形式(※2)で表示されています。「Server response > Response body」を確認すると、今回設定した条件に合致したイベント情報が、JSON形式で表示されています。

※2 JSON (JavaScript Object Notation) :JavaScriptのオブジェクト表記法をベースにした、データを構造化して表現するためのテキスト形式。主にWebアプリケーション間などでデータを交換するために使われる。


5. ブラウザで確認

オープンデータのAPI画面での実行結果と同じ内容を、Webブラウザでも確認することができます。

以下の「リクエストURL」をコピーして、WebブラウザのURLに貼り付けて実行してみてください。

https://api.data.metro.tokyo.lg.jp/v1/Event?ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%E4%BB%B6.ex%3A%E6%96%99%E9%87%91_%E8%A6%81%E5%90%A6=0&ex%3A%E5%8F%82%E5%8A%A0%E6%9D%A1%E4%BB%B6.ex%3A%E4%BA%88%E7%B4%84%E7%94%B3%E8%BE%BC_%E8%A6%81%E5%90%A6=0&limit=10

 

Webブラウザに貼り付けて実行します。

APIページの実行結果と同じ「レスポンス」が、ブラウザからも確認できました。

このようにAPIを利用すると、いろいろなデータをやり取りすることができます。

今回は、APIを使うことで、どのように情報がやり取りされるのかを確認しました。次回の第3章では、Postman(※3)を使って実際にAPIを実行してみましょう。

※3 Postman:APIが正しく動作するかを簡単にテストしたり、開発したりするためのツール。

第2章の振り返り

  • クライアントとサーバーの関係
    • クライアントは、APIを利用してデータやサービスをリクエストする役割で、サーバーはそのリクエストに応じてデータやサービスを提供する役割を担っています。この関係がAPIの基本的な動作原理です。
  • リクエストとレスポンスの流れ
    • リクエストが、クライアントからサーバーに送られ、サーバーはその内容に応じて処理を行い、レスポンスをクライアントに返します。
  • メソッド
    • APIリクエストには、様々な種類があり、それらを総じて「メソッド」と言います。具体的には、情報を取得する「GET」、新しい情報を送る「POST」、既存の情報を更新する「PUT」、情報を削除する「DELETE」などがあります。
  • APIの実際の使用例
    • APIを利用して東京都のオープンデータを取得し、パラメータを設定してリクエストを送信し、レスポンスを確認する具体的な手順を学びました。

まとめ

第2章では、APIの仕組みについて解説しました。

クライアントとサーバーの関係や、リクエストとレスポンスの流れについて、さらにAPIメソッドの種類とその使い方も学びました。

次の章では、「APIリファレンスの読み方」を見ていきましょう!

]]>
/blog/2026/01/06/17844/feed/ 0
業務改善の第一歩を学ぶ 【第1章】APIとは?基本を理解しよう! /blog/2025/11/27/17379/ /blog/2025/11/27/17379/#respond Thu, 27 Nov 2025 03:00:05 +0000 /?p=17379 「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用 […]]]>

「BIZTEL」では多彩なAPI群を用意しており、柔軟なシステム連携によるコールセンター運営のサポートが可能です。また、BIZTELブログで掲載中の「BIZTEL API使ってみた」シリーズでは、担当者がAPI連携を活用した様々な機能実装にチャレンジし、センター運営の新たな可能性を拡げる活動をしています。

ですが、「そもそもAPIって?」「なんだか難しそう…」と思う方も多いのではないでしょうか。

そこで、この「業務改善の第一歩を学ぶ」シリーズでは、「BIZTEL API使ってみた」の記事で数々の機能実装に挑戦している田中 美穂さんが、APIの基礎から応用まで解説します。

早速見ていきましょう!

はじめに

「業務改善の第一歩を学ぶ」シリーズについて

こんにちは!BIZTEL開発部門の田中です。
この記事をご覧いただき、ありがとうございます!

BIZTELには、お客さまの業務プロセスを改善し、日々の作業を効率化するための「外部サービス(API)連携機能」が備わっています。

この機能を活用することで、様々な外部サービスとのシームレスな連携が可能となり、業務の自動化やデータ処理の効率化が実現します。例えば、BIZTELでは、以下のようなサービスと連携が可能です。

しかしながら、このポテンシャルをフル活用するには「APIの基本原理」と「BIZTELの具体的な利用法」を理解することが必要不可欠です。

私自身も、初めは何から手をつければよいのか分からず途方に暮れていましたが、時間をかけてAPIについて学び、試行錯誤を経て、現在はBIZTELのAPI連携機能を駆使した業務改善を実現できるようになりました。この過程で得た知識と経験は、センター運営の課題解決・効率化を目指し、日夜奮闘する皆さまのお役に立てる内容だと思っております。

この「業務改善の第一歩を学ぶ」シリーズは、より多くのお客さまに効率的な業務改善を体験していただくことを目的に作成をしました。ご紹介する内容が、業務改善の可能性の発見、そしてBIZTELのAPI連携機能を活用し、お客さまご自身で改善を実現するための一助となれば幸いです。

それでは、本シリーズをどうぞよろしくお願いいたします。

シリーズの構成

本シリーズでは、APIの基本概念から実践的な使用方法までを段階的に学ぶことができます。初心者の方にもわかりやすい内容になるよう、各章で特定のトピックに焦点を当てて解説していきます!

第2章: APIの仕組みの概要
クライアントとサーバーの関係、リクエストとレスポンスの流れ、APIメソッドについて

第3章: APIリファレンスを読み解き、ChatGPTをPostmanで実行しよう!
APIリファレンスの読み方と、Postmanを使ってChatGPTのAPIを実行する方法

第4章: ChatGPTを味方につけよう!
ChatGPTを使ってAPIの問題解決をサポートする方法

第5章: BIZTELのAPI連携(コールアクション)について
BIZTELのコールアクション機能の概要とその利点について

第6章: BIZTELコールアクションの実践
BIZTELのコールアクションを設定し、実際にAPI連携を行う方法

第7章: ひっかかりやすいポイントと対処法
API利用時に直面しやすい問題点とその対処法について

第8章: 演習問題
第1~7章までの内容を復習し、理解度を確認するための演習問題


それでは早速一緒に学習しましょう。

APIとは?基本を理解しよう

皆さまは、APIという言葉を聞いたことがありますか?

APIは、「Application Programming Interface(アプリケーション プログラミング インターフェース)」の略で、異なるソフトウェア間で機能やデータを共有するための仕組みです。つまり、アプリケーション同士が話し合うための約束事(ルール)です。

言葉だけだと少し難しいですね。
では、
APIをレストランでの注文に例えてみましょう。

身近な例:レストランでの注文

  • メニュー :APIの使い方、ルール
  • お客さま :API利用者
  • ウェイター:API

お客さま(API利用者)がレストランで、ウェイター(API)に料理を注文します。ウェイターはその注文をクックに伝え、料理が完成すると、ウェイターが料理をお客さまに提供します。

つまり、APIを使うことで、特定のルール(メニュー)に従って情報やサービスを要求し、その内容に応じた結果を受け取ることができます。このように、APIは異なるソフトウェアやシステムが互いに通信し、データや機能をやり取りするための仕組みなのです。

このレストランの例をもう少し詳しく見てみましょう。

  1. お客さまがウェイターに「今日のおすすめは何ですか?」と尋ねる(要求)
  2. ウェイターがクックさんに確認して「本日のおすすめは野菜炒め定食です」と伝える(提供)
  3. お客さまが「では、その野菜炒め定食をお願いします」と注文(要求)
  4. ウェイターがキッチンに注文を伝え、料理が完成してお客さまに提供される(提供)

このように、APIを使うことで、システム同士が情報やサービスをやり取りすることができるんです!

身近なAPIの例

実は、APIは私達の日常生活に欠かせない存在であり、多くのサービスで利用されています。例えば、以下のような活用があります。

◼︎天気予報サイト(アプリ)
スマートフォンの天気アプリは、インターネットから天気情報を取得する際にAPIを活用しています。例えば、天気予報APIを利用して、現在の天気や週間予報などを画面に表示しています。


◼︎地図サイト(アプリ)
Googleマップなどの地図アプリは、インターネットから最新の地図情報を取得する際にAPIを利用しています。具体的には、地図APIを使って現在地を表示したり、目的地までの経路検索を実現しています。

◼︎オンラインショッピング
楽天市場やAmazonなどのオンラインショッピングサイトでは、商品を表示・検索・購入といった一連の機能にAPIが利用されています。例えば、商品情報APIを使って最新の商品情報を取得し、Webサイトに表示しています。

第1章の振り返り

APIの定義
APIは、異なるソフトウェアやシステムが互いに通信し、データや機能をやり取りするための仕組みです。APIは 「Application Programming Interface(アプリケーション プログラミング インターフェース)」の略です。

APIの役割
APIは、アプリケーション同士が特定の約束事(ルール)に従って情報やサービスを要求し、その結果を受け取るためのインターフェースを提供します。

レストランの例
お客さま(API利用者)がウェイター(API)に料理を注文し、ウェイターがクックに伝えて料理を提供するプロセスが、APIのリクエストとレスポンスの仕組みに例えられます。

まとめ 

この章では、APIの基本概念とその役割について学びました。

天気予報サイト・地図サイト・オンラインショッピングなど、APIは日常生活で幅広く利用されており、とても重要な位置づけとなっています。

次の章では、APIの具体的な仕組みについて見ていこうと思います!

]]>
/blog/2025/11/27/17379/feed/ 0
BIZTEL API使ってみた vol.17 コールアクション×生成AIでコールリーズンを自動分類!Salesforce連携で見える化と分析も可能に /blog/2025/11/07/17500/ /blog/2025/11/07/17500/#respond Fri, 07 Nov 2025 03:00:06 +0000 /?p=17500 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと コールリー […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

コールリーズンとは「お客さまが、なぜコールセンターに問い合わせしたのか」の理由のことです。このコールリーズンを分析することで「どういった内容の問い合わせが多いのか」などが把握でき、商品・サービスの改善につなげたり、センター運営ではFAQ改善、IVR・ACDルーティングの最適化に活かしたりすることができます。

メリットの多いコールリーズン分析ですが、こんなお悩みはありませんか?

  • オペレーターの負担: 通話後の登録作業に時間がかかり、業務効率が低下している
  • データのばらつき: オペレーターごとで判断基準が異なり、データに一貫性がない
  • 入力漏れやミス: 業務が多忙で、入力漏れや設定ミスが発生している
  • 「その他」の多発:どこに分類して良いか判断できず「その他」ばかりになっている

こうした課題を解決するため、今回はBIZTELの「API連携コールアクション」と「生成AI」を組み合わせ、コールリーズンの自動分類に挑戦します!

なお今回の挑戦では、コールリーズン分類に加え、vol.16のブログでご紹介した「カスハラの自動判定」や、問い合わせの解決状況の評価、通話内容の要約まで、まるっと自動化させる内容となっています。

コールリーズンの登録作業が大幅に削減され、顧客対応に集中できるようになることはもちろん、自動分類により一貫性の高いデータが蓄積されるため、顧客ニーズの正確な把握と業務改善への有効活用も可能になります。

コールセンター業務のさらなるDXに向けて、ぜひ一緒にチャレンジしてみましょう!

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回紹介するシステム連携を行うためには、BIZTELのバージョンが3.12.10以上である必要があります。

BIZTELで必要なオプション

・API連携コールアクション
・音声認識連携(AmiVoice API)
※詳細はこちらの「1.音声認識連携(AmiVoice API)」をご覧ください。

BIZTEL以外に必要なもの

・Salesforce
・OpenAI API
※OpenAI APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、OpenAIのWebサイトをご覧ください。
・AmiVoice API
※AmiVoice APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、AmiVoice APIのWebサイトをご覧ください。

動作の全体像


※今回の記事では「インターネット銀行のコールセンター」を例として、通話テキストの内容から、
あらかじめ定義したコールリーズンに自動で分類する仕組みを構築します。

コールリーズンのサンプル(例:インターネット銀行のコールセンター)

▼コールリーズン自動判定結果

設定の流れ

OpenAI 事前準備

OpenAI APIを利用して、お客さまとの会話の要約やコールリーズンの自動分類などを行うため、APIキーの発行します。

Salesforce 事前準備

SalesforceのAPIを利用して通話内容を記録するため、OAuth認証接続アプリケーションの作成やToDoオブジェクトの項目設定、ページレイアウト変更を行います。

BIZTEL 事前設定

お客さまとの会話をテキスト化するため、音声認識連携の設定を行います。さらに、会話の要約・コールリーズン分類・解決状況判定・カスハラ判定を行い、Salesforceに記録するため「コールアクションテンプレート機能」を利用してコールアクションを設定します。

設定の実践

OpenAI 事前準備

OpenAIのAPIキーを発行
OpenAIのアカウント作成および、OpenAI APIキー発行が必要となります。発行手順はこちらの「設定の実践 OpenAI 事前準備」をご参照ください。

Salesforce 事前準備

1.  OAuth認証の接続アプリケーションを作成
こちらの「設定の実践 1.Salesforce 設定準備」を参照しながら、SalesforceのOAuth認証のアプリケーション作成と鍵情報の確認を行います。

2. 活動オブジェクトにカスタム項目を新規作成
抽出した情報を格納する項目が必要なので、以下に従って作成してください。作成方法については、こちらの「2.3 カスタム項目の作成」を参考に作成してください。

◼︎通話録音再生

◼︎通話終了時の解決状況

◼︎コールリーズン大分類

◼︎コールリーズン中分類

◼︎コールリーズン小分類

◼︎カスハラ/クレーム判定

3. ToDoオブジェクトのページレイアウトを変更
以下が連携に必要な項目なので、任意のレイアウトを定義してください。

(ページレイアウトの設定例)

BIZTELの設定

1. 音声認識連携
お客さまの音声をテキスト化するための設定を行います。設定方法については、こちらの「2. 音声認識連携の設定方法」をご参照ください。
※別途、アドバンスト・メディア社の「AmiVoice API」 のご契約が必要です。

2. OAuthアカウント設定
BIZTELとSalesforceを連携するためのOAuth設定を行います。こちらの「設定の実践 2.BIZTELでのOAuth設定」をご参照ください。

3. コールアクション連携
通話内容の要約結果やコールリーズン分類の結果を、Salesforceに記録するコールアクションの設定を「コールアクションテンプレート機能」を利用して行います。

(OpenAIに依頼するプロンプト概要)

<コールアクション連携 手順の概要>
Ⅰ テキストエディタを利用して、コールアクションテンプレートを作成
Ⅱ BIZTEL管理画面から、コールアクションテンプレートをインポート
Ⅲ BIZTEL管理画面から、コールアクション連携を編集
  OAuthアカウント設定 :4件編集
  紐づけ先が特定できない時のレコードID:1件編集
  OpenAI APIキー:1件編集
  ※合計6件修正することで設定が完了します。
Ⅳ お客さまの業務に応じて、OpenAI APIへの指示を調整
Ⅴ 連携対象とする電話番号を選択
Ⅵ コールアクションの設定を有効化

<コールアクション連携 手順の詳細>

Ⅰ コールアクションテンプレートを作成
以下のテキストをすべてコピーして、テキストエディタにペーストして保存してください。

注意事項
●ファイルはJSON形式であるため、ファイルの拡張子は「.json」にしてください。
●文字コードはUTF8で保存してください。

{
  "version_name": "unknown",
  "version_hash": "df34bc1",
  "server_id": "f6c873a3ee5ea9a9c8891aa8596083c8b9943e21ecf8b43f9590461017c9040e",
  "name": "コールリーズン自動判定対応",
  "memo": "gpt-4.1-mini対応版",
  "api_nodes": [
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "oauth_account_id": null,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": null,
      "request_method": "GET",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/parameterizedSearch/?q={TEL}&sobject=Account&sobject=Contact&sobject=Lead",
      "response_variable_pattern": "/\"attributes\":\\{\"type\":\"(?P<TYPE>[a-zA-Z]*)\".*?\"Id\":\"(?P<NOID>[a-zA-Z0-9]*)\"/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_sms_template_id": null,
      "result_entry_summary_text": null,
      "result_entry_tag_code": null,
      "result_entry_tag_id": null,
      "result_entry_tag_pattern": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 1,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "oauth_account_id": null,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": "{\r\n  \"model\": \"gpt-4.1-mini\",\r\n  \"messages\": [\r\n        {\r\n      \"role\": \"system\",\r\n       \"content\": \"**【通話テキスト分析タスク】**\\n以下の手順で、通話テキストのコールリーズン分類とカスハラ判定と解決状況判定を行ってください。\\n**## PART1: コールリーズン分類**\\n**STEP1-3: 段階的分類**\\n1. 大分類を特定\\n2. 該当する中分類を特定\\n3. 該当する小分類を特定\\n判断基準:\\n- 複数の分類にまたがる場合は、顧客の最終的な目的・ゴールを重視\\n- 会話の大部分を占める内容で判断\\n- 1つの分類のみを選択\\n- どの分類にも該当しない場合は「なし」と出力\\n**【分類体系】(要修正:業務にあわせて修正)**\\n[大分類1] 検討・情報収集[大分類2] 申し込み[大分類3] 操作方法[大分類4] 解約[中分類1-1] 条件[中分類2-1] 口座開設[中分類3-1] ログイン[中分類4-1] 解約手続き[小分類1-1-1] 利用者の年齢[小分類2-1-1] Webでの手続き[小分類3-1-1] ログイン操作[小分類4-1-1] Webでの手続き[小分類1-1-2] 店舗・口座[小分類2-1-2] 来店での手続き・持ち物[小分類3-1-2] IDが分からない[小分類4-1-2] 来店での手続き・持ち物[小分類2-1-3] 本人確認書類[小分類3-1-3] パスワードが分からない[小分類4-1-3] 郵送での手続き[中分類1-2] サービス内容[小分類3-1-4] パスワードのリセット方法[小分類1-2-1] 定期預金[中分類2-2] インターネットバンキング申し込み[小分類1-2-2] 投資信託[小分類2-2-1] Webでの手続き[中分類3-2] 定期預金[小分類1-2-3] 普通預金・振込[小分類2-2-2] 来店での手続き・持ち物[小分類3-2-1] 預金の操作方法[小分類1-2-4] 住宅ローン[小分類2-2-3] 郵送での手続き[小分類3-2-2] 中途解約の操作[小分類2-2-4] 本人確認書類[小分類3-2-3] 満期手続きの操作[小分類2-2-5] 印鑑が分からない・見つからない[小分類3-2-4] 契約内容の確認[小分類2-2-6] 通帳が分からない・見つからない[小分類3-2-5] 金利[中分類2-3] 会員証・暗証番号の発送[中分類3-3] 投資信託[小分類2-3-1] 発送方法[小分類3-3-1] 購入の操作方法[小分類2-3-2] 発送時期[小分類3-3-2] 解約の操作[小分類2-3-3] 発送状況の確認[小分類3-3-3] 償還の操作[小分類3-3-4] 契約内容の確認[小分類3-3-5] ファンドの質問(転送含む)[中分類3-4] 普通預金・振り込み[小分類3-4-1] 入出金明細の操作[小分類3-4-2] 振り込みの操作[小分類3-4-3] 振り込みの手数料[小分類3-4-4] 振り込み用の暗証番号[中分類3-5] 住宅ローン[小分類3-5-1] 残高照会[小分類3-5-2] 一部繰上返済[小分類3-5-3] 金利コース変更[小分類3-5-4] 相談(転送)[中分類3-6] 会員証・暗証番号の喪失[小分類3-6-1] 利用停止・再発行受付[小分類3-6-2] 再発行状況の確認\\n**## PART2: カスハラ・クレーム判定**\\n**## 【最優先判定ルール】**\\n1. 会話全体から[A][B]に該当する発言を探す\\n2. 該当発言があれば必ず「カスハラ」と判定\\n3. 該当発言がない場合のみ、クレームまたは通常会話と判定\\n**## [A] カスハラの定義(必要に応じてカスタマイズ)**\\n① 従業員に苦痛を与える迷惑行為\\n② 人格・尊厳を侵害し安全を損なう行為\\n**## [B] カスハラのタイプ(業界特性に応じて調整可能だが注意必要!)**\\n1. 精神的攻撃型:暴言・脅迫・人格否定\\n2. 過剰要求型:制度外の要求\\n3. 差別型:差別的発言\\n4. 身体的攻撃型:物理的危害の示唆\\n**## カスハラの明確な事例(必要に応じてカスタマイズ)**\\n### 精神的攻撃型\\n* 「あなたはバカなの?」\\n* 「無能だね」\\n* 「あなたの名前と顔を覚えておくからね」\\n* 「あなた個人に責任を取らせる」\\n### 過剰要求型\\n* 「24時間以内に対応しないと訴える」\\n* 「規約は関係ない、今すぐ特別対応しろ」\\n### 差別型\\n* 「男性スタッフに代われ」\\n* 「若い人より年配の人に代わってほしい」\\n### 身体的攻撃型\\n* 「殴るぞ」\\n* 「あなたの住所を調べるからな」\\n* 「SNSに顔写真を晒すぞ」\\n## [C] クレームの判定基準(業界特性に応じて調整可能)\\nクレームとは、製品・サービスへの不満や改善要望で、感情的表現を含むことがあっても社会通念内であり、業務内容に対する批判や問題指摘を含むものです。\\nクレームと判定する基準:\\n- 製品・サービスの具体的な問題点への言及\\n- 改善や対応を求める明確な意思表示\\n- 具体的な商品不良、不具合の指摘\\n- 交換、返品、修理などの改善要求\\n- サービスの品質に対する明確な不満表明\\n※単なる一般的な問い合わせや軽微な質問は「通常会話」とするが、実質的な不満や改善要求がある場合はクレームとして扱う\\n**## [D] 分析タスク**\\n1. 会話を判定:\\n- タイプ[B]のいずれか\\n- クレーム\\n- なし\\n2. 判定に応じて記載:\\n- カスハラ:[E]の優先順位に基づき、最も深刻な単一のタイプのみ選択\\n * 該当タイプ、発言引用、理由\\n- クレーム:発言引用、内容\\n- 通常会話:「なし」\\n3. 複数のカスハラタイプに該当する場合の判定方法:\\n- [E]の優先順位に従い、最上位の単一タイプのみを選択\\n- 例:身体的攻撃型と精神的攻撃型に該当する場合、「身体的攻撃型」のみ記載\\n**## [E] 優先順位(必要に応じて順序を調整可能)**\\n身体的攻撃型 > 精神的攻撃型 > 差別型 >
過剰要求型\\n**## PART3: 解決状況判定(必要に応じてカスタマイズ)**\\n【解決状況の判定基準】\\n通話終了時点での顧客の問題解決レベルを以下の4段階で判定してください:\\n重要:顧客が具体的な問題や困りごとを抱えている場合は「解決不要」ではありません。必ず問題解決の観点で判定してください。\\n1. 完全解決\\n- 顧客の全ての要求・問題が解決された\\n- 顧客が満足して通話を終了している\\n- 追加の対応や連絡が不要な状態\\n- 判定キーワード例:「ありがとうございました」「助かりました」「よく分かりました」「解決しました」\\n2. 一部解決\\n- 主要な問題は解決したが、軽微な課題や追加の疑問が残る\\n- 顧客は基本的に満足しているが、小さな不明点がある\\n- 判定キーワード例:「これについては分かりましたが」「もう一つ確認したいことが」「基本的には理解できました」\\n3. 未解決\\n- 顧客の主要な問題が解決されていない\\n- 具体的な解決策や対応方法が提示されていない\\n- 問題を抱えたまま通話が終了している\\n- 判定キーワード例:「まだよく分からない」「解決していない」「また連絡します」「どうすればいいですか」\\n- ※顧客が困りごとを相談したが解決策が提示されない場合も「未解決」\\n4. 解決不要\\n- そもそも解決すべき問題や困りごとがない\\n- 単純な情報確認や現状照会のみの通話\\n- 顧客に困りごとがなく、確認事項に対して適切に回答済み\\n- 判定キーワード例:「確認できました」「情報をいただきありがとうございます」「現在の状況が分かりました」\\n- ※重要:顧客が「〜が分からない」「〜できない」等の問題を抱えている場合は「解決不要」ではない\\n**## 出力フォーマット(必要に応じて調整可能だが注意必要!)**\\n【解決状況】:完全解決/一部解決/未解決/解決不要\\n【解決状況の根拠】:[判定理由と該当する顧客発言を簡潔に説明]\\n大分類: [番号] - [選択した大分類]\\n中分類: [番号] - [選択した中分類]\\n小分類: [番号] - [選択した小分類]\\n理由: [判断根拠を簡潔に説明]\\n【カスハラ判定結果】:[精神的攻撃型/過剰要求型/差別型/身体的攻撃型/クレーム/なし]\\n【該当発言】:[カスハラまたはクレームの場合は発言引用、なしの場合は「なし」]\\n【要約結果】:\\n・~~~~\\n・~~~~\\n・~~~~\\n**## 重要な出力ルール(必要に応じてカスタマイズ)**\\n- 要約結果は500文字以内で記載する\\n- 【カスハラ判定結果】にはタイプ名のみを記載(「カスハラ・」は付けない)\\n- カスハラの場合は「精神的攻撃型」「過剰要求型」「差別型」「身体的攻撃型」のいずれか1つのみ\\n- 【カスハラ判定結果】の直後に【該当発言】を記載\\n- 【該当発言】と【要約結果】の間に余計な説明や空行を入れない\\n- クレームの場合、【該当発言】には発言引用のみを記載し、理由説明は含めない\\n- カスハラの場合、【該当発言】には「発言引用:\\\"~\\\" 理由:~ 重度レベル:○○」の形式で記載\"\r\n    },\r\n    {\r\n      \"role\": \"user\",\r\n      \"content\": \"{VOICE_LOG.JSON_ESCAPE()}\"\r\n    }\r\n  ],\r\n  \"max_tokens\": 700,\r\n  \"temperature\": 0.7\r\n}",
      "request_header": "Authorization:Bearer XXXXXXXX\r\nContent-Type:application/json",
      "request_method": "POST",
      "request_url": "https://api.openai.com/v1/chat/completions",
      "response_variable_pattern": "/【解決状況】:\\s*(?P<RESOLUTION_STATUS>[^\\n]+)\\s*【解決状況の根拠】:\\s*(?P<RESOLUTION_REASON>[\\s\\S]*?)大分類:\\s*(?P<DAI_FULL>[^\\n]+)\\s*中分類:\\s*(?P<CHU_FULL>[^\\n]+)\\s*小分類:\\s*(?P<SHO_FULL>[^\\n]+)\\s*理由:\\s*(?P<CATEGORY_REASON>[\\s\\S]*?)【カスハラ判定結果】:\\s*(?P<HARASSMENT>[^\\n]+)\\s*【該当発言】:\\s*(?P<HARASSMENT_DETAIL>[\\s\\S]*?)【要約結果】:\\s*(?P<SUMMARY>[\\s\\S]*?)(?=,\"refusal\":null,\"annotations\":\\[\\]}|\")/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_sms_template_id": null,
      "result_entry_summary_text": null,
      "result_entry_tag_code": null,
      "result_entry_tag_id": null,
      "result_entry_tag_pattern": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 60,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 2,
      "max_retry_count": 3,
      "oauth_account_id": null,
      "precondition_pattern": "/Contact|Lead/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n  \"WhoId\": \"{RESPONSE_NOID}\",\r\n  \"Subject\": \"{STARTTIME}に通話(着信)\",\r\n  \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n------------\\r\\n【解決状況】:{RESPONSE_RESOLUTION_STATUS}\\r\\n【解決状況の根拠】:{RESPONSE_RESOLUTION_REASON}\\r\\n------------\\r\\n【コールリーズン大分類】:{RESPONSE_DAI_FULL}\\r\\n【コールリーズン中分類】:{RESPONSE_CHU_FULL}\\r\\n【コールリーズン小分類】:{RESPONSE_SHO_FULL}\\r\\n【分類理由】:{RESPONSE_CATEGORY_REASON}\\r\\n------------\\r\\n【カスハラ判定結果】:{RESPONSE_HARASSMENT}\\r\\n【該当発言・理由】:{RESPONSE_HARASSMENT_DETAIL}\\r\\n------------\\r\\n【要約結果】:{RESPONSE_SUMMARY}\",\r\n  \"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}\\\\r\\\\n■通話時間:{CALL_SEC}\",\r\n  \"Resolution_Level__c\": \"{RESPONSE_RESOLUTION_STATUS}\",\r\n  \"Call_Reason_Large__c\": \"{RESPONSE_DAI_FULL}\",\r\n  \"Call_Reason_Medium__c\": \"{RESPONSE_CHU_FULL}\",\r\n  \"Call_Reason_Small__c\": \"{RESPONSE_SHO_FULL}\",\r\n  \"Conversation_Category__c\": \"{RESPONSE_HARASSMENT}\",\r\n  \"WavUrl__c\": \"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_sms_template_id": null,
      "result_entry_summary_text": null,
      "result_entry_tag_code": null,
      "result_entry_tag_id": null,
      "result_entry_tag_pattern": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 3,
      "max_retry_count": 3,
      "oauth_account_id": null,
      "precondition_pattern": "/Account/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n\t\"WhatId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n\t\"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n------------\\r\\n【解決状況】:{RESPONSE_RESOLUTION_STATUS}\\r\\n【解決状況の根拠】:{RESPONSE_RESOLUTION_REASON}\\r\\n------------\\r\\n【コールリーズン大分類】:{RESPONSE_DAI_FULL}\\r\\n【コールリーズン中分類】:{RESPONSE_CHU_FULL}\\r\\n【コールリーズン小分類】:{RESPONSE_SHO_FULL}\\r\\n【分類理由】:{RESPONSE_CATEGORY_REASON}\\r\\n------------\\r\\n【カスハラ判定結果】:{RESPONSE_HARASSMENT}\\r\\n【該当発言・理由】:{RESPONSE_HARASSMENT_DETAIL}\\r\\n------------\\r\\n【要約結果】:{RESPONSE_SUMMARY}\",\r\n\t\"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}\\\\r\\\\n■通話時間:{CALL_SEC}\",\r\n\t\"Resolution_Level__c\": \"{RESPONSE_RESOLUTION_STATUS}\",\r\n\t\"Call_Reason_Large__c\": \"{RESPONSE_DAI_FULL}\",\r\n\t\"Call_Reason_Medium__c\": \"{RESPONSE_CHU_FULL}\",\r\n\t\"Call_Reason_Small__c\": \"{RESPONSE_SHO_FULL}\",\r\n\t\"Conversation_Category__c\": \"{RESPONSE_HARASSMENT}\",\r\n\t\"WavUrl__c\": \"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_sms_template_id": null,
      "result_entry_summary_text": null,
      "result_entry_tag_code": null,
      "result_entry_tag_id": null,
      "result_entry_tag_pattern": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 4,
      "max_retry_count": 3,
      "oauth_account_id": null,
      "precondition_pattern": "/^(?!.*(Contact|Lead|Account)).*$/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n\t\"WhoId\": \"XXXXXXXX\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n\t\"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n------------\\r\\n【解決状況】:{RESPONSE_RESOLUTION_STATUS}\\r\\n【解決状況の根拠】:{RESPONSE_RESOLUTION_REASON}\\r\\n------------\\r\\n【コールリーズン大分類】:{RESPONSE_DAI_FULL}\\r\\n【コールリーズン中分類】:{RESPONSE_CHU_FULL}\\r\\n【コールリーズン小分類】:{RESPONSE_SHO_FULL}\\r\\n【分類理由】:{RESPONSE_CATEGORY_REASON}\\r\\n------------\\r\\n【カスハラ判定結果】:{RESPONSE_HARASSMENT}\\r\\n【該当発言・理由】:{RESPONSE_HARASSMENT_DETAIL}\\r\\n------------\\r\\n【要約結果】:{RESPONSE_SUMMARY}\",\r\n\t\"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}\\\\r\\\\n■通話時間:{CALL_SEC}\",\r\n\t\"Resolution_Level__c\": \"{RESPONSE_RESOLUTION_STATUS}\",\r\n\t\"Call_Reason_Large__c\": \"{RESPONSE_DAI_FULL}\",\r\n\t\"Call_Reason_Medium__c\": \"{RESPONSE_CHU_FULL}\",\r\n\t\"Call_Reason_Small__c\": \"{RESPONSE_SHO_FULL}\",\r\n\t\"Conversation_Category__c\": \"{RESPONSE_HARASSMENT}\",\r\n\t\"WavUrl__c\": \"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_sms_template_id": null,
      "result_entry_summary_text": null,
      "result_entry_tag_code": null,
      "result_entry_tag_id": null,
      "result_entry_tag_pattern": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    }
  ]
}
 

Ⅱ コールアクションテンプレートをインポート
BIZTEL管理画面より「連携オプション>コールアクション連携」をクリックして、画面右上の「インポート」をクリックします。詳細はこちらの「6.2 コールアクションのインポート」をご参照ください。

Ⅲ コールアクション連携を編集
作成されたコールアクション連携の「API連携」タブをクリックしてください。各設定情報を編集していきます。

【必須で修正する箇所(合計6件)】
・!マークが出ている設定は、OAuthアカウントが未設定のため、「BIZTELの設定 2. OAuthアカウント設定」で登録したSalesforce用のOAuthアカウントを選択します(計4件)。

・以下のイベントURL内「XXXXXXXX」で表示されている箇所は、適切な値に書き換えます(計2件)。
<録音完了/音声認識連携完了>実行順1:OpenAI APIキー
<録音完了/音声認識連携完了>実行順4:紐づけ先が特定できない時のレコードID

(録音完了/音声認識連携完了イベント 実行順1:OpenAI APIキー設定例)

(録音完了/音声認識連携完了イベント 実行順4:レコードID設定例)
下の画像の赤線部分には、発信番号から履歴を紐づけるレコードが特定できなかった場合にデータの受け渡し先となる、リードのレコードIDを記載します。

※レコードIDの確認方法(以下の赤線部分がレコードIDです)

Ⅳ お客さまの業務に応じて、OpenAI APIへの指示を調整
<録音完了/音声認識連携完了>実行順1にて、OpenAI APIへ要約や各種判定の指示をしているので、業務にあわせて修正してください。
なお、本プロンプトのコールリーズン事例・カスハラ事例・判断基準などはあくまでも参考情報としてご活用ください。

▼OpenAI APIへの指示内容(APIリクエストボディのcontentを整形して表示したもの)

【通話テキスト分析タスク】
以下の手順で、通話テキストのコールリーズン分類とカスハラ判定と解決状況判定を行ってください。

## PART1: コールリーズン分類

STEP1-3: 段階的分類

  1. 大分類を特定
  2. 該当する中分類を特定
  3. 該当する小分類を特定

判断基準:
- 複数の分類にまたがる場合は、顧客の最終的な目的・ゴールを重視
- 会話の大部分を占める内容で判断
- 1つの分類のみを選択
- どの分類にも該当しない場合は「なし」と出力

【分類体系】(要修正:業務にあわせて修正)

[大分類1] 検討・情報収集[大分類2] 申し込み[大分類3] 操作方法[大分類4] 解約[中分類1-1] 条件[中分類2-1] 口座開設[中分類3-1] ログイン[中分類4-1] 解約手続き[小分類1-1-1] 利用者の年齢[小分類2-1-1] Webでの手続き[小分類3-1-1] ログイン操作[小分類4-1-1] Webでの手続き[小分類1-1-2] 店舗・口座[小分類2-1-2] 来店での手続き・持ち物[小分類3-1-2] IDが分からない[小分類4-1-2] 来店での手続き・持ち物[小分類2-1-3] 本人確認書類[小分類3-1-3] パスワードが分からない[小分類4-1-3] 郵送での手続き[中分類1-2] サービス内容[小分類3-1-4] パスワードのリセット方法[小分類1-2-1] 定期預金[中分類2-2] インターネットバンキング申し込み[小分類1-2-2] 投資信託[小分類2-2-1] Webでの手続き[中分類3-2] 定期預金[小分類1-2-3] 普通預金・振込[小分類2-2-2] 来店での手続き・持ち物[小分類3-2-1] 預金の操作方法[小分類1-2-4] 住宅ローン[小分類2-2-3] 郵送での手続き[小分類3-2-2] 中途解約の操作[小分類2-2-4] 本人確認書類[小分類3-2-3] 満期手続きの操作[小分類2-2-5] 印鑑が分からない・見つからない[小分類3-2-4] 契約内容の確認[小分類2-2-6] 通帳が分からない・見つからない[小分類3-2-5] 金利[中分類2-3] 会員証・暗証番号の発送[中分類3-3] 投資信託[小分類2-3-1] 発送方法[小分類3-3-1] 購入の操作方法[小分類2-3-2] 発送時期[小分類3-3-2] 解約の操作[小分類2-3-3] 発送状況の確認[小分類3-3-3] 償還の操作[小分類3-3-4] 契約内容の確認[小分類3-3-5] ファンドの質問(転送含む)[中分類3-4] 普通預金・振り込み[小分類3-4-1] 入出金明細の操作[小分類3-4-2] 振り込みの操作[小分類3-4-3] 振り込みの手数料[小分類3-4-4] 振り込み用の暗証番号[中分類3-5] 住宅ローン[小分類3-5-1] 残高照会[小分類3-5-2] 一部繰上返済[小分類3-5-3] 金利コース変更[小分類3-5-4] 相談(転送)[中分類3-6] 会員証・暗証番号の喪失[小分類3-6-1] 利用停止・再発行受付[小分類3-6-2] 再発行状況の確認

## PART2: カスハラ・クレーム判定

## 【最優先判定ルール】

  1. 会話全体から[A][B]に該当する発言を探す
  2. 該当発言があれば必ず「カスハラ」と判定
  3. 該当発言がない場合のみ、クレームまたは通常会話と判定

## [A] カスハラの定義(必要に応じてカスタマイズ)

① 従業員に苦痛を与える迷惑行為
② 人格・尊厳を侵害し安全を損なう行為

## [B] カスハラのタイプ ※業界特性に応じて調整可能ですが、この指示内容(白枠内部分)の下に記載の「注意」が必要!

  1. 精神的攻撃型:暴言・脅迫・人格否定
  2. 過剰要求型:制度外の要求
  3. 差別型:差別的発言
  4. 身体的攻撃型:物理的危害の示唆

## カスハラの明確な事例(必要に応じてカスタマイズ)

### 精神的攻撃型

* 「あなたはバカなの?」
* 「無能だね」
* 「あなたの名前と顔を覚えておくからね」
* 「あなた個人に責任を取らせる」

### 過剰要求型

* 「24時間以内に対応しないと訴える」
* 「規約は関係ない、今すぐ特別対応しろ」

### 差別型

* 「男性スタッフに代われ」
* 「若い人より年配の人に代わってほしい」

### 身体的攻撃型

* 「殴るぞ」
* 「あなたの住所を調べるからな」
* 「SNSに顔写真を晒すぞ」

## [C] クレームの判定基準(業界特性に応じて調整可能)

クレームとは、製品・サービスへの不満や改善要望で、感情的表現を含むことがあっても社会通念内であり、業務内容に対する批判や問題指摘を含むものです。

クレームと判定する基準:
- 製品・サービスの具体的な問題点への言及
- 改善や対応を求める明確な意思表示
- 具体的な商品不良、不具合の指摘
- 交換、返品、修理などの改善要求
- サービスの品質に対する明確な不満表明

※単なる一般的な問い合わせや軽微な質問は「通常会話」とするが、実質的な不満や改善要求がある場合はクレームとして扱う

## [D] 分析タスク

  1. 会話を判定:

- タイプ[B]のいずれか
- クレーム
- なし

  1. 判定に応じて記載:

- カスハラ:[E]の優先順位に基づき、最も深刻な単一のタイプのみ選択
 * 該当タイプ、発言引用、理由
- クレーム:発言引用、内容
- 通常会話:「なし」

  1. 複数のカスハラタイプに該当する場合の判定方法:

- [E]の優先順位に従い、最上位の単一タイプのみを選択
- 例:身体的攻撃型と精神的攻撃型に該当する場合、「身体的攻撃型」のみ記載

## [E] 優先順位(必要に応じて順序を調整可能)

身体的攻撃型 > 精神的攻撃型 > 差別型 > 過剰要求型

## PART3: 解決状況判定(必要に応じてカスタマイズ)

【解決状況の判定基準】

通話終了時点での顧客の問題解決レベルを以下の4段階で判定してください:

重要:顧客が具体的な問題や困りごとを抱えている場合は「解決不要」ではありません。必ず問題解決の観点で判定してください。

  1. 完全解決

- 顧客の全ての要求・問題が解決された
- 顧客が満足して通話を終了している
- 追加の対応や連絡が不要な状態
- 判定キーワード例:「ありがとうございました」「助かりました」「よく分かりました」「解決しました」

  1. 一部解決

- 主要な問題は解決したが、軽微な課題や追加の疑問が残る
- 顧客は基本的に満足しているが、小さな不明点がある
- 判定キーワード例:「これについては分かりましたが」「もう一つ確認したいことが」「基本的には理解できました」

  1. 未解決

- 顧客の主要な問題が解決されていない
- 具体的な解決策や対応方法が提示されていない
- 問題を抱えたまま通話が終了している
- 判定キーワード例:「まだよく分からない」「解決していない」「また連絡します」「どうすればいいですか」
- ※顧客が困りごとを相談したが解決策が提示されない場合も「未解決」

  1. 解決不要

- そもそも解決すべき問題や困りごとがない
- 単純な情報確認や現状照会のみの通話
- 顧客に困りごとがなく、確認事項に対して適切に回答済み
- 判定キーワード例:「確認できました」「情報をいただきありがとうございます」「現在の状況が分かりました」
- ※重要:顧客が「〜が分からない」「〜できない」等の問題を抱えている場合は「解決不要」ではない

## 出力フォーマット ※必要に応じて調整可能ですが、この指示内容(白枠内部分)の下に記載の「注意」が必要!

【解決状況】:完全解決/一部解決/未解決/解決不要

【解決状況の根拠】:[判定理由と該当する顧客発言を簡潔に説明]

大分類: [番号] - [選択した大分類]
中分類: [番号] - [選択した中分類]
小分類: [番号] - [選択した小分類]

理由: [判断根拠を簡潔に説明]

【カスハラ判定結果】:[精神的攻撃型/過剰要求型/差別型/身体的攻撃型/クレーム/なし]
【該当発言】:[カスハラまたはクレームの場合は発言引用、なしの場合は「なし」]
【要約結果】:

・~~~~
・~~~~
・~~~~

## 重要な出力ルール(必要に応じてカスタマイズ)

- 要約結果は500文字以内で記載する
- 【カスハラ判定結果】にはタイプ名のみを記載(「カスハラ・」は付けない)
- カスハラの場合は「精神的攻撃型」「過剰要求型」「差別型」「身体的攻撃型」のいずれか1つのみ
- 【カスハラ判定結果】の直後に【該当発言】を記載
- 【該当発言】と【要約結果】の間に余計な説明や空行を入れない
- クレームの場合、【該当発言】には発言引用のみを記載し、理由説明は含めない
- カスハラの場合、【該当発言】には「発言引用:"~" 理由:~ 重度レベル:○○」の形式で記載


※プロンプト指示を変更する際の注意点※

  • コールリーズン分類の【分類体系】の内容を更新する場合
    • 上述の『Salesforce事前準備 2.活動オブジェクトにカスタム項目を新規作成』で作成した、「コールリーズン大分類」「コールリーズン中分類」「コールリーズン小分類」の設定値もあわせて変更してください。
  • [B]のカスハラタイプ内容を更新する場合
    • 上述の『Salesforce事前準備 2.活動オブジェクトにカスタム項目を新規作成』で作成した、「カスハラ/クレーム判定」の設定値もあわせて変更してください。
  • 出力フォーマットを更新する場合
    • 変数抽出パターンの正規表現も変更する必要がありますのでご注意ください。

上記のプロンプト指示をAPIのリクエストボディにそのまま貼り付けるとJSONエラーが発生します。APIで使用する場合は、改行や特殊文字はエスケープ処理が必要です。手動で処理するのは大変なので、生成AIにプロンプト指示の文字列を渡して「APIに情報を渡したいので、JSONエラーにならないようにエスケープ処理してください」というとエスケープ済みの文字列を表示してくれます。

Ⅴ 連携対象とする電話番号を選択
「連携対象」タブをクリックして、連携対象とする電話番号に✓を設定してください。

Ⅵ コールアクションの設定を有効化
「基本情報」タブをクリックして、ステータス項目を無効から有効に変更してください。

連携結果

Salesforceに通話内容を連携した結果、このようになりました。

振り返り・まとめ

今回の挑戦により、通話テキストと生成AIを最大限に活かし、適切なプロンプトを設計することで、高い精度でコールリーズンを自動分類できることがわかりました!

サンプルに基づき動作確認をした後は、ぜひ皆さまの現場の状況に合わせてプロンプトをカスタマイズし、さらに実用的なものに仕上げていただければと思います。また、Salesforceのダッシュボードやレポート機能から、コールリーズン・解決状況・カスハラ(またはクレーム)の発生有無といった情報を組み合わせて多角的に分析できるようになります。

例えば、今回のコールリーズンの分類体系であれば、

  • 未解決が多い問い合わせ
    (例:「ログイン操作」に関する問い合わせの解決率が低い など)
  • クレームが発生しやすい問い合わせ
    (例:「定期預金の相談」でクレームが発生しやすい など)

といったことが把握でき、効果的な対策を講じるための情報として活用できます。

本記事が、働きやすい職場づくりと顧客満足度の両立に役立ちますと、とても嬉しいです!

編集後記

今回は、「生成AI」とBIZTELの「API連携コールアクション」「音声認識連携」機能を活用して、通話内容からコールリーズンを自動分類するとともに、問い合わせの解決状況やカスハラ発生の有無について判定を行い、Salesforceへ連携する仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。
現在、BIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2025/11/07/17500/feed/ 0
BIZTEL API使ってみた vol.16 コールアクション×生成AIでカスハラを自動判定!Salesforceに結果を連携して分析を効率化 /blog/2025/05/28/16323/ /blog/2025/05/28/16323/#respond Wed, 28 May 2025 03:00:27 +0000 /?p=16323 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと 東京都など […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

東京都などが2025年4月1日に施行した「カスタマー・ハラスメント防止条例」が、全国初の試みとして注目を集めています。北海道や三重県桑名市でも同様の条例が施行され、他の自治体でも検討が進むなど、全国的な広がりを見せています。

カスタマー・ハラスメント(以下 カスハラ)は電話による顧客接点においても発生しており、対策を進めるコールセンターが増えてきました。

そこで今回は「生成AI(※1)」と、BIZTELの「API連携コールアクション」「音声認識連携」を活用し、テキスト化した通話内容からカスハラに該当するかを自動判定する仕組みに挑戦します。
具体的には、通話内容を「カスハラ」「クレーム」「通常会話」に分類(※2)し、その結果をSalesforceに自動で記録してみたいと思います。

※1 今回利用するモデルは、OpenAI APIの「GPT-4.1 mini」です。最大100万トークンの長文処理に対応でき、コスト効率と高精度を兼ね備えたAPI専用モデルです。テキスト化した通話の要約や「カスハラ」「クレーム」「通常会話」といった分類処理において、高い性能を発揮することが期待できます。

※2 本記事では、厚生労働省の定義を参考に、「社会通念を超えた迷惑行為で、精神的攻撃・過剰要求・差別・身体的攻撃のいずれかに該当するもの」をカスハラとし、「製品やサービスへの正当な不満であり、個人攻撃を含まないもの」をクレームとして判定します。

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回ご紹介するシステム間の連携を行うためには、BIZTELのバージョンが3.7.20以上である必要があります。

BIZTELで必要なオプション

・API連携コールアクション

・音声認識連携(AmiVoice API)
※詳細はこちらの「1.音声認識連携(AmiVoice API)」をご覧ください。

BIZTEL以外に必要なもの

・Salesforce

・OpenAI API
※OpenAI APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、OpenAIのWebサイトをご覧ください。

・AmiVoice API
※AmiVoice APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、AmiVoice APIのWebサイトをご覧ください。

動作の全体像

カスハラ自動判定の結果を、Salesforceに記載(GPT-4.1 miniモデルを使用)

設定の流れ

OpenAI 事前準備

OpenAI APIを利用してお客さまとの会話を要約し、さらにカスハラ判定を行うため、APIキーの発行します。

Salesforce 事前準備

SalesforceのAPIを利用して通話内容を記録するため、OAuth認証接続アプリケーションの作成とToDoオブジェクトの項目設定やページレイアウトの変更を行います。

BIZTEL 事前設定

お客さまとの会話をテキスト化するため、音声認識連携の設定を行います。
さらに、通話内容の要約、カスハラの判定結果などをSalesforceに記録するため、「コールアクションテンプレート機能」を利用してコールアクションを設定します。

設定の実践

OpenAI 事前準備

1.OpenAIのAPIキーを発行
お客さまにてOpenAIのアカウント作成および、OpenAI APIキー発行が必要となります。発行手順はこちらの記事の「設定の実践 OpenAI 事前準備」をご参照ください。

Salesforce 事前準備

1.OAuth認証の接続アプリケーションを作成
こちらの記事の「設定の実践 1.Salesforce 設定準備」を参照しながら、SalesforceのOAuth認証のアプリケーション作成と鍵情報の確認を行います。

2.活動オブジェクトにカスタム項目「会話分類」「通話録音再生」を新規作成
カスハラ種別を格納する項目が必要なため、以下に従って作成します。
作成方法については、こちらの「2.3 カスタム項目の作成」をご参照ください。

 ◾︎通話録音再生

 ◾︎会話分類

3.ToDoオブジェクトのページレイアウトを変更
以下が連携に必要な項目なので、任意のレイアウトを定義してください。

(ページレイアウトの設定例)

BIZTELの設定

1.音声認識連携
お客さまの音声をテキスト化するための設定を行います。設定方法については、こちらの「2. 音声認識連携の設定方法」をご参照ください。
※別途、アドバンスト・メディア社の「AmiVoice API」 のご契約が必要です。

2.OAuthアカウント設定
BIZTELとSalesforceを連携するためのOAuth設定を行います。こちらの記事の「設定の実践 2.BIZTELでのOAuth設定」をご参照ください。

3.コールアクション連携
通話内容の要約や、カスハラ判定の結果をSalesforceに記録するコールアクションの設定を「コールアクションテンプレート機能」を利用して行います。

OpenAIに依頼するプロンプト概要

<コールアクション連携 手順の概要>
Ⅰ  テキストエディタを利用して、コールアクションテンプレートを作成
Ⅱ  BIZTEL管理画面から、コールアクションテンプレートをインポート
Ⅲ  BIZTEL管理画面から、コールアクション連携を編集
  OAuthアカウント設定 :4件編集
  紐づけ先が特定できない時のレコードID:1件編集
  OpenAI APIキー:1件編集
  ※合計6件修正することで設定が完了します。
Ⅳ お客さまの業務に応じて、OpenAI APIへの指示を調整

<コールアクション連携 手順の詳細>
Ⅰ コールアクションテンプレートを作成
以下のテキストをすべてコピーして、テキストエディタにペーストして保存してください。

注意事項
●ファイルはJSON形式であるため、ファイルの拡張子は「.json」にしてください。
●文字コードはUTF8で保存してください。

{
  "version_name": "unknown",
  "version_hash": "962c54e",
  "name": "カスタマーハラスメント自動判定版",
  "memo": "gpt-4.1-mini対応版",
  "api_nodes": [
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": null,
      "request_method": "GET",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/parameterizedSearch/?q={TEL}&sobject=Account&sobject=Contact&sobject=Lead",
      "response_variable_pattern": "/\"attributes\":\\{\"type\":\"(?P<TYPE>[a-zA-Z]*)\".*?\"Id\":\"(?P<NOID>[a-zA-Z0-9]*)\"/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 1,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": "{\r\n  \"model\": \"gpt-4.1-mini\",\r\n  \"messages\": [\r\n     {\r\n     \"role\": \"system\",\r\n     \"content\": \"# 通話内容をカスタマーハラスメント定義に基づき判定します。\\n## 【最優先判定ルール】\\n1. 会話全体から[A][B]に該当する発言を探す\\n2. 該当発言があれば必ず「カスハラ」と判定\\n3. 該当発言がない場合のみ、クレームまたは通常会話と判定\\n## [A] カスハラの定義\\n① 従業員に苦痛を与える迷惑行為\\n② 人格・尊厳を侵害し安全を損なう行為\\n## [B] カスハラのタイプ\\n1. 精神的攻撃型:暴言・脅迫・人格否定\\n2. 過剰要求型:制度外の要求\\n3. 差別型:差別的発言\\n4. 身体的攻撃型:物理的危害の示唆\\n## カスハラの明確な事例\\n### 精神的攻撃型\\n* 「あなたはバカなの?」\\n* 「無能だね」\\n* 「あなたの名前と顔を覚えておくからね」\\n* 「あなた個人に責任を取らせる」\\n### 過剰要求型\\n* 「24時間以内に対応しないと訴える」\\n* 「規約は関係ない、今すぐ特別対応しろ」\\n### 差別型\\n* 「男性スタッフに代われ」\\n* 「若い人より年配の人に代わってほしい」\\n### 身体的攻撃型\\n* 「殴るぞ」\\n* 「あなたの住所を調べるからな」\\n* 「SNSに顔写真を晒すぞ」\\n## [C] クレームの判定基準\\nクレームとは、製品・サービスへの不満や改善要望で、感情的表現を含むことがあっても社会通念内であり、業務内容に対する批判や問題指摘を含むものです。 \\n\\nクレームと判定する基準:\\n- 製品・サービスの具体的な問題点への言及\\n- 改善や対応を求める明確な意思表示\\n- 具体的な商品不良、不具合の指摘\\n- 交換、返品、修理などの改善要求\\n- サービスの品質に対する明確な不満表明\\n\\n※単なる一般的な問い合わせや軽微な質問は「通常会話」とするが、実質的な不満や改善要求がある場合はクレームとして扱う\\n## [D] 分析タスク\\n1. 会話を判定:\\n- タイプ[B]のいずれか\\n- クレーム\\n- なし\\n2. 判定に応じて記載:\\n- カスハラ:[E]の優先順位に基づき、最も深刻な単一のタイプのみ選択\\n  * 該当タイプ、発言引用、理由\\n- クレーム:発言引用、内容\\n- 通常会話:「なし」\\n3. 複数のカスハラタイプに該当する場合の判定方法:\\n- [E]の優先順位に従い、最上位の単一タイプのみを選択\\n- 例:身体的攻撃型と精神的攻撃型に該当する場合、「身体的攻撃型」のみ記載\\n## [E] 優先順位\\n身体的攻撃型 > 精神的攻撃型 > 差別型 > 過剰要求型\\n## [F] 出力フォーマット\\n1. 【判定結果】と【該当発言】は同じ行に必ず記載\\n2. 通話内容の要約(500文字以内)\\n3. 【判定結果】は必ず以下の形式で出力:\\n   - カスハラの場合:「【判定結果】:型名」\\n   - クレームの場合:「【判定結果】:クレーム」\\n   - 通常会話の場合:「【判定結果】:なし」\\n\\n【判定結果】:[B]のいずれかの型名のみ/クレーム/なし【該当発言】:\\n- 発言引用:「~~~~」/なし\\n- 理由/内容:~~~。※カスハラの場合:〇〇(軽度/中度/重度)\\n\\n【要約結果】:\\n- ~~~~\\n- ~~~~\\n※要約できない場合は「要約できません」\"\r\n   },\r\n    {\r\n      \"role\": \"user\",\r\n      \"content\": \"{VOICE_LOG.JSON_ESCAPE()}\"\r\n    }\r\n  ],\r\n  \"max_tokens\": 700,\r\n  \"temperature\": 0.7\r\n}",
      "request_header": "Authorization:Bearer XXXXXXXX\r\nContent-Type:application/json",
      "request_method": "POST",
      "request_url": "https://api.openai.com/v1/chat/completions",
      "response_variable_pattern": "/【判定結果】:(?P<CATEGORY>[\\s\\S]*?)(?=【該当発言】)【該当発言】:(?P<COM>[\\s\\S]*?)(?=【要約結果】)【要約結果】:(?P<SUM>[\\s\\S]*?)(?=\",\"refusal\"|$)/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 60,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 2,
      "max_retry_count": 3,
      "precondition_pattern": "/Contact|Lead/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n\t\"WhoId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n\t\"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n【判定結果】:{RESPONSE_CATEGORY}\\r\\n【該当発言】:{RESPONSE_COM}\\r\\n【要約結果】:{RESPONSE_SUM}\",\r\n\t\"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}■通話時間:{CALL_SEC}\",\"Conversation_Category__c\": \"{RESPONSE_CATEGORY}\",\"CallAudioUrl__c\":\"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 3,
      "max_retry_count": 3,
      "precondition_pattern": "/Account/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n\t\"WhatId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n\t\"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n【判定結果】:{RESPONSE_CATEGORY}\\r\\n【該当発言】:{RESPONSE_COM}\\r\\n【要約結果】:{RESPONSE_SUM}\",\r\n\t\"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}■通話時間:{CALL_SEC}\",\"Conversation_Category__c\": \"{RESPONSE_CATEGORY}\",\"CallAudioUrl__c\":\"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 4,
      "max_retry_count": 3,
      "precondition_pattern": "/^(?!.*(Contact|Lead|Account)).*$/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\r\n\t\"WhoId\": \"XXXXXXXX\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n\t\"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n【判定結果】:{RESPONSE_CATEGORY}\\r\\n【該当発言】:{RESPONSE_COM}\\r\\n【要約結果】:{RESPONSE_SUM}\",\r\n\t\"CallDisposition\": \"■発信電話番号:{TEL}■着信電話番号:{CALLED}■着信アカウント名:{AGENT_NAME}\\\\r\\\\n■着信内線番号:{AGENT_EXTEN_NO}■通話開始時間:{START_TIME}\\\\r\\\\n■通話終了時間:{END_TIME}■通話時間:{CALL_SEC}\",\"Conversation_Category__c\": \"{RESPONSE_CATEGORY}\",\"CallAudioUrl__c\":\"https://{HOST}:8000/monitor_link/{ID}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    }
  ]
}


Ⅱ コールアクションテンプレートをインポート

BIZTEL管理画面より「連携オプション>コールアクション連携」をクリックして、画面右上の「インポート」をクリックします。詳細はこちらの「6.2 コールアクションのインポート」をご参照ください。

Ⅲ コールアクション連携を編集
作成されたコールアクション連携の「API連携」タブをクリックしてください。各設定情報を編集していきます。

【必須で修正する箇所(合計6件)】

・!マークが出ている設定は、OAuthアカウントが未設定のため、「OAuthアカウント設定」で登録したSalesforce用のOAuthアカウントを選択します(計4件)。

・以下のイベントURL内「XXXXXXXX」で表示されている箇所は、適切な値に書き換えます(計2件)。
<録音完了/音声認識連携完了>実行順1:OpenAI APIキー
<録音完了/音声認識連携完了>実行順4:紐づけ先が特定できない時のレコードID

(録音完了/音声認識連携完了イベント 実行順1:OpenAI APIキー設定例)

(録音完了/音声認識連携完了イベント 実行順4:レコードID設定例)
下の画像の赤線部分には、発信番号から履歴を紐づけるレコードを特定することができなかった場合に、紐づけるリードのレコードIDを記載します。

※レコードIDの確認方法(以下の赤線部分がレコードIDです)

Ⅳ お客さまの業務に応じて、OpenAI APIへの指示を調整
<録音完了/音声認識連携完了>実行順1にて、OpenAI APIへ要約やカスハラ判定の指示をしているので、必要に応じて修正してください。
なお、本プロンプトのカスハラ事例・判断基準などは、あくまでも参考情報としてご活用ください。

▼OpenAI APIへの指示内容(APIリクエストボディのcontentを整形して表示したもの)

# 通話内容をカスタマーハラスメント定義に基づき判定します。

## 【最優先判定ルール】

  1. 会話全体から[A][B]に該当する発言を探す
  2. 該当発言があれば必ず「カスハラ」と判定
  3. 該当発言がない場合のみ、クレームまたは通常会話と判定

## [A] カスハラの定義(必要に応じてカスタマイズ)

① 従業員に苦痛を与える迷惑行為
② 人格・尊厳を侵害し安全を損なう行為

## [B] カスハラのタイプ ※業界特性に応じて調整可能ですが、この指示内容(白枠内部分)の下に記載の注意が必要!

  1. 精神的攻撃型:暴言・脅迫・人格否定
  2. 過剰要求型:制度外の要求
  3. 差別型:差別的発言
  4. 身体的攻撃型:物理的危害の示唆

## カスハラの明確な事例(必要に応じてカスタマイズ) 

### 精神的攻撃型

* 「あなたはバカなの?」
* 「無能だね」
* 「あなたの名前と顔を覚えておくからね」
* 「あなた個人に責任を取らせる」

### 過剰要求型

* 「24時間以内に対応しないと訴える」
* 「規約は関係ない、今すぐ特別対応しろ」

### 差別型

* 「男性スタッフに代われ」
* 「若い人より年配の人に代わってほしい」

### 身体的攻撃型

* 「殴るぞ」
* 「あなたの住所を調べるからな」
* 「SNSに顔写真を晒すぞ」

## [C] クレームの判定基準(業界特性に応じて調整可能)

クレームとは、製品・サービスへの不満や改善要望で、感情的表現を含むことがあっても社会通念内であり、業務内容に対する批判や問題指摘を含むものです。 

クレームと判定する基準:

- 製品・サービスの具体的な問題点への言及
- 改善や対応を求める明確な意思表示
- 具体的な商品不良、不具合の指摘
- 交換、返品、修理などの改善要求
- サービスの品質に対する明確な不満表明

※単なる一般的な問い合わせや軽微な質問は「通常会話」とするが、実質的な不満や改善要求がある場合はクレームとして扱う

## [D] 分析タスク

  1. 会話を判定:

- タイプ[B]のいずれか
- クレーム
- なし

  1. 判定に応じて記載:

- カスハラ:[E]の優先順位に基づき、最も深刻な単一のタイプのみ選択
 * 該当タイプ、発言引用、理由
- クレーム:発言引用、内容
- 通常会話:「なし」

  1. 複数のカスハラタイプに該当する場合の判定方法:

- [E]の優先順位に従い、最上位の単一タイプのみを選択
- 例:身体的攻撃型と精神的攻撃型に該当する場合、「身体的攻撃型」のみ記載

## [E] 優先順位(必要に応じて順序を調整可能)

身体的攻撃型 > 精神的攻撃型 > 差別型 > 過剰要求型

## [F] 出力フォーマット ※必要に応じて調整可能ですが、この指示内容(白枠内部分)の下に記載の注意が必要!

  1. 【判定結果】と【該当発言】は同じ行に必ず記載
  2. 通話内容の要約(500文字以内)
  3. 【判定結果】は必ず以下の形式で出力:

  - カスハラの場合:「【判定結果】:型名」
  - クレームの場合:「【判定結果】:クレーム」
  - 通常会話の場合:「【判定結果】:なし」

【判定結果】:[B]のいずれかの型名のみ/クレーム/なし【該当発言】:

- 発言引用:「~~~~」/なし
- 理由/内容:~~~。※カスハラの場合:〇〇(軽度/中度/重度)

【要約結果】:

- ~~~~
- ~~~~

※要約できない場合は「要約できません」


※プロンプト指示を変更する際の注意点※

・[B]のカスハラタイプ内容を更新する場合
上述の『Salesforce事前準備 2.活動オブジェクトにカスタム項目「会話分類」「通話録音再生」を新規作成』の値の設定も併せて変更してください。

・[F]の出力フォーマットを更新する場合
変数抽出パターンの正規表現も変更する必要がありますのでご注意ください。

上記のプロンプト指示をAPIのリクエストボディにそのまま貼り付けるとJSONエラーが発生します。APIで使用する場合は、改行や特殊文字はエスケープ処理が必要です。手動で処理するのは大変なので、生成AIにプロンプト指示の文字列を渡して「APIに情報を渡したいので、JSONエラーにならないようにエスケープ処理してください」というとエスケープ済みの文字列を表示してくれます。


Ⅴ 連携対象とする電話番号を選択
「連携対象」タブをクリックして、連携対象とする電話番号に✓を設定してください。

Ⅵ コールアクションの設定を有効化
「基本情報」タブをクリックして、ステータス項目を無効から有効に変更してください。

結果

Salesforceに通話内容を連携した結果、このようになりました。

<カスハラと判定された場合>

<クレームと判定された場合>

<通常会話と判定された場合>

振り返り・まとめ

今回は「コールアクション」と「生成AI」を活用したカスタマー・ハラスメントの自動判定を実践しました。

適切なプロンプト設計をすることで、高い精度の判定が実現できることがわかりました。現場の声を取り入れた試行錯誤を重ねることで、より高い精度になることが期待できます。まずは、サンプル通りに動くことを確認し、その後、皆さまの運用に合わせたプロンプトにカスタマイズしてみてください。

管理者はSalesforceのダッシュボード・レポート機能から、カスハラやクレームの発生状況を簡単に確認できるようになります。「いつ」「どのような」カスハラが発生しているのかを把握しながら、効果的な対策の検討ができるでしょう。

カスハラ対策は、働きやすい職場づくりと顧客満足度の両立に貢献できます。具体的には、以下のような効果につながります。

①働きやすい職場づくり
・カスハラをいち早く見つけて、スタッフの心の負担を軽減
・「いつ」「どの部署」でカスハラが多いかを把握し、サポート体制を整備
・カスハラタイプごとに適切な対応フローを構築し、SV・管理者などへのスムーズなエスカレーションを実現

②顧客満足度の向上
・お客さまの不満や要望を一元管理して、商品・サービスの改善に役立てる
・過去のカスハラ事例の分析から、トラブルが起きそうな場面を予測して先手を打ち、事前に回避できるようにする
・応対マナーが原因でカスハラを誘発してしまった事例を参考に、説明の仕方や相手に与える印象などを改善

本記事が、皆さまのカスハラ対策推進のお役に立てば幸いです。

編集後記

今回は、「生成AI」とBIZTELの「API連携コールアクション」「音声認識連携」機能を活用して、通話内容をもとにカスハラを自動判定し、Salesforceへ連携する仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。
現在、BIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2025/05/28/16323/feed/ 0
BIZTEL APIアイデアベース Vol.3 コールセンターの混雑状況(待ち人数)をWebページに表示させたい /blog/2025/03/19/15708/ /blog/2025/03/19/15708/#respond Wed, 19 Mar 2025 03:00:33 +0000 /?p=15708 「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者がAPIを活用し、 世の中の仕組み・ツールとBIZTELを連携させることで 「こんなことができたら面白そう」 「こういうことが実現できるともっと […]]]>

「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者がAPIを活用し、
世の中の仕組み・ツールとBIZTELを連携させることで

「こんなことができたら面白そう」
「こういうことが実現できるともっと便利になるかも?」

といったアイデアを考え、どのように実現するか検討していきます。

今回は、コールセンターの混雑状況をお客さまが把握できるよう、オペレーターへの接続を待っている人数をリアルタイムにWebページへ表示する仕組みについてを考えてみました。

※「BIZTEL APIアイデアベース」シリーズは動作検証などを行っていない『構想段階』の記事となります。機能実装に関するご相談をお受けすることは可能ですが、詳しくお答えできない場合がございます。あらかじめご了承ください。

チャレンジャー

やってみたいこと

コールセンターに電話した際、「なかなかつながらない…」「あとどれくらい待つんだろう?」と困った経験はありませんか?

そんなお客さまの不満を軽減するために、BIZTELの「イベント通知API」を活用して、コールセンターのリアルタイムな混雑状況をWebページに表示させる仕組みを考えてみました。

▼お客さま・事業者、双方に嬉しいメリット
お客さま:混雑状況をひと目で把握でき、待ち時間の目安が立てやすい
事業者:お客さまの待ち時間に対するストレスを軽減し、クレーム防止やリソース管理の最適化が可能

※本記事で紹介する機能活用アイデアは技術的に実現可能ですが、Webページへの実装に関する詳細は個別の環境によって異なります。詳細はBIZTELまでお問い合わせください。

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回ご紹介する連携を行うためには、BIZTELのバージョンが3.8.0以上である必要があります。

BIZTELで必要なオプション

・イベント通知API
※詳細はこちら

BIZTEL以外に必要なもの

・コールセンターの待ち呼をリアルタイムで表示する実装プログラム
→本プログラムは、ご利用になる企業さま側で開発・実装いただく必要があります
→プログラム要件の一例として、イベント通知API(WebSocket API)を利用し、各センターの待ち呼情報を受信・表示する方法が考えられます

※詳細は、BIZTELまでお問い合わせください

動作の全体図

BIZTELの「イベント通知API(WebSocket API)」は、通常のREST APIとは異なり、サーバーが特定のイベント(例:待ち呼の発生)を検知してリアルタイムに通知を送る仕組みです。このため、リアルタイムで情報をやりとりする仕組みが構築できますが、自社システムに組み込むためのプログラム開発が必要になります。

動作イメージ

特定のコールセンターの待ち呼情報を取得し、待ち呼が発生したら、HTMLに待ち呼数を表示します。待ち呼数の変動に応じて、リアルタイムにHTMLの情報が更新されます。

※以下の画像は、Web上での待ち呼数の表示イメージです。BIZTELのサービスサイトへの実装はされていません。

・待ち呼があるとき:リアルタイムで待ち呼数が増加して表示されます。

・待ち呼がないとき:通話が切断された場合など、リアルタイムで待ち呼数が減ります。

まとめ

イベント通知APIを活用することで、コールセンターの待ち呼状況をリアルタイムに表示することが可能です。これにより、お客さまが待ち時間の目安を把握しやすくなり、顧客満足度の低下を防止することにもつながります。

また、このAPIで取得できるデータを蓄積・分析することで

  • オペレーターの効率的な人員配置
  • 混雑状況の傾向分析
  • 運営状況の可視化と改善

など、さらなる活用も可能です。

編集後記

今回は、BIZTELのイベント通知APIを利用して、コールセンターのリアルタイムな混雑状況をWebページに表示させる仕組みについて検討してみました。

「BIZTEL APIアイデアベース」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能活用をご紹介する予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2025/03/19/15708/feed/ 0
BIZTEL API使ってみた vol.15 通話評価を自動化!「AI連携」を使って音声レビューの工数を削減したい ~第2弾〜 /blog/2024/12/04/15164/ /blog/2024/12/04/15164/#respond Wed, 04 Dec 2024 04:00:43 +0000 /?p=15164 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと 『BIZT […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

『BIZTEL API使ってみた vol.14 通話評価を自動化!「AI連携」を使って応対品質チェックの工数を削減したい』の第2弾として、今回は引き続き「AI連携」を活用した通話評価の自動化を試みます。

コールセンター業務の中で、お客さまに重要な情報を正確に伝えることは、品質管理において欠かせません。特に、電話予約時に法的な説明や契約に関連する重要事項を正しく伝えているかどうかは、後々のトラブルを未然に防ぐためにも大切です。

今回は、「AI連携」を活用して、お客さまに「重要事項説明」をきちんと伝えられているかを自動的に評価する仕組みに挑戦したいと思います。

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約

※今回はOpenAIのAPIモデル「gpt-4o-mini」を利用しています。
AI連携はBIZTELバージョン3.9.0以上で利用可能ですが、OpenAIのAPIモデル「gpt-4o-mini」を利用するには、BIZTELのバージョンが3.10.0以上である必要があります。

BIZTELで必要なオプション

・AI連携
※詳細はこちらの「1. AI連携」をご覧ください。

・音声認識連携(AmiVoice API)
※詳細はこちらの「1.音声認識連携(AmiVoice API)」をご覧ください。

BIZTEL以外に必要なもの

・OpenAI API
※ChatGPTのAPIの使用には、従量制の料金が適用されます。
料金に関する詳細は、OpenAIのWebサイトをご覧ください。

・AmiVoice API
※AmiVoice APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、AmiVoice APIのWebサイトをご覧ください。

動作の全体像

Before:現状の業務プロセス例

例)1回あたり10分程度の通話の場合、応対品質の評価にかかる所要時間は30〜50分程度になります。
※1 例えば「契約が成立した通話は必ず確認する」という運用フローがある場合、オペレーターがその通話に「タグ」を付けておくことで、管理者が確認対象を簡単に把握できるようになります。

After:「AI連携」を利用した業務プロセス例

例)1回あたり10分程度の通話の場合、「AI連携」による自動評価であれば、評価結果の確認・アウトプットが【1分程度】に短縮されます
※2 通話中に通話履歴から「AI連携」を実行すると、リアルタイムで応対のセルフチェックができます。要点を確認しながら対応できるため品質改善につながります。

設定の実践

OpenAIの事前準備

OpenAIのAPIキーを発行します。
※お客さまにて、OpenAIのアカウント作成および、OpenAI APIキー発行が必要となります。
発行手順は「2.OpenAIの事前準備」をご参照ください。

BIZTEL事前設定

1.BIZTEL管理画面の「AI連携」>「OpenAI APIキー登録」を設定します。
(3.10.X未満のお客さまは「連携オプション」>「AI連携」>「Open AI APIキー登録」から設定します)

今回はより精度の高いモデルを利用するため、モデル名は「gpt-4o-mini」を入力してください。詳細は「OpenAI APIキー登録」をご参照ください。

2.BIZTEL管理画面の「AI連携」>「プロンプト設定」を設定します。
(3.10.X未満のお客さまは、「連携オプション」>「AI連携」>「 プロンプト設定」から設定をします)
詳細は「3.2 AI連携 プロンプト設定」をご参照ください。

▼以下は、プロンプトの入力例です。

- コールセンターのオペレータとお客様の通話内容を、以下の評価指標に基づいて評価してください
- 結果はMarkdown形式ではなく、シンプルな箇条書きにしてください。出力イメージは■出力例を参考にしてください。
- 必ず各項目がすべて確認されているか、および最後に確認事項が全て再確認されているかをチェックしてください。
- 全項目で対応できていたら○、1つでも確認できていないものがあれば×で評価してください。
- 評価の理由については、できている項目もできていない項目もお客様とオペレータの会話を引用しながら箇条書きで簡潔に補足してください。
- 特に、キャンセル待ちの今後の対応では「空きが出た場合の連絡」と「空きが出なかった場合の連絡」が行われているかを確認してください。単に「キャンセル待ちができる」という確認のみでは評価しないでください。

■評価指標
1. [確認事項]を全てお客様に確認しているか。
2. [重要事項]の説明が全てなされているか。
3. 最後に[確認事項]を全て再度お客様に確認して、間違いがないか確認しているか。

■確認事項
- ご宿泊代表者の名前
- ご宿泊代表者の連絡先
- ご宿泊の予約日付/人数(内訳)
- 到着時間/駐車場の利用有無
- 食事の有無
- アレルギーの有無

■重要事項
- アレルギー対応について、完全な除去はできないことを説明しているか。
- キャンセルポリシー(キャンセル時の費用など)を説明しているか。
- キャンセル待ちの対応(空きが出た場合、出なかった場合の連絡方法)を説明しているか。

■出力例
【総合評価】:〇か×
評価理由:

【確認事項】:〇か×
評価理由:
- ご宿泊代表者の名前:〇か×(補足)
- ご宿泊代表者の連絡先:〇か×(補足)
- ご宿泊の予約日付/人数:〇か×(補足)
- 到着時間/駐車場の利用有無:〇か×(補足)
- 食事の有無:〇か×(補足)
- アレルギーの有無:〇か×(補足)
- 上記全項目の再確認:〇か×(補足)

【重要事項】:〇か×
評価理由:
- アレルギー対応についての説明:〇か×(補足)
- キャンセルポリシーの説明:〇か×(補足)
- キャンセル待ち対応の説明:〇か×(補足)

AI解析実行

通話中もしくは通話後、履歴画面またはワークスペースよりAI解析を実行します。
※今回はコールセンター履歴画面の履歴モーダル画面から実行します。

「AI連携」を活用し、プロンプトに評価指標を詳細に設定することで、全体的に問題が無いように見える応対でも、AIの解析によって改善点を自動で抽出し把握することができるようになります。

「何が不足していたのか」「良かった点はどこか」などを具体的に評価してくれるため、次回以降の応対の改善につなげることができます。

また、オペレーターが通話中に通話履歴からAI連携を実行することで、応対のセルフチェックをリアルタイムで行え、自身の課題を修正しつつ質の高い対応につなげられます。

結果

今回は「AI連携」機能を活用した通話評価の自動化 第2弾をご紹介しました。
この機能を使うことで、お客さまに重要な情報を正確に伝えられているかを自動で確認することができます。
特に注意が必要な「契約に関する説明」や「法的な重要事項」を正確に伝えているかも評価できるため、トラブルを未然に防ぎ、応対品質の向上を図ることができます。

さらに、応対品質管理にかかる工数を削減できるため、管理者の作業負担も軽減されます。結果として、管理者はより重要な業務に集中でき、業務全体の生産性向上が期待できます。

また、AIによる一定基準の評価により、評価者ごとのバラつきを解消し、標準化が実現できます。評価結果に対するオペレーターの納得感が得やすくなりますので、モチベーションの低下を防ぎ、離職防止につながることも期待されます。

皆さまのコールセンター運営がより一層効率化され、顧客満足度の向上につながりますと幸いです。
ぜひ「AI連携」をお試しいただき、その効果を実感してみてください。

編集後記

今回は、BIZTELの「AI連携」を活用した、通話評価の自動化・効率化の仕組み第2弾を実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。
現在、BIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2024/12/04/15164/feed/ 0
BIZTEL API使ってみた vol.14 通話評価を自動化!「AI連携」を使って応対品質チェックの工数を削減したい /blog/2024/08/20/14407/ /blog/2024/08/20/14407/#respond Tue, 20 Aug 2024 04:00:47 +0000 /?p=14407 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと コールセン […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

コールセンターでは、オペレーター教育による応対品質の向上施策の一環として、SV(スーパーバイザー)が定期的にオペレーターの通話をランダムに抽出し、応対品質チェックが行われています。しかし、この応対品質チェックには相応の工数が必要となり、効率化が大きな課題となっています。

今回は、ChatGPTに指示を出し、通話内容のテキストに対してさまざまな処理が行えるBIZTELのオプション機能「AI連携」を活用し、通話評価の指標である
・オープニング
・クロージング
・
NGワードの有無
・お客さまからの感謝・満足を示す反応の有無
に焦点を当て、応対品質チェックの自動化を試みたいと思います。

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回はOpenAIのAPIモデル「gpt-4o」を利用しています。
AI連携はBIZTEL3.9.0以上で利用可能ですが、OpenAIのAPIモデル「gpt-4o」を利用するには、BIZTELのバージョンが3.9.23以上である必要があります。

BIZTELで必要なオプション

・AI連携
※詳細はこちらの「1. AI連携」をご覧ください。

・音声認識連携(AmiVoice API)
※詳細はこちらの「1.音声認識連携(AmiVoice API)」をご覧ください。

BIZTEL以外に必要なもの

・OpenAI API
※ChatGPTのAPIの使用には、従量制の料金が適用されます。
料金に関する詳細は、OpenAIのWebサイトをご覧ください。

・AmiVoice API
※AmiVoice APIの使用には、従量制の料金が適用されます。
料金に関する詳細は、AmiVoice APIのWebサイトをご覧ください。

動作の全体像

Before:現状の業務プロセス例

例)1回あたり10分程度の通話の場合、応対品質の評価にかかる所要時間は30〜50分程度になります。

※1 通話分析オプションの「通話評価フィルタ」機能を利用すると、「トークスピード差」「かぶり回数」「沈黙回数」などのスコアから評価対象とする通話を抽出することが可能です。

After:「AI連携」を利用した業務プロセス例

例)1回あたり10分程度の通話の場合、「AI連携」による自動評価であれば、評価結果の確認・アウトプットが【1分程度】に短縮されます。

「AI連携」による通話評価の結果

以下は通話内容に基づく評価結果です。

## 評価結果

### 1. 会話の開始時の応対

- 会社名とオペレータ名の両方を名乗っている:〇
- 適切な挨拶をしている:〇
- 用件を明確に復唱している:〇

### 2. 会話の終了時の応対

- 自身の名前を再度名乗っている:〇
- 状況に応じた適切な挨拶をしている:〇
- 不明点がないか最後に確認している:〇
- 通話の最後まで顧客の話を聞いている:〇

### 3. オペレータからのNGワードの使用

- 否定的な言葉(無理、できないなど)の使用回数:2回
 - 「いいえ。それは無理だったかと思います。」
  - 「すみません、今はないですね。」

- 曖昧な言葉(たぶんなど)の使用回数:1回
 - 「多分現状はAIが自動判定いたしますので」

- 命令形の使用回数:0回
- 不適切な言葉の使用回数:0回

### 4. お客様からの感謝を表す言葉の使用

- 感謝や満足の表現の回数:8回
- 「ありがとうございます。」(複数回) 
- 「わかりました。」
- 「ちょっと使ってみようかな。」 
- 「勝手に判断して出題してくれるのはいいですね。」
- 「わかりましたちょっと試してみますね。」 
- 「検討します。」

## 総評

オペレータは会話の開始時と終了時において、会社名と自身の名前を名乗り、適切な挨拶を行い、お客様の用件を明確に復唱しているため、非常に良好な応対を行っています。また、通話の最後までお客様の話をしっかりと聞き、不明点がないか確認している点も評価できます。

NGワードの使用については、否定的な言葉や曖昧な言葉が数回使用されているものの、命令形や不適切な言葉は使用されていないため、全体的には良好です。
お客様からの感謝や満足の表現も多く見られ、オペレータの対応に対するお客様の満足度が高いことが伺えます。

全体として、オペレータの応対は非常に良好であり、お客様の満足度も高いと評価できます。

設定の実践

OpenAI事前準備

OpenAIのAPIキーを発行します。
※OpenAIのアカウント作成および、OpenAI APIキー発行が必要となります。
発行手順は「2.OpenAIの事前準備」をご参照ください。

BIZTEL事前設定

1.BIZTEL管理画面の「連携オプション」>「AI連携 OpenAI APIキー登録」を設定します。
今回はより精度の高いモデルを利用するため、モデル名は「gpt-4o」を選択してください。詳細は「3.1 OpenAI APIキー登録」をご参照ください。

2.BIZTEL管理画面の「連携オプション」>「AI連携 プロンプト設定」を設定します。
詳細は「3.2 AI連携 プロンプト設定」をご参照ください。

▼以下は、プロンプトの入力例です。

以下の指標に基づき、コールセンターのオペレータとお客様間の通話内容を評価すること。

## 評価指標

### 1. 会話の開始時の応対
オペレータが会社名と自身の名前を名乗り、適切な挨拶をして、お客様の用件を明確に復唱しているかどうかを評価。

- 会社名とオペレータ名の両方を名乗っている:〇/×
- 適切な挨拶をしている:〇/×
- 用件を明確に復唱している:〇/×

### 2. 会話の終了時の応対
オペレータが名前を再度名乗り、適切な挨拶をして、通話を締めくくる前に不明点がないか確認しているかを評価。

- 自身の名前を再度名乗っている:〇/×
- 状況に応じた適切な挨拶をしている:〇/×
- 不明点がないか最後に確認している:〇/×
- 通話の最後まで顧客の話を聞いている:〇/×

### 3. オペレータからのNGワードの使用
オペレータが発話する内容の中に、お客様を不快にさせるような否定的な言葉、曖昧な言葉、命令形、不適切な言葉(タメ口、俗語)を使っていないかを評価

- 否定的な言葉(無理、できないなど)の使用回数
- 曖昧な言葉(たぶんなど)の使用回数
- 命令形の使用回数
- 不適切な言葉の使用回数

### 4. お客様からの感謝を表す言葉の使用
以下の通話内容からお客様が感謝や満足を表している回数をカウントしてください。

- 通話内容からお客様が発した「お客様:」がついている文章のみ検出
- 「オペレータ:」がついている文章はオペレータが発しているので検出しない
- 感謝や満足の表現には、前後の文脈にお客様からのポジティブなフィードバックや肯定的な反応がある場合

以下は通話内容:

AI解析実行

通話後、履歴画面またはワークスペースよりAI解析を実行します。
※今回はコールセンター履歴画面の履歴モーダル画面から実行します。

解析結果
※以下の画像は結果の一部を抜粋しています。

結果

「AI連携」機能を用いることで、AI解析ボタンをクリックするだけで、複数の指標について自動で評価できるようになりました。

通話内容の評価観点をAI連携のプロンプトに記述するだけで、従来手作業で行っていた分析業務が自動化され、音声のチェックが格段に効率化されます。

さらに、SVの作業工数も大幅に削減できるため、より重要な業務に集中することができます。

編集後記

今回は、BIZTELの「AI連携」を活用した、通話評価の自動化・効率化の仕組みを実践しました。

この機能活用が「業務効率化」「応対品質の向上」に寄与し、より質の高い顧客サービスの提供に貢献できることを期待しています。
是非、「AI連携」の便利さと効果を実際に体感してみてください。

皆さまからのフィードバックをお待ちしております!

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。
現在、BIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2024/08/20/14407/feed/ 0
【続編】BIZTEL API使ってみた vol.13 分析業務を効率化!「マイGPT(MyGPT)」と「レポート取得API」を活用してデータを自動抽出 /blog/2024/07/24/13967/ /blog/2024/07/24/13967/#respond Wed, 24 Jul 2024 04:00:18 +0000 /?p=13967 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと 前回の「B […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになる
API連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

前回の「BIZTEL API使ってみた vol.13」の記事で、コールセンター管理者の通話データ分析業務を効率化するツールについてご紹介しました。

今回はその続編として、OpenAIの「マイGPT(MyGPT)(※1)」とBIZTELの「レポート取得API」を使って、分析業務の工数を削減する一例をご紹介します。

※1:以下より「マイGPT」と表記します。

具体的には、BIZTELの「レポート取得API」(エージェントレポート)を使って、エージェントごとのCPH(※2)やATT(※3)を算出して、グラフ化する作業を自動化させたいと思います。

※2:CPH(Call Per Hour):オペレーター1名が1時間あたりに対応したコール数のこと
※3:ATT(Average Talk Time):通話開始から切電まで、1件あたりにかかる平均時間のこと

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回のツールを利用するには、BIZTELのバージョンが3.8.1以上である必要があります。
※BIZTELサービスの開放ポートを標準外にする必要があります。詳細はお問い合わせください。

BIZTELで必要なオプション

・レポート取得API

BIZTEL以外に必要なもの

・OpenAIの「 ChatGPT Plus 」か「 ChatGPT Team」
※学習データに活用されたくない場合「ChatGPT Plus」では、利用する際にオプトアウト設定を行ってください。「ChatGPT Team」の場合は、デフォルトで学習データに活用されません。(2024年8月時点の情報です。詳細はOpenAIのWebサイトをご覧ください。)

・マイGPT
※本記事を参照しながら、ご自身でマイGPTを作成する必要があります。

動作の流れ

Before:現状の業務プロセス例

従来、分析用のExcelデータを準備するまでには、複数のステップが必要です。

  1. BIZTEL管理画面へのログイン
  2. 履歴画面からの検索や、各レポート画面からのレポート生成
  3. CSVダウンロード
  4. ダウンロードしたCSVをExcelに取り込む

After:マイGPTを利用した業務プロセス例

Beforeで記載した、Excelデータの準備(もしくは2次加工まで)を簡略化することができます。

マイGPTを利用した出力結果例

今回の例では、以下の処理を実行しています。

  1. レポート取得APIを使って、エージェントレポートからエージェントごとの通話・ステータス情報を取得
  2. そこから、2次加工として各エージェントのCPHやATTを算出
  3. 各エージェントのCPHとATTをグラフ化


⚫︎出力結果の詳細はこちらをご覧ください。


⚫︎Excelでの出力結果の詳細はこちらからダウンロードのうえ、ご覧ください。

今回ご紹介するマイGPTは、エージェントレポートの「通話・ステータス情報」だけではなく、「日時・曜日別レポート」も同様に取得可能です。

設定の実践

BIZTEL事前設定

APIキーを発行する

ロールが「システム管理者」以上のアカウントでBIZTEL管理画面にログイン後、
APIトークンを発行します。

設定の詳細はこちら「1.APIトークン」をご参照ください。
※取得できる履歴・レポートは、アカウントのリソース権限設定によります。

IPアクセス制御の確認

BIZTEL管理画面>システム設定>セキュリティ>IPアクセス制御が「設定する」となっている場合、

BIZTEL管理画面>セキュリティ>IPアクセス制御 で、次のCIDRブロックからのアクセスを許可する必要があります(詳細はこちらをご参照ください)。

設定例)104.210.133.240/28 のアクセスを許可する場合
※同様に他のCIDRからのアクセスについても登録する

マイGPTの作成

「マイGPT」を開くには、ChatGPT画面にログインして、左下のアイコン→「マイGPT」をクリックします。

マイGPTの一覧画面が表示されます。「GPTを作成する」をクリックして、新規作成画面を開きます。

マイGPTの作成画面が表示されます。左側の画面で「構成」を選択し、各項目に情報を設定してください。

構成情報登録

項目名 設定値

名前

GPTの名称:任意で設定可能

説明

GPTの説明:ツールの説明を任意で設定可能

指示

以下をコピーして、指示に貼り付けてください。

 

# 役割

* あなたは、BIZTELのAPIを使ってお客様が求める条件の履歴を取得する役割があります。

* 最初にお客様が指示する内容によって、処理内容を変えてください。

# 処理内容

## 「エージェントレポートを取得したい(エージェントステータス)」を押されたら以下の処理

* ①お客様に以下の質問をしてください。

* エージェントレポートを取得したいと思います。取得したい条件を入力ください。

* ②お客様が条件を入力したら、「Actionsに記載あるGetAgentCallStatusの/public/api/v1/report/agent/call_statusを実行すること」

* 実行結果はJSON形式で取得されるので、そのままExcel形式で保存してください。

*  ただ、Excelで開いたときに文字化けしないようにSJISで保存してください。

* ③追加のご要望があれば、コメントください。
(例:「2カラム追加してCPHやATTを算出して格納してほしい」や、「グラフ表示してほしい」など)を聞いてください。

 

## 「エージェントレポートを取得したい(日時・曜日別レポート)」を押されたら以下の処理

* ①お客様に以下の質問をしてください。

 * エージェントレポートを取得したいと思います。取得したい条件を入力ください。

* ②お客様が条件を入力したら、「Actionsに記載あるGetAgentDateTimeDataの/public/api/v1/report/agent/datewiseを実行すること」

* 実行結果はJSON形式で取得されるので、そのままExcel形式で保存してください。

 *  ただ、Excelで開いたときに文字化けしないようにSJISで保存してください。

* ③追加のご要望があれば、コメントください。
(例:「2カラム追加してCPHやATTを算出して格納してほしい」や、「グラフ表示してほしい」など)を聞いてください。

## なおエージェントレポートのマニュアルはこちらを参照してください。
https://manual.biztel.jp/hc/ja/articles/
19335048659481-5-%E3%83%AC%E3%83%9D%E3%
83%BC%E3%83%88%E5%8F%96%E5%BE%97API-%
E3%82%A8%E3%83%BC%E3%82%B8%E3%82%A7%
E3%83%B3%E3%83%88%E3%83%AC%
E3%83%9D%E3%83%BC%E3%83%88

会話の開始者

会話のきっかけを登録

・エージェントレポートを取得したい(エージェントステータス)
・エージェントレポートを取得したい(日時・曜日別レポート)

機能

以下にチェックを入れる

・WebBrowsing
・Code Interpreter

アクション

「新しいアクションを作成」をクリックして、「アクションの情報登録」を行う。

 

以上の入力が完了したら一時保存をするために、画面右上の「作成する」をクリックして保存をしてください。

一時保存をするため「私だけ」を選択して、「保存する」をクリックします。

保存が完了したら、右上の×印をクリックして、マイGPTの編集画面に戻ります。

 

アクション情報登録

次にアクションの作成をします。「新しいアクションを作成する」をクリックします。

アクション作成画面が表示されるので、各項目に情報を設定します。

アクションの設定詳細

項目名 設定値
認証

認証タイプ

APIキーにチェック

APIキー

Token {BIZTEL事前設定「APIキーを発行する」で発行したAPIトークン}

(例)
Token bb9d89be4e57b579ac2b3c0
eeed3b153fde8asssfxxwwf9900

認証タイプ

カスタムにチェック

カスタムヘッダーの名前

Authorization

スキーマ

こちらをクリックし、表示されるテキストをすべてコピーして、ご使用ください。

  • 使用前に7行目「 https://XXXXXXXX.u.biztel.jp」の「XXXXXXXX」部分は書き換えが必要です。
  • XXXXXXXX はBIZTELサーバのホスト名に書き換えてください。(例)https://s210999999999.u.biztel.jp
  • 「XXXXXXXX」以外を更新すると正常に動作しない可能性があります。

利用可能なアクション

以下が表示されていることを確認

GetAgentCallStatus       GET     /public/api/v1/report/agent/call_status

GetAgentDateTimeData  GET     /public/api/v1/report/agent/datewise

プライバシーポリシー

/privacypolicy/


アクション設定結果

以上入力が完了したら自動的に保存されるので、画面左上「<」をクリックして、マイGPTの作成画面(構成情報)に戻ります。

マイGPTのアイコン設定

+ボタンをクリックしてアイコンを設定します。

利用したいアイコンがある場合は「写真をアップロードする」を選択、
生成AIでアイコンを作成したい場合は「DALL-Eを使用する」を選択します。

アイコンが表示されます。

マイGPTのテスト実行

設定した内容の通りに動くかをテストすることができます。右側のプレビュー画面から動作確認をしてください。

プレビュー画面からの動作確認の例

成功した場合

BIZTELサーバに接続できていない場合

この場合は以下を確認してください。

・アクション情報登録画面の「スキーマ」で設定したBIZTELサーバのURLが正しいこと
・IPアクセス制御の設定が正しいこと

BIZTELサーバに接続できたがレポート取得APIで認証エラーになった場合

この場合は以下を確認してください。

・アクション情報登録画面の「認証」で設定した値が正しいこと

レポート取得APIでエラーになった場合(指定したコールセンターIDやアカウントIDなどに間違いがある場合など)

この場合は以下を確認してください。

・BIZTEL管理画面で、対象に指定したIDのコールセンターとアカウントが存在するか

保存

動作に問題がなければ、画面右上の「更新する」をクリックします。
もし、共有する先を変更したい場合は、「更新する」の左隣にある「共有する」をクリックして、「私だけ」か「リンクを持つ人のみ」を選択して「保存する」をクリックします。

※注意事項※「リンクを持つ人のみ」を選択した場合は、URLリンクを知っている人であれば誰でも実行可能になるので取り扱いに注意してください。

保存が完了しました。

「GPTを表示する」をクリックすると作成したGPTが表示されます。

結果

今回は、「マイGPT +レポート取得API」による分析業務の効率化について紹介しました。

「マイGPT +レポート取得API」を活用することで、自動的にエージェントレポート情報をExcelデータとして抽出することが可能です。さらに、Promptで追加処理を指示することにより、2次加工やグラフ化などの作業も自動化できます。

これまで手間と時間を要していたレポート分析業務が、マイGPTの導入により効率化されることが期待されます。

ぜひ一度、マイGPTをお試しいただき、その便利さと効果を実感してみていただけたら嬉しいです。

編集後記

今回は、BIZTELの「マイGPT」と「レポート取得API」の活用による、分析業務の効率化の仕組みを実践しました。
「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。
現在、BIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2024/07/24/13967/feed/ 0
【リリースノート】BIZTEL バージョン3.9.11 〜新機能「Quickworkオプション」を追加〜 /blog/2024/04/15/13736/ /blog/2024/04/15/13736/#respond Mon, 15 Apr 2024 04:00:37 +0000 /?p=13736 本記事では、2024年4月に提供開始した最新バージョン3.9.11で追加された機能をご紹介します。 Quickworkオプション BIZTEL と「Zendesk」または「HubSpot CRM」を連携する際、従来よりも […]]]>

本記事では、2024年4月に提供開始した最新バージョン3.9.11で追加された機能をご紹介します。

Quickworkオプション

BIZTEL と「Zendesk」または「HubSpot CRM」を連携する際、従来よりも設定を簡易にして、連携時の作業工数とお客さまの負担を削減することができるオプションです。

Quickwork 社が開発したノーコードかつシンプルな操作でシステム同士の連携が可能になるサービス「Quickwork」(https://www.quickwork.co/)を、Zendesk / HubSpot CRMとの連携用に設定をした状態で提供します。

従来は必須だったOAuth(※1)アカウントの発行・設定といった難易度の高い作業がなくなり、全体の工数が大幅に削減されるため、専門的な知識がなくてもスピーディーに設定が行えるようになります。

※1 OAuth:本来、異なるシステム間では連携できないデータや機能などをやりとりできるようにするため、アクセス権限を付与する仕組み。

本オプションは、BIZTEL で着信・応答・切断・発信などのコールに関する動作をする際に、外部システムの API (※2)に接続して、さまざまなアクションが実行できる機能「API連携コールアクション」と組み合わせて利用します。

通話後、録音ファイルの再生・ダウンロード用のURLや、応対内容の書き起こし・要約文をZendesk / HubSpot CRMに保存できるようになり、オペレーターの応対履歴の入力作業が軽減できるほか、コールセンターで収集したお客さまの問い合わせ・要望といったデータを社内に自動で共有する仕組みが実現します。

※2 API(Application Programming Interface):システム間の連携が簡単に行えるように作られた接続口。

→詳細ページを見る

]]>
/blog/2024/04/15/13736/feed/ 0
【挑戦編】GPT-4版 「ChatGPTで通話内容を要約して、オペレーター業務を効率化させたい」をやってみる /blog/2023/12/28/12976/ /blog/2023/12/28/12976/#respond Thu, 28 Dec 2023 04:00:34 +0000 /?p=12976 BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。 こちらの記事(BIZTEL APIアイデアベース Vol.2)では、ChatGPTを […]]]>

BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。

こちらの記事(BIZTEL APIアイデアベース Vol.2)では、ChatGPTを使ってお客さまとの通話内容を要約し、さらにSalesforceへ記録をする仕組みを紹介しました。

今回は【ChatGPT-4】を利用した実現方法について具体的に説明しながら設定していきたいと思います。

※ ChatGPT-3.5 Turbo版での設定方法はこちらです。


- biztel.jp

やってみたいこと

多くのコールセンターでは、オペレーターはお客さまとの通話終了後、応対内容の記録を手動で登録しています。

今回は、いま話題となっているOpenAIのサービス「ChatGPT」を使って、お客さまとの会話を要約し、その結果をSalesforceに自動登録させてオペレータの後作業を効率化してみたいと思います。

チャレンジャー

使用するツール・利用ライセンス

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回ご紹介する連携を行うためには、BIZTELのバージョンが3.7.20以上である必要があります。

BIZTELで必要なオプション

・API連携コールアクション
・音声認識連携

BIZTEL以外に必要なもの

・Salesforce
・AmiVoice API
・OpenAI API(モデル:gpt-4o-2024-08-06)

※ OpenAI APIの使用には、従量制の料金が適用されます。料金に関する詳細は、OpenAIのWebサイトをご覧ください。

※ セキュリティ面から、会話内容をクローズドな環境で運用されたい場合は、Microsoft社が提供するAzure OpenAI APIも利用可能です。

※ 詳細な条件についてはお問い合わせください。

動作の全体像

設定の流れ

◾︎OpenAI事前準備
OpenAI APIを利用してお客さまとの会話を要約するため、APIキーを発行します。

◾︎Salesforce事前準備
SalesforceのAPIを利用して通話内容を記録するため、OAuth認証接続アプリケーションの作成とToDoオブジェクトのページレイアウト変更を行います。

◾︎BIZTEL設定
お客さまとの会話をテキスト化するため、音声認識連携の設定を行います。
さらに、会話を要約してSalesforceに記録するために、コールアクションの設定を「コールアクションテンプレート機能」を利用して行います。

設定の実践

OpenAI事前準備

1.クレジットカード登録

OpenAIのアカウントを登録すると無料トライアル枠が与えられます。(2024年1月時点:アカウント登録後3ヵ月間で5ドル分)
この無料トライアル枠を超えて利用した場合、OpenAI APIを利用できなくなるため、事前にクレジットカード登録を行います。

OpenAIの左メニューから、Settings→Billingを選択して「Add payment details」ボタンをクリックし、画面に従いクレジットカード登録作業を進めてください。

「個人アカウント」または「法人アカウント」を選択。

画面に従って、クレジットカード情報及び住所等を設定します。

5ドル以上を初期購入します。
※購入額、および自動リチャージの設定は任意です。

※「OpenAI事前準備」>「1.クレジットカード登録」のご案内は、2024年1月時点の情報です。詳しくは、OpenAI Webサイトをご覧ください。

2.プロジェクトAPIキー発行

こちらからOpenAIにログインして、画面右上の歯車マークをクリックしてください。

画面右上の「Dashboard」をクリックして、左メニューの「API keys」をクリック後、プロジェクトキーを作成します。

設定画面に従って、情報を設定して「Create secret key」をクリックします。
【Permissions:Allの場合】

【Permissions:Restrictedの場合】
APIの種類によって、権限付与あり/なしを設定することが可能です。その場合、以下の設定が必要となります。
・Models は「Read」権限を付与
・Model capabilities は「Write」権限を付与

Keyが発行されるので「Copy」ボタンをクリックして、キー文字列をコピーし、保存してください。

※「OpenAI事前準備」>「2.プロジェクトAPIキー発行」のご案内は、2024年7月時点の情報です。詳しくは、OpenAI Webサイトをご覧ください。

Salesforce事前準備

1.OAuth認証の接続アプリケーションを作成

こちらの「設定の実践 1.Salesforce 設定準備」を参照しながら、Salesforce のOAuth認証のアプリケーション作成と鍵情報の確認を行います。

2.ToDoオブジェクトのページレイアウトを変更

以下が連携に必要な項目なので、任意のレイアウトを定義してください。

BIZTEL設定

1.音声認識連携

お客さまの音声をテキスト化するための設定を行います。

※設定方法については、こちらの「2. 音声認識連携の設定方法」をご参照ください。
※別途、アドバンスト・メディア社の「AmiVoice API」 のご契約が必要です。

2.OAuthアカウント設定

BIZTELとSalesforceを連携するためのOAuth設定は、こちらの「設定の実践 2.BIZTELでのOAuth設定」をご参照ください。

3.コールアクション連携

お客さまとの会話を要約して、Salesforceに記録するコールアクションの設定を「コールアクションテンプレート機能」を利用して行います。
今回は、ChatGPTへ「お客様との会話を500文字以内で箇条書きで要約」と指示します。

<コールアクション連携 手順の概要>
Ⅰ  テキストエディタを利用して、コールアクションテンプレートを作成
Ⅱ  BIZTEL管理画面から、コールアクションテンプレートをインポート
Ⅲ  BIZTEL管理画面から、コールアクション連携を編集
  OAuthアカウント設定 :4件編集
  紐づけ先が特定できない時のレコードID:1件編集
  OpenAI APIキー:1件編集
  ※合計6件修正することで設定が完了します。
Ⅳ お客さまの業務に応じて、ChatGPTへの指示を調整
Ⅴ 連携対象とする電話番号を選択
Ⅵ コールアクションの設定を有効化

<コールアクション連携 手順の詳細>
Ⅰ コールアクションテンプレートを作成
以下のテキストをすべてコピーして、テキストエディタにペーストして保存してください。

注意事項
●ファイルはJSON形式であるため、ファイルの拡張子は「.json」にしてください。
●文字コードはUTF8で保存してください。

{
  "version_name": "unknown",
  "version_hash": "94e4508",
  "name": "ChatGPT4版連携(240227)",
  "memo": "ChatGPT4対応版",
  "api_nodes": [
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": null,
      "request_method": "GET",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/parameterizedSearch/?q={TEL}&sobject=Account&sobject=Contact&sobject=Lead",
      "response_variable_pattern": "/\"attributes\":\\{\"type\":\"(?P<TYPE>[a-zA-Z]*)\".*?\"Id\":\"(?P<NOID>[a-zA-Z0-9]*)\"/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 1,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": "{\r\n\t\"model\": \"gpt-4o-2024-08-06\",\r\n\t\"messages\": [\r\n\t{\r\n\t\t\"role\": \"system\",\r\n\t\t\"content\": \"お客様お問い合わせ窓口でのお客様とオペレータの会話。500文字以内で箇条書きで要約する。要約できないときは要約できないとお応えください。\"\r\n\t},\r\n\t{\r\n\t\t\"role\": \"user\",\r\n\t\t\"content\": \"{VOICE_LOG.LEFT(8000).JSON_ESCAPE()}\"\r\n\t}],\r\n\t\"max_tokens\": 500,\r\n\t\"temperature\": 0.7,\r\n\t\"frequency_penalty\": 0,\r\n\t\"presence_penalty\": 0,\r\n\t\"top_p\": 1\r\n}",
      "request_header": "Authorization:Bearer XXXXXXXX\r\nContent-Type:application/json",
      "request_method": "POST",
      "request_url": "https://api.openai.com/v1/chat/completions",
      "response_variable_pattern": "/\"content\":\"(?P<SUM>.*?)\"/",
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 60,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 2,
      "max_retry_count": 3,
      "precondition_pattern": "/Contact|Lead/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhoId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n\t\"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 3,
      "max_retry_count": 3,
      "precondition_pattern": "/Account/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhatId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n\t\"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 4,
      "max_retry_count": 3,
      "precondition_pattern": "/^(?!.*(Contact|Lead|Account)).*$/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhoId\": \"XXXXXXXX\",\r\n    \"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n\t\"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "result_entry_information_label": null,
      "result_entry_information_text": null,
      "result_entry_prompt_text": null,
      "result_entry_summary_text": null,
      "result_entry_type": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    }
  ]
}
 

Ⅱ コールアクションテンプレートをインポート
BIZTEL管理画面より「連携オプション>コールアクション連携」をクリックして、画面右上の「インポート」をクリックします。詳細はこちらの「6.2 コールアクションのインポート」をご参照ください。

Ⅲ コールアクション連携を編集
作成されたコールアクション連携の「API連携」タブをクリックしてください。
各設定情報を編集していきます。

【必須で修正する箇所(合計6件)】
・!マークが出ている設定は、OAuthアカウントが未設定のため「OAuthアカウント設定」で登録したSalesforec用のOAuthアカウントを選択します。(計4件)

・以下のイベントURL内「XXXXXXXX」で表示されている箇所は、適切な値に書き換えます。(計2件)
<録音完了/音声認識連携完了>実行順1:OpenAI APIキー
<録音完了/音声認識連携完了>実行順4:紐づけ先が特定できない時のレコードID

(録音完了/音声認識連携完了イベント 実行順1:OpenAI APIキー設定例)

(録音完了/音声認識連携完了イベント 実行順4:レコードID設定例)
下の画像の赤線部分には、発信番号から履歴を紐づけるレコードを特定することができなかった場合に、紐づけるリードのレコードIDを記載します。

※レコードIDの確認方法(以下の赤線部分がレコードIDです)

Ⅳ お客さまの業務に応じて、ChatGPTへの指示を調整
<録音完了/音声認識連携完了>実行順1:OpenAI APIへ要約の指示をしているので、必要に応じて修正してください。
  
※現在の設定例)お客さまとの会話を500文字以内で箇条書きでまとめてほしいとき
※その他の設定例
 例)BIZTELユーザをオペレータと読み替える
 例)お客さまからのお褒めや評価の言葉を抽出する
 例)会話の改善点を提案する

今回、ChatGPTで利用するモデル【GPT-4】はMAXREQUESTが8192tokensとなっているため、要約にかけられるお客さまとの会話文字数に制限があります。
現状、会話の先頭からおおよそ8000文字となっていますので、{VOICE_LOG.LEFT(8000).JSON_ESCAPE()}でお客さまとの会話を8000文字だけ抽出して、ChatGPTに指示しています。

上述の制限があり要約対象の最大文字列数を増やすことは出来ませんが、文字数を減らしたい場合には{VOICE_LOG.LEFT(8000).JSON_ESCAPE()}の8000文字の数値を調整してください。

Ⅴ 連携対象とする電話番号を選択
「連携対象」タブをクリックして、連携対象とする電話番号に✓を設定してください。

Ⅵ コールアクションの設定を有効化
「基本情報」タブをクリックして、ステータス項目を無効から有効に変更してください。

連携結果

Salesforceに通話内容を連携した結果、このようになりました。
(画像をクリックすると、拡大されます)


文字が小さく見づらいので、通話内容の原文を以下に掲載します。

<通話内容の全テキスト>

オペレータ : こんにちはXYZカスタマーサポートセンターです。お名前と問い合わせ内容を教えていただけますか。

お客様 : はい、こんにちは。私の名前は鈴木です。

お客様 : 今日はインターネットの速度が非常に遅くなってしまって困っているのですが、こちらの窓口で問い合わせ可能でしょうか?

オペレータ : はい。鈴木様ご連絡いただきましてありがとうございます。インターネット速度が遅いということですね。大変ご不便おかけして申し訳ございません。

オペレータ : 状況を確認させていただく前に、まずはお客様のご住所とアカウント番号をお聞かせいただけますでしょうか?

お客様 : もちろんです。

お客様 : 住所は東京都新宿区1-1-1アカウント番号は12345678です。

オペレータ : ありがとうございますできたアカウント情報を確認させていただきますので少々お待ちくださいませ。

オペレータ : 鈴木様、アカウント情報の確認ができました。まずはお客様のインターネット環境についていくつか質問させていただきます。

オペレータ : 現在お使いのデバイスは何台接続されておりますでしょうか?

お客様 : 今のところスマートフォンが2台と、パソコンが2台です。

オペレータ : 承知いたしました。それらのデバイスで同時にインターネットを使用している場合は多いでしょうか?

お客様 : そうですね、大体夜になると家族がみんなで使うので、同時に使うことが多いです。

お客様 : 夜とかは、スマホが4台と、パソコン4台とかですかね。

オペレータ : かしこまりました夜になると多くなるということですね。承知いたしました。お客様のご自宅ではWi-Fiルーターを使用してますか、それとも郵政接続でしょうか?

お客様 : Wi-Fiルーターを使っています。

オペレータ : ありがとうございます。インターネット速度に関連するトラブルシューティングをいくつか試させていただきます。

オペレータ : まずはお客様のご自宅のインターネット環境に問題がないか確認させていただきます。

オペレータ : まずルーターの電源を一度切って30秒ぐらい待ってから、再度つけていただけますでしょうか?

お客様 : はい、わかりました。

お客様 : ちょっとお待ちください。

お客様 : 再起動が完了しました。

オペレータ : ありがとうございます。それでは再度、インターネットの速度を確認していただけますでしょうか?

お客様 : わかりました。やってみます。

お客様 : 今試してみたところ、速度が戻ったようです。

お客様 : ありがとうございます。

オペレータ : 速度が回復したということで、味いたしました。それでは引き続きインターネットが遅くならないよう、いくつかの対策をご紹介させていただきます。

オペレータ : まず一つ目がルーターの位置を見直してください。壁や家具に囲まれた場所に置くと電波が届きにくくなりますので、できる限り高い位置に設置して障害物を避けるようにしていただければと思います。

オペレータ : 二つ目は、デバイスも数が増えてしまいますと、それぞれのデバイスでインターネットの速度が遅くなることがございます。

オペレータ : 必要なデバイスだけを接続し、不要なデバイスのWi-Fiをオフすることで速度が改善されることがあります。

お客様 : アドバイスありがとうございます。

お客様 : どちらも該当しそうだから、ちょっとまた試してみます。

オペレータ : ありがとうございます。本日はこの他に質問はございますでしょうか?

お客様 : いいえ、大丈夫です。ありがとうございます。

オペレータ : かしこまりました。本日は田中が承りました。今後も引き続きよろしくお願いいたします。

お客様 : ありがとうございます。

お客様 : 失礼いたします。

オペレータ : はい、ありがとうございます例します。

<要約結果>

- 鈴木様はインターネットの速度が遅くなっている問題について問い合わせた
- オペレータは鈴木様のアカウント情報と接続状況を確認した
- 多くのデバイスが同時にインターネットを使用すると遅くなる可能性があることを説明した 
- ルーターの再起動を行った結果、速度が改善した 
- ルーターの位置やデバイス数の管理についてアドバイスを提供した 
- 鈴木様はその他の質問が無いと回答し、会話を終了した

振り返り・まとめ

今回は、『BIZTEL APIアイデアベース Vol.2 ChatGPTで通話内容を要約して、オペレーター業務を効率化させたい』の記事でご紹介したChatGPTとの連携方法について、【GPT-4】を利用した場合の設定を具体的に説明しながら実践しました。

ChatGPTと連携することで自動で要約が実現でき、「後作業」時間が削減されるだけでなく、人による通話記録の精度差もなくなり、大幅な業務効率化・標準化につながります。


コールアクションテンプレート機能を利用することで複雑なAPI設定も簡単にできるので、ぜひお試しください。

編集後記

今回は「ChatGPT-4」を使ってお客さまとの通話内容を要約、さらにSalesforceへ記録をする仕組みを実践しました。

このブログでは、今後も様々な機能の実装に挑戦していきます。設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2023/12/28/12976/feed/ 0
BIZTEL API使ってみた vol.13 分析業務を効率化!レポート取得APIとExcelマクロの活用方法 /blog/2023/12/28/12978/ /blog/2023/12/28/12978/#respond Thu, 28 Dec 2023 04:00:34 +0000 /?p=12978 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら やってみたいこと コールセンタ […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

やってみたいこと

コールセンター管理者は、定期的にコールセンターの状況や課題を把握するために、通話データをもとに分析をしています。

今回は、この分析業務を簡略化するツールをご紹介します。
BIZTELのバージョン3.8.1でリリースされた「レポート取得API」と「Excelマクロ」を組み合わせたツールを使うことで、分析業務の手間を削減することができます。

具体的には、
「管理画面へのログイン>各レポート画面からのレポート生成>CSVダウンロード>CSVをExcelへ取り込む」までの一連の作業を省くことができます。

ぜひ一緒に体験してみましょう。

チャレンジャー

使用するツール・利用ライセンス

BIZTELの利用ライセンス

・コールセンタープランのご契約
※コールセンター履歴・コールセンターレポート・エージェントレポート・アウトバウンドレポートを利用する場合
※今回のツールを利用するには、BIZTELのバージョンが3.8.1以上である必要があります。

BIZTELで必要なオプション

・履歴取得API
※発着信履歴・コールセンター履歴を利用する場合に必要

・レポート取得API
※コールセンターレポート・エージェントレポート・アウトバウンドレポートを利用する場合に必要

BIZTEL以外に必要なもの

・OSはWindowsのみ
※Macは今後対応予定

・BIZTEL_sample.xlsm
※BIZTELの通話履歴やレポート情報を出力するサンプルのExcelマクロ

動作の流れ

Before:現状の業務プロセス例

分析用のExcelデータを準備するまでに複数のステップが必要です。
・BIZTEL管理画面へのログイン
・履歴画面からの検索や、各レポート画面からのレポート生成
・CSVダウンロード
・ダウンロードしたCSVをExcelへ取り込む

After:ツールを利用した業務プロセス例

Beforeで記載した、Excelデータを準備するまでの作業を省くことができます。

ツールを利用したExcel出力結果例

「BIZTEL管理画面>コールセンター>コールセンターレポート」と画面を移ることなく、わずか1回のボタンクリックで、指定したコールセンターの「サマリーレポート」を直接Excelファイルに取り込めます。

このツールを使うことで、応答率やサービスレベルなどの情報をExcelに取り込む手間が大幅に削減され、より効率的に分析作業を行うことができます。

設定の実践

BIZTEL事前設定

APIキーを発行する
ロールが「システム管理者」以上のアカウントでBIZTEL管理画面にログイン後、APIトークンを発行します。設定の詳細はこちら「1.APIトークン」をご参照ください。
※取得できる履歴・レポートは、アカウントのリソース権限設定によります。

Excelマクロ事前設定(BIZTEL_sample.xlsm)

1.BIZTEL_sample.xlsm をダウンロードする

▼こちらからダウンロードをしてください。
/download/BIZTEL_sample.xlsm

2.BIZTEL_sample.xlsmを開き、VBE(Visual Basic Editor)を開く

VBEの起動方法
<ショートカットキーで起動する方法>
 Excelのワークシート画面上で、以下のショートカットキーで起動
 Windows:Altキー + F11キー
 ※上記が他のショートカットキーに割り当てられている場合は起動しません。
  その場合には、次にご紹介する「開発タブからの起動」をお試しください。

<開発タブから起動する方法>
 Excelを開き「開発」タブをクリックして、「Visial Basic」アイコンをクリックする。

3.標準モジュール「Module1」を編集
プロジェクトエクスプローラからModule1をダブルクリックで開き、“ご契約中のBIZTEL管理画面URL”のみ変更してください。

履歴/レポートを出力

今回は、以下のケースを想定してレポート情報を出力したいと思います。

<想定ケース>
管理するコールセンターの「応答率」と「サービスレベル」を確認する
(「コールセンターレポート>サマリーレポート」で指定した日の応答率とサービスレベルを確認)

1.BIZTEL_sample.xlsmの対象シートを開く
BIZTEL_sample.xlsmには複数のシートが存在します。取得したい履歴やレポートに対応するシート名を開いてください。

今回のケースでは「コールセンターレポート>サマリーレポート」が対象レポートなので、「CCレポート_サマリ」シートを開きます。

2.項目に条件を設定
項目に条件を設定してください。

・集計対象:コールセンターのサマリを確認したいため「0」を設定する
・コールセンターID:「BIZTEL管理画面>コールセンター>コールセンター」をクリックして、対象コールセンターのIDを確認して設定する

※コールセンターIDが表示されていない場合は、右上にある「ハンバーガーメニュー」をクリックして、IDに✓を入れる
※複数指定の場合は「,」(カンマ)で区切る


Excelの項目にどのような値を入力するかわからない場合は、項目名をクリックしてください。項目の説明がセルのコメントで表示されます。

3.取得ボタンをクリックして、APIトークンを入力
グレーに色付けされた「取得」ボタンをクリックして、ロールが「システム管理者」以上のアカウントで発行したAPIトークンを入力し、OKボタンをクリックしてください。

入力したAPIトークンを保存する場合には、右下の「APIトークンを保存する」に✓を入れてください。次回、実行時にAPIトークンの入力を省略することができます。

【APIトークン保存機能】※取り扱い注意
APIトークンの保存先はBIZTEL_sample.xlsm内「APIトークン設定」シートに保存されるため、ファイルにアクセス可能な人であれば、容易にAPIトークンを参照されるリスクがあります。APIトークンの保存機能を利用する際は、ファイルの取り扱いに十分ご注意のうえ、ご利用ください。

4.結果が出力される

正常終了時
正常に終了すると指定したレポート値が出力されます。指定した2つのコールセンターの応答率やサービスレベルなどを確認することができます。

上記の結果をうけて、1時間ごとの応答率やサービスレベルを把握したい場合は、「コールセンターレポート>日時・曜日別レポート」が対象になるので、BIZTEL_sample.xlsm内「CCレポート_日時曜日別」シートから即時で取得可能です。


これで、BIZTELのレポート画面からレポートを生成することなく、時間ごとの応答率やサービスレベルのばらつきも確認できるようになります。 

エラー終了時
エラーが発生した場合は、エラー情報がポップアップで表示されます。

実行時エラー 一覧

結果

このツールを活用することで、通話履歴の一次加工作業やCSVダウンロードからの作業が大幅に簡略化され、リアルタイムでの迅速かつ正確な業務分析が実現しました。

コールセンター運営をより効率的に行うため、ぜひこのツールを活用して業務効率化と改善を実感してください。

編集後記

今回は、BIZTELの「レポート取得API」と「Excelマクロ」を連携したツールによる、コールセンター管理者の分析業務の簡易化の仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2023/12/28/12978/feed/ 0
【リリースノート】BIZTEL バージョン3.8.0 〜新機能「ワークスペース」「SMS送信」を追加〜 /blog/2023/07/31/12256/ /blog/2023/07/31/12256/#respond Mon, 31 Jul 2023 06:00:17 +0000 /?p=12256 BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。 本記事では、2023年7月に提供開始した最新バージョン3.8.0で追加された機能をご紹介します。 ワ […]]]>

BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。

本記事では、2023年7月に提供開始した最新バージョン3.8.0で追加された機能をご紹介します。

ワークスペース

電話応対や顧客情報・通話履歴の確認、応対記録の入力といった作業を、1つのユーザインターフェースでシームレスに行える機能です。

これまで管理画面での操作が必要だった通話録音の確認や、コールリーズンなどのタグを通話履歴に付けるといった機能の利用もワンストップで実行できます。
また、オプションで使える「音声認識連携」による通話の書き起こしや、AIによる「通話分析」の結果も同一画面で閲覧することが可能です。

応対した内容を記録・管理するための基礎的な機能がそろっているので、簡易のCRMシステムとして活用することもできます。

本機能の詳細ページはこちら

SMS送信

ワークスペースから、SMSを手動で送信できる機能です。

SMS送信を活用することで、問い合わせに関連する資料・マニュアルの送付や、カード決済の認証用URLの案内など、顧客応対の過程で発生する業務を、通話中または切電後すぐ対応することができます。

API機能の拡充

BIZTELでは、外部システムと連携して便利な仕組みを簡単に構築することができる「API連携機能」を多数提供しています。

今回のバージョンアップでは、電話の発着信やオペレーターの業務ステータスの変更など、BIZTELの一部の機能を外部システムのインターフェースに設置できる「電話機組み込みモデル」や、BIZTELで集計したデータが抽出・加工できる「レポート取得API」を追加しました。

▪電話機組み込みモデル

発着信や待ち呼などBIZTELのコールに関する情報を通知する「イベント通知API」、オペレーターのステータスを変更する機能が組み込める「エージェントステータスAPI」、ソフトフォン(PCで操作する電話)アプリの操作機能が実装できる「ソフトフォン制御API」の3つを組み合わせて、外部システムの画面にBIZTELの機能をベースとした独自のソフトフォンが構築できます。

ユーザは自社の業務システムから電話機能が利用できるようになり、より効率的なオペレーションが可能になります。

本機能の詳細ページはこちら

▪レポート取得API

BIZTELの各レポート機能(コールセンターレポート・エージェントレポート・アウトバウンドレポート)で集計するデータを、外部システムでも利用できるようにするAPIです。
取得したデータから必要な情報を抽出したり、指標名を自社の表現に変更したりと、お客さまの業務にあわせて加工したい場合などに便利です。

本機能の詳細ページはこちら

音声認識連携(Omnis)

丸紅情報システムズ株式会社のクラウドAI音声認識サービス「 MSYS Omnis(エムシス オムニス)」とのシステム連携が、短期間・低コストで実現するオプションサービスです。

従来、BIZTELとOmnisの連携機能には、音声認識システムで利用する通話データを保存するための物理サーバをBIZTELのデータセンターに設置し、さらにシステム間をVPN接続する必要があり、準備期間やコスト負担が発生していました。

このオプションを利用することで、物理サーバの設置とVPNが不要になり、フルクラウド構成による効率的な音声認識が可能になります。

モデル図

Omnisのリアルタイム音声認識画面イメージ

ソフトフォンに「オペレータ向け 待ち呼 確認機能」を追加

ソフトフォンで待ち呼の状況が確認できる機能です。待ち呼の発生時、ソフトフォンの右上に表示されているアイコンが赤色に変化し、クリックすると「着信しているコールセンター名」「待ち呼の数」「最長待ち時間」がウインドウで確認できます。
また、「待ち呼の数」「最長待ち時間」は、設定した「しきい値」を超えると赤色に変化します。

オペレーターは、待ち呼の発生を即座に把握できるほか、顧客の待ち時間を事前に確認でき、応対の初めに「大変お待たせいたしました」と一言添えるなどのフォローが可能になります。

※本機能は、アプリタイプのソフトフォンでのみ利用できます(ブラウザタイプのソフトフォンでは対応していません)

ソフトフォンの省スペースモード

ソフトフォンのダイヤルパッド部分の表示を省略できるようにしました。
画面を占有する面積が減るため、複数のウインドウを立ち上げている場合などでも見やすく、操作しやすくなります。

 

コールフローをより見やすく表示

コールフロー(顧客からの電話の振り分けや分岐ごとの対応)の表示機能を、より見やすく改善しました。

フローの分岐を示すラインを従来の斜線から水平線 / 垂直線に変更し、長く複雑なフローも分かりやすくなりました。
また、これまではフローごとの設定内容をラインと重ねて表示していましたが、ラインの上部に位置を変更して視認性を高めています。

さらに、画面右下にミニマップ(コールフローの全体像に対して、画面に映しだされている範囲を示した図)を表示し、フローのどの部分を見ているのかが分かるようになりました。

<アップデート前>

<アップデート後>

 

「発着信履歴」「業務ラベル履歴」からも「タグ」の付与が可能に

BIZTELでは、コールリーズンや事後対応の有無といった任意の情報ラベルを通話履歴に付与できる「タグ」機能を提供しています。

これまでタグを付ける操作は「コールセンター履歴(コールセンター業務で発着信した履歴を検索・表示する画面)」のみで可能でしたが、本バージョンから「発着信履歴」「業務ラベル履歴」からも行えるようになり、利便性が向上しました。

]]>
/blog/2023/07/31/12256/feed/ 0
【続編】「API使ってみた Vol.9 着信時に自動でZendeskの新規チケットを作成し、ポップアップ表示させる」をコールアクションテンプレートを利用してやってみる /blog/2023/06/16/11902/ /blog/2023/06/16/11902/#respond Fri, 16 Jun 2023 04:00:57 +0000 /?p=11902 BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。 BIZTEL APIブログ「API使ってみた Vol.9」の記事では、着信時に自動で […]]]>

BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。

BIZTEL APIブログ「API使ってみた Vol.9」の記事では、着信時に自動でZendeskの新規チケットを作成し、ポップアップ表示をさせる仕組みを紹介しました。

記事はこちら

今回は、APIの設定がより簡単にできる「コールアクションテンプレート」という機能を使った際の手順を具体的に説明していきたいと思います。

やってみたいこと

BIZTELではバージョン3.7.0にて、コールアクション連携の設定情報をテンプレート化できる機能をリリースしました。
今回はこのコールアクションのテンプレートを利用して、BIZTEL APIブログ「API使ってみた vol.9」の設定に挑戦したいと思います。

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約

BIZTELで必要なオプション

・API連携コールアクション

BIZTEL以外に必要なもの

・Zendesk

※ 詳細な条件についてはお問い合わせください。

前提条件

・WebAPIの基礎的な技術知識がある、テックユーザ(IT技術者)様が対象
・Zendeskにカスタマイズが入っていないこと
 ※カスタマイズが入っている場合は、お問い合わせください。

設定の実践

1.こちらの「BIZTEL API使ってみた Vol.9」の「設定の実践」を参照しながら、以下の設定を行います。

・Zendesk管理画面での事前準備
・BIZTEL管理画面での設定
 1.BIZTEL管理画面にて「OAuth連携設定」を作成する
 2.BIZTEL管理画面へZendeskアカウントIDを登録する
 3.
BIZTEL管理画面にてコールアクション設定を登録する

2.コールアクションテンプレートを利用したコールアクションの設定
<手順の概要>
Ⅰ テキストエディタを利用して、コールアクションテンプレートを作成
Ⅱ BIZTEL管理画面から、コールアクションテンプレートをインポート
Ⅲ BIZTEL管理画面から、コールアクション連携を編集

 OAuthアカウント設定:3件編集
 ZendeskURL:3件編集
 ※合計6件修正することで設定が完了します。

<手順の詳細>
I コールアクションテンプレートを作成
以下のテキストを全部コピーして、テキストエディタにペーストし保存してください。

注意事項
・ファイルはJSON形式であるため、ファイルの拡張子は「.json」にしてください
・文字コードはUTF8で保存してください

{
  "version_name": "unknown",
  "version_hash": "79aee48",
  "name": "Zendesk連携(Vol.9_Zendeskチケットポップアップ)",
  "memo": null,
  "api_nodes": [
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 0,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": "Content-Type:application/json",
      "request_method": "GET",
      "request_url": "https://XXXXXXXX.zendesk.com/api/v2/search.json?query=phone:{TEL}",
      "response_variable_pattern": "/\"results\":\\[({\"id\":(?P<ID>[0-9]+),.*|\\]),.*,\"count\":(?P<COUNT>[0-9].*)}/",
      "retry_interval_milli_sec": 1000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 2,
      "max_retry_count": 0,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": "{ \"ticket\": {\n    \"subject\":  \"電話での問い合わせ\",\n    \"comment\":  { \"body\": \"着信がありました\" },\n    \"requester_id\": {RESPONSE_ID},\n    \"priority\": \"urgent\",\n    \"tags\":[\"お客様相談窓口\"]\n  }}",
      "request_header": "Content-Type:application/json",
      "request_method": "POST",
      "request_url": "https://XXXXXXXX.zendesk.com/api/v2/tickets.json",
      "response_variable_pattern": "/\"id\":(?P<TICKETID>.*),\"external_id\":/ ",
      "retry_interval_milli_sec": 1000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 1100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 0,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": "Content-Type:application/json",
      "request_method": "POST",
      "request_url": "https://XXXXXXXX.zendesk.com/api/v2/channels/voice/agents/{ACCOUNT_VALUE_ID}/tickets/{RESPONSE_TICKETID}/display.json",
      "response_variable_pattern": null,
      "retry_interval_milli_sec": 1000,
      "timeout_num": 10,
      "memo": null
    }
  ]
}

 

Ⅱ コールアクションテンプレートをインポート
BIZTEL管理画面より「連携オプション」>「コールアクション連携」をクリックして、画面右上の「インポート」をクリックします。

「ファイル選択」をクリックして、先ほど保存したテンプレートファイルを選択します。

「インポート」をクリックします。

インポートが完了したことを示すポップアップが表示されます。インポート時にエラーが表示された場合には、こちらの「6.2 コールアクションのインポート インポート時のエラーについて」をご参照ください。

Ⅲ コールアクション連携を編集
作成されたコールアクション連携をクリックします。

「API連携」タブをクリックして、各設定情報を編集します。
・「着信イベント 実行順1と2」と「コールセンターエージェント呼び出し 実行順1」に対して以下のOAuthアカウント設定とZendeskURLを編集します。
・!マークが出ている設定は、OAuthアカウントが未設定のため「OAuthアカウント登録」で登録したZendesk用のOAuthアカウントを選択します。(計3件)
・XXXXXXXXで表示されている箇所は、連携先のZendeskURLを設定します。(計3件)

(例)ZendeskURLがhttps://bizteltest.zendesk.com/ の場合は、XXXXXXXX のところにbizteltestを設定します。

(着信イベント 実行順1の設定例)

Ⅳ 連携対象とする電話番号を選択
「連携対象」タブをクリックして、連携対象とする電話番号に「✓」を設定してください。

Ⅴ コールアクションの設定を有効化
「基本情報」タブをクリックして、ステータス項目を「無効」から「有効」に変更してください 。

動作確認

着信時にZendeskで新規作成したチケットがポップアップ表示されることを確認します。

結果

今回はコールアクションのテンプレートを利用して、「着信時における、Zendeskで新規作成したチケットのポップアップ表示」に挑戦しました。

Zendeskとの基本的な連携部分をテンプレート化しておくことで、コールアクションの複雑なAPI設定を簡略化することができました。ぜひ、お試しください。

編集後記

このブログでは、今後も様々な機能の実装に挑戦していきます。設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2023/06/16/11902/feed/ 0
【挑戦編】GPT-3.5 Turbo版「ChatGPTで通話内容を要約して、オペレーター業務を効率化させたい」をやってみる /blog/2023/05/09/11626/ /blog/2023/05/09/11626/#respond Tue, 09 May 2023 03:30:54 +0000 /?p=11626 BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。 前回の記事(BIZTEL APIアイデアベース Vol.2)では、ChatGPTを使 […]]]>

BIZTELでは、「API連携機能」を使って世の中にある様々なツールと組み合わせることで、多種多彩な便利機能を実装することができます。

前回の記事(BIZTEL APIアイデアベース Vol.2)では、ChatGPTを使ってお客さまとの通話内容を要約し、さらにSalesforceへ記録をする仕組みを紹介しました。

今回は、その実現方法について具体的に説明しながら設定していきたいと思います。

※ ChatGPT-4 での設定方法はこちらです。

やってみたいこと

多くのコールセンターでは、オペレーターはお客さまとの通話終了後、応対内容の記録を手動で登録しています。

今回は、いま話題となっているOpenAIのサービス「ChatGPT」を使って、お客さまとの会話を要約し、その結果をSalesforceに自動登録させてオペレータの後作業を効率化してみたいと思います。

チャレンジャー

使用するツール・利用ライセンス

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回ご紹介する連携を行うためには、BIZTELのバージョンが3.7.20以上である必要があります。

BIZTELで必要なオプション

・API連携コールアクション
・音声認識連携

BIZTEL以外に必要なもの

・Salesforce
・AmiVoice API
・OpenAI API

※ OpenAI APIの使用には、従量制の料金が適用されます。料金に関する詳細は、OpenAIのWebサイトをご覧ください。

※ セキュリティ面から、会話内容をクローズドな環境で運用されたい場合は、Microsoft社が提供するAzure OpenAI APIも利用可能です。

※ 詳細な条件についてはお問い合わせください。

動作の全体図

設定の流れ

OpenAI事前準備
OpenAI APIを利用してお客さまとの会話を要約するため、APIキーの発行を行います。

Salesforce事前準備
SalesforceのAPIを利用して通話内容を記録するため、OAuth認証接続アプリケーションの作成とToDoオブジェクトのページレイアウト変更を行います。

BIZTEL設定
お客さまとの会話をテキスト化するため、音声認識連携の設定を行います。
さらに、会話を要約してSalesforceに記録するために、コールアクションの設定を「コールアクションテンプレート機能」を利用して行います。

設定の実践

OpenAI事前準備

1.クレジットカード登録

OpenAIのアカウントを登録すると無料トライアル枠が与えられます。(2024年1月時点:アカウント登録後3ヵ月間で5ドル分)
この無料トライアル枠を超えて利用した場合、OpenAI APIを利用できなくなるため、事前にクレジットカード登録を行います。

OpenAIの左メニューから、Settings→Billingを選択して「Add payment details」ボタンをクリックし、画面に従いクレジットカード登録作業を進めてください。

「個人アカウント」または「法人アカウント」を選択。

画面に従って、クレジットカード情報及び住所等を設定します。

5ドル以上を初期購入します。
※購入額、および自動リチャージの設定は任意です。

※「OpenAI事前準備」>「1.クレジットカード登録」のご案内は、2024年1月時点の情報です。詳しくは、OpenAI Webサイトをご覧ください。

2.プロジェクトAPIキー発行

こちらからOpenAIにログインして、画面右上の歯車マークをクリックしてください。

画面右上の「Dashboard」をクリックして、左メニューの「API keys」をクリック後、プロジェクトキーを作成します。

設定画面に従って、情報を設定して「Create secret key」をクリックします。
【Permissions:Allの場合】

【Permissions:Restrictedの場合】
APIの種類によって、権限付与あり/なしを設定することが可能です。その場合、以下の設定が必要となります。
・Models は「Read」権限を付与
・Model capabilities は「Write」権限を付与

Keyが発行されるので「Copy」ボタンをクリックして、キー文字列をコピーし、保存してください。

※「OpenAI事前準備」>「2.プロジェクトAPIキー発行」のご案内は、2024年7月時点の情報です。詳しくは、OpenAI Webサイトをご覧ください。

Salesforce事前準備

1.OAuth認証の接続アプリケーションを作成

こちらの「設定の実践 1.Salesforce 設定準備」を参照しながら、Salesforce のOAuth認証のアプリケーション作成と鍵情報の確認を行います。

2.ToDoオブジェクトのページレイアウトを変更

以下が連携に必要な項目なので、任意のレイアウトを定義してください。

BIZTEL設定

1.音声認識連携

お客さまの音声をテキスト化するための設定を行います。

※設定方法については、こちらの「2. 音声認識連携の設定方法」をご参照ください。
※別途、アドバンスト・メディア社の「AmiVoice API」 のご契約が必要です。

2.OAuthアカウント設定

BIZTELとSalesforceを連携するためのOAuth設定は、こちらの「設定の実践 2.BIZTELでのOAuth設定」をご参照ください。

3.コールアクション連携

お客さまとの会話を要約してSalesforceに記録するコールアクションの設定を、「コールアクションテンプレート機能」を利用して行います。

今回は、ChatGPTへ「お客さまとの会話を300文字以内で箇条書きで要約」と指示します。

<コールアクション連携 手順の概要>

Ⅰ  テキストエディタを利用して、コールアクションテンプレートを作成
Ⅱ  BIZTEL管理画面から、コールアクションテンプレートをインポート
Ⅲ  BIZTEL管理画面から、コールアクション連携を編集
  OAuthアカウント設定 :4件編集
  紐づけ先が特定できない時のレコードID:1件編集
  OpenAI APIキー:1件編集
  ※合計6件修正することで設定が完了します。
Ⅳ お客さまの業務に応じて、ChatGPTへの指示を調整

<コールアクション連携 手順の詳細>

Ⅰ コールアクションテンプレートを作成
以下のテキストをすべてコピーして、テキストエディタにペーストして保存してください。

注意事項
●ファイルはJSON形式であるため、ファイルの拡張子は「.json」にしてください。
●文字コードはUTF8で保存してください。

{
  "version_name": "3.7.20",
  "version_hash": "b3526eb",
  "name": "ChatGPT3.5版連携(240227)",
  "memo": "ChatGPT3.5対応版",
  "api_nodes": [
    {
      "api_event_type": 100,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": null,
      "request_header": null,
      "request_method": "GET",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/parameterizedSearch/?q={TEL}&sobject=Account&sobject=Contact&sobject=Lead",
      "response_variable_pattern": "/\"attributes\":\\{\"type\":\"(?P<TYPE>[a-zA-Z]*)\".*?\"Id\":\"(?P<NOID>[a-zA-Z0-9]*)\"/",
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 1,
      "error_response_status_code_pattern": null,
      "execution_order": 1,
      "max_retry_count": 3,
      "precondition_pattern": null,
      "precondition_target_text": null,
      "request_body": "{\r\n\t\"model\": \"gpt-3.5-turbo\",\r\n\t\"messages\": [\r\n\t{\r\n\t\t\"role\": \"system\",\r\n\t\t\"content\": \"お客様お問い合わせ窓口でのお客様とオペレータの会話。300文字以内で箇条書きで要約する。但し、[context]に記載のない情報を要約することは許されていません。要約できないときは要約できないとお応えください。\"\r\n\t},\r\n\t{\r\n\t\t\"role\": \"user\",\r\n\t\t\"content\": \"{VOICE_LOG.LEFT(4000).JSON_ESCAPE()}\"\r\n\t}],\r\n\t\"max_tokens\": 300,\r\n\t\"temperature\": 0.7,\r\n\t\"frequency_penalty\": 0,\r\n\t\"presence_penalty\": 0,\r\n\t\"top_p\": 1\r\n}",
      "request_header": "Authorization:Bearer XXXXXXXX\r\nContent-Type:application/json",
      "request_method": "POST",
      "request_url": "https://api.openai.com/v1/chat/completions",
      "response_variable_pattern": "/content\":\"(?P<SUM>.*)\"},/",
      "retry_interval_milli_sec": 3000,
      "timeout_num": 30,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 2,
      "max_retry_count": 3,
      "precondition_pattern": "/Contact|Lead/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhoId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n\t\"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 3,
      "max_retry_count": 3,
      "precondition_pattern": "/Account/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhatId\": \"{RESPONSE_NOID}\",\r\n\t\"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n\t\"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    },
    {
      "api_event_type": 5000,
      "api_link_type": 2,
      "error_response_status_code_pattern": null,
      "execution_order": 4,
      "max_retry_count": 3,
      "precondition_pattern": "/^(?!.*(Contact|Lead|Account)).*$/",
      "precondition_target_text": "{RESPONSE_TYPE}",
      "request_body": "{\t\r\n\t\"WhoId\": \"XXXXXXXX\",\r\n    \"Subject\": \"{STARTTIME}に通話(着信)\",\r\n    \"Description\": \"{VOICE_LOG.JSON_ESCAPE()}\\r\\n■要約:\\r\\n{RESPONSE_SUM}\",\r\n    \"CallDisposition\":\"■発信電話番号:{TEL}■着信電話番号:{CALLED}\\\\r\\\\n■着信アカウント名:{AGENT_NAME}■着信内線番号:{AGENT_EXTEN_NO}\\\\r\\n■通話開始時間:{STARTTIME}■通話終了時間:{ENDTIME}\\\\r\\n■通話時間:{CALLSEC}\"\r\n}",
      "request_header": "Content-Type: application/json",
      "request_method": "POST",
      "request_url": "{OAUTH_INSTANCE_URL}/services/data/v45.0/sobjects/Task/",
      "response_variable_pattern": null,
      "retry_interval_milli_sec": 3000,
      "timeout_num": 10,
      "memo": null
    }
  ]
}


Ⅱ コールアクションテンプレートをインポート

BIZTEL管理画面より「連携オプション」>「コールアクション連携」をクリックして、画面右上の「インポート」をクリックします。詳細はこちらの「6.2 コールアクションのインポート」をご参照ください。

Ⅲ コールアクション連携を編集
作成されたコールアクション連携の「API連携タブ」をクリックしてください。
各設定情報を編集していきます。


【必須で修正する箇所(合計6件)】

● !マークが出ている設定は、OAuthアカウントが未設定のため「OAuthアカウント設定」で登録したSalesforce用のOAuthアカウントを選択します。(計4件)

● 以下のイベントURL内「XXXXXXXX」で表示されている箇所は、適切な値に書き換えます。(計2件)
<録音完了/音声認識連携完了>実行順1:OpenAI APIキー
<録音完了/音声認識連携完了>実行順4:紐づけ先が特定できない時のレコードID

(録音完了/音声認識連携完了イベント 実行順1:APIキー設定例)

 

(録音完了/音声認識連携完了イベント 実行順4:レコードID設定例)

下の画像の赤線部分には、発信番号から履歴を紐づけるレコードを特定することができなかった場合に、紐づけるリードのレコードID(※)を記載します。

※レコードIDの確認方法(以下の赤線部分がレコードIDです)

Ⅳ お客さまの業務に応じて、ChatGPTへの指示を調整
<録音完了/音声認識連携完了>実行順1:OPenAI APIへ要約の指示をしているので、必要に応じて修正してください。

※現在の設定例
 お客さまとの会話を300文字以内で箇条書きでまとめてほしいとき

※その他の設定例
 例)BIZTELユーザをオペレーターと読み替える
 例)お客さまからのお褒めや評価の言葉を抽出する
 例)会話の改善点を提案する

API_13_09

今回、ChatGPTで利用するモデル「gpt-3.5-turbo」はMAXREQUESTが4096tokensとなっているため、要約にかけられるお客さまとの会話文字数に制限があります。

現状、会話の先頭4000文字程度となっていますので、{VOICE_LOG.LEFT(4000).JSON_ESCAPE()}でお客さまとの会話を4000文字だけ抽出して、ChatGPTに指示しています。

上述の制限があり、要約対象の最大文字数を増やすことは出来ませんが、文字数を減らしたい場合には{VOICE_LOG.LEFT(4000).JSON_ESCAPE()}の4000文字の数値を調整してください。

Ⅴ 連携対象とする電話番号を選択
「連携対象」タブをクリックして、連携対象とする電話番号に✓を設定してください。

Ⅵ コールアクションの設定を有効化
「基本情報」タブをクリックして、ステータス項目を無効から有効に変更してください。

連携結果

Salesforceに通話内容を連携した結果、このようになりました
(画像をクリックすると、拡大されます)。

文字が小さく見づらいので、通話内容の原文を以下に掲載します。

<通話内容の全テキスト>

BIZTELユーザ : お電話ありがとうございます。カスタマーサポートセンターです。名前と問い合わせ内容を教えていただけますでしょうか?

お客様 : はい、こんにちは。私の名前は鈴木です。

お客様 : 今日は、インターネットの速度が非常に遅くなってしまって困っているのですが、こちらの窓口で問い合わせ可能でしょうか?

BIZTELユーザ : はい。鈴木様ご連絡いただきましてありがとうございます。インターネット速度が遅いというですね、大変ご不便おかけしまして申し訳ございません。

BIZTELユーザ : 上京区にさせていただく目に、まずはお客様のご住所と、アカウント番号をお聞かせいただけますでしょうか?

お客様 : はい。

お客様 : 住所は東京都新宿区。

お客様 : 1-1-1

お客様 : アカウント番号は、

お客様 : 12345678です。

BIZTELユーザ : ありがとうございます鈴木様、アカウント情報を確認させていただきますので、このまま少々お待ちくださいませ。

お客様 : はい。

BIZTELユーザ : 鈴木様大変お待たせいたしました。

BIZTELユーザ : アカウント情報の確認が取れました。

BIZTELユーザ : まずはですねお客様のインターネット環境について、靴か質問させていただきます。

BIZTELユーザ : 現在お使いのデバイスは何台接続されておりますでしょうか?

お客様 : 今のところスマートフォンが2台と、パソコンが2台です。

BIZTELユーザ : 承知いたしました。それらのデバイス読んだですね、どういうインターネットをしている場合多いですか。

お客様 : はい。

お客様 : そうですね。大体夜になると家族がみんなで使うので、同時に使うことが多いです。

BIZTELユーザ : ありがとうございます。夜になると、数が多くなるということですね承知いたしました。

お客様 : 夜とかはスマホが4台と、パソコン4台とかですかね。

BIZTELユーザ : お客様のご自宅はWi-Fiルーターを使用してますか。それとも有線接続ですか。

BIZTELユーザ : ありがとうございます。

BIZTELユーザ : いらネット速度に関連するトラブルシューティングをいくつか試させていただきます。

お客様 : Wi-Fiルーターを使っています。

BIZTELユーザ : まずはお客様のご自宅のインターネット環境に問題がないか確認させていただきます。

BIZTELユーザ : ルーターの電源を一度切っていただきまして、

BIZTELユーザ : 30秒ぐらい待ってから、再度電源をつけていただけますでしょうか?

BIZTELユーザ : はい。

お客様 : はい、わかりました。

お客様 : ちょっと待ってくださいね。

BIZTELユーザ : ありがとうございます。

BIZTELユーザ : それでは再度、インターネットの速度ですねパソコンでもスマホでもいいんですけど、確認していただけますでしょうか?

お客様 : 再起動が完了しました。

お客様 : はい。

お客様 : わかりました。やってみます。

BIZTELユーザ : 速度が回復したとのことで安心いたしました。

お客様 : 今試してみたところ速度が戻ったようです。ありがとうございます。

BIZTELユーザ : それでは引き続きインターネットが遅くならないよう、いくつかの対策を今回ちょっとご紹介させていただこうと思います。

BIZTELユーザ : 二つほどありまして、一つが、あのルーターが配置しているっていうところを見直してみてくださいっていうところですかね。

BIZTELユーザ : 壁や家具に囲まれた場所に置く電波が届きにくくなりますので、できるだけ高い位置に設置して、

BIZTELユーザ : 障害物っていうところを避けるようにしていただければと思います。

BIZTELユーザ : あとはですね、デバイスの数が接続されているデバイスの数が増えると、遅くなる可能性があります。

BIZTELユーザ : 必要なデバイスだけ接続して、不要なデバイスのWi-Fiをオフすることで、ことが改善されることがありますので、

お客様 : はい。

BIZTELユーザ : ぜひお試しいただければと思います。

BIZTELユーザ : ありがとうございます日お試しください。

BIZTELユーザ : 本日、この他にですねご質問はございますでしょうか?

お客様 : アドバイスありがとうございます。

お客様 : どちらも該当しそうなので、ちょっとまだ駄目見ますね。

BIZTELユーザ : かしこまりました。本日は田中が承りました。今後も引き続きよろしくお願いいたします。

お客様 : 大丈夫です。ありがとうございます。

BIZTELユーザ : はい失礼いたします。

お客様 : はい、ありがとうございます。失礼いたします。

 

<要約結果>

■要約:
お客様からの問い合わせ内容は、インターネットの速度が遅いこと。
BIZTELユーザは、お客様の住所とアカウント番号を確認。
デバイスの数や使用時間などの情報を聞き取り、ルーターの再起動を提案。
再起動後、速度が回復したとの報告があり、ルーターの配置や接続デバイスの数についてアドバイスを提供。
お客様はアドバイスを受け取り、引き続き試してみるとのこと。

 

要約結果の精度が高く、会話の全容を簡潔に把握することが可能になりました。

振り返り・まとめ

今回は、『BIZTEL APIアイデアベース Vol.2 ChatGPTで通話内容を要約して、オペレーター業務を効率化させたい』の記事でご紹介したChatGPTとの連携方法について、具体的にご説明しながら設定していきました。

ChatGPTと連携することで自動で要約が実現でき、「後作業」時間の工数が削減されます。例えば、これまで約7分の通話に対して、最大で約30〜40分要していた後作業時間が、約1分のSVによる要約内容の確認のみとなり、大幅に短縮されます。

さらに、人による通話記録の精度差もなくなり、業務の大幅な効率化・標準化に繋がります。


コールアクションテンプレート機能を利用することで複雑なAPI設定も簡単に設定できますので、ぜひお試しください。

編集後記

今回は、ChatGPTを使ってお客さまとの通話内容を要約、さらにSalesforceへ記録をする仕組みを実践しました。

このブログでは、今後も様々な機能の実装に挑戦していきます。設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2023/05/09/11626/feed/ 0
BIZTEL APIアイデアベース Vol.2 ChatGPTで通話内容を要約して、オペレーター業務を効率化させたい /blog/2023/05/09/11566/ /blog/2023/05/09/11566/#respond Tue, 09 May 2023 03:30:36 +0000 /?p=11566 「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者が 世の中の仕組みやツールとBIZTELをAPIを活用して連携させることで 「こんなことができたら面白そう」 「こういうことが実現できるともっと […]]]>

「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者が
世の中の仕組みやツールとBIZTELをAPIを活用して連携させることで

「こんなことができたら面白そう」
「こういうことが実現できるともっと便利になるかも?」

といったアイデアを考え、どのように実現するか検討していくシリーズです。

今回はChatGPTを活用して通話を要約し、その内容をSalesforceに連携する仕組みを考えてみました。

※ 具体的な設定方法は、こちらの【挑戦編】の記事で公開中です!
  → GPT-3.5 Turbo版
  → GPT-4版

チャレンジャー

やってみたいこと

多くのコールセンターでは、オペレーターはお客さまとの通話終了後、応対内容の記録を手動で登録しています。

今回は、いま話題となっているOpenAIのサービス「ChatGPT」を使って、お客さまとの会話を要約し、その結果をSalesforceに自動登録させてオペレータの後作業を効率化してみたいと思います。

使用するツール・利用ライセンス

BIZTELの利用ライセンス

・コールセンタープランのご契約
※今回ご紹介する連携を行うためには、BIZTELのバージョンが3.7.20以上である必要があります。

BIZTELで必要なオプション

・API連携コールアクション
・音声認識連携

BIZTEL以外に必要なもの

・Salesforce
・AmiVoice API
・OpenAI API

※ OpenAI APIの使用には、従量制の料金が適用されます。料金に関する詳細は、OpenAIのWebサイトをご覧ください。

※ セキュリティ面から、会話内容をクローズドな環境で運用されたい場合は、Microsoft社が提供するAzure OpenAI APIも利用可能です。

※ 詳細な条件についてはお問い合わせください。

動作の全体図

 

設定の流れ

OpenAI事前準備

OpenAI APIを利用してお客さまとの会話を要約するため、APIキーの発行など事前準備を行います。

Salesforce事前準備

お客さまとの通話履歴をSalesforceのToDoオブジェクトに連携するため、OAuth設定やToDoオブジェクトの設定などを行います。

BIZTEL設定

お客さまとの通話内容をテキスト化するため、音声認識連携の設定を行います。
またOpenAI APIを使って通話内容テキストを要約するために、コールアクションの設定を行います。
 

※ 詳細な設定方法は、こちらの記事をご覧ください。

連携結果

Salesforceに通話内容を連携した結果、このようになりました
(画像をクリックすると、拡大されます)。

文字が小さく見づらいので、通話内容の原文を以下に掲載します。

<通話内容の全テキスト>

BIZTELユーザ : お電話ありがとうございます。カスタマーサポートセンターです。名前と問い合わせ内容を教えていただけますでしょうか?

お客様 : はい、こんにちは。私の名前は鈴木です。

お客様 : 今日は、インターネットの速度が非常に遅くなってしまって困っているのですが、こちらの窓口で問い合わせ可能でしょうか?

BIZTELユーザ : はい。鈴木様ご連絡いただきましてありがとうございます。インターネット速度が遅いというですね、大変ご不便おかけしまして申し訳ございません。

BIZTELユーザ : 上京区にさせていただく目に、まずはお客様のご住所と、アカウント番号をお聞かせいただけますでしょうか?

お客様 : はい。

お客様 : 住所は東京都新宿区。

お客様 : 1-1-1

お客様 : アカウント番号は、

お客様 : 12345678です。

BIZTELユーザ : ありがとうございます鈴木様、アカウント情報を確認させていただきますので、このまま少々お待ちくださいませ。

お客様 : はい。

BIZTELユーザ : 鈴木様大変お待たせいたしました。

BIZTELユーザ : アカウント情報の確認が取れました。

BIZTELユーザ : まずはですねお客様のインターネット環境について、靴か質問させていただきます。

BIZTELユーザ : 現在お使いのデバイスは何台接続されておりますでしょうか?

お客様 : 今のところスマートフォンが2台と、パソコンが2台です。

BIZTELユーザ : 承知いたしました。それらのデバイス読んだですね、どういうインターネットをしている場合多いですか。

お客様 : はい。

お客様 : そうですね。大体夜になると家族がみんなで使うので、同時に使うことが多いです。

BIZTELユーザ : ありがとうございます。夜になると、数が多くなるということですね承知いたしました。

お客様 : 夜とかはスマホが4台と、パソコン4台とかですかね。

BIZTELユーザ : お客様のご自宅はWi-Fiルーターを使用してますか。それとも有線接続ですか。

BIZTELユーザ : ありがとうございます。

BIZTELユーザ : いらネット速度に関連するトラブルシューティングをいくつか試させていただきます。

お客様 : Wi-Fiルーターを使っています。

BIZTELユーザ : まずはお客様のご自宅のインターネット環境に問題がないか確認させていただきます。

BIZTELユーザ : ルーターの電源を一度切っていただきまして、

BIZTELユーザ : 30秒ぐらい待ってから、再度電源をつけていただけますでしょうか?

BIZTELユーザ : はい。

お客様 : はい、わかりました。

お客様 : ちょっと待ってくださいね。

BIZTELユーザ : ありがとうございます。

BIZTELユーザ : それでは再度、インターネットの速度ですねパソコンでもスマホでもいいんですけど、確認していただけますでしょうか?

お客様 : 再起動が完了しました。

お客様 : はい。

お客様 : わかりました。やってみます。

BIZTELユーザ : 速度が回復したとのことで安心いたしました。

お客様 : 今試してみたところ速度が戻ったようです。ありがとうございます。

BIZTELユーザ : それでは引き続きインターネットが遅くならないよう、いくつかの対策を今回ちょっとご紹介させていただこうと思います。

BIZTELユーザ : 二つほどありまして、一つが、あのルーターが配置しているっていうところを見直してみてくださいっていうところですかね。

BIZTELユーザ : 壁や家具に囲まれた場所に置く電波が届きにくくなりますので、できるだけ高い位置に設置して、

BIZTELユーザ : 障害物っていうところを避けるようにしていただければと思います。

BIZTELユーザ : あとはですね、デバイスの数が接続されているデバイスの数が増えると、遅くなる可能性があります。

BIZTELユーザ : 必要なデバイスだけ接続して、不要なデバイスのWi-Fiをオフすることで、ことが改善されることがありますので、

お客様 : はい。

BIZTELユーザ : ぜひお試しいただければと思います。

BIZTELユーザ : ありがとうございます日お試しください。

BIZTELユーザ : 本日、この他にですねご質問はございますでしょうか?

お客様 : アドバイスありがとうございます。

お客様 : どちらも該当しそうなので、ちょっとまだ駄目見ますね。

BIZTELユーザ : かしこまりました。本日は田中が承りました。今後も引き続きよろしくお願いいたします。

お客様 : 大丈夫です。ありがとうございます。

BIZTELユーザ : はい失礼いたします。

お客様 : はい、ありがとうございます。失礼いたします。

 

<要約結果>

■要約:
お客様からの問い合わせ内容は、インターネットの速度が遅いこと。
BIZTELユーザは、お客様の住所とアカウント番号を確認。
デバイスの数や使用時間などの情報を聞き取り、ルーターの再起動を提案。
再起動後、速度が回復したとの報告があり、ルーターの配置や接続デバイスの数についてアドバイスを提供。
お客様はアドバイスを受け取り、引き続き試してみるとのこと。

 

要約結果の精度が高く、会話の全容を簡潔に把握することが可能になりました。

結果

今回は、OpenAI APIを利用してお客さまとの通話内容を要約し、Salesforceに結果を記録してみました。

オペレータのスキルによる通話記録の精度や粒度についての課題は、ChatGPTが自動で処理することで解決されます。

また、オペレーターやSVの業務も大幅に効率化が可能です。

例えば、約7分の通話に対しての後処理作業で比べてみると、これまでは通話の書き起こし(必要な場合のみ)、内容の要約と記録、SVの録音確認(クレームがあった場合)など、最大で約30〜40分要していましたが、ChatGPTと連携することで、約1分のSVの要約確認のみと、後作業の時間が大幅に短縮され、業務効率化に繋がります。

ぜひ、ご興味ある方はBIZTELまでお問い合わせください。

]]>
/blog/2023/05/09/11566/feed/ 0
BIZTEL APIアイデアベース Vol.1 モーニングコール予約の仕組みを考える /blog/2023/02/08/11095/ /blog/2023/02/08/11095/#respond Wed, 08 Feb 2023 07:26:33 +0000 /?p=11095 「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者がAPIによって 世の中の仕組みやツールとBIZTELを連携させて、応用的な機能や仕組みの構築を検討した記事をご紹介します。 「こんなことができ […]]]>

「BIZTEL APIアイデアベース」シリーズでは、BIZTELの技術担当者がAPIによって
世の中の仕組みやツールとBIZTELを連携させて、応用的な機能や仕組みの構築を検討した記事をご紹介します。

「こんなことができたら面白そう」「こういうことが実現できるともっと便利になるかも?」といったアイデアを、BIZTELのAPI機能を通じて、どのように具体的に実現できそうか、検討していくシリーズです。

今回はBIZTELのIVRにダイヤル入力することでモーニングコール予約ができる仕組みを考えてみました。

※「BIZTEL APIアイデアベース」シリーズは動作検証などを行っていない『構想段階』の記事となります。
 機能実装に関するご相談をお受けすることは可能ですが、詳しくお答えできない場合がございます。あらかじめご了承ください。

担当者

BIZTEL APIを使ったアイデア

仮想の外部システムと連携し、BIZTELのIVRでモーニングコール予約ができる仕組みが作れないかと検討しています。

想定している利用ツール

BIZTELで必要なオプション

  • API連携IVR
  • コールバックAPI

それ以外で用意が必要なツール

  • 「時刻」と「内線」を登録できるDB
  • 規定時刻にコールバックAPIを起動できる外部システム

想定している動作の概要

手順1:モーニングコール予約用ダイヤルへ発信

BIZTELの対象IVRに電話をかけます。

手順2:コールバック時刻を登録する

「何時にお電話をご希望でしょうか?」と、あらかじめ登録しておいたガイダンスが流れるので、起こしてほしい時間を、4桁でダイヤル入力します。

手順3:予約を完了する

「登録が完了しました」と、あらかじめ登録しておいたガイダンスが流れるので切電します。

手順4:モーニングコールの着信

「手順2」で登録した時刻にモーニングコールがかかってきます。

動作の詳細

下記のような順番でシステムが動作すると考えています。

※想定フローのイメージは、図をご覧ください。

1.BIZTELのAPI連携IVRを使用

API-IVRのフロー1段目、初期ガイダンスで「何時にお電話をご希望でしょうか」と読み上げます。

2.BIZTELのAPI連携IVRを使用

API-IVRのフロー2段目、BIZTELのIVRにてダイヤル入力で4桁を入力させて外部システムに内線番号と時刻を送信します。

※こちらはダイヤルを4桁の時間にする(例外を認めない)正規表現のサンプルです。
 (00~19、20~23の先頭2桁および00~59まで)

/^([01][0-9]|2[0-3][0-5][0-9])$/

エラーの場合に何回繰り返すかは、任意で設定します。
外部システムよりOKレスポンスを受け取ることができた場合は次のフローへ移行します。

3.BIZTELのAPI連携IVRを使用

API-IVRのフロー3段目、「登録が完了しました、今おかけになっている電話機に指定時間にお電話します」のガイダンスと共に切電します。

4.外部システムでの動作

指定時刻に下記APIをキックします。
※サンプルコードです。【】内を書き換えて使用します。

https://【sxxxxxxxxxxxx.u.biztel.jp:8000/→ご契約のアドレス】callback?first_call_number=【2001→かけ返したい内線番号】&second_call_number=【5000→ガイダンスを流す5000番台のグループ内線番号】&async_flg=0

5.BIZTELがコールバックAPIに沿ってダイヤルする

  1. ファーストコール →内線番号に応じたユーザを呼び出し
  2. セカンドコール  →ガイダンスを鳴動

6.モーニングコールの完了

まとめ

モーニングコールはホテルの客室での利用が代表的ですが、今回検討した仕組みはDBに格納された時間にAPIをどのように起動させるかを外部システム側で考慮することがポイントだと考えています。

なお、その他にも、

  • リアルタイム音声合成オプションを利用することでIVRで入力した時間を自動音声が復唱してくれる
  • 外部システム側でAPIの起動回数と時間をコントロールしてスヌーズ機能を実現する

といったことも可能になると思います。

一つ一つ仕組みを理解していくことで普段何気なく使っているものをより身近に感じることができるのも、API連携を検討する醍醐味の一つだと感じました。

編集後記

今回は、BIZTELと外部システムを連携してモーニングコールの仕組みについて検討してみました。

「BIZTEL APIアイデアベース」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能をご紹介する予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

 

]]>
/blog/2023/02/08/11095/feed/ 0
BIZTEL API使ってみた Vol.12 ダイレクトインダイヤル設定~代表番号から取次なしで担当者や部署を呼び出したい /blog/2022/11/29/10873/ /blog/2022/11/29/10873/#respond Tue, 29 Nov 2022 06:49:45 +0000 /?p=10873 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら 今回は代表番号への着信を担当者 […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回は代表番号への着信を担当者・部署の内線番号に直接電話をつなげる仕組みを実践してみます。

やってみたいこと

外線番号から、さらに担当者や部署の内線番号を指定できるようにします。

指定したい担当者や部署に直接電話をかけられるため、取り次ぎにかかる時間の削減を実現できます。
今回は、2つの方法をご紹介します。

・【標準版】BIZTELの「API連携IVR」を利用して、ダイヤルされた内線番号につなげる。
・【応用版】BIZTELの「音声認識IVR」を利用して、発話された部署や担当者の内線番号につなげる。

チャレンジャー

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

【標準版】BIZTELで必要なオプション

・API連携IVR

【応用版】BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成
・音声認識IVR

BIZTEL以外に必要なもの

・AmiVoice API

※ 詳細な条件についてはお問い合わせください。

【標準版】動作の流れ

外線番号(API連携IVR)に着信した後に、さらに繋げたい内線番号をダイヤルするよう促すガイダンスを流します。内線番号をダイヤルすると、指定した内線番号へ転送されます。

このように、人を介することなく目的の個人へ取り次ぐことができます。

【標準版】設定の実践

対象メニュー:コールセンター > IVR
新規作成の場合はIVRメニュー左上の「新規」ボタンを押下のうえ、ご設定ください。

1. ダイレクトダイヤルイン設定(API連携IVRでのダイヤル入力)を作成

API連携IVRで、指定した入力パターンでダイヤルされるようにします。

1-1 「基本情報」の設定

各項目を以下の通り登録します。

■受付入力種別:ダイヤル入力
■受付ダイヤル最大桁数:4
■入力チェックパターン:/[1-3][0-9][0-9][0-9]|5004/

※電話端末内線(1000~3999)or グループ内線番号(5000番台)とする。
ここでは、担当者の内線番号が不明なときにグループ内線番号(5004)へつなぐことを想定しています。

1-2 「API連携設定」タブの設定

項目「URL」を以下の通り登録します。

・URL:response://
※APIリクエストしないようにする。

1-3 「APIレスポンス設定」タブの設定

①ダイヤルされた4桁の内線番号へ{DIGITS}で転送する設定

各項目を以下の通り登録します。
・レスポンスコード:200
・転送先:{DIGITS}

【注意事項】
・登録されていない内線番号、または起動していない電話端末の内線番号をダイヤルした場合は切断されますのでご注意ください。
・誤入力や誤認識を考慮して、リアルタイム音声合成機能を利用した内線番号の復唱によって、内線番号を確認してからのダイレクトインダイヤルも可能です。

②レスポンスコードが200ではない場合に操作ガイダンスに戻る設定

項目「選択時の動作」を以下の通り設定します。

・選択時の動作:操作ガイダンスに戻る

【応用版】動作の流れ

外線番号に着信した後に、繋ぎたい方の個人名や部署名の発話を促すガイダンスを流します。
発話することで、内線番号をダイヤルせずに指定の個人や部署へ転送できるため、取り次ぎなく発信することができます。

【応用版】設定の実践

1.ダイレクトダイヤルイン設定(音声認識)を作成

対象メニュー:コールセンター > IVR

1-1「基本情報」「ガイダンス」「API連携設定」タブの設定

設定方法はこちらをご参照ください。

1-2「APIレスポンス設定」タブの設定

各項目を以下の通り設定します。

・レスポンスパターン:部署名称を判定する文字列を設定します。
今回は営業部、総務部、開発部へ転送するために、3つのレスポンスパターンを設定しました。

・ガイダンス形式:リアルタイム音声合成
発話内容の誤認識を考慮して、今回は転送先をリアルタイム音声合成で確認します。
確認ステップが不要の場合には、設定不要です。

・転送先:各部署用の確認IVR
転送部署に問題がないかを確認するIVR(ダイヤル入力)へ転送します。

2.はい・いいえ確認用のIVR(ダイヤルIVR)作成

設定方法は、こちらをご参照ください。
ここでは、以下の内容で設定を入れていきます。

・転送先に問題がない場合は『1』をダイヤルすると、指定の内線番号へ転送。

・それ以外の場合には『2』をダイヤルすると、ひとつ前のダイレクトダイヤルイン設定(音声認識)に戻る。

結果

外出先から内線番号を指定して直接社内の担当者や部署にかける方法を、【標準版】と【応用版】の2パターンでご紹介いたしました。どちらも人を介さずに電話をかけたい相手に直接発信することができるため、取り次ぎの手間を省略することができます。

また、外出先から内線電話を利用するような感覚で運用できるため利便性が向上されます。ぜひ、お試しください。

編集後記

今回は、代表番号へ着信した通話を担当の部署や担当者の内線番号にそのまま転送する、という仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2022/11/29/10873/feed/ 0
BIZTEL API使ってみた Vol.11 SMSで別のチャネルに誘導し、待ち呼のお客さまのストレスを軽減 /blog/2022/08/26/10069/ /blog/2022/08/26/10069/#respond Fri, 26 Aug 2022 08:23:11 +0000 /?p=10069 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら 今回はBIZTELとSMSサー […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回はBIZTELとSMSサービスを連携し、コールセンターの混雑時にWebフォームへ誘導するためのSMSを送信するフローを構築してみます。

やってみたいこと

お客さまが状況を把握するためにコールセンターへお問い合わせいただいた際に、入電が集中しているとオペレーターに接続するまでに長い時間お待たせしてしまい、顧客満足度の低下につながってしまう。

そこでBIZTELとSMS配信サービスを連携し、ご希望されるお客さまに対して、電話以外に障害連絡フォームやお問い合わせフォームなどWeb窓口のURLをご案内することで早期受付をおこない、顧客満足度の低下を防ぎたい。

チャレンジャー

 

使用するツール ※

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携コールアクション

BIZTEL以外に必要なもの

・SMS FourS

※ 詳細な条件についてはお問い合わせください。

動作イメージ

コールセンターにて待ち呼となったお客さまに、Webサイトのお問い合わせフォームへ誘導するガイダンスを流します。
SMS送信を希望するお客さまは「#」をプッシュすることで待ち呼から離脱します。その際、お問い合わせフォームのURLが書かれたSMSが現在架電している電話番号宛に送信されます。

設定の実践

全体の流れ

1.コールアクション連携の設定

外部サービスへAPIリクエストを送るための設定

2.ガイダンス登録

お待たせガイダンスとSMS送信時ガイダンスの登録

3.着信グループの作成

SMS送信時ガイダンスを流すための着信グループ作成

4.共通着信ルールの設定

待ち呼中に#を押した時に着信グループへ転送させる設定

5.コールセンターの設定

SMSを送信したいコールセンターにこれまでの設定を反映

設定手順

1.コールアクション連携の設定

まずはBIZTELと、りーふねっと社のSMSサービス「SMS FourS」を連携させます。

はじめにSMS FourSで用意されているAPIにSMS送信リクエストを送る設定をします。

1-1:コールアクションの作成

①「コールアクション連携」の一覧画面右上の「新規」をクリックします。

②新規設定画面が開いたら、以下の通り設定します。

・コールアクション名:「SMS送信」などわかりやすい名称を入力
・ステータス:「有効」

必要な項目への入力が完了したら「保存」ボタンをクリックします。
正常に保存されるとコールアクション連携の詳細画面が表示されます。

1-2:連携対象の設定

①詳細画面の上部に表示されている「連携対象」タブをクリックし、「編集」ボタンをクリックします。

②SMS連携を実行するすべての電話番号にチェックを入れます。

必要な項目への入力が完了したら「保存」ボタンをクリックします。

1-3:「API連携」の設定

①詳細画面の上部に表示されている「API連携」タブをクリックします。

②画面上部タブの右下にある「新規」ボタンをクリックします。

③詳細設定画面が開きますので、次の通り入力します。

イベント種別 コールセンターキューダイヤル受付
実行順 1
判定用コード {CALLED}
判定評価パターン /^0312345678/
API連携種別 マニュアル
URL https://4sm.jp/api/sms_send
メソッド POST
リクエストヘッダ Content-Type:application/x-www-form-urlencoded
リクエストボディ carrier_id=99&message=BIZTELのお問い合わせはこちらまで /support/inquiry/&address={TEL}&urlshorterflg=0&cp_userid=ID&cp_password=PASSWORD
タイムアウト判定(秒) 30
変数抽出パターン -(記載なし)
メモ -(記載なし)

※赤字部分は連携対象ごとに修正が必要な個所です。

【実行順】

  • 同じイベント種別の中で1から順に連番を選択します。

【判定評価パターン】

  • SMS送信対象のBIZTELの電話番号を入力してください。半角数字のみで-は入れないでください。

【リクエストボディ】

  • message=の次 SMSで送信する本文を入力してください。
  • cp_userid=の次 API KEY IDを入力してください。
  • Cp_password=の次 API KEY Password を入力してください。

必要な項目への入力が完了したら「保存」ボタンをクリックします。

2.ガイダンス登録

Ⓐお待たせガイダンス と ⒷSMS送信時に流すガイダンス の2つを用意し、「共通ガイダンス」に登録します。

・関連マニュアル 1.共通ガイダンスと個別ガイダンス

Ⓐお待たせガイダンス
通常のお待たせガイダンスにSMS送信の案内を追加しています。

<例>
お待たせして申し訳ございません。ただいま電話がたいへん混雑しております。オペレーターが空き次第順番にお繋ぎしますので、電話を切らずにそのままお待ちください。なお、Webサイトからのお問い合わせですと、お待ちいただくことなく、お問い合わせいただけます。携帯電話からおかけの方は、ショートメールでWebサイトのURLをお送りすることもできますので、ご希望される場合は電話機の♯ボタンを押してください。

ⒷSMS送信時に流すガイダンス
お待たせ中に#ボタンを押した方に流すガイダンスです。

<例>
お電話いただいております携帯電話あてにショートメールを送信しました。ショートメールに記載のURLよりWebサイトにアクセスいただき、お問い合わせ内容をご入力ください。お問い合わせ内容を確認後、当社よりご連絡いたします。本日はお電話ありがとうございました。

必要な項目への入力が完了したら「保存」ボタンをクリックします。

3. 着信グループの作成

SMS送信時にガイダンスを流すための着信グループを設定します。
お客さまが待ち呼中に#を押した時にこの着信グループへ転送させ、SMSを送信した旨のガイダンスを流します。

3-1:着信グループの新規作成

①着信グループ画面右上にある「新規」ボタンをクリックします。

新規登録画面が開きますので、以下の通り登録します。

・着信グループ名:「SMS送信時ガイダンス再生用」などわかりやすい名称を入力。
・内線番号:5000~5999の中で使用していない番号を入力。
・ダイヤルイン番号:「選択なし」

必要な項目への入力が完了したら「保存」ボタンをクリックします。
正常に保存されると作成した着信グループの詳細画面が表示されます。

3-2:ガイダンスを流すための着信ルールの設定

①画面上部の「個別着信ルール」タブをクリックします。
※タブがない場合は、右端にある 「V」をクリックすると表示されます。

②画面上部のタブの右下にある「新規」をクリックします。

③個別着信ルールの新規設定画面が表示されますので、以下の通り登録します。

・着信ルール名:「SMS送信時用」などわかりやすい名称を入力。
・着信ルール種別:「ガイダンス」を選択。
・ガイダンス名:2.ガイダンス登録 で設定した ⒷSMS送信時に流すガイダンス を選択します。

必要な項目への入力が完了したら「保存」ボタンをクリックします。

3-3:着信設定

①同画面の上部 「着信設定」タブを開きます。

②「編集」をクリックし、以下の通り登録します。

・不在着信時ルール:「設定する」
 ┗不在判定(秒):「0」を入力
・応答不能時ルール:「個別に設定する」
・着信ルール:3-2:ガイダンスを流すための着信ルールの設定 で登録したSMS送信時用のルールを選択します。

必要な項目への入力が完了したら「保存」ボタンをクリックします。
これで、待ち呼中に#を押した際に 、SMSを送信した旨をお伝えするガイダンスを流す動作ができるようになりました。

4.共通着信ルールの設定

待ち呼中に#を押し、離脱した時の動作を設定します。

①画面右上にある「新規」ボタンをクリックします。

②共通着信ルールの新規設定画面が開くので、以下の通り登録します。

・着信ルール名:「待ち呼中#選択」などわかりやすい着信ルール名を入力。
・着信ルール種別:「転送」を選択。
 ┗転送先:3-1:着信グループの新規作成 で登録した着信グループを選択。

必要な項目への入力が完了したら「保存」ボタンをクリックします。これで、待ち呼中に#を押した際に、SMS送信時のガイダンスを流すための着信グループへ転送できるようになりました。

5.コールセンターの設定

5-1:ガイダンス設定

①SMS送信を行いたいコールセンターをクリックして詳細画面を開き、上部に表示される「ガイダンス」タブをクリックします。

②ガイダンス設定が表示されますので「編集」をクリックし、以下の通り登録します。

・受付種別:「おまたせガイダンス+保留音」
・初期ガイダンス:「14_CC_初期ガイダンス」
・お待たせガイダンス設定:「指定した間隔で次のガイダンスを流す」
 ┗ 2.ガイダンス登録 で設定した Ⓐお待たせガイダンス を選択します。

・お待たせガイダンス間隔(秒):任意の秒数を入力

必要な項目への入力が完了したら「保存」ボタンをクリックします。

5-2:待ち呼に入ったときの挙動設定

①コールセンター詳細画面の上部にある「着信設定」タブをクリックします。

②着信設定画面が表示されたら「編集」をクリックし、以下の通り登録します。
・待ち呼ダイヤル受付:「設定する」に変更
・着信ルール:4-1:共通着信ルールの設定 で作成した、待ち呼中#選択用の着信ルールを選択

必要な項目への入力が完了したら「保存」ボタンをクリックします。

動作確認

実際にコールセンターの番号へかけて、「#」で待ち呼から離脱するとSMSで障害連絡フォームURLが送信されることを確認します。

結果

SMS配信サービスと連携して、待ち呼中に電話以外の受付窓口(Webフォームなど)へ誘導する方法をご紹介しました。

SMS配信サービスと連携すると、お客さまのご用件を早期に受け付けできるだけでなく、お客さまが自己解決できる仕組みを提示できるため、応対品質の向上につながります。ぜひ、お試しください。

編集後記

今回は、SMSサービスとの連携を活用してコールセンターの混雑時にWebサイトへの誘導を実現する、という仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2022/08/26/10069/feed/ 0
BIZTEL API使ってみた Vol.10 IFTTTを使ってノーコードでコールバック予約受付業務の自動化を実現したい /blog/2022/05/23/9259/ /blog/2022/05/23/9259/#respond Mon, 23 May 2022 06:09:20 +0000 /?p=9259 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら 今回はIFTTTを利用して、コ […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら

今回はIFTTTを利用して、コードをいじらずにコールバック予約受付業務の自動化を実現してみたいと思います。

やってみたいこと

  • 営業時間外に電話をかけてきたお客さま向けに、コールバック予約受付機能をつくりたい
  • お客さまが話した内容(折り返し先の電話番号などのコールバックに必要な情報)をGoogleスプレッドシートに自動で書き込み、書き込みが終わったらSlackで通知する
  • 技術者ではない人でも簡単に、複数のWEBサービスと連携することができる仕組みをつくりたい

以上のことを踏まえ、BIZTELのコールアクション機能と、システム連携サービスのIFTTT(イフト)を利用してノーコードで実現可能な仕組みをつくってみたいと思います。

チャレンジ担当者紹介

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成
・API連携コールアクション
・音声認識IVR

BIZTEL以外に必要なもの

・IFTTT Pro
・AmiVoice API
・Google スプレッドシート
・Slack

※ 今回ご紹介する連携を行うためにはBIZTELのバージョンが3.3.0以上である必要があります。

※ 詳細な条件についてはお問い合わせください。

動作の流れ

  1. BIZTELに電話がかかってきたら、あらかじめIVRに登録しておいたガイダンスシナリオをもとに、自動音声でコールバック予約受付を開始。
    コールバック先の情報(用件や連絡先電話番号)をヒアリングし、テキスト化する。

  2. 1で得た情報をWebプリケーションと連携するために、BIZTELのコールアクション連携設定でIFTTT側のWebhooksを呼び出す。

  3.  IFTTT側のWebhooksが呼び出されたら以下のWebアプリケーションが実行される。
    • Googleスプレッドシートに、コールバック先の情報が挿入される
    • Slackにコールバック予約受付があったことを通知

 

設定の実践

■【IFTTT設定①】Applet(プログラム)を作成

IFTTTにて、お客さまが発話する内容をGoogleスプレッドシートに書き込み、書き込みが終わったらSlackで通知するApplet(プログラム)を作成していきます。

1.右上「Create」ボタンから作成開始

 

2.“If This”に「Webhooks」を追加

Webhooksサービスの「Receive a web request」を選択し、Event Name(名称は任意)を設定します。
Event Nameは「コールアクション連携」設定時に利用するので、メモしておきます。

3.“Then That”に「Google Sheets」を追加

3-1.Google Sheets サービスの「Add row SpreadSheet」を選択し、Connectをクリックして、IFTTTに操作を許可します。

3-2.情報を設定

  • Spreadsheet name →スプレッドシートのファイル名
  • Formatted row →スプレッドシートに挿入するデータを設定
    ※ BIZTELのコールアクションで指定する3つの値を設定する。受付日時・発信電話番号・詳細(名前や希望時間・用件)など。

4.“Then That”に「Slack」を追加

4-1.Slack サービスの「post to channnel」を指定し、ConnectをクリックしてIFTTTに操作を許可します。

4-2.情報を設定
「Which channel?」では通知先のチャンネルを設定し、タイトルとメッセージを指定します。

5.「Continue」をクリックして、Appletタイトルを設定して終了します。

■【IFTTT設定②】Webhookで呼び出すURLを確認する

Webhooksトリガーのページに移動し、「Documentation」をクリックします。

ここから、PostのリクエストURLを確認します。

このリクエストURLはBIZTEL側の「コールアクション連携」設定時に必要となるため、メモしておいてください。

 ※{event}はWebhooksで設定したEvent Nameが入ります。

■【BIZTEL設定】

1.コールバック受付IVR(音声認識連携IVR)を作成

お客さまが発話する音声(コールバックの受付に必要な情報)をテキスト化し、お客さまに発話内容を音声でご確認いただくための設定をします。

1-1.ガイダンス設定やAPI連携設定を行います。

※設定方法については、こちらをご参照ください。

1-2.APIレスポンス設定

お客さまが発話した内容(コールバック予約の受付に必要な情報)を変数{CODE1}に格納します。

 

2.はい・いいえ確認IVR(ダイヤルIVR)作成

1で流れた音声内容に問題がないかをお客さまに回答(意思表示)していただくための設定を行います。

  ※設定方法については、こちらをご参照ください。

この設定により、内容に問題なければ切断され、間違いがあれば再度コールバック受付IVRへ転送される挙動となります。

 

3.コールアクション連携設定

着信切断時に、指定した情報をWebアプリケーションに連携するために、IFTTTのWebhooksを呼び出す設定を行います。
URLには「【IFTTT設定②】Webhookで呼び出すURLを確認する」で取得したPostのリクエストURLを設定し、
リクエストボディには、「Google Sheets」の項目:Formatted rowで指定した変数にそれぞれ値※を設定していきます。

※このイベントが実行された時刻{DATE}、発信元電話番号{TEL}、コールバック受付IVRでお客さまが発話した内容{7006_CODE1}

これで、着信切断時にWebhooksのイベントを呼び出し、指定した値を連携することが可能です。

 

■動作確認

試しに該当のコールバック予約受付用の電話番号に架電し、切断時にGoogleのスプレッドシートにコールバック受付内容が追加され、Slackに通知されることを確認します。

①Googleスプレッドシートにデータが挿入されることを確認

②Slackに通知されることを確認

結果

IFTTTを利用することで、GoogleスプレッドシートやSlackなど各WebサービスのAPI仕様を調べる必要なく、BIZTELコールアクション設定だけで、BIZTELと複数のWebサービスを連携することができました。

今までWebサービスとの連携を試したことがない方も、是非お試しください。

編集後記

今回は、IFTTTを使ってコードをいじらずにコールバック予約受付業務を自動化する、という仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2022/05/23/9259/feed/ 0
BIZTEL API使ってみた Vol.9 着信時に自動でZendeskの新規チケットを作成しポップアップ表示させる /blog/2022/03/29/8997/ /blog/2022/03/29/8997/#respond Tue, 29 Mar 2022 07:05:14 +0000 /?p=8997 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら 今回はBIZTELとZende […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回はBIZTELとZendeskを連携して、着信時に自動でチケットを発行し、ポップアップ表示する仕組みを作ってみたいと思います。

やってみたいこと

  • 着信時に自動的にZendeskのチケットを新規作成し、そのチケットをポップアップ表示させる
  • BIZTELの機能「コールアクション連携」(※オプション)と、アカウントの「APIカスタム項目」タブを利用して実現する

チャレンジ担当者紹介

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約

BIZTELで必要なオプション

・API連携コールアクション

BIZTEL以外に必要なもの

・Zendesk(詳細な条件についてはお問い合わせください)

動作の流れ

  1. 着信時に、お客さまの電話番号からZendeskの顧客IDを特定する
  2. Zendeskでチケットが自動的に新規作成され、特定した顧客IDと紐づけられる
  3. 着信中のBIZTELアカウントに対して、Zendesk画面上で自動作成されたチケットをポップアップ表示させる

設定の実践

2026年6月のZendeskのOAuth認証仕様変更に伴い、BIZTEL バージョン3.14.0のリリース前後で設定方法が異なります。

ご利用の環境に応じて、以下の手順をご確認ください。
BIZTELバージョン3.14.0は、2026年7月中のリリースを予定しています。

◆Zendesk管理画面での事前準備

Zendesk OAuth仕様変更後 かつ BIZTEL 3.14.0リリース前の設定方法(APIトークン認証)

ZendeskのOAuth仕様変更後、BIZTELバージョン3.14.0がリリースされる前の期間は、APIトークン認証による設定が必要です。

APIトークンの発行

1. Zendesk管理センターで「アプリおよびインテグレーション」>「API」>「Zendesk API」を開き、「APIトークンを追加」をクリックします。


2.任意の文字列を入力したら、保存をクリックし、発行されたAPIトークンを控えておきます。発行されたAPIトークンは後続の「BIZTEL管理画面での設定」で使用します。

BIZTEL 3.14.0リリース以降の設定方法(OAuth認証/Refresh Token Rotation対応)

BIZTELバージョン3.14.0リリース以降は、ZendeskのRefresh Token Rotation方式に対応したOAuth認証を利用できます。

OAuthクライアントの作成

1.Zendesk管理センターで「アプリおよびインテグレーション」>「API」>「OAuthクライアント」を開きます。

2.「OAuthクライアント」タブを選択し、「OAuthクライアントを追加」をクリックし、以下の内容を設定します。

フィールド名

設定値

名前(必須)

アプリケーションの名前を入力する。
※BIZTEL側のOAuthアカウント設定の登録時に必要となります。

説明

任意文字列

会社

会社名を記載

ロゴ

省略可能

識別子

クライアント名として入力した名前が再フォーマットされ、自動的に設定される。
変更しても問題ない。

クライアントの種類

Confidential

リダイレクトURL

BIZTEL管理画面のURL/oauth_client/callback

例)https://sXXXXXXXXXXXX.u.biztel.jp:8000/oauth_client/callback
※「XXXXXXXXXXXX」には管理画面URLの「s」の後に続く12桁の数字を入力してください。

シークレット

シークレットキーが発行された場合に、文字列が表示される。
※発行されたOAuthシークレットは、後続のBIZTEL設定で使用します。

◆BIZTEL管理画面での設定

1.BIZTEL管理画面にて「OAuth連携設定」を作成(BIZTEL 3.14.0リリース以降の設定方法)(※2)

※2 ステップ1の設定は、BIZTEL バージョン3.14.0以上をご利用の場合のみ必要です。

ZendeskとAPI連携するために、こちらの「1.OAuthアカウントの設定」を参照しながら、BIZTEL管理画面上でOAuthの連携設定を作成します。

  • Zendesk OAuthアカウント登録
  • Zendesk アクセストークンの取得

認証情報
名称 ZendeskOAuthアカウント
クライアントID biztel_test(Zendeskで発行したOAuthクライアント名)
クライアント・シークレット (Zendeskで発行したOAuthクライアントのシークレットキー)
リダイレクトURL https://XXXXXXXX.biztel.jp:8000/oauth_client/callback
認可URL https://XXXXXXXX.zendesk.com/oauth/authorizations/new
認可コード フロー scope read write
認可コード フロー パラメータ response_type=code
アクセストークンURL https://XXXXXXXX.zendesk.com/oauth/tokens
リフレッシュトークン フロー scope  
トークンリクエスト・パラメータ  
リフレッシュトークン返却確認 確認する
認証ヘッダ・テンプレート  
メモ  
アクセストークン・付与情報 {"scope":"read write"}
リフレッシュトークン取得状態
アクセストークン取得状態

取得済み

リフレッシュトークン取得状態 未取得

2.BIZTEL管理画面へZendeskアカウントIDを登録する

BIZTELアカウントとZendeskアカウントを関連付けるために、BIZTEL管理画面にて紐付け設定を行います。

①Zendesk管理画面で、ZendeskのアカウントIDを確認します(下図の赤線部分)。

②BIZTEL管理画面で、BIZTELのアカウントに対して上記で確認したZendeskのアカウントIDを設定します。

(対象画面)
BIZTEL管理画面>メニュー「アカウント」>アカウント>対象のアカウントを選択>『APIカスタム項目タブ』にZendeskアカウントIDを登録

3.BIZTEL管理画面にてコールアクション設定を登録

本記事ではOAuth認証を利用した設定例を掲載しています。

BIZTEL 3.14.0リリース前の環境で「APIトークン認証」を利用する場合は、各API設定の「API連携種別」および「リクエストヘッダ」の設定が異なります。
各設定例の補足をご参照ください。

a. 顧客発信電話番号を条件として顧客IDを検索し、顧客IDを取得する処理
b. 着信時に自動で新規チケットを作成し、チケットと顧客IDを紐づける処理
c. 着信中のアカウントにチケットをポップアップ表示させる処理

<説明>
a.着信時にお客さまの発信電話番号を条件として顧客情報を検索し、該当する顧客IDを変数に格納

基本情報
イベント種別 着信
実行順 1
API実行条件
判定用コード  
判定評価パターン  
API情報
API連携種別 OAuth認証時:OAuth

APIトークン認証時:マニュアル

OAuthアカウント ZendeskOAuthアカウント
URL https://XXXXXXXX.zendesk.com/api/v2/search.json?query=phone:{TEL}
メソッド GET
リクエストヘッダ

OAuth認証時:Content-Type:application/json

APIトークン認証時:
Content-Type:application/jsonAuthorization: Basic
<Base64エンコードした「メールアドレス/token:APIトークン」の値>

◼︎認証文字列の作成例
Zendeskログインメールアドレス:support@biztel-user.jp
Zendeskで発行したAPIトークン:j9X2kL8mP4qRtWv1zNcB6v

上記の場合、support@biztel-user.jp/
token:j9X2kL8mP4qRtWv1zNcB6v
をBase64エンコードし、
以下の形式でリクエストヘッダに設定します。

Authorization: Basicc3VwcG9ydEBiaXp0ZWwtdXNlci5qcC90b2
tlbjpqOVgya0w4bVA0cVJ0V3Yxek5jQjZ2

リクエストボディ  
タイムアウト判定(秒) 10
変数抽出パターン /"results":\[({"id":(?P<ID>[0-9]+),.*|\]),.*,"count":(?P<COUNT>[0-9].*)}/

 

b.着信時に自動で新規チケットを作成する
上記a.で取得したZendeskの顧客IDとチケットを紐づけ、作成したチケットIDを変数に格納します。

基本情報
イベント種別 着信
実行順 2
API実行条件
判定用コード  
判定評価パターン  
API情報
API連携種別 OAuth認証時:OAuth

APIトークン認証時:マニュアル

OAuthアカウント ZendeskOAuthアカウント
URL https://XXXXXXXX.zendesk.com/api/v2/tickets.json
メソッド POST
リクエストヘッダ OAuth認証時:Content-Type:application/json

APIトークン認証時:
Content-Type:application/jsonAuthorization: Basic
<Base64エンコードした「メールアドレス/token:APIトークン」の値>

※Authorizationヘッダの設定方法は、aのリクエストヘッダをご参照ください。

リクエストボディ { "ticket": {
"subject": "電話での問い合わせ",
"comment": { "body": "着信がありました" },
"requester_id": {RESPONSE_ID},
"priority": "urgent",
"tags":["お客様相談窓口"]
}}
タイムアウト判定(秒) 10
変数抽出パターン /"id":(?P<TICKETID>.*),"external_id":/
メモ  

 

c.着信中のアカウントにチケットをポップアップ表示させる
着信中のBIZTELアカウントのZendeskIDは、変数 { ACCOUNTVALUE_ID } から取得します。
※「BIZTEL管理画面>アカウント>APIカスタム項目」で設定した変数

基本情報
イベント種別 コールセンターエージェント呼び出し
実行順 1
API実行条件
判定用コード  
判定評価パターン  
API情報
API連携種別 OAuth認証時:OAuth

APIトークン認証時:マニュアル

OAuthアカウント ZendeskOAuthアカウント
URL https://XXXXXXXX.zendesk.com/api/v2/channels/voice/agents
/{ACCOUNT_VALUE_ID}
/tickets/{RESPONSE_TICKETID}/display.json
メソッド POST
リクエストヘッダ OAuth認証時:Content-Type:application/json

APIトークン認証時:
Content-Type:application/jsonAuthorization: Basic
<Base64エンコードした「メールアドレス/token:APIトークン」の値>

※Authorizationヘッダの設定方法は、<説明>a の表のリクエストヘッダをご参照ください。

リクエストボディ  
タイムアウト判定(秒) 10
変数抽出パターン  
メモ  

◆注意事項

動作対象のコールセンター>ガイダンスの受付種別が「呼出音」の時はポップアップさせることはできませんので、「保留音」か「おまたせガイダンス+保留音」を設定してください。

◆動作確認

BIZTEL着信時に、Zendesk上で自動的に新規作成されたチケット画面がポップアップ表示されることを確認します。

結果

BIZTELの「APIカスタム項目」を利用することで、BIZTELアカウントとZendeskアカウントを紐づけることが可能です。

この機能と「コールアクション連携」を組み合わせて利用することで、着信中のBIZTELアカウントに対して、Zendesk画面にてチケットを自動作成&ポップアップ表示が出来るようになりました。

ZendeskとBIZTELをご利用の方はぜひお試しください。

編集後記

今回は、着信時にZendeskのチケットを自動で作成しポップアップ表示する、という仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2022/03/29/8997/feed/ 0
BIZTEL API使ってみた Vol.7 天気予報IVR 〜天気予報を基に自動音声で案内をする仕組み(基本編) /blog/2021/12/22/8106/ /blog/2021/12/22/8106/#respond Wed, 22 Dec 2021 01:27:54 +0000 /?p=8106 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。 前回の記事はこちら 今回は気象庁の「天気予報API […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者が様々な機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回は気象庁の「天気予報API」を用いて、特定の番号へ電話をかけた際に天気予報を読み上げてくれる仕組みを作っていきます。

チャレンジ担当者紹介

API_challenger

やってみたいこと・実現したいこと

天気予報を読み上げてくれるダイヤルを作ってみます。
作成したダイヤルにかけると、あらかじめ設定した地域のその日の天気を確認できるイメージです(今回は東京都を例に作成します)。

★役立つシーン:
今回は基本編として、天気の情報を取得して音声で流すところまでの仕組みをご紹介しますが、予報をもとに音声ガイダンスを変えるといった活用が可能です。

例えば、飲食店などでの利用において あらかじめ店舗地域の天気を確認し、自動音声で雨の日は限定のサービスをご案内する、晴れの日はテラス席を案内する、などの対応に役立てることができます。

使用するツールと動作の流れ

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成

BIZTEL以外に必要なもの

・気象庁の天気予報API (※)

※ 気象庁の公開サイトが情報源となっており、今後のサービス継続提供等を保証するものではないことをご理解・ご了承ください。

※ 詳細な条件についてはお問い合わせください。

実現したい動作の流れ

対象の番号にダイヤルをすると、東京都の天気を教えてくれます。

 

設定の実践

BIZTELのAPI連携IVR(最近個人的にAPRと呼んでいます)を用いて設定します。

1.IVRの作成

対象マニュアル:1.IVRの新規作成

天気予報のIVRを作成します。『API連携を利用する』は『選択する』を選んでください。
このとき、ダイヤルイン番号(電話番号)も一緒に割り当ててしまいます。

2.タブ:「API連携設定」にURLを記載

対象マニュアル: 2.API連携IVR

[1] URL:画像内で記載しているURLは、東京地方の天気予報を教えてくれる気象庁のURL(※)です。
https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json

URLの内容を変えると、対象地域の変更や、天気以外の情報(大雨情報・地震情報など)を設定できます。

[2] 受付入力種別:今回は『入力なし』としています。IVRのダイヤル入力を行わないため、対象の番号に架電をするとすぐにガイダンスが流れる仕組みになっています。

今回、上記以外の項目はデフォルトのままとしていますが、必要に応じて設定変更を行ってください。

3. タブ:「APIレスポンス」でレスポンスルールを設定する

[1]変数抽出パターン:読ませたい部分を抽出できるように正規表現で内容を記載します。

[2]音声合成テキスト:抽出した変数と固定で読み上げたい文言を入力します。

4.電話してみる

対象の電話番号にかけてみて、天気予報が聞ければ完成です!

結果

天気を教えてくれるダイヤルの完成です!
今回はそれほど複雑な内容ではないので、設定の時間もかからないかと思います。ぜひ試してみてください。

振り返り・まとめ

■つまずきやすいポイントなど

正規表現がちょっと難しいです。
入手できるJsonは往々にして可変不能(開発済み)であることが多いので、きちんと抽出範囲を合わせてあげて、読む部分をもっと増やしてあげるのが良いかもしれません。

■ひとことコメント

今回は、ひとまず簡単な仕組みを作ってみました。
次回は、この仕組みを使ってどんなことができるのか、試行錯誤する部分も含めて応用編を記事にする予定です!

編集後記

今回は気象庁の天気予報APIを使って、特定の番号に電話をかけると天気を読み上げてくれる、という仕組みを実践しました。

「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後も様々な機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/12/22/8106/feed/ 0
BIZTEL API使ってみた Vol.6 Salesforceの登録情報に応じてコールセンターの受付動作を自動で変える /blog/2021/11/17/7735/ /blog/2021/11/17/7735/#respond Wed, 17 Nov 2021 00:42:23 +0000 /?p=7735 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。 前回の記事はこちら 今回はSalesforce […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回はSalesforceとの連携により、入電時に登録情報を参照してコールセンターでの受付対応を変化させてみます。

チャレンジ担当

やってみたいこと

内容としてはBIZTEL APIブログの2回目でAWS DBと連携して実現したものに近いです。
今回は、弊社ユーザさまでの利用実績が多いSalesforceと連携し、登録情報によってコールセンター動作の挙動を変える、自動化の仕組みにチャレンジしました。

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約

※ ビジネスフォンプランでもご利用いただける場合がございます。詳細な条件についてはお問い合わせください。

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成

BIZTEL以外に必要なもの

・Salesforce

実現したい動作

1. SalesforceのVIP顧客情報の登録有無によって、BIZTELの外線番号(1番号)への着信を以下2つの窓口に割り振り、応対できるようにする。   

①一般用窓口(内線:7801)   
②VIP用窓口(内線:7802)

2. BIZTELとSalesforceとの連携はOAuthを利用する。

3. 一般用窓口(内線:7801)に着信したお客さまには、音声合成利用して以下のガイダンスを流し、キューイング(待ち呼)させる。
ガイダンス:「登録が確認できませんでした。担当者におつなぎします」

4. VIP用窓口(内線:7802)に着信したお客さまには、音声合成を利用して以下のガイダンスを流し、キューイング(待ち呼)させる。
ガイダンス:「Salesforce登録のお客さま名」+「担当者におつなぎしますのでしばらくお待ちください」

設定の実践

全体の工程としては、大きく分けて以下3項目です。

【1】Salesforce設定準備

・アプリケーションの作成
・作成したアプリケーションの鍵情報を確認

【2】BIZTELでのOAuth設定

・OAuthアカウント登録
・アクセストークンの取得

【3】BIZTELでのIVR設定

・IVRの作成
・API連携設定の編集
・一般用と VIP用の窓口2つのAPI処理を設定

 ではここから、上記の項目で行った詳細な手順をご紹介していきます。

1.Salesforce 設定準備

SalesforceのOAuth認証の設定を行うには、こちらの「1.2 SalesforceのOAuth認証の設定を行う」を参照してください。

2.BIZTELでのOAuth設定

BIZTEL 対象マニュアル: 1.OAuthアカウントの設定

①BIZTEL管理画面にシステム管理者でログインしたうえで、「連携オプション」から「OAuthアカウント登録」を選択し、画面右上の方にある「新規」をクリックしてください。

「OAuthアカウント登録」画面が表示されるので、下の図のように設定します。

[1] 左側のメニューバーにある「連携オプション」から「OAuthアカウント管理」をクリック
[2] 「名称」を任意で設定
[3] 「クライアントID」に「Salesforce:コンシューマ鍵」を、「クライアント・シークレット」に「Salesforce:コンシューマの秘密」をそれぞれ入力
[4] 環境に応じた「認可URL」「アクセストークンURL」を設定

環境① 本番環境(環境③に該当しない場合)
認可URL:https://login.salesforce.com/services/oauth2/authorize
アクセストークンURL:https://login.salesforce.com/services/oauth2/token

環境②:Sandbox
認可URL:https://test.salesforce.com/services/oauth2/authorize
アクセストークンURL:https://test.salesforce.com/services/oauth2/token

環境③:My Domain 有効化+login.salesforce.com 禁止時 ※本番・Sandbox共通
認可URL:https://<yourDomain>.my.salesforce.com/services/oauth2/authorize 
アクセストークンURL:https://<yourDomain>.my.salesforce.com/services/oauth2/token

[注]:lightning.force.comドメインは「Salesforce の画面表示用 URL」であり、OAuthの認可/トークン取得には使えません。URL に lightning.force.com が含まれていないことをご確認ください。

[5] 設定が完了したら「保存」をクリック
  ※今回、赤枠で囲っている箇所以外の部分はデフォルトの設定で大丈夫です。

②「OAuthアカウント登録」を完了後、登録内容が表示されます。

その画面の下部にある、「トークン取得」をクリックしてください。
認証設定に問題が無ければ「アクセストークン取得状態」箇所が「取得済み」の表記に変わります。これで設定完了です。

3.BIZTELでのIVR設定

対象マニュアル:1.IVRの新規作成

いよいよここからが大詰めのIVRの挙動設定箇所となります。

BIZTELコールセンターの仕組みを簡単にご説明しますと、IVRや各窓口に内線番号(必要に応じて外線番号)を割り当て、設定を入れるようになっています。

①BIZTEL管理画面で「コールセンター」の「IVR」画面で「新規」をクリックし、赤枠内の項目を設定します (下図参照)。

[1] 「IVR」名・「内線番号」をそれぞれ任意で設定
[2] 「ダイヤルイン番号」は着信用外線番号を設定
[3] 「API連携を利用する」の箇所は「選択する」を設定 ※重要
[4] 設定後、「保存」をクリック

②保存後、以下の図のように先ほど作成したIVRの設定画面が表示されますので、「API連携設定」のタブを選択してください。

③「API連携設定」で編集をクリックし、下の図のように赤枠内をそれぞれ設定してください。

[1] 「API連携種別」は「OAuth」を選択
[2] 「OAuthアカウント」は先ほどの【BIZTELでのOAuth設定】で登録したアカウントを選択
[3] 「URL」にはSalesforceが提供しているAPIを設定 ※注
[4] 「メソッド」には利用するHTTPメソッドを選択 ※今回はHTTP GET
[5] 「受付入力種別」は「入力なし」を選択
[6] 設定が完了したら「保存」をクリック
  ※「リクエストヘッダ」〜「リクエストエラー時の動作」部分は任意で設定(今回はデフォルト設定)

※注:今回利用したSalesforceのAPIは以下のような内容で、HTTP GET用のものです。Salesforce内を電話番号で検索をし、「取引先責任者」の「ID・名前・電話番号」を戻り値として返す設定を入れました。

{OAUTH_INSTANCE_URL}/services/data/v50.0/search/?q=FIND {{TEL}} IN PHONE FIELDS RETURNING Contact(Id, Name, Phone)

URLの“v50.0”の箇所は利用しているSalesforce APIバージョンに合わせてください。
また、今回利用した「取引先責任者:Contact」以外にも、例えば「取引先:Account」などを指定することも可能ですので、適宜変更してみてください。

④「APIレスポンス設定」のタブを選択し、「新規」をクリックしてAPIで取得した内容ごとの処理を設定します。
※以下、Salesforceに登録が無い場合とある場合の2パターンの設定例をご紹介します。

パターン1:Salesforceに登録が無い場合

優先順位 「APIレスポンス設定」が複数ある場合、適用させる優先順位を設定します。
下図の例では「1」(最優先)を指定。
レスポンスコード HTTPのレスポンスコードにより挙動を変えたい場合に設定します。
下図の例では、HTTP 200 OKが返ってくることを条件として設定。
レスポンスパターン 振り分け分岐の条件を「レスポンスボディ内の文字列と指定正規表現とのマッチ」とする場合の正規表現を指定します。
下図の例ではボディに含まれる「SearchRecordsが空=登録が無い」の場合を表しています。
変数抽出パターン APIレスポンス値を変数化して保持する場合にチェック対象とする 正規表現を指定します。
下図の例では使っていません。次に記載する 「パターン2」で説明します。
ガイダンス形式 流すガイダンスの形式を選べます。「標準ガイダンス」の場合、登録したWAVファイルを流すだけですが、「リアルタイム音声合成」の場合、 「音声合成テキスト」に設定した文言(プレーンテキスト、およびAPI レスポンスから抽出した値)を流します。
音声合成テキスト 音声合成エンジンに渡すテキストおよびAPIから抽出した変数を設定します。下図の例ではAPIレスポンス値の設定はしていません。次の「2パターン目」では変数を利用した例を記載しています。
選択時の動作 ここまでに設定した内容に合致している場合の動作を決めます。「転送」「着信ルール」「操作ガイダンス」の3つから選択が可能です。 下図の例では転送を選択しています。
転送先 「選択時の動作」で「転送」を選択した場合に設定できます。
下図の例では、一般用の窓口(7801:SFDC検証用1)に転送指定。
ここまでで問題がなければ「保存」をクリックします。

参考画像

パターン2:Salesforceに登録がある場合

優先順位 「APIレスポンス設定」が複数ある場合、適用させる優先順位を設定します。
下図の例では「2」を指定。
レスポンスコード HTTPのレスポンスコードにより挙動を変えたい場合に設定します。
下図の例では、HTTP 200 OKが返ってくることを条件として設定。
レスポンスパターン 振り分け分岐の条件を「レスポンスボディ内の文字列と指定正規表現とのマッチ」とする場合の正規表現を指定します。
パターン1の例では、「優先順位1」に設定して最初に「登録が無い場合」をフィルタリングしました。下図のパターン2の例では、何らかの登録がある状態ということになりますので、レスポンスパターンは設定していません。
変数抽出パターン APIレスポンス値を変数化して保持する場合にチェック対象とする正規表現を指定します(PHPのPCRE正規表現形式)。
下図の例では「 /"Name":"(.*)",/ 」という設定で、HTTP レスポンスのボディ内のName(名前)を抽出する正規表現を指定しています。
抽出した内容は変数CODE1から順番に連番で自動格納されます。
ガイダンス形式 流すガイダンスの形式を選べます。「標準ガイダンス」の場合、登録したWAVファイルを流すだけですが、「リアルタイム音声合成」の場合、 「音声合成テキスト」に設定した文言(プレーンテキスト、およびAPI レスポンスから抽出した値)を音声合成して流します。
音声合成テキスト 音声合成エンジンに渡すテキストおよびAPIから抽出した変数を設定します。
下図の例では、APIレスポンス値から取得したSalesforce の「Name」の値が格納されている変数{CODE1}を指定しています。
【お客さまのお名前を音声合成する際の注意点】
 漢字登録の場合、音声合成が正しく行われない可能性があるので、Salesforceにひらがなで登録する項目を作成したほうが良いでしょう。
選択時の動作 ここまでに設定をした内容に合致している場合の動作を決めます。
「転送」 「着信ルール」「操作ガイダンス」の3つから選択が可能です。 ※下図の例では転送を選択しています。
転送先 「選択時の動作」で「転送」を選択した場合に設定できます。
下図の例では、VIP用の窓口(7802:SFDC検証用2)に転送指定。
ここまでで問題がなければ「保存」をクリックします。

参考画像

結果

ここまでの設定により、

①BIZTELへの着信時にSalesforce上で発信元番号の検索を行い、
②Salesforce上に登録が無ければ一般用窓口(内線:7801)に着信させ、
③登録があればSalesforceから取得したお客さまのお名前を音声合成で流し、VIP用窓口(内線:7802)に着信させる

という動作を実現することができました!

振り返り・まとめ

今回のような振る舞いの他にも、Salesforceオブジェクト内の値で優先判断を行う、 FAQテキストを渡して音声合成で流すなど、さまざまなアイデアに応用できると思います。 クラウドPBXのBIZTELと外部システムとの連携によるコールセンター業務の自動化・効率化の一案として、本ブログがBIZTELをご利用中のユーザさま、コールセンターシステムの刷新をご検討中の企業さまにとって、少しでも参考になりましたら幸いです。

今回、担当者より「ブログの記事を頼むよ」と依頼された際は困惑しましたが、PHPの正規表現ってどうだっけ?SalesforceのAPI何があったっけ?と復習をしながら、なんとか無事完了することができました。

ひと昔前までは、上記の自動化を実現するとなると個別開発が必要となり、数か月(場合によると1年)単位のプロジェクトで多額の費用が掛かり、多くのプログラマが関与していたと思います。
それが今だと各社提供のAPIを組み合わせるだけで、システム連携が比較的簡単に構築できるようになり、あらためて「クラウドの力ってすごいな~」と実感しました。

最後までお読みいただき、ありがとうございました。

編集後記

今回はSalesforceとBIZTELを連携することで、自社の顧客データベースを参照し、登録の有無に応じて対応を変化させる仕組みを実践しました。

この「BIZTEL API使ってみた」シリーズでは、BIZTELの利用者が実際に思いついた業務改善のアイデアをもとに、今後もさまざまな機能を紹介する予定です。

簡単に実現できるよう、設定方法も交えながらお伝えしますので、読者のみなさまもぜひチャレンジしてみてください。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

 

]]>
/blog/2021/11/17/7735/feed/ 0
BIZTEL API使ってみた Vol.5 Google Sheets APIと連携して対応履歴を自動作成したい /blog/2021/09/29/7459/ /blog/2021/09/29/7459/#respond Wed, 29 Sep 2021 03:45:54 +0000 /?p=7459 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。 前回の記事はこちら: 今回はGoogle Sh […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。

前回の記事はこちら:


- biztel.jp

今回はGoogle Sheets APIと連携し、対応履歴の自動作成の仕組みを行っていきます。

チャレンジ担当者紹介

背景

開発部門では、営業時間外に社内から問い合わせがあった場合、対応履歴を管理台帳にまとめています。問い合わせを受けた人が、BIZTELの通話履歴画面の情報を基に手動で台帳記入を行っています。
時刻・通話時間・発信者・応答者だけではなく、録音ファイルを聞いて通話概要も記入しているため、対応履歴の作成業務に工数がかかってしまっていることが課題です。

今回やってみたいこと、実現したいこと

今回は、BIZTELとGoogleスプレッドシートを使って対応履歴の作成業務の効率化を実施してみたいと思います。
具体的には、通話終了後にGoogle Workspaceと連携してGoogleスプレッドシートに以下を自動記録する仕組みを作っていきます。

  • 『いつ・誰が・どのくらいの時間』電話対応を行ったのか
  • 音声認識の結果(通話内容のテキスト)

使用するツール

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約 ※

BIZTELで必要なオプション

・API連携コールアクション
・音声認識連携

BIZTEL以外に必要なもの

・AmiVoice Cloud Platform
・Google Sheets API
・Google スプレッドシート

※ ビジネスフォンプランの場合はオプションで通話録音のご契約が必要です。
詳細な条件についてはお問い合わせください。

実現したい動作

BIZTELに電話がかかってきたら、いつもと同じように通話を開始します。
通話が終了すると、Google Sheets APIを使って指定したGoogleスプレッドシートに
「いつ・誰が」など通話に関する情報や、テキスト化された通話内容が自動で記録されます。

設定の実践

Google Sheets APIの事前準備

①OAuthクライアントの作成

Google Cloud Platform にアクセスし、OAuthクライアントを作成します。

 

 

②Google Sheets APIの有効化

Google Sheets APIを有効にします。

③Google スプレッドシートの準備

対応履歴用のスプレッドシートを準備します。
反映させたい項目名をセルに入力します。

 

BIZTEL管理画面の設定

①OAuthアカウントの登録

対象マニュアル: 1.OAuthアカウントの設定

Google側で発行したOAuthクライアントIDとOAuthクライアントシークレットを、以下のとおり登録します。

BIZTEL管理画面 > メニュー「連携オプション」 >「OAuthアカウント登録」 > 右上「新規」
『クライアントID』へ『OAuthクライアントID』を入力
『クライアント・シークレット』へ『OAuthクライアントシークレット』を入力

 

 

②コールアクション連携の設定

対象マニュアル:1.コールアクション

BIZTEL管理画面 >メニュー「連携オプション」 >「コールアクション連携」
右上「新規」>「コールアクション名」を記入 >「保存」
タブ「API連携」 > 新規

音声認識サービス連携完了後に
指定したスプレッドシートに対して、通話履歴情報が記録されます。

結果

設定後にテストコールを実施し、以下の情報をGoogleスプレッドシートに
自動記録させることに成功しました!

  • 通話開始時間
  • 発信電話番号
  • 着信電話番号
  • 応答した内線番号
  • 応答したアカウント名
  • 通話時間
  • 音声認識結果
  • 録音ファイルURL

 

音声認識結果も連携でき、録音ファイルを都度確認することなく、
通話内容のテキストが自動的に反映されるため、入力の手間を省くことができます。

もし音声認識結果でわからないところがあれば、録音ファイルURLで確認することも可能です。
対応の状況がこのファイル1つで把握可能となったチャレンジでした。

振り返り・まとめ

今まで人の手で管理していたことが、APIと連携することで自動入力での管理が実現でき、ミスなく作業効率を向上させることに成功しました。
これにより他の業務へ従事する時間を増やすことができ、業務改善にもつながります。

同じような業務で困っている方は是非、ご活用ください。

編集後記

今回の「BIZTEL API使ってみた」は、Google Sheets APIと連携し、対応履歴を自動的に作成する仕組みを実践しました。

BIZTELでは、API連携によってさまざまな利用シーンに対応することができます。

「BIZTEL API使ってみた」ではこのように実際にBIZTELの利用者が思いついた業務改善のアイデアを、読者のみなさまが簡単に設定・実現できるよう、これからもさまざまな機能を紹介していく予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/09/29/7459/feed/ 0
BIZTEL API使ってみたVol.4 【後編】コールバック受付IVR機能で混雑時の対応を自動化 /blog/2021/07/30/7222/ /blog/2021/07/30/7222/#respond Fri, 30 Jul 2021 06:01:01 +0000 /?p=7222 この記事は「BIZTEL API使ってみたVol.4 コールバック受付IVR機能で混雑時の対応を自動化」の続きとなる記事です。まだお読みでない方は前編からご覧いただければと思います。 前編はこちらから BIZTEL設定 […]]]>

この記事は「BIZTEL API使ってみたVol.4 コールバック受付IVR機能で混雑時の対応を自動化」の続きとなる記事です。まだお読みでない方は前編からご覧いただければと思います。

前編はこちらから

BIZTEL設定

では、ここからは実際にIVRの設定を行い、コールバック受付が可能な状態にします。
IVRの中で使用する各種ガイダンス(アナウンス)および着信ルールは個別設定を使用するものとします。

注意事項として、内線番号は数字の大きい方から設定していく必要があります。
(ここでは7493から作り始め、7480が最後になるように設定してください)

以下、内線番号が多いため各番号まで飛べるリンクを設置しています。ご活用ください。

IVR 内線番号:7480

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:オープニングアナウンス
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://{TEL}
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位 1
1.レスポンスコード  
1.レスポンスパターン /anonymous/
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作 転送
1.転送先 7486
1.メモ  
2.優先順位 2
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作 転送
2.転送先 7481
2.メモ  

IVR 内線番号:7481

内線番号一覧へ

  • IVR種別:標準IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:連絡先確認アナウンス
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:IVRエラー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了

ダイヤル設定1:転送先7482
ダイヤル設定3:転送先7486
ダイヤル設定9:操作ガイダンスに戻る

IVR 内線番号:7482

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://{TEL}
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位 1
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式 リアルタイム音声合成
1.音声合成テキスト ご連絡先の電話番号は<vtml_pause time="300"/><vtml_speed value="80"><vtml_pitch value="80">^^{TEL}<vtml_pause time="300"/>^^{TEL}</vtml_pitch></vtml_speed><vtml_pause time="300"/>で、よろしいでしょうか。
1.選択時の動作 転送
1.転送先 7483
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7483

内線番号一覧へ

  • IVR種別:標準IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:連絡先電話番号確認アナウンス
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:IVRエラー
  • 操作エラー回数:3
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了

ダイヤル設定1:転送先7484
ダイヤル設定3:転送先7486
ダイヤル設定9:転送先7482

IVR 内線番号:7484

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了

IVR 内線番号:7485

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL https://fk8dyjlwt5sx.cybozu.com/k/v1/record.json
メソッド POST
リクエストヘッダ X-Cybozu-API-Token:*********************
(※発行したAPIトークンを入力)
Content-Type:application/json
リクエストボディ {
  "app":"11",
  "record":{
    "ani":{
      "value":"{TEL}"
    },
    "dnis":{
      "value":"{CALLED}"
    },
    "clicktocall":{
      "value":"{TEL}"
    },
    "cb_type":{
      "value":"即時"
    },
    "requestid":{
      "value":"{ID}"
    },
    "cb_status":{
      "value":"未対応"
    },
    "reservation_route":{
      "value":"IVR"
    },
    "record_no":{
      "value":"{RESPONSE_KCID}"
    }
タイムアウト判定(秒) 10
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位  
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作  
1.転送先  
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7486

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 10
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 ダイヤル入力 12桁
1.優先順位 1
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作 転送
1.転送先 7487
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7487

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 10
API連携前ガイダンス 選択なし
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位 1
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式 リアルタイム音声合成
1.API連携後ガイダンス ご連絡先の電話番号は<vtml_pause time="300"/><vtml_speed value="80"><vtml_pitch value="80">^^{7486_DIGITS}<vtml_pause time="300"/>^^{7486_DIGITS}</vtml_pitch></vtml_speed><vtml_pause time="300"/>で、よろしいでしょうか
1.選択時の動作 転送
1.転送先 7488
1.メモ  

IVR 内線番号:7488

内線番号一覧へ

  • IVR種別:標準IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:連絡先電話番号確認アナウンス
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:IVRエラー
  • 操作エラー回数:3
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了

ダイヤル設定1:転送先7489
ダイヤル設定3:転送先7486
ダイヤル設定9:転送先7487

IVR 内線番号:7489

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位  
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作  
1.転送先  
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7490

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL https://fk8dyjlwt5sx.cybozu.com/k/v1/records.json
メソッド GET
リクエストヘッダ X-Cybozu-API-Token:*********************
(※発行したAPIトークンを入力)

Content-Type:application/json
リクエストボディ {
"app": 2,
"query": "TEL = {TEL} or TEL2 = {TEL} or TEL3 = {TEL} or TEL={7486_DIGITS} or TEL2={7486_DIGITS} or TEL3={7486_DIGITS}",
  "fields": [
              "Customer_Name",
              "record_no",
              "Person_Name"
  ],
  "totalCount": "true"
}
タイムアウト判定(秒) 10
API連携前ガイダンス 選択なし
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位 1
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン /"Customer_Name":.*"value":"(?P<CUSTNAME>.*)"}.*"record_no":.*"value":"(?P<KCID>[0-9]+)"}.*"Person_Name":.*"value":"(?P<PERSNAME>.*)"}}.*"totalCount":"(?P<KCCOUNT>[0-9]+)"/
1.ガイダンス形式 標準
1.API連携後ガイダンス 選択なし
1.選択時の動作 転送
1.転送先 7491
1.メモ  

IVR 内線番号:7491

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL https://fk8dyjlwt5sx.cybozu.com/k/v1/records.json
メソッド GET
リクエストヘッダ X-Cybozu-API-Token:*********************
(※発行したAPIトークンを入力)

Content-Type:application/json
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス 選択なし
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位  
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作  
1.転送先  
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7492

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://{TEL}
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位  
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作  
1.転送先  
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

IVR 内線番号:7493

内線番号一覧へ

  • IVR種別:API連携IVR
  • 初期ガイダンス:選択なし
  • 操作ガイダンス:無音ダミー
  • 操作ガイダンス再生回数:1
  • 操作エラーガイダンス:無音ダミー
  • 操作エラー回数:1
  • エラー回数到達時の動作:何もしない
  • 終了ガイダンス:IVRエラー終了
API連携種別 マニュアル
URL response://{TEL}
メソッド GET
リクエストヘッダ  
リクエストボディ  
タイムアウト判定(秒) 5
API連携前ガイダンス  
リクエストエラー時の動作 IVRシステムエラー時ガイダンス
受付入力種別 入力なし
1.優先順位  
1.レスポンスコード  
1.レスポンスパターン  
1.変数抽出パターン  
1.ガイダンス形式  
1.API連携後ガイダンス  
1.選択時の動作  
1.転送先  
1.メモ  
2.優先順位  
2.レスポンスコード  
2.レスポンスパターン  
2.変数抽出パターン  
2.ガイダンス形式  
2.API連携後ガイダンス  
2.選択時の動作  
2.転送先  
2.メモ  

結果

設定が完了したら、動作の確認をします。
フロー図どおりに操作が行われ、ガイダンスが流れたら問題なく動作していることになります。
※kintone側にも情報が反映されていることも併せてご確認ください。

振り返り・まとめ

今回はBIZTEL コールバック受付IVR機能を使って、オペレーターが30秒応答できなかった場合に自動的にIVRに転送し、受け付けたお客さまの情報をkintoneに保存する、というオペレーションを設定しました。

編集後記

今回の「BIZTEL API使ってみた」は、BIZTELのコールバックIVR機能を使い、混雑時のコールバック対応の一部を自動化する仕組みを実践しました。

BIZTELでは、API連携によってさまざまな利用シーンに対応することができます。

「BIZTEL API使ってみた」ではこのように実際にBIZTELの利用者が思いついた業務改善のアイデアを、読者のみなさまが簡単に設定・実現できるよう、これからもさまざまな機能を紹介していく予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/07/30/7222/feed/ 0
BIZTEL API使ってみたVol.4 【前編】コールバック受付IVR機能で混雑時の対応を自動化 /blog/2021/07/30/7172/ /blog/2021/07/30/7172/#respond Fri, 30 Jul 2021 06:00:45 +0000 /?p=7172 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。 前回の記事はこちら 今回はコールセンターの混雑 […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回はコールセンターの混雑時に、お客さまの連絡先をお伺いして後で折り返し対応を行う際の簡略化を行っていきます。

チャレンジ担当者紹介

challenger

今回やってみたいこと、実現したいこと

テレビショッピングの注文受付などのように、一瞬で大量呼が発生し、放映時間が終了したら落ち着いてしまうような呼量の増減が激しい業務の場合、待ち呼と放棄呼の大量発生が大きな課題となります。

そこで今回はBIZTELの「コールバック受付IVR機能」を使って、コールセンターが混雑していてすぐに対応できない場合に、お客さまの連絡先を伺い、混雑が落ち着いた後に折り返しお電話するというオペレーションの簡略化を行っていきたいと思います。

使用するツール ※

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成

BIZTEL以外に必要なもの

・kintone

※ 今回はkintoneで設定していますが、弊社で確認している範囲ではソフトブレーン株式会社提供の「eセールスマネージャー」、ノイアンドコンピューティング株式会社提供の「FlexCRM」でもIVRで受け付けたお客さまの情報が保存可能です。
詳細な条件についてはお問い合わせください。

想定する動作の流れ

流れとしては、

1.オペレーターが応答できない状況が30秒継続する
2.BIZTEL コールバックIVRへ自動で転送し、電話番号を取得
3.取得した電話番号をkintoneに保存する
を想定しています。

今回は例として、「30秒オペレーターが応答できなかった」場合をトリガーとして設定していきます。
以下に想定の動作フローを掲載しています。文字が小さいので、お手数ですが画像をクリックの上、拡大してご覧ください。

設定の実践

※今回、kintoneの設定はIVRを設定するために必要な最低限の情報のみ記載しております。
kintoneについての詳細は、サイボウズ株式会社さまに直接お問い合わせください。

kintoneアプリ作成
お客さまの情報を登録するkintoneアプリを作成します。
アプリやアプリ管理から「アプリを作成する」をクリックします。

必要なカラムは以下のとおりです。

No カラム形式 フィールド名 フィールドコード 備考
1 文字列(1行) 発信者通知電話番号 ani  
2 文字列(1行) 着信ダイヤルイン番号 dnis  
3 文字列(1行) 発信電話番号 cb_number  
4 リンク クリックトゥコール clicktocall  
5 文字列(1行) 発信指定 cb_type  
6 日付 指定発信日 cb_day  
7 時刻 指定発信時刻 cb_time  
8 文字列(1行) リクエストID requestid  
9 文字列(1行) コールバックステータス cb_status  
10 文字列(1行) 受付媒体 reservation_route  
11 文字列(1行) IVR指定日 tmp_ivr_day  
12 文字列(1行) IVR指定時刻 tmp_ivr_time  
13 レコード番号 レコード番号 CBID kintone標準項目
14 作成者 作成者 作成者 kintone標準項目
15 作成日時 作成日時 作成日時 kintone標準項目
16 更新者 更新者 更新者 kintone標準項目
17 更新日時 更新日時 更新日時 kintone標準項目
18 文字列(1行) ステータス   kintone標準項目
19 文字列(1行) 作業者   kintone標準項目
20 文字列(1行) カテゴリー   kintone標準項目
21 数値 顧客ID record_no 連携用

見た目上では使わないカラムがあっても、きちんと作っておかなければいけない点に気をつけてください。使わないカラムは画面に出さなくても問題ないのですが、データの格納先は用意しておく必要があります。

必要なカラムを画面上に配置します。配置が完了したら「フォームを保存」をクリックして保存します。この状態ではまだ反映がされていないので「アプリを更新」をクリックして、このアプリの本番環境を最新状態に反映します。
アプリの名前を暫定で「コールバックオペレーション」として保存しておきます。

APIトークンの発行

「コールバックオペレーション」の「アプリの設定」にある「APIトークン」をクリックします。

「生成する」ボタンをクリックして新しいトークンを発行します。
新しく発行したトークンを使用してBIZTELからお客さまの情報を書き込みますので、トークンをコピーする等で保存しておいてください。
新しく発行したトークンのアクセス権はレコード閲覧のみしか与えられていませんので、「レコード追加」「レコード編集」「レコード削除」にチェックを入れ、アクセス権を追加します。
アクセス権の追加が完了したら「保存」ボタンをクリックして、設定を保存します。この状態ではまだ反映がされていないので「アプリを更新」をクリックして、このアプリの本番環境を最新状態に反映します。

アプリIDとサブドメイン

作成した「コールバックオペレーション」アプリのkintone アプリIDとサブドメインを確認します。アプリIDとサブドメインは、APIアクセスで使用します。
確認方法はいくつかありますが、一番簡単な方法をご紹介します。ブラウザのURL欄に2つとも表示されています。

この場合は次の通りとなります。

サブドメイン:fk8dyjlwt5sx
アプリID: 11

BIZTEL設定

BIZTELの設定は後編で行なっていきます!

後編はこちらから

]]>
/blog/2021/07/30/7172/feed/ 0
【リリースノート】BIZTEL バージョン3.4.0〜ソフトフォン ブラウザタイプが登場〜 /blog/2021/07/15/7120/ /blog/2021/07/15/7120/#respond Thu, 15 Jul 2021 04:00:04 +0000 /?p=7120 BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。 本記事では、2021年7月に提供開始した最新バージョン3.4.0で追加された機能をご紹介します。 ソ […]]]>

BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。

本記事では、2021年7月に提供開始した最新バージョン3.4.0で追加された機能をご紹介します。

ソフトフォン ブラウザタイプ(WebRTC)

従来BIZTELでは、PC(WindowsまたはMacOSのもの)にインストールして利用するアプリタイプのソフトフォンを提供していました。本バージョンでは、新たにWebRTC(※)の技術を活用したブラウザタイプのソフトフォンが利用できます。

PCごとにインストールやセットアップ作業を行う必要がないため、在宅勤務などにおいてもすぐに運用が始められるとともに、システム管理者の負担を軽減することが可能です。

※ WebRTC( Web Real-Time Communication ):ブラウザやモバイルアプリなどで利用できるリアルタイム通信の機能(音声通話・ビデオチャット・ファイル共有など)を、オープンソースで提供するプロジェクト。アップル・Google・マイクロソフトなどが参画している。

エージェントコントロールの機能拡張

エージェントコントロールは、社内でのテキストチャットに加え、オペレーター同士の業務ステータス(通話中・休憩中・後処理中など)の表示ができるコミュニケーションツールです。

これまで以上に活発な情報共有が行えるよう、今回のバージョンアップではチャットを中心に機能を拡張しました。

ブラウザ通知

メッセージが届いた際に、ブラウザからプッシュ通知をする機能です。通知時に効果音を鳴らすこともできます。

アイコン表示

利用者ごとにアイコン画像を設定することができ、だれが発言したか認識しやすくなります。

絵文字入力

チャットのメッセージ作成時に絵文字が利用できます。言葉で伝えることが難しい空気感や感情を表現することができます。

送信済みメッセージの編集と削除

自身が送信したメッセージの編集・削除ができます。

固定メッセージ表示

任意のメッセージをチャットルームの上部に固定して表示できます。重要な連絡や朝礼での伝達事項など、確実に周知したい内容が他のメッセージに埋もれて見えなくなることを防ぎます。

メッセージ確認マーク

他のメンバーからのメッセージに、内容を確認したことを示すマークをつけることができます。「確認しました」などの返信の手間を省くことが可能です。

ステレオ録音API

顧客とオペレーターの発話を分けてそれぞれ録音ファイルを作成するとともに、ユーザのシステムにダウンロードさせることができる機能です。

ダウンロードしたステレオ録音ファイルは、音声認識サービスやAIソリューションを用いてテキスト化・要約化・データマイニングといった作業をする際に活用できます。

また、通話録音ファイルの作成完了時に連携したシステムに通知することができ、そのタイミングで録音をダウンロードしたり、テキスト化などの作業をしたりすることが可能です。

後作業の業務の把握

通話後の作業時間について、登録したコールセンターごとに数値を出し、レポートを作成することができます(通話後のステータスを自動で「後処理」にする設定をしている場合に利用できます)。

年間休日の設定機能

元日など、毎年日付が変わらない休日の登録ができます。

設定変更履歴

管理画面で行った設定変更について、日時・実施者・操作内容などが確認できます。

操作履歴

管理画面と通話録音ファイルの閲覧・操作の履歴が確認できます。不必要なアクセスや録音ファイルのダウンロードがないかチェックすることができるため、情報漏洩の防止にも役立ちます。

通話ビジュアル表示

録音した通話を波形で表示する機能です。会話をしている箇所と無音の箇所を視覚的に捉えることができるため、効率的に音声を聴くことが可能です。また、波形を見ながら抜き出したい音声を指定し、該当部分だけをダウンロードすることもできます。

ソフトフォン上に保留時間の表示

保留にしてから経過した時間をソフトフォンに表示します。

外部API連携エラー通知

ユーザのシステム側のAPIで連携している際にエラーが発生した場合、指定したメールアドレスあてに通知を送ります。

コールセンター呼出優先度

オペレーターが複数のコールセンターに所属している場合に、どのセンターの着信を優先して受け付けるか設定する機能です。

 

]]>
/blog/2021/07/15/7120/feed/ 0
BIZTEL API使ってみた Vol.3 TableCheckの空席状況に応じたガイダンスを設定したい /blog/2021/05/24/6840/ /blog/2021/05/24/6840/#respond Mon, 24 May 2021 00:30:56 +0000 /?p=6840 「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。 前回の記事はこちら 今回は飲食業界で広く使われ […]]]>

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回は飲食業界で広く使われているTableCheck(旧TableSolution)とBIZTELの連携による、空席状況に応じたガイダンス機能の設定についてご紹介します。

チャレンジ担当者紹介

API_challenger

今回やってみたいこと、実現したいこと

今回は、飲食業界で広く使われているTableCheckと連携して、満席時と空席時でそれぞれガイダンスの内容を変更する方法をご案内します。

使用するツール ※

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成

BIZTEL以外に必要なもの

・TableCheck

※ 詳細な条件についてはお問い合わせください。

想定する動作の流れ

TableCheck上の空席時と満席時で、ガイダンスが変わっていることを確認します。

API3_Workflow

設定の実践

※今回の設定には、TableCheck側で別途ご契約が必要です。

まず設定に入る前に、BIZTELとTableCheckを連携するにあたって、以下2つの内容について気をつける必要があります。

  • 店舗番号を登録しておく
  • 電話番号は、+81の形式に変更する必要がある

では、BIZTELのIVRへの設定をご説明します。

ダイヤルIVR設定

①「IVR」のメニューから、各IVRのハコをまず作成します。

内線番号:7830 → ダイヤルIVR
内線番号:7831 → API連携IVR

API3_IVR1API3_IVR2

②「共通ガイダンス」から、各ガイダンスを作成します。

以下は一例です。

初期ガイダンス
 お電話ありがとうございます。

操作ガイダンス
 本日の予約をご希望の方は1を押してください。それ以外の方は2を押してください。

API3_IVR3

③ダイヤルIVR(7830)に戻って、各設定を行います。

まずは、ガイダンスを設定します。

API_IVR4

次に、ダイヤル設定で1を押したときにAPI連携IVRに行くように設定します。

※
今回は省きますが、2を押したときは翌日の予約確認や、SMSの案内、もしくは店舗に直接かかるなどの設定が可能です。
IVR機能はやりたいこと次第で幅広く応用が利きますので、用途に応じて設定いただければと思います。

API_IVR5

API連携用IVR設定

ここでは当日分の予約が可能かを取得するAPIの設定を行います。

①ガイダンス

前の段で必要なガイダンスの設定は終わっているので、とくに設定せずに次に行きます。

②API連携設定

以下のパラメータで設定します。

API連携種別 マニュアル
URL ※1※2

https://cti.tablesolution.com/xxxxxxx/availability?cti_number=+81{CALLED.START(1)}&date={DATE.DATE_FORMAT(Ymd)}&is_online=false

メソッド GET
リクエストヘッダ Content-Type:application/x-www-form-urlencoded
リクエストボディ なし
受付入力 ※3 入力なし

※1 cti_numberは店舗番号、dateは本日日付YYYYMMDD形式で設定されます。
※2 URLのxxxx箇所はご契約によって違いますのでご確認ください。
※3 入力なしにすると、ガイダンスを流さずにAPI連携を開始します。
 このフローでガイダンスを作成していない理由は、ここで無視する設定を入れるためです。

API_IVR6

③APIレスポンス設定

APIで問い合わせた結果のレスポンス設定を行います。
想定としては、まず予約可能・予約失敗・APIエラーに対応できるように3つのレスポンスを設定します。

優先順位1:予約可能だった場合

レスポンスコード 200(成功を意味する)
レスポンスパターン /true/
変数抽出パターン なし
ガイダンス形式 リアルタイム音声合成(標準ガイダンスでも可能)
API連携後ガイダンス 任意
転送先

特定のコールセンターなど ※

※今回は予約用のコールセンターに着信するケースを想定します。

API_IVR7
処理時のガイダンスは都度形成する音声合成と、あらかじめ登録しておいた標準ガイダンスから選択可能ですが、今回はせっかくオプションがあるので音声合成を選んでいます。

優先順位2:予約不可能な場合

レスポンスコード 200(成功を意味する)
レスポンスパターン /false/
変数抽出パターン なし
ガイダンス形式 リアルタイム音声合成(標準ガイダンスでも可能)
API連携後ガイダンス 任意
転送先

特定のコールセンターやガイダンス、ビジーなど ※

※今回はビジーにします。

API_IVR8
今回は特に設定していませんが、「満席でした」で切断すると若干不親切になってしまいますので、店舗に転送する、別日程予約のためのSMSのフローに回すなども併せて設定いただければと思います。

優先順位10:エラーカバー

運用をしていると、予期せぬエラーが発生することがありますので、その対応も設定しておきましょう。

レスポンスコード 設定しない
レスポンスパターン 設定しない
変数抽出パターン なし
ガイダンス形式 リアルタイム音声合成(標準ガイダンスでも可能)
API連携後ガイダンス 任意
転送先 特定のコールセンターやガイダンス、ビジーなど ※

※今回はビジーにします。

API_IVR9
例えば、エラーコード(400や500番台)が返ってきたときのために、成功例以外のすべてのケースをエラーとして処理できるように、暗黙のルールを先に設定しておくのがこの部分になります。
なにかしらのエラーが発生したため、予約できない旨のガイダンスを流して電話を切っています。これも実際の運用ではもう少し親切に、どこかに転送するなどの設定をしていただければと思います。

結果

該当店舗の電話番号を、IVR1段目の7830に設定し、その後、TableCheckから席を満席にしたり、空席にしたりして電話をかけてみます。

ガイダンスがきちんと切り替えられているかを確認してみましょう。
切り替えができていれば設定完了です。

振り返り・まとめ

・BIZTELの設定だけではなく、TableCheck側でも店舗番号や座席の設定がありますので、そちらも忘れずにご登録をお願いします。
・最初に内線番号のハコを作らないと、後で転送の設定をする際に設定先が用意されていないため、やり直しになる箇所があります。IVRを設定する前に、手書きでもいいのでフロー図などを書いておくとわかりやすいです。

一番忙しい満席の際に、電話応対の業務を別の場所や時間帯にスライドできることがメリットです。是非ご活用ください。

編集後記

今回の「BIZTEL API使ってみた」では、TableCheckの空席状況を参照して、BIZTELのIVR機能を活用して状況別にガイダンスを設定する、という仕組みを実践しました。

BIZTELでは、API連携によってさまざまな利用シーンに対応することができます。

「BIZTEL API使ってみた」ではこのように実際にBIZTELの利用者が思いついた業務改善のアイデアを、読者のみなさまが簡単に設定・実現できるよう、これからもさまざまな機能を紹介していく予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/05/24/6840/feed/ 0
BIZTEL API使ってみた Vol.2 AWSのデータを活用してIVRで自動処理させたい /blog/2021/04/23/6696/ /blog/2021/04/23/6696/#respond Fri, 23 Apr 2021 02:15:21 +0000 /?p=6696 API2_eyecatch「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。 前回の記事はこちら 今回はサービスの開発担当が […]]]> API2_eyecatch

「BIZTEL API使ってみた」シリーズでは、BIZTELがもっと便利に使えるようになるAPI連携機能を活用して、サービス担当者がさまざまな機能の実装にチャレンジします。

前回の記事はこちら


- biztel.jp

今回はサービスの開発担当が、API連携機能を活用したAWSのデータ利用について実践します!

チャレンジ担当者紹介

API2_challenger

 

やってみたいこと

今回は、発信者の電話番号から既に取引のあるお客さまを識別し、取引がある場合はVIPルーティングのようにお客さまのお名前を読み上げてから転送を行う設定をしてみたいと思います。
具体的にはAWSのRDBにある顧客情報からお客さまの氏名情報を取得し、BIZTELのIVR機能を用いて読み上げる処理をイメージしています。

今回はこの仕組みを、AWSのLambda関数を利用してサーバレスで構築していきます。

使用するツール ※

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・API連携IVR
・リアルタイム音声合成

BIZTEL以外に必要なもの

・Amazon RDS
・Amazon Lambda

※ 詳細な条件についてはお問い合わせください。

想定する動作の流れ

  1. 電話がかかってくる。
  2. Lambda関数を経由して電話番号からお客さまの氏名情報を取得する。
  3. 氏名情報が取得できた場合は、氏名を読み上げて専用のコールセンターへ着信する。

設定の実践

①AWSのAPIGatewayURLの取得

まず、BIZTELとLambda関数を連携するためにAPIGatewayを構築します。

連携したいLambda関数の設定タブからBIZTEL用のトリガを追加します。

API_Lambda1

トリガーの種類はAPI Gatewayを選択し、APIキーをセキュリティーにもつRESTAPIを作成します。

API_Lambda2

API_Lambda3_mask
これで、API連携のためのAPIエンドポイントとAPIキーが作成されます。

② API連携IVRの設定

次に、BIZTELのAPI連携IVRの設定です。
※ BIZTELの「3.3.0」以降のバージョンで利用できます。

コールセンター -> IVR -> 新規登録へ

API_Lambda4
「API連携を利用する」を有効にして新規登録

API_Lambda5_mask
「URL」にはAPIGatewayのAPIエンドポイントを、「リクエストヘッダ」にはx-api-keyとしてAPIキーをそれぞれ設定します。

③APIレスポンス設定

API_Lambda6
最後に連携した結果の氏名の「かな」を変数にして、音声合成テキストで読み上げられるようにします。
今回はお客さまの氏名を読み上げるだけなので、転送先はコールセンターにします。

結果

RDSへの登録の有無により、ガイダンスや着信先のコールセンターを動的に振り分けることができました。

注意点として、戻り値を読み上げる際に敬称(●●さま)を漢字で音声合成すると、例えば「びずてる様」を「びずてるよう」と読み上げてしまうので、戻り値はひらがなで設定するようにしましょう。

振り返り・まとめ

今回は単純なルーティングと名前読み上げのみの実装となりましたが、Lambda側の実装次第では

  • BIZTELのコールバックAPIを利用して定期的な見守りコールの実装
  • 主治医への問い合わせの前に検温結果や連絡事項を音声認識でRDSへ記録し、着信時に内容を表示する

といったような業務が簡単に実現できそうです。

編集後記

今回の「BIZTEL API使ってみた」では、AWSにあるRDBのお客さま情報を取得し、BIZTELのAPI連携IVRを活用して着信時に自動音声でお名前を読み上げて転送する、という仕組みを実践しました。

BIZTELでは、API連携によってさまざまな利用シーンに対応することができます。

「BIZTEL API使ってみた」ではこのように実際にBIZTELの利用者が思いついた業務改善のアイデアを、読者のみなさまが簡単に設定・実現できるよう、これからもさまざまな機能を紹介していく予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/04/23/6696/feed/ 0
BIZTEL API使ってみた Vol.1 取れない電話の悩みを解決したい! /blog/2021/03/19/6513/ /blog/2021/03/19/6513/#respond Fri, 19 Mar 2021 06:41:04 +0000 /?p=6513 API1_eyecatch今回から新たに始まる「BIZTEL API使ってみた」シリーズでは、BIZTELをもっと便利にお使いいただくためのAPI連携機能について、BIZTELのサービス担当が実際にさまざまな機能の実装にチャレンジします。 &nb […]]]> API1_eyecatch

今回から新たに始まる「BIZTEL API使ってみた」シリーズでは、BIZTELをもっと便利にお使いいただくためのAPI連携機能について、BIZTELのサービス担当が実際にさまざまな機能の実装にチャレンジします。

 

チャレンジ担当者

 

やってみたいこと

 

在宅勤務が主流になり始めてから、日々オンライン会議の連続。。。

会議ばかりで内線着信やダイヤルイン番号への着信に出られないケースも多いですよね。
折り返しするのも手間がかかりますし、用件を留守電で吹き込んでもらうにしても、毎回ヘッドセットをして聞くのもまた手間がかかります。

そこでぼんやりと「用件がテキスト化されてslackに飛んでくるといいな。。。」と思い始めたので、これをBIZTEL APIで実現するべくチャレンジしてみました。

使用するツール・利用ライセンス ※

BIZTELの利用ライセンス

・コールセンタープランのご契約、もしくはビジネスフォンプランのご契約

BIZTELで必要なオプション

・音声認識IVR
・API連携IVR

BIZTEL以外に必要なもの

・Slack
・AmiVoice API

※ 詳細な条件についてはお問い合わせください。

準備

一連の流れを整理しましょう。まずはどういう仕組みにしたいかを検討。

考えた仕組みは次のとおりです。

①電話に10秒出られない(内線・ダイヤルイン着信)

②ガイダンスを再生
「坂元は現在電話にでられません。用件をお話しいただくとSlackで坂元に内容が届きますので確認させていただきます」
※留守番電話のようなメッセージだと吹き込んでもらえない可能性があるので、あえてSlackというワードを出して吹き込んでもらえるようにしました

③メッセージをしゃべってもらう

④メッセージを音声認識

⑤テキスト化されたメッセージをSlackの自分のダイレクトメッセージで通知
表示される内容としては「メッセージ内容」・「発信者番号」があればまずは充分かなと思い、将来的に機能を充実させるのであれば、発信者番号はクリックトゥコールでiPhoneからすぐに発信できるようになるとなおよいと思っています。

設定

① SlackのWebhookURLの取得

BIZTELとSlackを連携するために、SlackのWebhookURLを取得します。


取得時に送信したいチャネルを選択します

https://slack.com/services/new/incoming-webhook

API_Image

チャネルを選択してWebhookURLを取得

API_Image2

これで、WebhookURLが発行されます。

 

②  音声認識IVRの設定

次に、BIZTELの音声認識IVRの設定です。

※ BIZTELの「3.3.0」以降のバージョンで利用できます。


コールセンター -> IVR -> 新規登録へ

API_Image3

「API連携を利用する」を有効にして新規登録

API_Image4

音声認識のAmivoice Cloud Platformでユーザ登録して接続URLを発行

https://acp.amivoice.com/main/

音声認識のURLを指定してAPI設定を行います。

 

③ APIレスポンス設定

API_Image5

音声認識結果を変数に入れて次のIVRへ転送する

転送するIVR番号は事前に設定しておく

 

音声認識結果は{(内線番号)_CODE1}のような形で次のIVRに引き継ぐことが可能です。

 

④ 転送先のIVR設定

同じく「API連携を利用する」でIVRを作成しAPI連携設定に進む

API_Image6

転送されてきた音声認識結果をslackのWebhookURLに対して送信します。

「受付入力種別」を入力なしとすることで転送後すぐにAPI処理に回すことが可能です。

 

結果

 

電話の動作確認。Slackにちゃんとメッセージが流れていることが確認できました。

API_Image7

 

電話に出れない時にまず内容が確認できて、必要があれば折り返しができる理想に近い運用が可能になりました。

実は、音声認識した結果をAPI処理するにあたって、最初は「API連携コールアクション」で実現できると思っていてその設定を何度もしながら苦戦していました。
結局のところ解決方法が判らず、BIZTELサービスデスクのメンバーに聞くと即答でAPI連携IVRを組み合わせることでできますよ、と教えてくれました。自分ももっと勉強して経験していかなければなりませんね。。

みなさまも是非、業務改善にBIZTELを活用してもらえればと思います。

最後に

結果として今回うまくいきましたが、こういった身近な業務改善がシステム開発なしに利用者のレベルでアイデアを出してうまく設定できるのはとてもよいですね。
また色々ちょっとした業務改善を考えていきたいと思います。

 

編集後記

今回の「BIZTEL API使ってみた」は、BIZTELの音声認識IVRを活用してSlackでメッセージを送信する仕組みを実践しました。

BIZTELでは、API連携によってさまざまな利用シーンに対応することができます。

「BIZTEL API使ってみた」ではこのように実際にBIZTELの利用者が思いついた業務改善のアイデアを、読者のみなさまが簡単に設定・実現できるよう、これからもさまざまな機能を紹介していく予定です。

いまBIZTELをご利用中のお客さまも、「こんなことがしたい」というご希望がございましたら、BIZTELサービス担当までご相談ください!

]]>
/blog/2021/03/19/6513/feed/ 0
IVRとは?仕組みとメリット、コールセンターでの導入事例を解説 /blog/2021/03/04/6495/ /blog/2021/03/04/6495/#respond Thu, 04 Mar 2021 08:30:38 +0000 /?p=6495 IVR_eyecatchはじめに 現代のコールセンターは、顧客満足度の向上がミッションとされています。丁寧な対応やスピーディな問題解決によって顧客満足度が高まるほど、自社商品やサービスの継続利用につながります。 一方で、窓口が分かれていたり、オ […]]]> IVR_eyecatch

はじめに

現代のコールセンターは、顧客満足度の向上がミッションとされています。丁寧な対応やスピーディな問題解決によって顧客満足度が高まるほど、自社商品やサービスの継続利用につながります。

一方で、窓口が分かれていたり、オペレーターの役割分担が決まっていたりするコールセンターでは、待ち時間が発生しやすく、顧客満足度の低下を招きがちです。

これを解決する方法としては「IVRの活用」が挙げられます。

IVRは省人化や業務効率化を後押しするばかりではなく、顧客満足度の向上も期待できる機能です。

ここでは、IVRの仕組みや解決できる課題・メリット、導入が向いているコールセンター、費用、選定ポイントなどを紹介します。

IVRとは?

IVR( Interactive Voice Response )とは「自動音声応答システム」のことで、あらかじめ設定した案内を自動音声で流す仕組みです。

IVRの基本的な動作は「着信 ⇒ 自動応答による音声ガイダンス ⇒ 音声ガイダンスに従ってプッシュボタンを操作 ⇒ 担当者・窓口に接続」という具合に、取次作業を自動化できるものとなっています。

以下は、IVRが活用されるシーンの一例です。

IVRの利用シーン

  • 担当窓口への自動振り分け

製品やサービス、問い合わせ内容によって担当窓口が分かれている場合に、IVRによって自動的な振り分けを行います。「製品Aに関する問い合わせは2を、製品Bについては3を…」といった具合に複数のルートを設定できるため、より専門性の高い知識を持つ担当者へ自動的につなぐことができます。

  • あふれ呼対策

担当者や窓口がすべて対応中の場合に「あふれ呼対策」としても利用可能です。

時間を置いてから掛けなおすことを促したり、折り返し連絡の予約を受け付けたりと、顧客の時間の浪費を防ぐことができます。

  • 不在時の対応

離席や休暇などで電話に出ることが出来ない場合も、IVRでの自動応答が役立ちます。

メッセージの録音や営業時間内での掛けなおしを促す内容を案内することが可能です。

  • 有人業務の一部無人化

IVRの案内にボタン操作や音声入力を含めることで、情報入力を促すこともできます。

各種情報照会や資料請求の受付など、定型作業の自動化・無人化にも役立ちます。

IVRにより解決できる課題と導入メリット

それでは、IVRを導入することでどのような課題を解決できるのでしょうか。導入メリットとともに以下で解説します。

リソース不足への対応

人材難や問い合わせ内容の複雑化・求められる対応の高度化などを背景に、コールセンターの業務負荷は日々増加する傾向にあります。

そのため、対応リソースの最適化がコールセンターの喫緊の課題となっています。

製品・サービスなどにより担当者が分かれているケースにおいては、問い合わせ内容に応じた取り次ぎが発生します。このような場合にIVRの自動振り分け機能を使うことで、スムーズな顧客対応が実現可能です。

「製品Aに関する問い合わせは1を、製品Bについては2を……」というように複数のルートを設定できるため、専門性の高い知識を持つなど、問い合わせ内容に適した担当者へ素早くつなぐことができます。

その結果、たらいまわしによる顧客満足度低下のリスクが軽減できるでしょう。

また、IVRの自動応答やガイダンスによる案内は、電話対応にかかる時間・人手の削減にも有効です。

案内時にボタン操作や音声入力を顧客に促すことで、情報の照会や資料請求といった定型業務の自動化・省力化も実現できます。IVRの設定によって入電フローが整理できるため、オペレーターは事前に顧客がどのような意図で電話をかけてきているかを知ることができ、スムーズな案内が可能になるのです。

あふれ呼対策・応答率の向上

IVRは、オペレーター全員が対応中の場合に発生する「あふれ呼」への対策としても効果的です。時間を置いてからかけ直すことを促したり、折り返し連絡の予約を受け付けたりして、顧客に時間を浪費させることを防ぎます。また、いつまでたっても電話がつながらないという不快感を顧客に与えずに済みます。

さらにIVRの活用により、定型的な内容であれば自動で対応することができるため、混雑時のリソース最適化につながり、結果として応答率の向上も見込めるでしょう。

営業時間外の対応

営業時間外や離席・休暇などで電話に出られないような場合にも、IVRでの自動応答が役立ちます。

メッセージの録音や、営業時間内のかけ直しを促す案内が可能です。また、自社WebサイトのFAQやチャットボットへの誘導などを行うこともできます。

IVRのデメリット

一方で、IVRにはデメリットも存在します。

顧客側に操作の手間を取らせてしまう

顧客側が操作を行うIVRは、手間と時間がかかるという理由からストレスを感じさせてしまうことがあります。

また、操作方法の説明や選択肢の読み上げが煩わしく感じる顧客も存在します。案内文はできるだけ簡潔にするなど、顧客にストレスを感じさせないような工夫が必要です。

担当者とつながるまでに、かえって時間がかかるケースもある

IVRでコールフローの階層や選択肢を多く作り、複雑な振り分けを実施すると、案内を聞く時間や操作時間が長くなります。
「いつまでたっても通話が開始できない」といった不満を顧客に抱かせてしまうと、満足度は低下してしまうでしょう。

そのため案内が複雑になりすぎないようバランスを取りつつ、いずれの選択肢の場合でも、できる限り1〜2階層ほどの短いコールフローで案内が完結できるように設計する必要があります。

「その他」の問い合わせが増える

IVRのシナリオ設計が不十分であると、顧客はどのボタンを選択すればよいかわからず、結局「その他」の選択肢を選んでしまいます。

これでは振り分けを行う効果を十分に得ることができないため、事前に問い合わせの多い内容を選別するなどして、案内すべき窓口が明確なものとなるようにシナリオを設計しましょう。

IVR導入が向いているコールセンター

IVRはコールセンター業務を効率化できるため、導入を検討している企業も多いでしょう。そこで、IVRの効果を得られやすいコールセンターの傾向を整理してみました。

窓口が複数あり細分化されているコールセンター

製品・サービス・問い合わせ内容ごとに窓口を分けているコールセンターは、IVRの導入で複数の効果が得られやすいでしょう。

まず、取次の手間が自動化されるため、細分化された窓口と問い合わせ内容のマッチングを判断する人手(一次受付)が不要になります。

さらに、仮に窓口が埋まっている場合でも、電話の掛けなおしや自動音声対応への誘導によって顧客に「次のアクション」を選択してもらえるようになるため、単純な待ち時間を減らすことが可能です。

24時間対応など営業時間が長いコールセンター

24時間問い合せを受け付けているコールセンターであれば、一部の問い合わせをIVRで自動化・無人化してみても良いかもしれません。

例えば深夜帯など、問い合わせ数が少ない時間帯の対応をIVRで行えば、余計な人件費をかけずにサービス品質を維持できます。

定型的な問い合わせが多いコールセンター

単純な問い合わせへの回答や案内など、半ば定型的な業務が常に発生しているコールセンターでも、IVRの導入がおすすめです。定型業務への対応をIVRに任せることで、複雑な問い合わせやクレーム対応に投下できる人的リソースが増加し、顧客満足度の向上が期待できるからです。

例えば、以下のような業務が該当します。

  • 商品の注文対応において、商品の種類・数量・宛先などを受付する業務。
  • 利用可能額・ポイント残高など、カード情報から各種残高を照会する業務。

こうした定型業務の削減は従業員満足度を向上させる要因でもあるため、ES対策としても有効です。

「音声認識×IVR」「API×IVR」で利便性が向上

これまでのIVRは「音声案内」と「プッシュボタン操作」による情報入力が主流でした。こうした従来型のIVRは、電話をかける顧客側に「音声案内を待っている時間がもったいない」「メニューに応じてボタンを押す手間が面倒だ」などのデメリットを感じさせてしまうことがあります。

また、電話システムと業務システムを連携させている場合、受付だけを自動化しても業務全体としての効率化が達成されないこともあります。

こうした従来型IVRの課題を解消するものとして、「音声認識」「API」と連携したIVRが登場していることをご存じでしょうか。音声認識やAPIを組み合わせたIVRであれば、これまでよりも顧客側に優しく、なおかつ柔軟な業務自動化が可能になります。

音声認識IVR

音声認識とIVRを組み合わせることで、「音声によってメニュー選択」が可能になります。ボタン操作の作業が音声入力ベースになることで、顧客側の労力を低減できるわけです。

また、ボタン操作だけでは難しかった「テキスト情報ベースでのコールフロー構築」も可能です。より具体的な情報をもとにコールフローを構築できるため、問い合わせ内容と接続先窓口とのマッチング度が上がり、顧客満足度の向上が見込めます。

さらに、オペレーターを介さない申し込み・解約作業が可能になるため、無人化対策としても有効です。

BIZTELでも音声認識を採用したIVRを提供しています。

→ BIZTEL 音声認識IVR機能について

API連携IVR

IVRと外部システムをAPI連携によって接続する機能です。コールセンター側の受付業務と業務システムを連結することで、システムをまたいだ自動化が可能になります。

例えば、予約システムと連携することで、「日時や人数を入力して予約受付 ⇒ 予約システムに登録し予約完了」といった業務が自動化されます。

また、受注システムと連携し、購入・解約手続きの対応など定型的な業務の自動化も進むでしょう。

アイディア次第で、さまざまな業務プロセスを効率化できるため、非常に柔軟性の高い仕組みです。

BIZTELでもAPI連携IVRの提供を開始しました。

→ BIZTEL API連携IVR機能について

具体的な事例はこちら


- biztel.jp

- biztel.jp

コールセンターにおけるIVRの導入事例

最後に、実際のIVR導入事例を紹介します。

タイムリーかつ緊急性の高い問い合わせへの対応

モバイル送金・決済サービスを提供するLINE Pay株式会社さまでは、物理カードの発行に伴い、電話窓口の開設を決定しました。この電話窓口において、IVRを活用しています。

IVRの導入によって「カード盗難・紛失」など緊急性の高い問い合わせに対しては、24時間対応が可能になりました。具体的には、IVRによる自動音声応答で決済サービスの利用停止方法を案内するなど、業務の無人化を達成しています。

また、クレジットカード会社のシステムトラブル発生時にも、状況に応じてアナウンス内容を変更できるようになったとのことです。

LINE Payさまの事例はこちらから

導入費用

それでは、IVRの導入にはどの程度の費用が必要なのでしょうか。

IVRは基本的にコールセンターシステムの機能のひとつとして提供されるため、ここではクラウド型コールセンターシステム・BIZTELで提供しているIVR機能を例に紹介します。

BIZTELではIVRが標準機能として利用できます。そのためサービスの基本料金以外には費用が発生しません。ダイヤルボタンで問い合わせ内容を選択して着信を振り分けたり、回線の混雑時や営業時間外での着信に自動案内ガイダンスを流したりといったことが標準機能の範囲で実現します。

その他にも、有償オプションとして音声認識IVRとAPI連携IVRを提供しています。

音声認識IVRでは、ダイヤルボタンの押下ではなく音声での入力操作が可能になります。より複雑な情報が入力でき、またオペレーターを介さずに自動処理できる幅も広がります。こちらの機能は初期費用50,000円〜、月間利用料20,000円〜※です。

※別途、API連携IVRのオプションおよび連携する音声認識サービスの契約が必要です。

API連携IVRでは、顧客が入力した情報を外部システムへ連携し、予約受付や受注・解約といった手続きを行うことが可能です。初期費用100,000円〜、月間利用料40,000円〜で利用できます。

システムの選定ポイント

以下では、IVRを導入する際に留意するべきポイントについて解説します。

導入目的・利用方法の整理

IVRを導入する際は、当然ながら「どのような目的で」「どのような業務に」利用するのかを事前に整理しておかなければなりません。

たとえば、「IVRの基本機能である振り分け機能さえあればよいのか」「時間外や混雑時のガイダンス設定などは必要か」「より高度な運用ができるよう音声認識AIと外部連携をする必要があるか」など、要件に沿って各社が提供するシステムの機能を比較検討すべきでしょう。

導入形態

前述した通り、IVRはコールセンターシステムと一体になっていることがほとんどです。コールセンターシステムは、主にオンプレミス型とクラウド型の2つがあります。

オンプレミス型は自社の業務要件に合わせて細かく柔軟なカスタマイズが可能ですが、一方でPBX機器やサーバー・回線の用意が必要であるため、コストが高くなりがちです。また、導入までの期間が長くなる傾向にあります。

クラウド型は、契約から短期間で利用が開始できる点がメリットです。また、プランの変更も柔軟かつ素早く実施できます。一方で、オンプレミス型ほど細やかなカスタマイズができないというデメリットがあります。

料金形態

特にクラウド型においては、利用する機能や回線数などによって料金形態が異なるケースが多いです。またサービスによっては、特定の機能を利用する際にオプション料金が発生します。

自社が現時点で必要としている機能やスペックはもちろんのこと、将来的な拡張も見越してサービスを選定するとよいでしょう。

設定変更の難易度

IVRによる振り分け内容や自動対応音声などは、コールセンターの運営状況が変化するたびに変更していく必要があります。IVRの設定作業が現場で容易に行えるかどうかは、選定の上で押さえておくべきポイントといえます。

まとめ

ここでは、IVRの特徴、音声認識やAPI連携による新しい機能、選定のポイントなどを紹介してきました。

IVRは単なる自動応答や転送だけに対応する機能ではありません。予約率改善や緊急性の高い問い合わせへの対応など、顧客満足度に直結しやすい分野でも活用できます。

また、音声認識やAPI連携の活用により、より複雑な業務の自動化にも応用できるようになりました。

顧客満足度向上と無人化・省人化などを両立させたい場合は、多機能なIVRの導入を検討してみてはいかがでしょうか。

 

※IVRについてもっと知る


- biztel.jp

- biztel.jp
]]>
/blog/2021/03/04/6495/feed/ 0
【リリースノート】BIZTEL バージョン3.3.0〜音声認識IVR・音声テキスト化・Slack連携〜 /blog/2021/01/19/6225/ /blog/2021/01/19/6225/#respond Tue, 19 Jan 2021 06:11:27 +0000 /?p=6225 BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。 本記事では、2021年1月に提供開始した最新バージョン3.3.0で追加された機能をご紹介します。 & […]]]>

BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。

本記事では、2021年1月に提供開始した最新バージョン3.3.0で追加された機能をご紹介します。

 

音声認識IVR

従来のIVRはガイダンスにしたがってダイヤルボタンを操作する必要がありましたが、本機能では音声による入力操作が可能です。また、お客さまの発話をテキスト化し、CRMなどの外部システムと連携してさまざまな自動応対ができます。例えば、氏名・住所・商品名を発話するようガイダンスで促すことでオペレーターを介さずに商品の購入/解約受付をすることができ、運営コストの削減や、電話の待ち時間の解消による顧客満足度の向上を実現します。

リアルタイム音声テキスト化

通話内容をリアルタイムに文字起こしする機能です。テキストデータは通話履歴とともに保存され、お客さまとオペレーターがいつ何を発言したか視覚化することができます。応対記録の入力作業の効率化や、問題のある応対の早期発見・オペレーターの教育・VOC(お客さまの声)の収集など、さまざまな業務の改善に役立てることができます。

Slack連携

Slackと連携し、電話着信の通知や通話録音ファイルのリンクなどを投稿することができます。タイムリーな情報共有により、顧客対応のスピードアップが実現します。

前バージョンでも外部サービスとの連携機能(API連携コールアクション)をリリースしましたが、本機能はAPIの知識がないユーザにも、投稿するタイミングやテキスト内容を登録するだけで簡単に設定することが可能です。

設定画面

 

Slackへの投稿のイメージ

音声再生速度の変更+追いかけ再生

通話録音の再生スピードを2倍速まで変更することが可能です。また、従来は通話が終了するまで再生できませんでしたが、通話中の録音データの追いかけ再生ができるようになりました。お客さまやオペレーターが話している内容の確認や、応対品質モニタリングのサンプル選定などを効率的に行うことができます。

シークバー

 

一覧画面

セキュリティ:メールによるパスワードリセット

利用者がアカウントのパスワードを忘れてしまった場合、従来は管理者がパスワードを再設定する必要がありました。今回のバージョンアップにより、利用者は自身のアカウントに登録したメールアドレス宛に再設定手続きのURLを配信し、自らパスワードをリセットすることが可能になりました。

セキュリティ:アカウントロック

一定回数以上のログインエラーがあった際などにアカウントをロックする機能です。不正アクセスを防止し、セキュリティを強化することができます。また、ロックがかかるまでのエラー回数や、ロックが解除されるまでの時間等の設定が可能です。

指定コールセンター待ち受け

複数のコールセンターに所属しているオペレーターについて、任意の時間帯のみ、指定したコールセンターに絞って着信を受けるよう設定できます。例えば、一時的に呼量が増加しているコールセンターがあり、そちらを重点的に応答する必要があるケースなどに活用でき、効果的な人員配置に役立ちます。

削除アカウントの履歴表示

従来では削除されたアカウントや電話端末に関する履歴を参照することができませんでしたが、今回のバージョンアップにより一定の権限を有する管理者であれば履歴の検索・参照ができるようになりました。

アカウント画面からコールセンター所属設定変更

これまで、オペレータが所属するコールセンターの変更は「コールセンター画面」でしか設定できませんでしたが、今回のバージョンアップにより「アカウント画面」でも変更することが可能となりました。アカウントを追加する際の所属設定が容易になります。

]]>
/blog/2021/01/19/6225/feed/ 0
【リリースノート】BIZTEL「バージョン3.2.10」〜パスワードポリシーとコールバック発信を強化〜 /blog/2020/09/29/5738/ /blog/2020/09/29/5738/#respond Tue, 29 Sep 2020 01:48:16 +0000 /?p=5738 BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。 本記事では、2020年9月に提供開始した最新バージョン3.2.10で追加された機能をご紹介します。 […]]]>

BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。

本記事では、2020年9月に提供開始した最新バージョン3.2.10で追加された機能をご紹介します。

パスワードポリシー

パスワードのセキュリティ強度を高めるための機能です。過去に利用したパスワード文字列の世代管理(前回設定したパスワードを設定できなくするなど)や、必須とする要素(数字・大文字・記号)が管理できるようになり、従来以上にセキュリティレベルを高めることが可能になりました。

コールバック発信画面

個人の携帯電話などと連携して、BIZTEL を介した発信・通話を行う機能です。

例えば、在宅勤務により個人携帯を利用して発信業務を行う際に、BIZTEL で契約 している電話番号を相手に通知したり、個人携帯の通話料をかけずに発信したりすることが できます。

従来、この機能はAPIからの利用が必要でしたが、管理画面から設定することが可能になり、より簡単にコールバック発信ができるようにしました。

]]>
/blog/2020/09/29/5738/feed/ 0
【リリースノート】BIZTEL「バージョン3.2.0」〜API機能の拡充や音声暗号化など新機能追加〜 /blog/2020/09/17/5637/ /blog/2020/09/17/5637/#respond Thu, 17 Sep 2020 03:48:00 +0000 /?p=5637 BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。 2020年7月に提供開始した最新バージョン3.2.0では、メジャーバージョンアップとして、お客さまの […]]]>

BIZTELでは1月と7月にメジャーバージョンアップを、3・5・9・11月にマイナーバージョンアップを提供しています。

2020年7月に提供開始した最新バージョン3.2.0では、メジャーバージョンアップとして、お客さまの多彩な業務やご要望に対応できるよう、多数の役立つ機能を追加しました。

API連携機能の拡充

API連携コールアクション

BIZTELで着信・応答・切断・発信などのコールに関する動作をする際に、外部システムの API に接続して、さまざまなアクションが実行できます。

例えば、着信した際にCRM側に通話履歴を記録したり、発信者電話番号などの情報を社内用チャットに自動投稿したり、ショートメッセージで通知したりと、円滑な業務遂行を助ける仕組みが構築できます。さまざまなシステムと連携できるので、自社の環境や業務フローに即した効率化が実現します。

 

API 連携 IVR

BIZTELでIVRの動作をする際に、外部システムのAPIに接続して、自動応答・自動受付することが可能になります。

例えば、医療機関やサロンなどの予約管理システムと連携し、プッシュボタンで会員番号や日時などを入力し予約受付を完了させる、といった対応が自動化できます。 また、受注システムと連携し、受注や解約の自動化をする、受注実績があるお客様には新しい商品を提案するガイダンスを流す、といった使い方も。アイデア次第で使い方の可能性が広がります。

コールバックAPI

個人の携帯電話などと連携して、BIZTEL を介した発信・通話を行う機能です。

例えば、在宅勤務により個人携帯を利用して発信業務を行う際に、BIZTEL で契約 している電話番号を相手に通知したり、個人携帯の通話料をかけずに発信したりすることが できます。通話の情報は、「発着信履歴」や「コールセンター履歴」に残ります。
また電話番号リストを用意して、クリックすることで発信するといった簡易的なアウトバウンド運用を実現することも可能です。

履歴取得API

BIZTELに記録されている電話の発着信やオペレーターの勤務ステータスなどに関する履歴データが取得できます。コールセンターの稼働状況について、標準のレポート機能では提供していない分析をユーザ固有のシステムで行う際などに役立ちます。

その他の提供機能

音声暗号化

通話中の音声情報を暗号化することにより、盗聴・改竄を防止します。インターネット回線で利用できるため、VPN(仮想の専用線で接続し、安全にデータ通信を行う仕組み)と比較して短期間・低コストで導入でき、緊急時における在宅勤務の実施など、セキュアな通話環境をスピーディに構築する際にも効果的 です。

ダウンロード禁止オプション

管理者以外のアカウントに対して、通話録音ファイルのダウンロードを禁止します。ダウンロード禁止設定が有効な場合でも通話録音の再生はできるため、業務に影響を与えずに不要なファイルの持ち出しを防ぐことが可能です。

コールセンターごとの録音禁止オプション

コールセンターごとに通話録音の有効/無効を設定できます。業務内容に応じて録音するべきか判断することが可能です。

録音再生リンク

通話ごとに割り振られているIDを用いて、外部システムからの通話録音の再生・ダウロードを容易に実現することができます。セキュリティに配慮し、再生・ダウンロードをする前にはアカウント認証と権限制御を行います。

ソフトフォン発信時連携

ソフトフォンから発信処理を行う際に、外部システムへAPIリクエストやOSコマンドが実行できます。

例えば、発信時にCRMと連携することで、通話録音再生用のリンクをCRMに記録することができます。

エージェント活動履歴

エージェントのステータス変更や通話状況の時系列履歴が参照できます。指定時間帯のエージェントの業務内容を詳細に把握することが可能です。

]]>
/blog/2020/09/17/5637/feed/ 0