※本記事はビデオトークAPIをご利用されているお客様向けの内容となっております。
本記事ではビデオ通話環境の大型アップデートに向けた、新環境と現環境の並行運用期間（2025年11月14日～2026年4月20日）において、ビデオトークAPIの動作確認手順を解説します。
|
【重要】ビデオ通話環境の大型アップデートについて ビデオトークでは2026年4月20日（月）をもちまして従来の通信基盤によるビデオ通話の提供を終了し、新たな通信基盤によるビデオ通話の提供を開始いたします。 これに伴い、2026年4月21日（火）以降、現環境のビデオトークAPIのURLパスがご利用いただけなくなります。 お客様が支障なく新環境へ移行ができるように、現在提供しているビデオ通話環境と新環境の並行運用期間を設けさせていただきます。 現環境の運用終了前に、新環境でのご利用確認をお願いします。 |
新環境の利用方法
新環境をご利用いただくには、新環境向けのAPIのURLを使用する必要があります。
新環境APIのURLパスは現環境APIのURLパスに「/v2」が追加されております。
また、リクエスト/レスポンスのbodyの内容は新環境と現環境で差異はありません
| 現環境API | 新環境API | |
| URLパス | https://vtalk.karaden.jp/api/XXXXX | https://vtalk.karaden.jp/api/v2/XXXXX |
| APIリクエストサンプル | curl -d "Token=xxxxx&SecurityCode=yyyyy&UserID=zzzz@aaa.bbb" https://vtalk.karaden.jp/api/roomopen | curl -d "Token=xxxxx&SecurityCode=yyyyy&UserID=zzzz@aaa.bbb" https://vtalk.karaden.jp/api/v2/roomopen |
| 提供時期 | 提供終了日：2026年4月20日（月） | 提供開始日：2025年11月14日（金） |
動作確認手順
| 項目 | 実施概要 | 正常動作判定 | |
| 1 | 新環境APIの動作確認 | ご利用されているAPIを新環境のURLパスでAPIを実行します | 適切なレスポンスが届くこと |
| 2 | ビデオ通話の実施 | 作成したトークルームでビデオ通話を実施します | ビデオ通話ができること |
手順1. APIによる新環境トークルームの作成
- お客様がビデオトークAPIをご利用いただいている環境にて、新環境APIを用いてトークルームを作成するリクエストを実行してください。
- 返ってきたレスポンスの内容をご確認ください。
| 成功 |
| ・実行したAPIに対して正常にレスポンスが届くこと ⇒レスポンスのbody内のAPIステータスコード(status)が"100"となれば成功です。（下記APIリクエストサンプル成功時を参照） |
APIリクエストサンプル成功時のレスポンス
| {"Status":"100","RoomId":"xxxxxxxxxxxxxxxx","OperateURL":"https://vtalk.karaden.jp/yyyyyyyyyyyyyyyyyy?openExternalBrowser=1","UserURL":"https://vtalk.karaden.jp/zzzzzzzzzzzzzzzzzzz?openExternalBrowser=1"} |
また、想定される失敗例として下記の事象が想定されます。ご利用環境や設定のご確認をお願いいたします。
| 失敗例 | ご確認いただきたいポイント |
| レスポンスのbody内のAPIステータスコード(status)が"201"の場合（下記APIリクエストサンプル失敗時を参照） | リクエスト中のアクセスキーやリクエストの値に誤りがあります。 |
| HTTP のプロトコル処理で失敗(HTTP ステータスコードが、4xx/5xx 等、200 OK 以外)の場合 | URL等、送信されたリクエストに誤りがないかご確認ください。 |
APIリクエストサンプル失敗時のレスポンス
| {"Status":"201"} |
手順2. ビデオ通話の成否判定
作成したトークルームに入室していただき、実際に新環境を利用しているか、新環境で問題なくビデオ通話ができているかをお客様ご自身でご確認をお願いいたします。
新環境のご利用に成功している判断基準として、下記2点がどちらも満たされていることをご確認ください。
| 成功 |
|
・ツールバーやアイコンが緑色であること（下図左側参照） ・作成したトークルームでビデオ通話を開始し、問題なく通話や各種機能がご利用できること |
※ツールバーやアイコンの色は新環境と現環境を区別するため新環境では緑色に設定しています。これは並行運用期間中のみの変更となりますので、2026年4月以降は新環境でもツールバーやアイコンは青色となります。
また、想定される失敗例として下記の事象が想定されます。ご利用環境や設定のご確認をお願いいたします。
| 失敗例 | ご確認いただきたいポイント |
| 通話画面のツールバーやアイコンが青い（上図右側参照） | 現環境でのビデオ通話となっております。トークルームを作成したAPIのURLをご確認ください。 |
| ビデオ通話が開始されない、トークルームに入室できない |
ご利用ネットワークにてセキュリティ設定によるアクセス制限がされていないかご確認ください。 新環境でのビデオ通話通信要件はこちらをご確認ください。 |
| 映像音声が届かない | 通信環境の良い場所で再度お試しください。改善しない場合はご利用のネットワーク環境の設定をご確認ください。 |
もし何度お試しいただいても改善しない場合は、新環境向けの「動作環境チェック」を実施していただき、弊社までお問い合わせください。
■新環境向けの動作環境チェックサイト
https://vtalk.karaden.jp/check_new
■本件のお問い合わせ先
NTTドコモビジネスX株式会社
コミュニケーション・プラットフォームサービス部 ビデオトークサポート担当
https://vt-support.karaden.jp/hc/ja/requests/new