wavix-python-sdk 1.1.1__tar.gz → 1.4.0__tar.gz

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: wavix-python-sdk
-Version: 1.1.1
+Version: 1.4.0
 Summary: 
 Requires-Python: >=3.10,<4.0
 Classifier: Intended Audience :: Developers
@@ -20,9 +20,9 @@ Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Provides-Extra: aiohttp
-Requires-Dist: aiohttp (>=3.14.0,<4) ; (python_version >= "3.10") and (extra == "aiohttp")
+Requires-Dist: aiohttp (>=3.14.1,<4) ; (python_version >= "3.10") and (extra == "aiohttp")
 Requires-Dist: httpx (>=0.21.2)
-Requires-Dist: httpx-aiohttp (==0.1.8) ; (python_version >= "3.10") and (extra == "aiohttp")
+Requires-Dist: httpx-aiohttp (>=0.1.8,<0.2.0) ; (python_version >= "3.10") and (extra == "aiohttp")
 Requires-Dist: pydantic (>=1.9.2)
 Requires-Dist: pydantic-core (>=2.18.2,<3.0.0)
 Requires-Dist: typing_extensions (>=4.0.0)

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/pyproject.toml

@@ -4,12 +4,11 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "wavix-python-sdk"
-version = "1.1.1"
+version = "1.4.0"
 description = ""
 readme = "README.md"
 authors = []
 keywords = []
-
 classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python",
@@ -37,9 +36,9 @@ Repository = 'https://github.com/wavix/wavix-python-sdk'
 
 [tool.poetry.dependencies]
 python = "^3.10"
-aiohttp = { version = ">=3.14.0,<4", optional = true, python = ">=3.10"}
+aiohttp = { version = ">=3.14.1,<4", optional = true, python = ">=3.10"}
 httpx = ">=0.21.2"
-httpx-aiohttp = { version = "0.1.8", optional = true, python = ">=3.10"}
+httpx-aiohttp = { version = "^0.1.8", optional = true, python = ">=3.10"}
 pydantic = ">= 1.9.2"
 pydantic-core = ">=2.18.2,<3.0.0"
 typing_extensions = ">= 4.0.0"

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/__init__.py

@@ -123,9 +123,6 @@ if typing.TYPE_CHECKING:
         ShortLinkMetricsItem,
         ShortLinkMetricsResponse,
         ShortLinkResponse,
-        SipTrunkCreateRequest,
-        SipTrunkCreateRequestAllowedIpsItem,
-        SipTrunkCreateRequestHostRequest,
         SipTrunkListResponse,
         SipTrunkResponse,
         SipTrunkSummary,
@@ -204,6 +201,9 @@ if typing.TYPE_CHECKING:
         WebRtcToken,
         WebRtcTokenResponse,
         WebRtcTokensListResponse,
+        WebhookInUseErrorResponse,
+        WhatsAppBusinessAccount,
+        WhatsAppBusinessAccountMessagingLimit,
         WhatsAppMessage,
         WhatsAppMessageGetResponse,
         WhatsAppMessageListItem,
@@ -211,34 +211,68 @@ if typing.TYPE_CHECKING:
         WhatsAppMessageListItemStatus,
         WhatsAppMessageListResponse,
         WhatsAppMessageSendRequest,
-        WhatsAppMessageSendRequestTemplate,
-        WhatsAppMessageSendRequestTemplateButtonsItem,
-        WhatsAppMessageSendRequestTemplateButtonsItemType,
-        WhatsAppMessageSendRequestTemplateHeader,
-        WhatsAppMessageSendRequestTemplateHeaderType,
         WhatsAppMessageSendResponse,
         WhatsAppMessageStatus,
         WhatsAppMessageTemplate,
         WhatsAppProblem,
         WhatsAppProblemErrorClass,
+        WhatsAppSendTemplate,
+        WhatsAppSendTemplateButton,
+        WhatsAppSendTemplateButtonType,
+        WhatsAppSendTemplateHeader,
+        WhatsAppSendTemplateHeaderType,
         WhatsAppSender,
-        WhatsAppSenderMessageTier,
+        WhatsAppSenderListResponse,
         WhatsAppSenderQualityRating,
         WhatsAppSenderStatus,
         WhatsAppTemplate,
+        WhatsAppTemplateBodyComponentRequest,
+        WhatsAppTemplateBodyComponentRequestExample,
+        WhatsAppTemplateButtonRequest,
+        WhatsAppTemplateButtonRequest_CopyCode,
+        WhatsAppTemplateButtonRequest_PhoneNumber,
+        WhatsAppTemplateButtonRequest_QuickReply,
+        WhatsAppTemplateButtonRequest_Url,
+        WhatsAppTemplateButtonsComponentRequest,
         WhatsAppTemplateCategory,
-        WhatsAppTemplateComponent,
-        WhatsAppTemplateComponentFormat,
-        WhatsAppTemplateComponentType,
+        WhatsAppTemplateComponentRequest,
+        WhatsAppTemplateComponentRequest_Body,
+        WhatsAppTemplateComponentRequest_Buttons,
+        WhatsAppTemplateComponentRequest_Footer,
+        WhatsAppTemplateComponentRequest_Header,
+        WhatsAppTemplateCopyCodeButtonRequest,
         WhatsAppTemplateCreateRequest,
         WhatsAppTemplateCreateRequestCategory,
-        WhatsAppTemplateListResponse,
+        WhatsAppTemplateFooterComponentRequest,
+        WhatsAppTemplateHeaderComponentRequest,
+        WhatsAppTemplateHeaderComponentRequest_Document,
+        WhatsAppTemplateHeaderComponentRequest_Image,
+        WhatsAppTemplateHeaderComponentRequest_Location,
+        WhatsAppTemplateHeaderComponentRequest_Text,
+        WhatsAppTemplateHeaderComponentRequest_Video,
+        WhatsAppTemplateLocationHeaderComponentRequest,
+        WhatsAppTemplateLocationHeaderComponentRequestType,
+        WhatsAppTemplateMediaHeaderComponentRequest,
+        WhatsAppTemplateMediaHeaderComponentRequestExample,
+        WhatsAppTemplateMediaHeaderComponentRequestType,
+        WhatsAppTemplatePageResponse,
+        WhatsAppTemplatePhoneNumberButtonRequest,
         WhatsAppTemplateQualityRating,
+        WhatsAppTemplateQuickReplyButtonRequest,
         WhatsAppTemplateResponse,
+        WhatsAppTemplateResponseComponent,
+        WhatsAppTemplateResponseComponentFormat,
         WhatsAppTemplateStatus,
+        WhatsAppTemplateTextHeaderComponentRequest,
+        WhatsAppTemplateTextHeaderComponentRequestExample,
+        WhatsAppTemplateTextHeaderComponentRequestType,
+        WhatsAppTemplateUrlButtonRequest,
+        WhatsAppWaba,
+        WhatsAppWabaListResponse,
     )
     from .errors import (
         BadRequestError,
+        ConflictError,
         ForbiddenError,
         NotFoundError,
         ServiceUnavailableError,
@@ -276,6 +310,12 @@ if typing.TYPE_CHECKING:
     from .environment import WavixEnvironment
     from .numbers import BulkUpdateNumbersResponse
     from .profile import ProfileUpdateRequestCompanyInfo, ProfileUpdateRequestCompanyInfoIndustry
+    from .sip_trunks import (
+        SipTrunkCreateRequestAllowedIpsItem,
+        SipTrunkCreateRequestHostRequest,
+        SipTrunkUpdateRequestAllowedIpsItem,
+        SipTrunkUpdateRequestHostRequest,
+    )
     from .sub_accounts import (
         ListSubAccountsRequestStatus,
         SubAccountsCreateRequestDefaultDestinations,
@@ -339,6 +379,7 @@ _dynamic_imports: typing.Dict[str, str] = {
     "CdrWithTranscription": ".types",
     "City": ".types",
     "CityListResponse": ".types",
+    "ConflictError": ".errors",
     "Country": ".types",
     "CountryHasNoRegionsErrorResponse": ".types",
     "CountryListResponse": ".types",
@@ -416,13 +457,14 @@ _dynamic_imports: typing.Dict[str, str] = {
     "ShortLinkMetricsItem": ".types",
     "ShortLinkMetricsResponse": ".types",
     "ShortLinkResponse": ".types",
-    "SipTrunkCreateRequest": ".types",
-    "SipTrunkCreateRequestAllowedIpsItem": ".types",
-    "SipTrunkCreateRequestHostRequest": ".types",
+    "SipTrunkCreateRequestAllowedIpsItem": ".sip_trunks",
+    "SipTrunkCreateRequestHostRequest": ".sip_trunks",
     "SipTrunkListResponse": ".types",
     "SipTrunkResponse": ".types",
     "SipTrunkSummary": ".types",
     "SipTrunkSummaryHostRequest": ".types",
+    "SipTrunkUpdateRequestAllowedIpsItem": ".sip_trunks",
+    "SipTrunkUpdateRequestHostRequest": ".sip_trunks",
     "SubAccountsCreateRequestDefaultDestinations": ".sub_accounts",
     "SubAccountsListResponse": ".types",
     "SubAccountsTransactionsListResponse": ".types",
@@ -505,6 +547,9 @@ _dynamic_imports: typing.Dict[str, str] = {
     "WebRtcToken": ".types",
     "WebRtcTokenResponse": ".types",
     "WebRtcTokensListResponse": ".types",
+    "WebhookInUseErrorResponse": ".types",
+    "WhatsAppBusinessAccount": ".types",
+    "WhatsAppBusinessAccountMessagingLimit": ".types",
     "WhatsAppMessage": ".types",
     "WhatsAppMessageGetResponse": ".types",
     "WhatsAppMessageListItem": ".types",
@@ -512,31 +557,64 @@ _dynamic_imports: typing.Dict[str, str] = {
     "WhatsAppMessageListItemStatus": ".types",
     "WhatsAppMessageListResponse": ".types",
     "WhatsAppMessageSendRequest": ".types",
-    "WhatsAppMessageSendRequestTemplate": ".types",
-    "WhatsAppMessageSendRequestTemplateButtonsItem": ".types",
-    "WhatsAppMessageSendRequestTemplateButtonsItemType": ".types",
-    "WhatsAppMessageSendRequestTemplateHeader": ".types",
-    "WhatsAppMessageSendRequestTemplateHeaderType": ".types",
     "WhatsAppMessageSendResponse": ".types",
     "WhatsAppMessageStatus": ".types",
     "WhatsAppMessageTemplate": ".types",
     "WhatsAppProblem": ".types",
     "WhatsAppProblemErrorClass": ".types",
+    "WhatsAppSendTemplate": ".types",
+    "WhatsAppSendTemplateButton": ".types",
+    "WhatsAppSendTemplateButtonType": ".types",
+    "WhatsAppSendTemplateHeader": ".types",
+    "WhatsAppSendTemplateHeaderType": ".types",
     "WhatsAppSender": ".types",
-    "WhatsAppSenderMessageTier": ".types",
+    "WhatsAppSenderListResponse": ".types",
     "WhatsAppSenderQualityRating": ".types",
     "WhatsAppSenderStatus": ".types",
     "WhatsAppTemplate": ".types",
+    "WhatsAppTemplateBodyComponentRequest": ".types",
+    "WhatsAppTemplateBodyComponentRequestExample": ".types",
+    "WhatsAppTemplateButtonRequest": ".types",
+    "WhatsAppTemplateButtonRequest_CopyCode": ".types",
+    "WhatsAppTemplateButtonRequest_PhoneNumber": ".types",
+    "WhatsAppTemplateButtonRequest_QuickReply": ".types",
+    "WhatsAppTemplateButtonRequest_Url": ".types",
+    "WhatsAppTemplateButtonsComponentRequest": ".types",
     "WhatsAppTemplateCategory": ".types",
-    "WhatsAppTemplateComponent": ".types",
-    "WhatsAppTemplateComponentFormat": ".types",
-    "WhatsAppTemplateComponentType": ".types",
+    "WhatsAppTemplateComponentRequest": ".types",
+    "WhatsAppTemplateComponentRequest_Body": ".types",
+    "WhatsAppTemplateComponentRequest_Buttons": ".types",
+    "WhatsAppTemplateComponentRequest_Footer": ".types",
+    "WhatsAppTemplateComponentRequest_Header": ".types",
+    "WhatsAppTemplateCopyCodeButtonRequest": ".types",
     "WhatsAppTemplateCreateRequest": ".types",
     "WhatsAppTemplateCreateRequestCategory": ".types",
-    "WhatsAppTemplateListResponse": ".types",
+    "WhatsAppTemplateFooterComponentRequest": ".types",
+    "WhatsAppTemplateHeaderComponentRequest": ".types",
+    "WhatsAppTemplateHeaderComponentRequest_Document": ".types",
+    "WhatsAppTemplateHeaderComponentRequest_Image": ".types",
+    "WhatsAppTemplateHeaderComponentRequest_Location": ".types",
+    "WhatsAppTemplateHeaderComponentRequest_Text": ".types",
+    "WhatsAppTemplateHeaderComponentRequest_Video": ".types",
+    "WhatsAppTemplateLocationHeaderComponentRequest": ".types",
+    "WhatsAppTemplateLocationHeaderComponentRequestType": ".types",
+    "WhatsAppTemplateMediaHeaderComponentRequest": ".types",
+    "WhatsAppTemplateMediaHeaderComponentRequestExample": ".types",
+    "WhatsAppTemplateMediaHeaderComponentRequestType": ".types",
+    "WhatsAppTemplatePageResponse": ".types",
+    "WhatsAppTemplatePhoneNumberButtonRequest": ".types",
     "WhatsAppTemplateQualityRating": ".types",
+    "WhatsAppTemplateQuickReplyButtonRequest": ".types",
     "WhatsAppTemplateResponse": ".types",
+    "WhatsAppTemplateResponseComponent": ".types",
+    "WhatsAppTemplateResponseComponentFormat": ".types",
     "WhatsAppTemplateStatus": ".types",
+    "WhatsAppTemplateTextHeaderComponentRequest": ".types",
+    "WhatsAppTemplateTextHeaderComponentRequestExample": ".types",
+    "WhatsAppTemplateTextHeaderComponentRequestType": ".types",
+    "WhatsAppTemplateUrlButtonRequest": ".types",
+    "WhatsAppWaba": ".types",
+    "WhatsAppWabaListResponse": ".types",
     "__version__": ".version",
     "api_keys": ".api_keys",
     "billing": ".billing",
@@ -638,6 +716,7 @@ __all__ = [
     "CdrWithTranscription",
     "City",
     "CityListResponse",
+    "ConflictError",
     "Country",
     "CountryHasNoRegionsErrorResponse",
     "CountryListResponse",
@@ -715,13 +794,14 @@ __all__ = [
     "ShortLinkMetricsItem",
     "ShortLinkMetricsResponse",
     "ShortLinkResponse",
-    "SipTrunkCreateRequest",
     "SipTrunkCreateRequestAllowedIpsItem",
     "SipTrunkCreateRequestHostRequest",
     "SipTrunkListResponse",
     "SipTrunkResponse",
     "SipTrunkSummary",
     "SipTrunkSummaryHostRequest",
+    "SipTrunkUpdateRequestAllowedIpsItem",
+    "SipTrunkUpdateRequestHostRequest",
     "SubAccountsCreateRequestDefaultDestinations",
     "SubAccountsListResponse",
     "SubAccountsTransactionsListResponse",
@@ -804,6 +884,9 @@ __all__ = [
     "WebRtcToken",
     "WebRtcTokenResponse",
     "WebRtcTokensListResponse",
+    "WebhookInUseErrorResponse",
+    "WhatsAppBusinessAccount",
+    "WhatsAppBusinessAccountMessagingLimit",
     "WhatsAppMessage",
     "WhatsAppMessageGetResponse",
     "WhatsAppMessageListItem",
@@ -811,31 +894,64 @@ __all__ = [
     "WhatsAppMessageListItemStatus",
     "WhatsAppMessageListResponse",
     "WhatsAppMessageSendRequest",
-    "WhatsAppMessageSendRequestTemplate",
-    "WhatsAppMessageSendRequestTemplateButtonsItem",
-    "WhatsAppMessageSendRequestTemplateButtonsItemType",
-    "WhatsAppMessageSendRequestTemplateHeader",
-    "WhatsAppMessageSendRequestTemplateHeaderType",
     "WhatsAppMessageSendResponse",
     "WhatsAppMessageStatus",
     "WhatsAppMessageTemplate",
     "WhatsAppProblem",
     "WhatsAppProblemErrorClass",
+    "WhatsAppSendTemplate",
+    "WhatsAppSendTemplateButton",
+    "WhatsAppSendTemplateButtonType",
+    "WhatsAppSendTemplateHeader",
+    "WhatsAppSendTemplateHeaderType",
     "WhatsAppSender",
-    "WhatsAppSenderMessageTier",
+    "WhatsAppSenderListResponse",
     "WhatsAppSenderQualityRating",
     "WhatsAppSenderStatus",
     "WhatsAppTemplate",
+    "WhatsAppTemplateBodyComponentRequest",
+    "WhatsAppTemplateBodyComponentRequestExample",
+    "WhatsAppTemplateButtonRequest",
+    "WhatsAppTemplateButtonRequest_CopyCode",
+    "WhatsAppTemplateButtonRequest_PhoneNumber",
+    "WhatsAppTemplateButtonRequest_QuickReply",
+    "WhatsAppTemplateButtonRequest_Url",
+    "WhatsAppTemplateButtonsComponentRequest",
     "WhatsAppTemplateCategory",
-    "WhatsAppTemplateComponent",
-    "WhatsAppTemplateComponentFormat",
-    "WhatsAppTemplateComponentType",
+    "WhatsAppTemplateComponentRequest",
+    "WhatsAppTemplateComponentRequest_Body",
+    "WhatsAppTemplateComponentRequest_Buttons",
+    "WhatsAppTemplateComponentRequest_Footer",
+    "WhatsAppTemplateComponentRequest_Header",
+    "WhatsAppTemplateCopyCodeButtonRequest",
     "WhatsAppTemplateCreateRequest",
     "WhatsAppTemplateCreateRequestCategory",
-    "WhatsAppTemplateListResponse",
+    "WhatsAppTemplateFooterComponentRequest",
+    "WhatsAppTemplateHeaderComponentRequest",
+    "WhatsAppTemplateHeaderComponentRequest_Document",
+    "WhatsAppTemplateHeaderComponentRequest_Image",
+    "WhatsAppTemplateHeaderComponentRequest_Location",
+    "WhatsAppTemplateHeaderComponentRequest_Text",
+    "WhatsAppTemplateHeaderComponentRequest_Video",
+    "WhatsAppTemplateLocationHeaderComponentRequest",
+    "WhatsAppTemplateLocationHeaderComponentRequestType",
+    "WhatsAppTemplateMediaHeaderComponentRequest",
+    "WhatsAppTemplateMediaHeaderComponentRequestExample",
+    "WhatsAppTemplateMediaHeaderComponentRequestType",
+    "WhatsAppTemplatePageResponse",
+    "WhatsAppTemplatePhoneNumberButtonRequest",
     "WhatsAppTemplateQualityRating",
+    "WhatsAppTemplateQuickReplyButtonRequest",
     "WhatsAppTemplateResponse",
+    "WhatsAppTemplateResponseComponent",
+    "WhatsAppTemplateResponseComponentFormat",
     "WhatsAppTemplateStatus",
+    "WhatsAppTemplateTextHeaderComponentRequest",
+    "WhatsAppTemplateTextHeaderComponentRequestExample",
+    "WhatsAppTemplateTextHeaderComponentRequestType",
+    "WhatsAppTemplateUrlButtonRequest",
+    "WhatsAppWaba",
+    "WhatsAppWabaListResponse",
     "__version__",
     "api_keys",
     "billing",

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/call_control/client.py

@@ -260,7 +260,7 @@ class CallControlClient:
             Indicates whether the call should be transcribed after it ends.
 
         stream_url : typing.Optional[str]
-            WebSocket URL to stream the call.
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio, which can include the caller's voice.
 
         stream_type : typing.Optional[CallStreamType]
             Direction of audio streamed to `stream_url`.
@@ -660,7 +660,7 @@ class AsyncCallControlClient:
             Indicates whether the call should be transcribed after it ends.
 
         stream_url : typing.Optional[str]
-            WebSocket URL to stream the call.
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio, which can include the caller's voice.
 
         stream_type : typing.Optional[CallStreamType]
             Direction of audio streamed to `stream_url`.

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/call_control/raw_client.py

@@ -537,7 +537,7 @@ class RawCallControlClient:
             Indicates whether the call should be transcribed after it ends.
 
         stream_url : typing.Optional[str]
-            WebSocket URL to stream the call.
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio, which can include the caller's voice.
 
         stream_type : typing.Optional[CallStreamType]
             Direction of audio streamed to `stream_url`.
@@ -1269,7 +1269,7 @@ class AsyncRawCallControlClient:
             Indicates whether the call should be transcribed after it ends.
 
         stream_url : typing.Optional[str]
-            WebSocket URL to stream the call.
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio, which can include the caller's voice.
 
         stream_type : typing.Optional[CallStreamType]
             Direction of audio streamed to `stream_url`.

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/call_control/streams/client.py

@@ -39,7 +39,7 @@ class StreamsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CallStreamResponse:
         """
-        Starts streaming the audio of the call identified by `call_id` to a WebSocket destination you supply, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The destination can be any URL you specify — Wavix does not restrict it. Returns the `stream_id`.
+        Starts streaming the audio of the call identified by `call_id` to the WebSocket destination in `stream_url`, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The streamed audio can include the remote party's voice.
 
         Parameters
         ----------
@@ -47,7 +47,7 @@ class StreamsClient:
             The `uuid` of the call.
 
         stream_url : str
-            WebSocket URL for call streaming
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio.
 
         stream_type : CallStreamType
             Direction of audio streamed to `stream_url`.
@@ -149,7 +149,7 @@ class AsyncStreamsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CallStreamResponse:
         """
-        Starts streaming the audio of the call identified by `call_id` to a WebSocket destination you supply, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The destination can be any URL you specify — Wavix does not restrict it. Returns the `stream_id`.
+        Starts streaming the audio of the call identified by `call_id` to the WebSocket destination in `stream_url`, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The streamed audio can include the remote party's voice.
 
         Parameters
         ----------
@@ -157,7 +157,7 @@ class AsyncStreamsClient:
             The `uuid` of the call.
 
         stream_url : str
-            WebSocket URL for call streaming
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio.
 
         stream_type : CallStreamType
             Direction of audio streamed to `stream_url`.

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/call_control/streams/raw_client.py

@@ -40,7 +40,7 @@ class RawStreamsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> HttpResponse[CallStreamResponse]:
         """
-        Starts streaming the audio of the call identified by `call_id` to a WebSocket destination you supply, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The destination can be any URL you specify — Wavix does not restrict it. Returns the `stream_id`.
+        Starts streaming the audio of the call identified by `call_id` to the WebSocket destination in `stream_url`, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The streamed audio can include the remote party's voice.
 
         Parameters
         ----------
@@ -48,7 +48,7 @@ class RawStreamsClient:
             The `uuid` of the call.
 
         stream_url : str
-            WebSocket URL for call streaming
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio.
 
         stream_type : CallStreamType
             Direction of audio streamed to `stream_url`.
@@ -257,7 +257,7 @@ class AsyncRawStreamsClient:
         request_options: typing.Optional[RequestOptions] = None,
     ) -> AsyncHttpResponse[CallStreamResponse]:
         """
-        Starts streaming the audio of the call identified by `call_id` to a WebSocket destination you supply, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The destination can be any URL you specify — Wavix does not restrict it. Returns the `stream_id`.
+        Starts streaming the audio of the call identified by `call_id` to the WebSocket destination in `stream_url`, in the direction (`stream_type`) and channel (`stream_channel`) you configure. The streamed audio can include the remote party's voice.
 
         Parameters
         ----------
@@ -265,7 +265,7 @@ class AsyncRawStreamsClient:
             The `uuid` of the call.
 
         stream_url : str
-            WebSocket URL for call streaming
+            WebSocket URL (`ws://` or `wss://`) that receives the call's audio.
 
         stream_type : CallStreamType
             Direction of audio streamed to `stream_url`.

{wavix_python_sdk-1.1.1 → wavix_python_sdk-1.4.0}/src/wavix/call_webhooks/client.py

@@ -61,11 +61,14 @@ class CallWebhooksClient:
         *,
         url: str,
         event_type: CallWebhooksCreateRequestEventType,
+        expected_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CallWebhook:
         """
         Registers a callback URL for the `on-call` or `post-call` event. Wavix sends a POST callback to the URL when the event occurs. Creates persistent configuration that forwards call metadata to the URL on every matching call until the webhook is deleted.
 
+        **Behavior:** Without `expected_url`, the webhook is set to `url` whatever it was before. With `expected_url`, the webhook is set only while it currently has that URL; an empty string matches an unset webhook. Otherwise the call returns `409` and the webhook is unchanged. Setting the URL the webhook already has succeeds. If the call returns a `Something went wrong` error, the webhook is unchanged and you can retry the request.
+
         Parameters
         ----------
         url : str
@@ -79,6 +82,9 @@ class CallWebhooksClient:
              - `post-call`: Sends a callback after the call ends
               with disposition, duration, and cost.
 
+        expected_url : typing.Optional[str]
+            Applies the change only if the webhook currently has this URL. Pass an empty string to set the webhook only while it is unset, or your own URL to replace your webhook. Setting the URL the webhook already has always succeeds.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -99,20 +105,31 @@ class CallWebhooksClient:
             event_type="post-call",
         )
         """
-        _response = self._raw_client.create(url=url, event_type=event_type, request_options=request_options)
+        _response = self._raw_client.create(
+            url=url, event_type=event_type, expected_url=expected_url, request_options=request_options
+        )
         return _response.data
 
     def delete(
-        self, *, event_type: DeleteCallWebhooksRequestEventType, request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        event_type: DeleteCallWebhooksRequestEventType,
+        expected_url: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> SuccessResponse:
         """
         Removes the call webhook for the given event type. Wavix stops sending callbacks for that event.
 
+        **Behavior:** Without `expected_url`, the webhook is cleared whatever URL it has. With `expected_url`, the webhook is cleared only while it currently has that URL; an empty value matches an unset webhook. Otherwise the call returns `409` and the webhook is unchanged. Clearing an unset webhook succeeds. Percent-encode the `expected_url` value in the query string. If the call returns a `Something went wrong` error, the webhook is unchanged and you can retry the request.
+
         Parameters
         ----------
         event_type : DeleteCallWebhooksRequestEventType
             Event type of the webhook to delete. One of `post-call` (callbacks sent after a call ends) or `on-call` (real-time call status callbacks during a call).
 
+        expected_url : typing.Optional[str]
+            Clears the webhook only if it currently has this URL. Percent-encode the value. An empty value clears only an unset webhook.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -130,9 +147,12 @@ class CallWebhooksClient:
         )
         client.call_webhooks.delete(
             event_type="post-call",
+            expected_url="https://your-site.com/webhook",
         )
         """
-        _response = self._raw_client.delete(event_type=event_type, request_options=request_options)
+        _response = self._raw_client.delete(
+            event_type=event_type, expected_url=expected_url, request_options=request_options
+        )
         return _response.data
 
 
@@ -190,11 +210,14 @@ class AsyncCallWebhooksClient:
         *,
         url: str,
         event_type: CallWebhooksCreateRequestEventType,
+        expected_url: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
     ) -> CallWebhook:
         """
         Registers a callback URL for the `on-call` or `post-call` event. Wavix sends a POST callback to the URL when the event occurs. Creates persistent configuration that forwards call metadata to the URL on every matching call until the webhook is deleted.
 
+        **Behavior:** Without `expected_url`, the webhook is set to `url` whatever it was before. With `expected_url`, the webhook is set only while it currently has that URL; an empty string matches an unset webhook. Otherwise the call returns `409` and the webhook is unchanged. Setting the URL the webhook already has succeeds. If the call returns a `Something went wrong` error, the webhook is unchanged and you can retry the request.
+
         Parameters
         ----------
         url : str
@@ -208,6 +231,9 @@ class AsyncCallWebhooksClient:
              - `post-call`: Sends a callback after the call ends
               with disposition, duration, and cost.
 
+        expected_url : typing.Optional[str]
+            Applies the change only if the webhook currently has this URL. Pass an empty string to set the webhook only while it is unset, or your own URL to replace your webhook. Setting the URL the webhook already has always succeeds.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -236,20 +262,31 @@ class AsyncCallWebhooksClient:
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.create(url=url, event_type=event_type, request_options=request_options)
+        _response = await self._raw_client.create(
+            url=url, event_type=event_type, expected_url=expected_url, request_options=request_options
+        )
         return _response.data
 
     async def delete(
-        self, *, event_type: DeleteCallWebhooksRequestEventType, request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        event_type: DeleteCallWebhooksRequestEventType,
+        expected_url: typing.Optional[str] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> SuccessResponse:
         """
         Removes the call webhook for the given event type. Wavix stops sending callbacks for that event.
 
+        **Behavior:** Without `expected_url`, the webhook is cleared whatever URL it has. With `expected_url`, the webhook is cleared only while it currently has that URL; an empty value matches an unset webhook. Otherwise the call returns `409` and the webhook is unchanged. Clearing an unset webhook succeeds. Percent-encode the `expected_url` value in the query string. If the call returns a `Something went wrong` error, the webhook is unchanged and you can retry the request.
+
         Parameters
         ----------
         event_type : DeleteCallWebhooksRequestEventType
             Event type of the webhook to delete. One of `post-call` (callbacks sent after a call ends) or `on-call` (real-time call status callbacks during a call).
 
+        expected_url : typing.Optional[str]
+            Clears the webhook only if it currently has this URL. Percent-encode the value. An empty value clears only an unset webhook.
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
@@ -272,10 +309,13 @@ class AsyncCallWebhooksClient:
         async def main() -> None:
             await client.call_webhooks.delete(
                 event_type="post-call",
+                expected_url="https://your-site.com/webhook",
             )
 
 
         asyncio.run(main())
         """
-        _response = await self._raw_client.delete(event_type=event_type, request_options=request_options)
+        _response = await self._raw_client.delete(
+            event_type=event_type, expected_url=expected_url, request_options=request_options
+        )
         return _response.data