Release v0.16.0 (sdk-python/v0.16.0)

Author: bird-release[bot]

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.16.0
+
+- **Breaking:** a WhatsApp send addresses its template by `slug` (previously `name`), and a WhatsApp message read echoes `template.slug` (previously `template.name`). Templates carry the slug as their permanent handle; the display name is cosmetic and never affects sending.
+
 ## 0.15.0
 
 - Email message reads now report the message as delivered. For a send that used a template, `subject` and the bodies from the message-content endpoint previously returned the template source, tokens and all, which is content no recipient received; they now return that source with the send's substitution values applied. The values themselves are exposed as a new `parameters` field so the inputs stay visible beside the result. Sends that supplied their content inline are unaffected.

src/bird/_generated.py

@@ -2824,14 +2824,14 @@ class WhatsAppMessageTemplate(BaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    name: Annotated[
+    slug: Annotated[
         str,
         Field(
             description="The template's stable handle (for example `bird_otp`).",
             examples=['bird_otp'],
-            max_length=512,
+            max_length=63,
             min_length=1,
-            pattern='^[a-z0-9_]+$',
+            pattern='^[a-z0-9]([a-z0-9_-]*[a-z0-9])?$',
         ),
     ]
     category: Annotated[
@@ -2984,14 +2984,14 @@ class WhatsAppTemplateSend(BaseModel):
     model_config = ConfigDict(
         extra='allow',
     )
-    name: Annotated[
+    slug: Annotated[
         str,
         Field(
-            description='The template to send, by its name (for example `bird_otp`).',
+            description='The template to send, by its slug (for example `bird_otp`).',
             examples=['bird_otp'],
-            max_length=512,
+            max_length=63,
             min_length=1,
-            pattern='^[a-z0-9_]+$',
+            pattern='^[a-z0-9]([a-z0-9_-]*[a-z0-9])?$',
         ),
     ]
     language: Annotated[

src/bird/_version.py

@@ -1 +1 @@
-__version__ = "0.15.0"
+__version__ = "0.16.0"

src/bird/resources/whatsapp.py

@@ -28,7 +28,7 @@ def _send_body(
 ) -> dict[str, Any]:
     body: dict[str, Any] = {"to": to}
     if template is not None:
-        tmpl: dict[str, Any] = {"name": template}
+        tmpl: dict[str, Any] = {"slug": template}
         if language is not None:
             tmpl["language"] = language
         if components is not None: