Merge pull request #164 from david-lev/dev

[ci] update CI configuration for pytest and upgrade action versions

Author: david-lev

.github/workflows/tests.yml

@@ -1,4 +1,4 @@
-name: Tests with pytest
+name: CI
 
 on:
   push:
@@ -11,7 +11,7 @@ permissions:
 
 jobs:
   tests:
-    name: Tests with pytest
+    name: pytest
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -20,9 +20,9 @@ jobs:
         python-version: [ '3.10', '3.11', '3.12', '3.13', '3.14' ]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip

CHANGELOG.md

@@ -4,7 +4,16 @@
 > NOTE: pywa follows the [semver](https://semver.org/) versioning standard.
 
 
-#### 3.6.1 (2025-12-11) **Latest**
+#### 3.7.0 (2026-01-11) **Latest**
+
+- [media] allow to override the default 1-hour TTL for `No Storage-enabled` business phone numbers
+- [types] add `QRCodeImageType` and enhance `QRCode` methods for image handling
+- [templates] adding `product_extensions` and `text_formatting_optimization` to `CreativeFeaturesSpec`
+- [api] add method to exchange Embedded Signup token for business access token
+- [ci] update GitHub Actions workflows for improved publishing and testing
+- [core] support Python 3.14
+
+#### 3.6.1 (2025-12-11)
 
 - [helpers] fix media URL in template param
 - [tests] test resolve_media_param

pywa/__init__.py

@@ -9,6 +9,6 @@
 from pywa.client import WhatsApp
 from pywa.utils import Version
 
-__version__ = "3.6.1"
+__version__ = "3.7.0"
 __author__ = "David Lev"
 __license__ = "MIT"

pywa/types/calls.py

@@ -887,6 +887,23 @@ class STRPKeyExchangeProtocol(utils.StrEnum):
     UNKNOWN = "UNKNOWN"
 
 
+@dataclasses.dataclass(slots=True, kw_only=True, frozen=True)
+class CallIcons:
+    """
+    Configure whether WhatsApp call button icon displays for users when chatting with the business.
+
+    Attributes:
+        restrict_to_user_countries: Restrict the visibility of call icons to these countries. For example if you restrict it to “US,” then it will apply to all the people who have a US registered phone number. These people could be physically located inside or outside of the USA.
+    """
+
+    restrict_to_user_countries: list[str]
+
+    def to_dict(self) -> dict:
+        return {
+            "restrict_to_user_countries": self.restrict_to_user_countries,
+        }
+
+
 @dataclasses.dataclass(slots=True, kw_only=True)
 class CallingSettings:
     """
@@ -897,13 +914,15 @@ class CallingSettings:
     Attributes:
         status: Enable or disable the Calling API for the given business phone number.
         call_icon_visibility: Configure whether the WhatsApp call button icon displays for users when chatting with the business. See `Call Icon Visibility <https://developers.facebook.com/docs/whatsapp/cloud-api/calling/call-settings#parameter-details>`_ for more details.
+        call_icons: Configure the visibility of call icons based on user countries.
         call_hours: Allows you to specify and trigger call settings for incoming calls based on your timezone, business operating hours, and holiday schedules.
         callback_permission_status: Configure whether a WhatsApp user is prompted with a call permission request after calling your business.
         sip: Configure call signaling via signal initiation protocol (SIP). Note: When SIP is enabled, you cannot use calling related endpoints and will not receive calling related webhooks.
     """
 
     status: CallingSettingsStatus | None = None
     call_icon_visibility: CallIconVisibility | None = None
+    call_icons: CallIcons | None = None
     call_hours: CallHours | None = None
     callback_permission_status: CallbackPermissionStatus | None = None
     srtp_key_exchange_protocol: STRPKeyExchangeProtocol | None = None
@@ -915,6 +934,8 @@ def to_dict(self):
             data["status"] = self.status.value
         if self.call_icon_visibility:
             data["call_icon_visibility"] = self.call_icon_visibility.value
+        if self.call_icons:
+            data["call_icons"] = self.call_icons.to_dict()
         if self.callback_permission_status:
             data["callback_permission_status"] = self.callback_permission_status.value
         if self.call_hours:
@@ -932,6 +953,13 @@ def from_dict(cls, data: dict) -> CallingSettings:
             call_icon_visibility=CallIconVisibility(data["call_icon_visibility"])
             if "call_icon_visibility" in data
             else None,
+            call_icons=CallIcons(
+                restrict_to_user_countries=data["call_icons"][
+                    "restrict_to_user_countries"
+                ]
+            )
+            if "call_icons" in data
+            else None,
             call_hours=CallHours.from_dict(data["call_hours"])
             if "call_hours" in data
             else None,
@@ -985,13 +1013,17 @@ def from_dict(cls, data: dict) -> BusinessPhoneNumberSettings:
 
     def to_dict(self) -> dict:
         return {
-            "calling": self.calling.to_dict() if self.calling else None,
-            "storage_configuration": dataclasses.asdict(self.storage_configuration)
-            if self.storage_configuration
-            else None,
-            "user_identity_change": self.user_identity_change.to_dict()
-            if self.user_identity_change
-            else None,
+            k: v
+            for k, v in {
+                "calling": self.calling.to_dict() if self.calling else None,
+                "storage_configuration": dataclasses.asdict(self.storage_configuration)
+                if self.storage_configuration
+                else None,
+                "user_identity_change": self.user_identity_change.to_dict()
+                if self.user_identity_change
+                else None,
+            }.items()
+            if v is not None
         }