ポスト・コール・トランスクリプション

価格

要約の有無にかかわらず、テープ起こしの料金は、参加者の人数にかかわらず、1分あたり0.04510ドル／0.04100ユーロです。個別のアーカイブ料金のみが適用されます。

機能概要

通話後の書き起こしは、記録管理の改善、顧客サービスの向上、生産性の向上、より良いデータ分析に役立ちます。Vonage Video APIサーバーは、人工知能やその他の最先端技術を使用して、通話後の書き起こしを生成します。

REST APIを使用してアーカイブを開始するときに、トランスクリプションを有効にします。

アーカイブ録画が完了すると、テープ起こしがJSONファイルとして利用できるようになります。

アーカイブの開始時に転写を有効にする

Vonage Video REST API を使用してアーカイブを開始する場合は、次のように設定します。 hasAudio そして hasTranscription プロパティ true を、start archive REST メソッドに送信した JSON プロパティに追加します：

また、オプションで transcriptionProperties オブジェクトに hasSummary (ブール）または primaryLanguageCode (String)プロパティを使用します。設定時 hasSummary をtrueに設定すると、AIが作成した要約が書き起こしに含まれます。falseまたはmissに設定すると（デフォルト値は false) の場合、書き起こしの要約は含まれません。トランスクリプションが "en-US"(デフォルト)以外の言語である場合、プロパティ primaryLanguageCode を持つ。 対応言語コード.

セット outputMode (POSTデータ内）を "individual".トランスクリプションは 個別ストリーム・アーカイブ だけである。

の値を設定する。 application_id をアプリケーションIDに設定します。の値を設定します。 json_web_token をJSONウェブトークンに変換します ( REST API 認証 文書）。

その他のアーカイブオプションについては アーカイブRESTメソッドの開始.

start archive REST メソッドの呼び出しに対するレスポンスには以下が含まれます。 hasTranscription そして transcription プロパティは、レスポンスの他の文書化されたプロパティに追加される：

{
  "createdAt" : 1384221730555,
  "duration" : 0,
  "hasAudio" : true,
  "hasVideo" : true,
  "id" : "b40ef09b-3811-4726-b508-e41a0f96c68f",
  "name" : "The archive name you supplied",
  "outputMode" : "individual",
  "applicationId" : "12345abc",
  "reason" : "",
  "resolution" : "640x480",
  "sessionId" : "flR1ZSBPY3QgMjkgMTI6MTM6MjMgUERUIDIwMTN",
  "size" : 0,
  "status" : "started",
  "streamMode" : "auto",
  "hasTranscription" : true,
  "transcription" : {
    "hasSummary": true,
    "primaryLanguageCode": "ja-JP",
    "reason": "",
    "status": "requested",
    "url": ""
  }
}

参照 転写ステータスの取得 を参照してください。

において 自動的にアーカイブされたセッションこの場合、テープ起こしは自動的に開始されません。2番目のアーカイブを開始する必要があります。 multiArchiveTag オプションで、転写のために 同時アーカイブ).

トランスクリプションのサポートは現在、Vonage Video REST APIで利用可能で、Vonage Server SDKsを通じて有効化および管理できます。

転写ステータスの取得

のRESTメソッドのレスポンスは、以下のようになる。 リスト・アーカイブ そして アーカイブ情報の検索 が含まれる。 hasTranscription そして transcription プロパティー

{
    "id" : "b40ef09b-3811-4726-b508-e41a0f96c68f",
    "event": "archive",
    "createdAt" : 1723584124,
    "duration" : 328,
    "name" : "the archive name",
    "partnerId" : "123456abc",
    "reason" : "",
    "sessionId" : "2_MX40NzIwMzJ-flR1ZSBPERUIDIwMTN-MC45NDQ2MzE2NH4",
    "size" : 18023312,
    "status" : "uploaded",
    "hasTranscription" : true,
    "transcription": {
      "status": "available",
      "url": "URL for downloading the transcription, if available",
      "reason": "The reason for failure, if status is set to failed",
      "hasSummary": true,
      "primaryLanguageCode": "The configured language code"
    }
}

について hasTranscription プロパティはブール値で、アーカイブでトランスクリプションが有効になっているかどうかを示します。

について transcription プロパティは、以下のプロパティを持つオブジェクトである：

• status (String) - 転写のステータスで、以下のいずれかに設定できる：

  • "requested" - について hasTranscription プロパティが true アーカイブの開始コール中に、トランスクリプションが開始されていない。
  • "failed" - 転写に失敗しました。を確認してください。 reason プロパティをご覧ください。
  • "started" - テープ起こしは進行中だ。
  • "available" - テープ起こしはVonageからダウンロードできます。をチェックしてください。 url 財産である。
  • "uploaded" - 書き起こしは、Video API アカウントで指定した S3 バケットまたは Azure コンテナからダウンロードできます。アーカイブ ストレージ ターゲットのアーカイブ ID フォルダで transcription.zip を探してください。以下を参照してください。 アーカイブ・ストレージ.

• url (String) - 転写ファイルをダウンロードするための URL。 status に設定されている。 "available".

• reason (String) - 転写に失敗した理由。 status に設定されている。 "failed".

• hasSummary (Boolean) - AIが作成した要約を書き起こしに含めるかどうかを示す。

• primaryLanguageCode (String) - 転写用に設定された言語コード。

に対してアーカイブステータスのコールバックを設定することもできます。 Video APIアカウント.参照 アーカイブステータスの変更.コールバックデータには hasTranscription そして transcription の特性を持つ。

転写形式

トランスクリプションは圧縮されたZIPファイルとして提供される。非圧縮ファイルはJSONデータを含むテキストファイルです。

トランスクリプションには、テキストの個々のセグメントが含まれる。各セグメントは、個々のオーディオチャンネル（セッションのオーディオストリームの1つ）に対応しています。

JSONは以下のトップレベルのプロパティを持つ：

• job_id - トランスクリプションのユニークなID。

• timestamp - 転写ファイルが作成されたISO 8601の日付文字列。

• number_of_channels - トランスクリプションに含まれる、アーカイブ内の個々のオーディオチャンネルの数。

• reliability - 1つのプロパティを持つオブジェクト： score.その score は、転写の総合的な信頼性の推定値を示す数値である（0～1.0）。

• summary - を設定した場合 hasSummary プロパティの transcriptionProperties 対象 true アーカイブを開始すると、このプロパティが含まれます。AIが生成した書き起こしの要約が設定される。

• confidence - 2つのプロパティを持つオブジェクト： overall そして channels.その overall プロパティは転写全体の推定信頼度（0～1.0）である。この channels プロパティは、転写における各チャンネルの推定信頼度を列挙した配列である。

• channels_metadata - 各オーディオチャンネルを定義するオブジェクトの配列。各オブジェクトは id プロパティは、ビデオ・ストリームIDである。接続データを識別するために クライアントトークンの作成 を各ユーザに各ユーザーは セッション監視コールバック を使用して、各ストリームの接続のストリームIDと接続データを取得する。そして、これらを使って、ストリームのユーザーをトランスクリプションで特定することができる。

• segments - トランスクリプトの個々のセグメントを含むオブジェクト。各セグメントオブジェクトには、以下のプロパティがあります：

  • text - セグメントの書き起こしテキスト。

  • formatted - セグメントのフォーマットされたテキスト（句読点付き）。

  • confidence - 0から1.0までの数値で、セグメントの転写の推定信頼度を表す。

  • channel - セグメントのオーディオチャンネルを示す整数。

• raw_data - トランスクリプションセグメント内の各単語の配列オブジェクト。各オブジェクトには、以下のプロパティが含まれます：

  • word - という言葉だ。

  • confidence - 0から1.0までの数値で、転写された単語の推定信頼度を表す。

  • start_ms - 書き起こし開始位置からの単語開始位置のオフセット（ミリ秒単位）。

  • end_ms - 書き起こし開始位置からの単語終了位置のオフセット（ミリ秒単位）。

トランスクリプションのダウンロード

アーカイブのトランスクリプションファイルをダウンロードするには、REST API経由とDeveloper Dashboard経由の2つの方法があります。

REST APIによるダウンロード

を呼び出すことで、特定のアーカイブのトランスクリプションファイルをダウンロードすることができます。 アーカイブ情報を取得する REST メソッド をチェックする。 transcription.url プロパティを指定する。もし transcription.status プロパティが "available" または "uploaded"その transcription.url プロパティには、転写ファイルをダウンロードするための URL が含まれます。

HTTPのGETリクエストを使って、URLから転写ファイルをダウンロードする。例えば

開発者ダッシュボードからダウンロード

をクリックすると、特定の通話のトランスクリプションをダウンロードできます。 フォールバックストレージ オプションは、以下の手順で有効にした：

1. 開発者ダッシュボードを開き、次の場所に移動する。 ビデオログ.
2. アプリケーションリストからアプリケーションを選択し 探索.オプション 録音ID または セッションID で結果を絞り込む。
3. 結果リストで、該当するセッションを探す。
4. マウスを ステータス そのセッションの 書き起こしダウンロード ボタンをクリックする。

制限/既知の問題

• トランスクリプションは、個々のストリーム・アーカイブに対してのみ利用可能で、構成されたアーカイブに対しては利用できません。

• トランスクリプションは暗号化されたアーカイブとは互換性がありません。

• この機能は現在 Vonage Video REST API でサポートされており、Vonage Video サーバ SDK ではサポートされていません。

• テープ起こしの最長時間は120分です。

• ポストコール・トランスクリプションは、すべてに完全に準拠しているわけではない。 地域メディアゾーン (下記参照）。

よくある質問

• 1つのセッションから何本のストリームを分析できますか？
  • 最大50ストリーム、最大120分。
• ポストコール・トランスクリプションは、ルーティング・セッションとリレー・セッションの両方で機能しますか？
  • ポストコール・トランスクリプション機能は、Vonage Mediaサーバを使用するRoutedセッションを対象としています。
• 顧客が設定したS3バケットへのトランスクリプションのアップロードが失敗した場合、リトライまたはフォールバックのメカニズムはアーカイブのアップロードと同様に機能しますか？
  • はい、PCTの再試行メカニズムは、通常のアーカイブアップロードとまったく同じように動作します。
• トランスクリプションがフォールバックされ、Vonageクラウドにアップロードされる場合、トランスクリプションのダウンロードリンクを取得するためにHTTP GETリクエストを使用する必要がありますか？
  • トランスクリプションのステータスが変更されると、顧客はダウンロードURLを含むコールバックを受け取る必要があります。コールバックが登録されていない場合、ダウンロードリンクはHTTP GETリクエストでのみ取得できます。
• トランスクリプションのダウンロードリンクを受信すると、直接ダウンロードすることができます。テープ起こしのダウンロードに認証を導入する予定はありますか？
  • リンクに認証を導入する予定はない。ダウンロードリンクには短い有効期限があります。その期間内にアクセスされなかった場合は、新しいリンクを取得するために新たなリクエストを行う必要があります。
• 複数のユーザーがセッションに参加しているにもかかわらず、トランスクリプションファイルは1つのJSONファイルです。どのようにユーザーを区別するのでしょうか？
  • ファイル内の各トランスクリプション・エントリーは、各ストリームに割り当てられた特定のチャンネル番号に関連付けられている。ファイルには以下も含まれる。 channels_metadata各チャンネルIDに対応するストリームID情報を提供する。

対応言語