技術詳細

はじめに

Vonage Voice APIを使用すると、開発者は2つの補完的なモデルを使用して音声通話をプログラムで管理することができます：

  • ひとつは アプリケーションによって開始されるREST APIコールまたはSDKを使用する。
  • もうひとつは Vonageからお客様のアプリケーションに要求されます。を使用している。 ウェブフック そして エヌシーシーオー (Nexmo Call Control Object - Nexmoは現在Vonageである）の説明を参照してください。

この2つのアプローチは、シンプルな通知から高度なコンタクトセンターフローやAI統合まで、様々なコールフローやプログラム可能な音声ユースケースを実装するための柔軟なコールハンドリングをサポートします。

さらに、Vonage Voice APIでは以下のことが可能です：

  • すでに使用しているウェブ技術で拡張性のあるアプリを構築。
  • NCCOでインバウンドコールとアウトバウンドコールのフローをJSONでコントロール。
  • インバウンドまたはアウトバウンドコールの録音と保存。
  • 電話会議の開催
  • 性別やアクセントの異なる40言語で音声合成メッセージを送信。

内容

この文書では、以下について学ぶことができる：

はじめに

Vonage Voice API を使用するために必要なすべての手順については、Vonage Voice API を使用するために必要なすべての手順を参照してください。 はじめに を案内する。

音声通話の開始

バックエンドアプリケーションから音声通話を開始するには、HTTPエンドポイントを使用します：

POST /calls

このメソッドは、電話番号またはSIPエンドポイントへのアウトバウンドコールを開始する。HTTP 経由で直接使用することも、任意の VonageサーバーSDK.

参照 電話をかける のコード・スニペットで、アウトバウンド・コールの開始について詳しく学ぶことができます。

通話が接続されると、VonageはWebhookまたは静的URLから（NCCOの形で）指示を要求し、通話をどのように進めるべきかを決定します。

NCCOとの通話指示

アン エヌシーシーオー (Nexmo Call Control Object）はJSONベースの構造体で、通話中に何が起こるかを定義します。通話がつながったときに、Vonageのウェブフック・リクエストに応答してこのオブジェクトを返します。

一般的なNCCOの行動には以下が含まれる：

  • talk - テキストを音声に変換し、通話相手に聞かせる
  • stream - オーディオファイルを再生する
  • record - 通話音声を録音する
  • connect - 他の参加者を会話に参加させる

NCCOコマンドの全リストは NCCOリファレンス.

アクティブコールの制御

通話が開始されると、REST APIエンドポイントを使用して、通話を動的に制御することもできる：

  • PUT /calls/{uuid} - 通話ステータスの更新（切断、転送、ミュートなど）
  • PUT /talk そして DELETE /talk - 通話中に音声合成を開始または停止する
  • PUT /talk そして DELETE /stream - オーディオファイルのストリーミングを開始または停止する

これらのアクションにより、ユーザーのアクションとアプリケーションロジックに基づいて、コールの動作をリアルタイムで変更できます。

参照 Voice API リファレンス REST API エンドポイントの完全なリストについては、こちらをご覧ください。

報告

Reports API は、Vonage 製品全体にわたる利用状況やレポートデータを取得するための中核となる手段であり、開発者や企業が、通話記録や電話番号を含むアクティビティ、課金、取引の詳細を一貫した方法で追跡できるようにします。複数の Vonage API から取得した利用状況や課金データを、1 つの統一された形式にまとめることで、レポート作成を簡素化します。 Reports API は、以下のような幅広いユースケースで利用できます。

  • 顧客への請求 - すべてのサブアカウントに関連するトランザクションをダウンロードし、含まれている価格データを使用して顧客への請求額を決定します。
  • 請求書の照合 - 利用データと受け取った請求書を比較します。
  • モニタリングと分析 - リアルタイムのCDRデータをビジネスインテリジェンスや分析システムに追加し、他のイベントと関連付けます。
  • キャンペーン管理 - セルフサービスツールを利用して、キャンペーンの成果を監視します。
  • デバッグ - 最大13ヶ月分の詳細な使用データを調査することで、問題のトラブルシューティングを行います。

参照 レポート API ドキュメント ガイド、コードスニペット、ベストプラクティス、料金など、詳細についてはこちらをご覧ください。

さらに読む