- Add support for the Vonage Number Verification API
- Add support for the Vonage Sim Swap API
- Add publisher-only as a valid Video API client token role
- Fix content-type incorrect serialization
- Migrating to use Pydantic v2 as a dependency
- Add support for the Vonage Video API
- Add checks for silent auth workflow optional parameters
redirect_url
andsandbox
- Add method to check JWT signatures of Voice API webhooks:
vonage.Voice.verify_signature
- Indicating support for Python 3.12
- Updating Meetings API url to a
/v1
endpoint
- Dropped support for Python 3.7 as it's end-of-life and no longer receiving security updates
- Adding support for the Users component of the Vonage Application API
- Fixing dependency version to a specific major version
- Adding support for the Vonage Meetings API
- Adding partial support for the Vonage Proactive Connect API - supporting API methods relating to
lists
,items
andevents
- Returning a more descriptive (non-internal) error message if invalid values are provided for
application_id
and/orprivate_key
when instantiating a Vonage client object
- Adding support for the Vonage Subaccounts API
- Using the Vonage JWT Generator instead of
PyJWT
for generating JWTs. - Other internal refactoring and enhancements
- Updating the internal use of the
fraud_check
parameter in the Vonage Verify V2 API
- Adding support for V2 of the Vonage Verify API
- Multiple authentication channels are supported (sms, voice, email, whatsapp, whatsapp interactive messages and silent authentication)
- Using fallback channels is now possible in case verification methods fail
- You can now customise the verification code that is sent, or even specify your own custom code
- Adding
advancedMachineDetection
functionality to the NCCO builder for the Vonage Voice API
- Internal refactoring changes
- Using header authentication for the Numbers API
- Updated Messages API:
- Added new messaging channels for Viber Service Messages (
video
,file
) - Added new WhatsApp
sticker
message channel - Increased
client_ref
max value to 100 characters
- Added new messaging channels for Viber Service Messages (
- Deprecated
pay
action in the NCCO builder as it is being removed by Vonage
- Fixing a bug on Windows
- Fixing an import bug
- Adding an NCCO Builder to make it easier to work with NCCOs when using the Voice API
- Individual NCCO Actions can be created as Pydantic models, which can be built into an NCCO via the
Ncco.build_ncco
method
- Supporting Python 3.11
- Upgrading some old dependencies
- Bugfix in
messages.py
where authentication method was not being checked for correctly, throwing an error when using header auth.
- Fixed bug where a JWT was created globally and could expire. Now a new JWT is generated when a request is made.
- Fixed bug where timeout was not passed to session object.
Breaking changes:
- Removed deprecated methods from
client.py
that are now available in specific modules related to each of the available Vonage APIs. E.g. to call the number insight API, the methods are now called in this way:client.number_insight.get_basic_number_insight(...)
, or by instantiating theNumberInsight
class directly:ni = vonage.NumberInsight(client)
,ni.get_basic_number_insight(...)
etc. - Removed automatic client creation when instantiating an
sms
,voice
orverify
object. You can now use these APIs from a client instance you create (e.g.client.sms.send_message()
) or pass in a client to the API class to create it (e.g.sms = vonage.Sms(client)
), as has been the case since v2.7.0 of the SDK. - Removed methods to call the Message Search API, which has been retired by Vonage.
- Removed deprecated voice and number insight methods from
voice.py
(initiate_call, initiate_tts_call and initiate_tts_prompt_call
) andnumber_insight.py
(request_number_insight
). - Renamed the
Account.delete_secret()
method torevoke_secret()
to bring it in line with what is described in our documentation.
Deprecations:
- Deprecated the ApplicationV2 class and created an Application class with the same methods to bring the naming in line with other classes. This can be called from the client object with
client.application.create_application(...)
etc. or directly withapplication = vonage.Application(client)
,application.create_application(...)
etc. - Deprecated old Pricing API methods
get_sms_pricing
andget_voice_pricing
. - Deprecated Redact class as it's a dev preview product that's unsupported in the SDK and will be removed in a later release.
Enhancements:
- Added
get_all_countries_pricing
method toAccount
object. - Added a
type
parameter for pricing calls, sosms
orvoice
pricing can now be chosen. - Added
max_retries
,timeout
,pool_connections
andpool_maxsize
optional keyword arguments to theClient
class, which can now be specified on instantiation and used in the API calls made with the client.
- Added Messages API v1.0 support. Messages API can now be used by calling the
client.messages.send_message()
method.
- Moved some client methods into their own classes:
account.py, application.py, message_search.py, number_insight.py, numbers.py, short_codes.py, ussd.py
- Deprecated the corresponding client methods. These will be removed in a major release that's coming soon.
- Client now instantiates a class object for each API when it is created, e.g.
vonage.Client(key="mykey", secret="mysecret")
instantiates instances ofAccount
,Sms
,NumberInsight
etc. These instances can now be called directly fromClient
, e.g.
client = vonage.Client(key="mykey", secret="mysecret")
print(f"Account balance is: {client.account.get_balance()}")
print("Sending an SMS")
client.sms.send_message(
"from": "Vonage",
"to": "SOME_PHONE_NUMBER",
"text": "Hello from Vonage's SMS API"
)
- Dropped support for Python 3.6 and below
- Now supporting currently supported stable versions of Python, i.e. Python 3.7-3.10
- Internal refactoring and enhancements
- Adding default
max_retries
option to theBasicAuthenticationServer
constructor, specifying optional parameters
- Support for Independent SMS, Voice and Verify APIs with tests as well as current client methods
- Getters/Setters to extract/rewrite custom attributes
- PSD2 Verification support
- Dropping support for Python 2.7
- Roadmap to better error handling
- Supporting Python 3.8
- Application V2 API added under
Client.application_v2
- Existing application methods under
Client
are now deprecated.
- Explicit parameter list for the
nexmo.Client
constructor. This may cause errors in code passing incorrect or spurious arguments to the Client constructor. - Secret Management
- Support for Authorization header authentication.
- Add support for
redact_transaction
.
- Add support for
get_recording
- Add support for SMS conversion
- Add debug logging for most calls, under the 'nexmo' logger.
- Internal refactoring (affects only private methods.)
- Drop support for Python 3.3 (in line with the cryptography library we depend upon)
- Ensure timestamp is added the params list if signing requests
- Avoid value injection in signature auth.
- Add support for different hashes for signature generation (thanks @trancee!)
- Tests ported to pytest
-
Add ability to provide a file path as private_key param no the nexmo.Client constructor
-
Add send/stop endpoints for audio/speech/dtmf
-
Add new number insight endpoints
-
Add new Voice API call methods
-
Add Application API methods
-
Add check_signature method for checking callback signatures
-
Deprecate old Verify API methods
-
Add get_sms_pricing method
-
Add get_voice_pricing method
-
Add get_event_alert_numbers method to get opt-in/opt-out numbers
-
Add resubscribe_event_alert_number method to opt-in a number
-
Add more clearly named methods for Verify API
-
Add app_name and app_version options
-
Add topup method
-
Add update_settings method
-
Add api_host attribute
-
Add ClientError and ServerError classes
-
Move repository to https://github.com/nexmo/nexmo-python
-
Add get_basic_number_insight method for Number Insight Basic API
-
Add get_number_insight method for Number Insight Standard API
-
Add User-Agent header to requests
- Change license from LGPL-3.0 to MIT
- Remove merge helper function
- Python 3.x fixes
- First version!