会話の詳細を取得する
Conversation APIを使用すると、音声通話のConversationオブジェクトの詳細を取得できます。
このチュートリアルでは、特に音声通話の詳細を取得することに焦点を当てますが、ビデオ通話やテキストチャットセッションなど、他の機能を持つ他の多くのユースケースが考えられます。このチュートリアルの目的は、会話の構造を理解することです。会話はVonageの技術の多くを支える重要なオブジェクトです。すべてのコミュニケーションは会話を通して行われるため、コミュニケーション活動の基本的なデータ構造です。
このチュートリアルで行うセットアップを下図に示す：
このチュートリアルでは
前提条件
- Vonageアカウントの作成 - これがなければ、遠くへは行けない。
- Vonage番号のレンタル - ユーロのフリークレジットがあるはずだ。十分すぎるほどだ。
- Vonageコマンドラインツールのインストール - 必要なもの ノード をインストールする必要がありますが、Vonage CLIを使うのが早くて便利です。
- を持つべきだ。 パイソン3 そして フラスコ をインストールします。これらはウェブフック・サーバーに必要です。
このチュートリアルでは ングロク を実行する。 ウェブフック サーバーをローカルに設置する。
ングロックをご存じない方は、以下をご参照ください。 チュートリアル 先に進む前に。
また、このチュートリアルでは、2台の携帯電話にアクセスする必要があります！
だから、もし続ける準備ができているのなら...。
Vonageアプリケーションの作成
まず、Vonage Applicationsを作成する必要があります：
この前のコマンドでは demo あなたのセットアップに当てはまるものを選んでください。
生成されたアプリケーションID(APP_ID)、JWTを生成する際に必要となる。
アプリケーションにVonage Numbersをリンクする
すでにVonage番号(VONAGE_NUMBER)、ダッシュボードまたはコマンドラインからVonage Numberとアプリケーションをリンクすることができます：
JWTの作成
Conversation APIはJWTを使用して認証されます。以下のコマンドでJWTを生成できる：
を交換する必要がある。 APP_ID をアプリケーションのIDと一緒に入力してください。また private.key は、この同じアプリケーションに関連するキーである。
注： このJWTは1日間有効です。
そして、JWTを見ることができる：
ヒント JWTのVerifyは以下のサイトで行えます。 jwt.io.
ウェブフックサーバーを実行する
進行中のコールのConversation IDを取得するために、Webhookサーバーを実行する必要があります。以下のPythonコードで十分です：
重要： を交換する必要がある。 TO_NUMBER を2台目の電話番号「電話2（Bob）」に置き換えてください。
このウェブフック・サーバーをローカルで実行する：
Vonage番号に電話をかける
電話機1（Alice）でVonage番号にダイヤルします。着信コールは2番目の電話、電話2（ボブ）に転送されます。電話2(Bob)で電話に出ます。この時点で通話をキャンセルしないでください。
ウェブフック・サーバーによって生成されたログを確認してください。以下のようなものが表示されるはずです：
あなたが興味があるのは、次のような会話IDだけだ。 CON-<uuid>.そのIDをコピーして便利な場所に貼り付ける。
会話の詳細を見る
別のターミナルタブで以下のコマンドを実行すれば、現在のコールの会話オブジェクトの詳細を取得できる。
注： 必ず交換してください。 $CONVERSATION_ID 以前に取得したIDと $JWT を、以前に作成したJWTで指定する。
以下を使用して、音声通話の会話詳細を取得する：
Run your code
Save this file to your machine and run it:
Prerequisites
Create a file named get-conversation.js and add the following code:
Run your code
Save this file to your machine and run it:
Prerequisites
Add the following to build.gradle:
Create a class named GetConversation and add the following code to the main method:
Run your code
We can use the アプリケーション plugin for Gradle to simplify the running of our application. Update your build.gradle with the following:
Run the following gradle command to execute your application, replacing com.vonage.quickstart.conversation with the package containing GetConversation:
Prerequisites
Create a file named GetConversation.cs and add the following code:
Add the following to GetConversation.cs:
Prerequisites
Create a file named get-conversation.php and add the following code:
Run your code
Save this file to your machine and run it:
このAPIコールでは、以下のようなレスポンスが返ってくる：
この対応については 会話 というトピックがある。
これで電話1(Alice)と電話2(Bob)を切って通話を終了することができます。
結論
Conversation APIを使用して、音声通話のConversationオブジェクトを取得する方法を説明しました。