Vonage Java SDK

参照 CHANGELOG.md GitHub 変更点の詳細については


9.3.1(2025年5月8日)

GitHub Maven Central

  • カスタムHTTPリクエストにおける不明なレスポンス・タイプの取り扱いが改善されました。

9.3.0 (2025年5月7日)

GitHub Maven Central

  • Messages APIにネイティブフェイルオーバーのサポートを追加

9.2.0 (2025/04/30)

GitHub Maven Central

  • によるカスタムHTTPリクエストヘッダのサポートを追加しました。 httpConfig

9.1.0 (2025/04/22)

GitHub Maven Central

  • 追加 CustomClient 自動化された(デ)シリアライゼーションと認証で、あらゆるVonage APIへのHTTPリクエストを可能にします。

9.0.0 (2025年4月8日)

GitHub Maven Central

  • 非推奨の削除(クラス、メソッド、コンストラクター、パッケージなど)
  • 古い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.SortOrder
    • com.vonage.client.messages.MessageType の代わりに com.vonage.client.common.MessageType 列挙
  • Number Insight APIをリファクタリングし、Advanced asynchronous insightsを適切にサポート。
  • リファクタリング CallInfoPage Voice 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> の代わりに ListNumbersResponse
  • linkNumber Numbers APIのメソッドは、IDによってアプリケーションに番号を割り当てる。

8.20.1 (2025/03/20)

GitHub Maven Central

  • 削除 brand Verify v2送信リクエストの長さ検証制限

8.20.0 (2025/03/19)

GitHub Maven Central

  • のサポートを追加した。 quantizationParameter in Video API アーカイブ
  • Conversation APIにおけるカスタムイベントの作成と解析が修正されました。
  • Conversation APIに読み取り専用イベントタイプのデータモデルを追加した。

8.19.0 (2025/03/12)

GitHub Maven Central

  • Conversation APIにTalkとStreamエンドポイントを実装。
  • Conversation APIに不足していたほとんどの読み取り専用イベントタイプのデータモデルを追加。

8.18.0 (2025年3月5日)

GitHub Maven Central

  • MMSテキスト、ファイル、マルチメディア・コンテンツ・メッセージのサポートを追加

8.17.0(2025年2月28日)

GitHub Maven Central

  • 追加 domain そして user パラメータをSIPコネクトNCCOアクションに
  • すべてのリクエストおよびレスポンス・パラメータに関する Voice API ドキュメントの更新と追加
  • リクエストパラメータビルダーの改善とレガシーメソッドシグネチャの廃止
  • Numbers Insight API認証でクエリパラメータではなくヘッダを使用するようにリファクタリング

8.16.2(2025年2月5日)

GitHub Maven Central

  • 追加 disconnected_by への EventWebhook in Voice API
  • Voice API のアンサーウェブフックコール ID のデシリアライズを修正しました。
  • 改善された com.vonage.client.voice.Call ドキュメンテーション

8.16.1(2025年2月4日)

GitHub Maven Central

  • メイド from Conversation API イベント作成時のパラメータは任意です。
  • 通話録音ダウンロードのURLドメイン検証を再導入
  • JWTライブラリのバージョンを更新

8.16.0 (2025年1月31日)

GitHub Maven Central

  • HTTPリクエストとレスポンスにきめ細かなロギングを追加
  • SMS API ドキュメントの改善
  • 非推奨不正検知 / Number Insight v2 API
  • 非推奨 real_time_data アドバンスド・ナンバー・インサイトのリクエストで

8.15.1(2024年12月19日)

GitHub Maven Central

  • 通話録音をダウンロードしようとした際のURLドメイン検証を削除

8.15.0 (2024年12月3日)

GitHub Maven Central

  • HTTPプロキシのサポートを追加
  • SMS API認証でクエリパラメータの代わりにヘッダを使用するようにリファクタリング。
  • ジャクソンのバージョンを2.18.2に更新

8.14.0 (2024年11月14日)

GitHub Maven Central

  • 追加 maxBitrate ビデオアーカイブ
  • HTTP接続応答の処理の改善

8.13.0(2024年10月28日)

GitHub Maven Central

  • Verifyカスタムテンプレートのサポート追加

8.12.0(2024年10月21日)

GitHub Maven Central

  • 追加 network_apis アプリケーションAPIへのケイパビリティ
  • Voice APIに非同期DTMF入力モードとリスナーエンドポイントを追加
  • Voice APIにおけるInput NCCOアクションの検証および文書化の改善
  • 追加 endpoint_type をVoice APIのAnswer webhookに追加する。
  • 追加 leg_persistence_time 声と signed_callbacks Rtcアプリケーション機能へ
  • 欠落の追加 name Video APIにおけるエクスペリエンス・コンポーザーのプロパティ
  • 欠落の追加 app_id Numbers APIにおける所有番号のプロパティ
  • ビデオセッションの作成にエンドツーエンドの暗号化を追加
  • WhatsApp LocationとViber Videoメッセージのシリアライズを修正しました。

8.11.0(2024年9月25日)

GitHub Maven Central

  • カスタムのユーザーエージェント文字列を追加する機能
  • Messages API アップデート
    • RCSチャンネルを追加
    • WhatsApp ボタン受信メッセージタイプの追加
    • に新しいプロパティを追加した。 InboundMessage
    • メッセージの更新」エンドポイントの追加(メッセージの取り消しと確認用)

8.10.0 (2024年8月2日)

GitHub Maven Central

  • Numbers API の改善:
    • 不足していたフィールドとドキュメントを追加
    • ビルダーと非推奨セッターの追加
  • 固定 state Nullの場合、Number Verificationの認証URLに含まれる。
  • 非推奨 Meetings API

8.9.4(2024年7月25日)

GitHub Maven Central

  • のUUIDバリデーションを削除しました。 canSpeak そして canHearConversationAction
  • での追加入力検証 ConnectAction
  • にビルダーを追加した。 DtmfSettings

8.9.3(2024年7月23日)

GitHub Maven Central

  • アクセス不能を修正 GenericEvent Conversation APIのボディ
  • バンプ commons-codec バージョンを1.17.1に変更

8.9.2(2024年7月12日)

GitHub Maven Central

  • バンプ com.vonage:jwt バージョンを2.0.0に変更(依存関係のフットプリントを削減)
  • メイド timestamp Conversion API のオプションです。
  • checkVerificationCode Verify (v2) はレスポンスボディを返す。
  • 音声読み上げ設定のネパール語コードを修正
  • 自動的に設定される random_from_number 音声通話で from は不定
  • 音声イベントのウェブフック解析に関する問題を修正

8.9.1(2024年7月9日)

GitHub Maven Central

  • 固定 listEvents in Conversation API
  • バンプ com.vonage:jwt バージョンを1.1.3に

8.9.0(2024年6月20日)

GitHub Maven Central

  • Numbers Verification APIに対応しました。
  • Voice Connect SIPエンドポイントにUser-to-Userヘッダを追加
  • に不足していたカスタムヘッダーフィールドを追加した。 SipEndpoint
  • Verify v2チャンネルのタイムアウトの最小値を15秒に短縮

8.8.1(2024年5月30日)

GitHub Maven Central

  • SIMスワップAPIの追加
  • リファクタリングされた認証メソッド

8.7.0(2024年5月16日)

GitHub Maven Central

  • Voice APIに音声合成用の言語を追加
  • 送信MMSメッセージに有効期限フィールドを追加
  • Whatsapp送信リクエストにメッセージ返信コンテキストを追加
  • 受信SMSおよびMMSメッセージに発信元ネットワークコードを追加

8.6.0(2024年4月18日)

GitHub Maven Central

  • Video APIにExperience Composerを追加
  • Application APIにVerify機能を追加。
  • の回帰を修正した。 createSession Video APIエンドポイント
  • muteSession Video API のエンドポイントが返すようになりました。 ProjectDetails

8.5.0 (2024年4月12日)

GitHub Maven Central

  • Video APIにAudio ConnectorとLive Captionsエンドポイントを追加
  • 追加 publisheronly Video APIにおけるトークン生成の役割
  • Verify v2 APIにNext Workflowエンドポイントを追加
  • Verify v2 APIにおけるリクエスト検証ロジックの更新
  • 未使用のものを削除 com.vonage.client.sms.HexUtil クラス
  • ジャクソンのグローバル・デフォルト設定 ObjectMapper SDKのすべてのドメインオブジェクトで使用される

8.4.0 (2024年4月5日)

GitHub Maven Central

  • Conversation APIの追加
  • バンプ com.vonage:jwt バージョンを1.1.1に変更

8.3.0 (2024年2月12日)

GitHub Maven Central

  • 送信者fromVerify v2のWhatsAppワークフローでは、このパラメータが必須になりました。
  • SMSの改善 MessageEvent

8.2.0(2024年1月29日)

GitHub Maven Central

  • Numbers Insight v2 APIを追加しました。
  • 実施済み toString, equals そして hashCode デバッグを容易にするために、すべてのJSONオブジェクトに対して
  • Voice APIウェブフックとNCCOのリファクタリング/更新
  • SMSおよびSilent Auth Verify v2ワークフロー用のビルダーが追加されました。

8.1.0 (2024年1月4日)

GitHub Maven Central

  • SMS、WhatsApp、MMSのMessages APIに様々な新規フィールドを追加
  • オプション追加 from Verify v2 SMSワークフローのパラメータ
  • 固定 length に設定されていない。 VerifyClient.verify オーバーロード法
  • ビデオ放送のレイアウトを更新する HTTP メソッドが正しくなかった問題を修正

8.0.0 (2023年11月30日)

GitHub Maven Central

  • Mavenの座標が次のように変更された。 com.vonage:server-sdk
  • Video API (com.vonage.video パッケージ)
  • 追加 redirect_url パラメータを SilentAuthWorkflow
  • でUUIDの代わりに文字列を使用する。 VoiceClient 呼の変更方法
  • パブリック verifyRequestSignature メソッドを使用します。 RequestSigning
  • ジャクソンのバージョンを2.16.0に更新
  • 非推奨クラスとメソッドの削除
    • 電話でのお支払い NCCO
    • WAPPush SMSメッセージの種類
    • 依存度 jakarta.servlet を使用するすべてのクラス/メソッド HttpServletRequest
    • 依存度 jackson-dataformat-hal (で使用されている ListSecretsResponse)
    • ip_addressAdvancedInsightRequest そして CheckRequest
    • Locale 列挙 verify2 パッケージ
    • LineTypeVerifyRequest
    • Call デフォルトのパブリックコンストラクタ
    • Voice API のセッターメソッド
    • ModifyCallResponse そして Recording クラス
    • modifyCall メソッド VoiceClient
    • legacyutils, logging そして sns パッケージ
    • へのすべての言及 snsBaseUriHttpConfig)

7.11.1(2023年11月7日)

GitHub Maven Central

  • 非推奨のレガシー・ユーティリティとSNS
  • 公開移転メタデータ

7.11.0(2023年10月31日)

GitHub Maven Central

  • VoiceおよびMessagesへの署名付きコールバックに対するJWT署名検証の追加
  • 改善された modifyCall そして downloadRecording in Voice API
  • バンプ com.vonage:jwt バージョンを1.1.0に

7.10.0(2023年10月20日)

GitHub Maven Central

  • Verify v2とMeetings APIにロケールが追加されました。
  • 追加 check_url フィールドは、同期サイレント認証の Verify レスポンスにある。
  • バンプ com.fasterxml.jackson バージョンを2.15.3に変更

7.9.0 (2023年9月28日)

GitHub Maven Central

  • にすべての国の価格を取得するエンドポイントを追加した。 AccountClient
  • で指定されていない場合、秘密管理にAccountのプライマリAPIキーを使用する。 AccountClient
  • Meetings APIエンドポイントパスにバージョン管理を追加

7.8.0 (2023年9月7日)

GitHub Maven Central

  • リクエストタイムアウトの設定機能を追加(デフォルトは60秒)
  • 非推奨のカスタムHTTPクライアント実装設定

7.7.0 (2023年8月10日)

GitHub Maven Central

  • Users API の実装を追加
  • Applications、capabilities、webhooksに不足していたフィールドを追加。
  • 削除 PageList (に置き換わる HalPageResponse)
  • Applications API ドキュメントの改善
  • の厳密なUUID検証を修正しました。 VoiceClient

7.6.0(2023年6月30日)

GitHub Maven Central

  • Meetings API実装の追加
  • リスト、アイテム、イベントのProactive Connect APIサポートを追加しました。
  • Subaccountの名前と秘密のバリデーションを更新しました。

7.5.0(2023年6月14日)

GitHub Maven Central

  • Subaccounts API実装の追加
  • Verify v1にカスタムPIN機能を追加
  • Silent AuthアクションのURLウェブフックのデシリアライズに関する問題を修正しました。

7.4.0(2023年5月18日)

GitHub Maven Central

  • インプルメンツ Verify v2 API
  • Voice APIに高度な機械検出機能を追加
  • 不正確な箇所を修正 VbcEndpoint タイプ
  • への依存を削除した。 jakarta.servlet そして jakarta.xml.bind
  • に依存するクラスとメソッドの非推奨用途 javax.servlet

7.3.0 (2023年4月14日)

GitHub Maven Central

  • 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日)

GitHub Maven Central

  • メッセージ v1:
    • 追加 InboundMessage ウェブフック・クラス
    • のタイムスタンプ形式のデシリアライズを修正しました。 MessageStatus (インスタントが返される)
    • Viberファイルおよびビデオメッセージの種類を追加
    • Viberの画像とテキストメッセージにアクションボタンを追加しました。
    • WhatsApp ステッカーメッセージタイプの追加
    • WhatsApp Locationカスタムメッセージタイプの追加
    • WhatsApp Productカスタムメッセージタイプの追加
    • client_ref 文字数制限が100文字に
    • ウェブフックに対応するため、有効なメッセージタイプを拡張(MMSテキスト、WhatsAppオーダー、返信、未サポート)
  • 非推奨ペイNCCOアクション
  • 非推奨 WAPPush ショートメール
  • 依存バージョンのバンプ

7.1.1(2022年11月16日)

GitHub Maven Central

  • バンプ com.fasterxml.jackson 依存バージョンを2.14.0に変更

7.1.0(2022年8月25日)

GitHub Maven Central

  • に便利なメソッドを追加した。 MessagesClient Messages Sandbox エンドポイントを使用する場合
  • 追加 network フィールドを VerifyResponse
  • Verify API のリクエストとレスポンスに不足していたドキュメンテーションと検証を追加しました。
  • 追加 estimated_price_messages_sent への CheckResponse そして VerifyDetails
  • 更新 VerifyStatus 列挙値
  • 固定 MessageResponseException レスポンス・ボディが空の場合のデシリアライズ
  • 不正確な箇所を修正 Content-Type ヘッダ verify そして check エンドポイント
  • 非推奨 request_typeVerifyRequest
  • 非推奨 ip_addressCheckRequest

7.0.0 (2022年8月11日)

GitHub Maven Central

  • 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.URI URIフィールドのStringの代わりに
  • API仕様と一致するようにNumber Insightを更新
    • 非推奨IPアドレス
    • 欠落の追加 InsightStatus コード
    • インサイトのレスポンス・フィールドにドキュメントを追加
    • 移動 AdvancedInsight 列挙してファイルを分ける
    • 追加 real_time_data への AdvancedInsightResponse

6.5.0 (2022/06/20)

GitHub Maven Central

  • Messages v1 API実装の追加
  • 追加 get-full-pricing エンドポイント
  • 追加 Content-Type そして Accept 該当するリクエストのヘッダ
  • 大幅な内部リファクタリング

6.4.2 (2022/04/14)

GitHub Maven Central

  • 追加 call_uuid をwebhook呼び出しイベントに追加します。
  • 依存バージョンのバンプ

6.4.0(2021年5月28日)

GitHub Maven Central

  • Voice APIにRandom From Number機能を追加。 true発信元番号は、電話をかけるアプリケーションが利用可能な番号のプールからランダムに選択されます。
  • jsonペイロードのチェックに使用される調整オペレータ。
  • アドバンスドナンバーインサイトにトップレベルのローミングステータスの解析機能を追加

6.3.0(2021年5月20日)

GitHub Maven Central

  • JSONベースのPOSTリクエストにインバウンドSMSメッセージ検証を追加する

6.2.0 (2021年3月11日)

GitHub Maven Central

  • 追加 entityId そして contentId インドのDLTコンプライアンスに関するSMSメッセージの分野
  • ディテールの追加と detailEnum フィールドをコールイベントに追加することで、コールから新たに作成された詳細を表示する切り替え可能な方法が提供される。

6.1.0 (2020年12月17日)

GitHub Maven Central

  • ボイストークアクションとトークリクエストに言語とスタイルを追加する
  • マーキング VoiceName 非推奨