Vonage Java SDK
参照 CHANGELOG.md GitHub 変更点の詳細については
9.3.1(2025年5月8日)
- カスタムHTTPリクエストにおける不明なレスポンス・タイプの取り扱いが改善されました。
9.3.0 (2025年5月7日)
- Messages APIにネイティブフェイルオーバーのサポートを追加
9.2.0 (2025/04/30)
- によるカスタムHTTPリクエストヘッダのサポートを追加しました。
httpConfig
9.1.0 (2025/04/22)
- 追加
CustomClient自動化された(デ)シリアライゼーションと認証で、あらゆるVonage APIへのHTTPリクエストを可能にします。
9.0.0 (2025年4月8日)
- 非推奨の削除(クラス、メソッド、コンストラクター、パッケージなど)
- 古いPricing APIを削除した。
com.vonage.client.account.*) - Verify v2 APIにおけるWhatsApp Interactive(コードレス)ワークフローのサポートを削除しました。
- 内部リファクタリングと不整合の整理
- レスポンス・オブジェクトにおけるより強力なデータ型/列挙型の使用
- 列挙型をリファクタリング:
- ほとんどの列挙型を内部クラスから独自のファイル/クラスに移動した。
- 標準化された列挙型の解析
- 削除
UNKNOWN実際の値ではない列挙型 - 無効な列挙型は
nullを投げる代わりにIllegalArgumentException応答データの解析を容易にする - 統一
Psd2Request.WorkflowそしてVerifyRequest.Workflow列挙(上位レベルに移動) ListUsersRequest.SortOrderのenumを使用しています。com.vonage.client.common.SortOrdercom.vonage.client.messages.MessageTypeの代わりにcom.vonage.client.common.MessageType列挙
- Number Insight APIをリファクタリングし、Advanced asynchronous insightsを適切にサポート。
- リファクタリング
CallInfoPageVoice API で他の HAL レスポンスと整合させる。 - 追加
getへの接頭辞VideoStreamそしてHlsSettingsアクセサ - Application API機能をリファクタリングし、Webhookをより宣言的に設定できるようにした。
- 追加
Application.builder(String)ゼロからIDでアプリケーションを更新するオプションとして - 簡易版
StreamCompositionLayout建設 - Verify v2 APIにコードのチェックを簡素化する便利なメソッドが追加されました。
- 名称変更
com.vonage.client.voice.EndpointへのCallEndpointそしてcom.vonage.client.voice.ncco.EndpointへのConnectEndpoint混乱を避けるために NumbersClient#listNumbersを返すようになった。List<OwnedNumber>の代わりにListNumbersResponselinkNumberNumbers APIのメソッドは、IDによってアプリケーションに番号を割り当てる。
8.20.1 (2025/03/20)
- 削除
brandVerify v2送信リクエストの長さ検証制限
8.20.0 (2025/03/19)
- のサポートを追加した。
quantizationParameterin Video API アーカイブ - Conversation APIにおけるカスタムイベントの作成と解析が修正されました。
- Conversation APIに読み取り専用イベントタイプのデータモデルを追加した。
8.19.0 (2025/03/12)
- Conversation APIにTalkとStreamエンドポイントを実装。
- Conversation APIに不足していたほとんどの読み取り専用イベントタイプのデータモデルを追加。
8.18.0 (2025年3月5日)
- MMSテキスト、ファイル、マルチメディア・コンテンツ・メッセージのサポートを追加
8.17.0(2025年2月28日)
- 追加
domainそしてuserパラメータをSIPコネクトNCCOアクションに - すべてのリクエストおよびレスポンス・パラメータに関する Voice API ドキュメントの更新と追加
- リクエストパラメータビルダーの改善とレガシーメソッドシグネチャの廃止
- Numbers Insight API認証でクエリパラメータではなくヘッダを使用するようにリファクタリング
8.16.2(2025年2月5日)
- 追加
disconnected_byへのEventWebhookin Voice API - Voice API のアンサーウェブフックコール ID のデシリアライズを修正しました。
- 改善された
com.vonage.client.voice.Callドキュメンテーション
8.16.1(2025年2月4日)
- メイド
fromConversation API イベント作成時のパラメータは任意です。 - 通話録音ダウンロードのURLドメイン検証を再導入
- JWTライブラリのバージョンを更新
8.16.0 (2025年1月31日)
- HTTPリクエストとレスポンスにきめ細かなロギングを追加
- SMS API ドキュメントの改善
- 非推奨不正検知 / Number Insight v2 API
- 非推奨
real_time_dataアドバンスド・ナンバー・インサイトのリクエストで
8.15.1(2024年12月19日)
- 通話録音をダウンロードしようとした際のURLドメイン検証を削除
8.15.0 (2024年12月3日)
- HTTPプロキシのサポートを追加
- SMS API認証でクエリパラメータの代わりにヘッダを使用するようにリファクタリング。
- ジャクソンのバージョンを2.18.2に更新
8.14.0 (2024年11月14日)
- 追加
maxBitrateビデオアーカイブ - HTTP接続応答の処理の改善
8.13.0(2024年10月28日)
- Verifyカスタムテンプレートのサポート追加
8.12.0(2024年10月21日)
- 追加
network_apisアプリケーションAPIへのケイパビリティ - Voice APIに非同期DTMF入力モードとリスナーエンドポイントを追加
- Voice APIにおけるInput NCCOアクションの検証および文書化の改善
- 追加
endpoint_typeをVoice APIのAnswer webhookに追加する。 - 追加
leg_persistence_time声とsigned_callbacksRtcアプリケーション機能へ - 欠落の追加
nameVideo APIにおけるエクスペリエンス・コンポーザーのプロパティ - 欠落の追加
app_idNumbers APIにおける所有番号のプロパティ - ビデオセッションの作成にエンドツーエンドの暗号化を追加
- WhatsApp LocationとViber Videoメッセージのシリアライズを修正しました。
8.11.0(2024年9月25日)
- カスタムのユーザーエージェント文字列を追加する機能
- Messages API アップデート
- RCSチャンネルを追加
- WhatsApp ボタン受信メッセージタイプの追加
- に新しいプロパティを追加した。
InboundMessage - メッセージの更新」エンドポイントの追加(メッセージの取り消しと確認用)
8.10.0 (2024年8月2日)
- Numbers API の改善:
- 不足していたフィールドとドキュメントを追加
- ビルダーと非推奨セッターの追加
- 固定
stateNullの場合、Number Verificationの認証URLに含まれる。 - 非推奨 Meetings API
8.9.4(2024年7月25日)
- のUUIDバリデーションを削除しました。
canSpeakそしてcanHearでConversationAction - での追加入力検証
ConnectAction - にビルダーを追加した。
DtmfSettings
8.9.3(2024年7月23日)
- アクセス不能を修正
GenericEventConversation APIのボディ - バンプ
commons-codecバージョンを1.17.1に変更
8.9.2(2024年7月12日)
- バンプ
com.vonage:jwtバージョンを2.0.0に変更(依存関係のフットプリントを削減) - メイド
timestampConversion API のオプションです。 checkVerificationCodeVerify (v2) はレスポンスボディを返す。- 音声読み上げ設定のネパール語コードを修正
- 自動的に設定される
random_from_number音声通話でfromは不定 - 音声イベントのウェブフック解析に関する問題を修正
8.9.1(2024年7月9日)
- 固定
listEventsin Conversation API - バンプ
com.vonage:jwtバージョンを1.1.3に
8.9.0(2024年6月20日)
- Numbers Verification APIに対応しました。
- Voice Connect SIPエンドポイントにUser-to-Userヘッダを追加
- に不足していたカスタムヘッダーフィールドを追加した。
SipEndpoint - Verify v2チャンネルのタイムアウトの最小値を15秒に短縮
8.8.1(2024年5月30日)
- SIMスワップAPIの追加
- リファクタリングされた認証メソッド
8.7.0(2024年5月16日)
- Voice APIに音声合成用の言語を追加
- 送信MMSメッセージに有効期限フィールドを追加
- Whatsapp送信リクエストにメッセージ返信コンテキストを追加
- 受信SMSおよびMMSメッセージに発信元ネットワークコードを追加
8.6.0(2024年4月18日)
- Video APIにExperience Composerを追加
- Application APIにVerify機能を追加。
- の回帰を修正した。
createSessionVideo APIエンドポイント muteSessionVideo API のエンドポイントが返すようになりました。ProjectDetails
8.5.0 (2024年4月12日)
- Video APIにAudio ConnectorとLive Captionsエンドポイントを追加
- 追加
publisheronlyVideo APIにおけるトークン生成の役割 - Verify v2 APIにNext Workflowエンドポイントを追加
- Verify v2 APIにおけるリクエスト検証ロジックの更新
- 未使用のものを削除
com.vonage.client.sms.HexUtilクラス - ジャクソンのグローバル・デフォルト設定
ObjectMapperSDKのすべてのドメインオブジェクトで使用される
8.4.0 (2024年4月5日)
- Conversation APIの追加
- バンプ
com.vonage:jwtバージョンを1.1.1に変更
8.3.0 (2024年2月12日)
- 送信者
fromVerify v2のWhatsAppワークフローでは、このパラメータが必須になりました。 - SMSの改善
MessageEvent
8.2.0(2024年1月29日)
- Numbers Insight v2 APIを追加しました。
- 実施済み
toString,equalsそしてhashCodeデバッグを容易にするために、すべてのJSONオブジェクトに対して - Voice APIウェブフックとNCCOのリファクタリング/更新
- SMSおよびSilent Auth Verify v2ワークフロー用のビルダーが追加されました。
8.1.0 (2024年1月4日)
- SMS、WhatsApp、MMSのMessages APIに様々な新規フィールドを追加
- オプション追加
fromVerify v2 SMSワークフローのパラメータ - 固定
lengthに設定されていない。VerifyClient.verifyオーバーロード法 - ビデオ放送のレイアウトを更新する HTTP メソッドが正しくなかった問題を修正
8.0.0 (2023年11月30日)
- Mavenの座標が次のように変更された。
com.vonage:server-sdk - Video API (
com.vonage.videoパッケージ) - 追加
redirect_urlパラメータをSilentAuthWorkflow - でUUIDの代わりに文字列を使用する。
VoiceClient呼の変更方法 - パブリック
verifyRequestSignatureメソッドを使用します。RequestSigning - ジャクソンのバージョンを2.16.0に更新
- 非推奨クラスとメソッドの削除
- 電話でのお支払い NCCO
WAPPushSMSメッセージの種類- 依存度
jakarta.servletを使用するすべてのクラス/メソッドHttpServletRequest - 依存度
jackson-dataformat-hal(で使用されているListSecretsResponse) ip_addressでAdvancedInsightRequestそしてCheckRequestLocale列挙verify2パッケージLineTypeでVerifyRequestCallデフォルトのパブリックコンストラクタ- Voice API のセッターメソッド
ModifyCallResponseそしてRecordingクラスmodifyCallメソッドVoiceClientlegacyutils,loggingそしてsnsパッケージ- へのすべての言及
snsBaseUriのHttpConfig)
7.11.1(2023年11月7日)
- 非推奨のレガシー・ユーティリティとSNS
- 公開移転メタデータ
7.11.0(2023年10月31日)
- VoiceおよびMessagesへの署名付きコールバックに対するJWT署名検証の追加
- 改善された
modifyCallそしてdownloadRecordingin Voice API - バンプ
com.vonage:jwtバージョンを1.1.0に
7.10.0(2023年10月20日)
- Verify v2とMeetings APIにロケールが追加されました。
- 追加
check_urlフィールドは、同期サイレント認証の Verify レスポンスにある。 - バンプ
com.fasterxml.jacksonバージョンを2.15.3に変更
7.9.0 (2023年9月28日)
- にすべての国の価格を取得するエンドポイントを追加した。
AccountClient - で指定されていない場合、秘密管理にAccountのプライマリAPIキーを使用する。
AccountClient - Meetings APIエンドポイントパスにバージョン管理を追加
7.8.0 (2023年9月7日)
- リクエストタイムアウトの設定機能を追加(デフォルトは60秒)
- 非推奨のカスタムHTTPクライアント実装設定
7.7.0 (2023年8月10日)
- Users API の実装を追加
- Applications、capabilities、webhooksに不足していたフィールドを追加。
- 削除
PageList(に置き換わるHalPageResponse) - Applications API ドキュメントの改善
- の厳密なUUID検証を修正しました。
VoiceClient
7.6.0(2023年6月30日)
- Meetings API実装の追加
- リスト、アイテム、イベントのProactive Connect APIサポートを追加しました。
- Subaccountの名前と秘密のバリデーションを更新しました。
7.5.0(2023年6月14日)
- Subaccounts API実装の追加
- Verify v1にカスタムPIN機能を追加
- Silent AuthアクションのURLウェブフックのデシリアライズに関する問題を修正しました。
7.4.0(2023年5月18日)
- インプルメンツ Verify v2 API
- Voice APIに高度な機械検出機能を追加
- 不正確な箇所を修正
VbcEndpointタイプ - への依存を削除した。
jakarta.servletそしてjakarta.xml.bind - に依存するクラスとメソッドの非推奨用途
javax.servlet
7.3.0 (2023年4月14日)
- Viberのビデオメッセージでは、再生時間とファイルサイズの設定が必要になりました。
- Numbers APIでは、クエリパラメータではなくヘッダでBasic認証が使用されるようになりました。
- メイド
jakarta.servlet-api必要な依存関係javax.servletとしてcompileOnly) - 用途
jakarta.xml.bind-apiの代わりにjavax.xml.bind - 追加
premiumそしてlevelトーク開始リクエストのフィールド - リファクタリング
TalkPayloadビルダーパターンを使用する - 追加
vbcそしてapp音声通話のエンドポイント・タイプ - の誤ったシリアライズを修正しました。
random_from_number - 建設用ビルダーを追加
Callリクエスト - のUUID、URL、リクエスト・オブジェクトの検証を追加した。
VoiceClient - Voice APIパッケージの内部リクエストクラスを非公開にした。
- の一般向け使用は廃止された。
CallModifer&ModifyCallPayload - Voice API のクラスのセッターを非推奨とし、ビルダー/コンストラクタを採用。
com.vonage.client.voice.WebSocketEndpointヘッダーにMapを使うようになった
7.2.0 (2023年3月8日)
- メッセージ v1:
- 追加
InboundMessageウェブフック・クラス - のタイムスタンプ形式のデシリアライズを修正しました。
MessageStatus(インスタントが返される) - Viberファイルおよびビデオメッセージの種類を追加
- Viberの画像とテキストメッセージにアクションボタンを追加しました。
- WhatsApp ステッカーメッセージタイプの追加
- WhatsApp Locationカスタムメッセージタイプの追加
- WhatsApp Productカスタムメッセージタイプの追加
client_ref文字数制限が100文字に- ウェブフックに対応するため、有効なメッセージタイプを拡張(MMSテキスト、WhatsAppオーダー、返信、未サポート)
- 追加
- 非推奨ペイNCCOアクション
- 非推奨
WAPPushショートメール - 依存バージョンのバンプ
7.1.1(2022年11月16日)
- バンプ
com.fasterxml.jackson依存バージョンを2.14.0に変更
7.1.0(2022年8月25日)
- に便利なメソッドを追加した。
MessagesClientMessages Sandbox エンドポイントを使用する場合 - 追加
networkフィールドをVerifyResponse - Verify API のリクエストとレスポンスに不足していたドキュメンテーションと検証を追加しました。
- 追加
estimated_price_messages_sentへのCheckResponseそしてVerifyDetails - 更新
VerifyStatus列挙値 - 固定
MessageResponseExceptionレスポンス・ボディが空の場合のデシリアライズ - 不正確な箇所を修正
Content-Typeヘッダverifyそしてcheckエンドポイント - 非推奨
request_typeでVerifyRequest - 非推奨
ip_addressでCheckRequest
7.0.0 (2022年8月11日)
- SMS検索APIの削除
- 非推奨 リダクトクライアント
- 用途
vonage-jwt-jdk:1.0.2ライブラリの代わりにnexmo-jwt-jdk:1.0.1 - 確保する
User-Agentはリクエストヘッダに設定される - Messages APIでSMSとMMSの送信者フィールドに英数字を許可する。
WhatsappRequest送信者はE164番号でなければならない。- の誤った制限を修正しました。
WhatsappTemplateRequest- ポリシーがオプションに
- デフォルトのロケールは
en - ロケールは文字列ではなく列挙型になりました。
parameters現在List<String>
- への依存を削除した。
commons-ioそしてcommons-lang3 - リクエストヘッダにUser-Agentが設定されていることを確認する。
- にプレミアム音声合成フラグを追加
TalkActionエヌシーシーオー - レガシーのサポートを削除
voiceNameパラメータ - SMSエラー・ステータス・コードの更新
- NCCOアクションを使用した音声決済のサポートを追加
- NCCOのクラスを更新
- アクションのデシリアライズを修正 (issue #373)
- のオブジェクト値を許可する。
WebSocketEndpointヘッダー - varargs の削除
headersメソッドWebSocketEndpoint.Builder - ビルダーのコンストラクターをパッケージ・プライベートに
- 追加
headersフィールドをSipEndpoint - 用途
java.net.URIURIフィールドのStringの代わりに
- API仕様と一致するようにNumber Insightを更新
- 非推奨IPアドレス
- 欠落の追加
InsightStatusコード - インサイトのレスポンス・フィールドにドキュメントを追加
- 移動
AdvancedInsight列挙してファイルを分ける - 追加
real_time_dataへのAdvancedInsightResponse
6.5.0 (2022/06/20)
- Messages v1 API実装の追加
- 追加
get-full-pricingエンドポイント - 追加
Content-TypeそしてAccept該当するリクエストのヘッダ - 大幅な内部リファクタリング
6.4.2 (2022/04/14)
- 追加
call_uuidをwebhook呼び出しイベントに追加します。 - 依存バージョンのバンプ
6.4.0(2021年5月28日)
- Voice APIにRandom From Number機能を追加。
true発信元番号は、電話をかけるアプリケーションが利用可能な番号のプールからランダムに選択されます。 - jsonペイロードのチェックに使用される調整オペレータ。
- アドバンスドナンバーインサイトにトップレベルのローミングステータスの解析機能を追加
6.3.0(2021年5月20日)
- JSONベースのPOSTリクエストにインバウンドSMSメッセージ検証を追加する
6.2.0 (2021年3月11日)
- 追加
entityIdそしてcontentIdインドのDLTコンプライアンスに関するSMSメッセージの分野 - ディテールの追加と
detailEnumフィールドをコールイベントに追加することで、コールから新たに作成された詳細を表示する切り替え可能な方法が提供される。
6.1.0 (2020年12月17日)
- ボイストークアクションとトークリクエストに言語とスタイルを追加する
- マーキング
VoiceName非推奨