これは何？
下記のようなことができるのか、の実験記録。
- BIZTELを使って電話サポートを行うとして、
- 音声通話の内容をAmiVoiceを使って文字起こしもしたい。
- ついでに通話の情報(通話開始、通話終了、担当者、、、および文字起こしの内容)をスプレッドシートに書き出したい
これについては BIZTEL API使ってみた Vol.5 Google Sheets APIと連携して対応履歴を自動作成したい に手順が載ってそうだ。
ということでやってみた。
必要なもの
- BIZTEL のアカウント
- AmiVoice Cloud Platform のアカウント
- GCP のアカウント
事前の設定
- BIZTELで電話対応ができる状態。(私はBIZTEL自体の設定方法はよくわかっていませんのであしからず…)
- AmiVoiceの設定も済んでいる状態から受け取ったのでAmiVoiceの設定はよくわかってないです。(おそらくBIZTELと連携するためのAPIキーが発行できるのかなと推測)
全体像のイメージ図
多分こんな感じ。
GCPの設定
- GCPにプロジェクトを作る (このあたりから)
-
APIとサービス>認証情報から認証情報を作成でOAuthクライアントIDを選択 - アプリケーションの種類に
ウェブ アプリケーションを選択 - 任意の名前を入力 (BIZTEL連携用、とか？)
これでクライアントが作成されるが、
- この時点では「名前」だけ入れたクライアントでOK
- ここで生成される
クライアントIDとクライアントシークレットを後で使う(*1) - BIZTELの設定をした後に
承認済みのリダイレクト URIを設定する必要がある
BIZTELでOAuthの設定
- 左メニューバーの
連携オプション>OAuthアカウント登録から「新規」
↓こんな画面になるので
-
名称は任意で。(「GoogleOAuthのアカウント」とか) (*2) -
クライアントIDとクライアント・シークレットに、(*1)の情報をいれる -
認可URLはhttps://accounts.google.com/o/oauth2/auth -
認可コード フロー scopeはhttps://www.googleapis.com/auth/spreadsheets -
認可コード フロー パラメータはprompt=consent&access_type=offline -
アクセストークンURLはhttps://www.googleapis.com/oauth2/v4/token
↑これらの情報をどこで知ったかというとBIZTEL API使ってみた Vol.5 Google Sheets APIと連携して対応履歴を自動作成したい | BIZTELブログのページにある 「①OAuthアカウントの登録」 の項目の 「画像の中」
あとはデフォルトのままで「保存」
その後、もう一度今のやつをクリックすると、画面の一番下が↓こうなってると思うので「トークン取得」を押す。
うまく行けばここでGoogleログインの認証が入るのでアカウント選んで、アクセスを許可する。
トークン取得が成功するとこうなるはず↓
BIZTELでコールアクションの設定
- 左メニューバーの
連携オプション>コールアクション連携で「新規」を押す -
コールアクション名を入力する (「検証用コールアクション」にした) -
連携対象のタブ > 「編集」 から「このアクションに紐づける電話番号」を選択する -
API連携のタブ > 「新規」で下記のような設定をする (皆さんの環境に合わせて設定してください)
↓こんな初期画面になるので
-
イベント種類に録音完了／音声認識連携完了 -
API連携種別でOAuthトークン取得を選択 -
OAuthアカウントに (*2) のアカウントを選択 -
URLにBIZTELからSheetsAPIに送るリスエストURLを書く
https://sheets.googleapis.com/v4/spreadsheets/xxxxxx/values/シート名!A1:append?valueInputOption=RAW&insertDataOption=INSERT_ROWS
-
メソッドはPOST リクエストヘッダ
accept:application/json
Content-Type: application/json
リクエストボディ
{
"majorDimension": "ROWS",
"values":[
["{ID}","{START_TIME}","{TEL}","{CALLED}","{END_TIME}","{AGENT_NAME}","{CALL_SEC}","{VOICE_LOG}"]
]
}
↑これは「何をどの順でシートに書き出したいか」によって変更してください。
何の値が取れるのか、については 1.コールアクション – BIZTEL Manual の 4. 変数展開コード を参照。
私の環境では下記のようになりました。
あとはデフォルトのままで「保存」
BIZTELでAmiVoiceの設定
最初に書きましたが、私自身AmiVoiceの設定をよくわかってないのですが、私が引き継いだ時点で
連携オプション > 音声認識連携 が下記のようになってました。
おそらくAmiVoiceの管理画面で、BIZTEL用の「サービス」が設定できると思われます。
連携対象 のタブから、連携させたい電話番号をチェックします。
やってみよう
この状態で連携対象の電話番号に電話をかけて、通話をしてみてください。
うまくいけば下のキャプチャのようにシートに記録が残ります。すごい。(文字起こしの精度はAmiVoice次第)
おわりに
BIZTEL使ってる人のお役に立てたらうれしい。