v4.2.1

Fixed

• Fixed the product name in Redact API for messages.

v4.2.0

Added

• Missing builders for StreamAction, AdvancedInsightRequest, StandardInsightRequest, and BasicInsightRequest.

Fixed

• AbstractMethod will force UTF-8 charset for requests using StringEntity.
• Tests will now run using static builder methods for each of the classes that use builders for construction.

v4.1.0

Added

• Added static builder methods to Action classes to reduce some of the verbosity around using them. You can now do TalkAction action = TalkAction.builder("Hello World!").build(); instead of just TalkAction action = new TalkAction.Builder("Hello World).build();.
• Added static builder methods to NexmoClient to reduce some of the verbosity around instantiating the client.
• Added ncco property to the Call object for use in the VoiceClient.createCall method. You can now send an Ncco directly to the API instead of defining an answer_url.

v4.0.1

Added

• channels property to RecordAction as it was unintentionally removed during the version 4 release.

v4.0.0

Added

• Added support for Java v8
• Added Ncco class to wrap Collection<Action> and handle the serialization of NCCO json through toJson.
• Added the following Builder classes:
  • ConnectAction.Builder
  • ConversationAction.Builder
  • InputAction.Builder
  • RecordAction.Builder
  • StreamAction.Builder
  • TalkAction.Builder
• Added PhoneEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added WebSocketEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added SipEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added EventMethod enumeration to replace the usage of strings.
• Added EventType enumeration and the ability to specify the eventType property of ConnectAction.
• Added NexmoClient.Builder to allow for fluent creation of NexmoClient.
• Added getBasicNumberInsight, getStandardNumberInsight, and getAdvancedNumberInsight to InsightClient which takes a respective *InsightRequest.
• Added CallerIdentity data object to be used in number insight.
• Added Builder to CallsFilter class to make filtering search results more intuative.

Changed

• Dropped support for Java v7
• Renamed all Ncco classes to Action classes:
  • Renamed Ncco interface to Action
  • Renamed ConnectNcco to ConnectAction
  • Renamed ConversationNcco to ConversationAction
  • Renamed InputNcco to InputAction
  • Renamed RecordNcco to RecordAction
  • Renamed StreamNcco to StreamAction
  • Renamed TalkNcco to TalkAction
• All Action classes now must be constructed through the provided Builder class.
• All Action classes are now immutable.
• The eventUrl property of ConnectAction, ConversationAction, InputAction, and RecordAction is now a Collection<String> instead of an array.
• The eventMethod property of ConnectAction, ConversationAction, InputAction, and RecordAction is now an EventMethod enum instead of a String.
• Removed ConnectWebSocketNcco as it is built into ConnectAction.
• VerifyClient will now return *Response instead of *Result objects.
• Refactored com.nexmo.client.voice.endpoints to be part of the com.nexmo.client.voice package.
• Made all *Endpoint and *Method classes package scoped. Users should always go through the appropriate Client classes.
• Moved AbstractMethod to the root package.
• Removed legacy setUri methods from the various VoiceClient endpoints. This should be done through HttpConfig.
• Changed BasicInsightRequest, StandardInsightRequest, and AdvancedInsightRequest to use builders as constructor
  telescoping is clunky. Added some static factory methods to these classes to allow shortcutting through the builder for "simple" requests.
• Updated BasicInsightEndpoint, StandardInsightEndpoint, and AdvancedInsightEndpoint to a more restrictive scope and moved them to the com.nexmo.client.insight package.
• Changed status property of BasicInsightResponse to an InsightStatus enumeration.
• Changed SendMessageEndpoint from XML to JSON. It now returns a SmsSubmissionResponse instead of an array result.

v3.10.0

Added

• Added the ability to specify the number of channels to record in RecordNcco

Changed

• Update base uri to always have the version string appended to it.

v3.9.0

[3.9.0] - 2018-10-18

Added

• Added missing voices to VoiceName enum.
• Added configuration object to be used with HttpWrapper to allow for customization.
• Added the ability to customize the base URI used for the various endpoints.
• Added ConnectWebSocketNcco to handle connecting to WebSocket endpoints similar to ConnectNcco to maintain backwards compatibility.
• Added getDisplayName method to VoiceName to represent the name that is used in serialization.

Changed

• TalkNcco to use VoiceName object instead of String
• HttpWrapper now uses system properties by default.

v4.0.0-beta.1

Note: This is a snapshot of the upcoming v4.0.0 of the library. Things may change.

Added

• Added Ncco class to wrap Collection<Action> and handle the serialization of NCCO json through toJson.
• Added the following Builder classes:
  • ConnectAction.Builder
  • ConversationAction.Builder
  • InputAction.Builder
  • RecordAction.Builder
  • StreamAction.Builder
  • TalkAction.Builder
• Added PhoneEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added WebSocketEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added SipEndpoint to com.nexmo.voice.ncco package for use with ConnectAction.
• Added EventMethod enumeration to replace the usage of strings.
• Added EventType enumeration and the ability to specify the eventType property of ConnectAction.

Changed

• Renamed all Ncco classes to Action classes:
  • Renamed Ncco interface to Action
  • Renamed ConnectNcco to ConnectAction
  • Renamed ConversationNcco to ConversationAction
  • Renamed InputNcco to InputAction
  • Renamed RecordNcco to RecordAction
  • Renamed StreamNcco to StreamAction
  • Renamed TalkNcco to TalkAction
• All Action classes now must be constructed through the provided Builder class.
• All Action classes are now immutable.
• The eventUrl property of ConnectAction, ConversationAction, InputAction, and RecordAction is now a Collection<String> instead of an array.
• The eventMethod property of ConnectAction, ConversationAction, InputAction, and RecordAction is now an EventMethod enum instead of a String.

v3.8.0

Added

• Added com.nexmo.client.incoming.MessageEvent to assist with the deserialization of the JSON payload used for incoming messages.
• Added com.nexmo.client.incoming.CallEvent to assist with the deserialization of the JSON payload used for call events.
• Added com.nexmo.client.incoming.InputEvent to assist with the deserialization of the JSON payload used for input events.
• Added com.nexmo.client.incoming.RecordEvent to assist with the deserialization of the JSON payload used for record events.
• Added secret management methods to AccountClient in the form of the following methods:
  • listSecrets for listing all secrets.
  • getSecret for getting information on a specific secret.
  • revokeSecret for revoking a secret.
  • createSecret for creating a new secret.

Changed

• User Agent String now includes the Java version in addition to the client version.
• enum classes that are used to deserialize JSON have been updated to return an UNKNOWN value instead of throwing an IllegalArgumentException when the value cannot be deserialized. These enums are:
  • RecordingFormat
  • MachineDetection
  • ModifyCallAction
  • CallDirection
  • CallStatus
  • RoamingDetails.RoamingStatus
  • AdvancedInsightResponse.PortedStatus
  • AdvancedInsightResponse.Validity
  • AdvancedInsightResponse.Reachability

Fixed

• Updated StreamNcco's streamUrl to serialize into an array for use in the Voice API.

v3.7.0

Added

• Added RedactClient and the ability to interact with the Nexmo Redact API.

Changed

• TalkNcco now uses VoiceName internally instead of String for the voiceName property.