sendly 4.5.0__tar.gz → 4.5.1__tar.gz

{sendly-4.5.0 → sendly-4.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sendly
-Version: 4.5.0
+Version: 4.5.1
 Summary: Official Sendly Python SDK for SMS messaging
 Project-URL: Homepage, https://sendly.live
 Project-URL: Documentation, https://sendly.live/docs
@@ -448,7 +448,7 @@ File uploads (`media.upload()`, `business_upgrade.start()` and `resubmit()`,
 make is the `too_many_concurrent_verifications` wait. `whatsapp.signup.verify()`
 and `whatsapp.signup.create()` with a `business_account_id` also raise a
 timeout, a network error or a `5xx` at once, because repeating them can use up
-a verification attempt or start a new signup; they still wait out a
+a verification attempt or start a new charged signup; they still wait out a
 `429` the API never ran.
 
 After the last attempt the SDK raises the error it last saw (`TimeoutError`,
@@ -1355,7 +1355,7 @@ client.links.update(link.code, True)
 
 ## WhatsApp
 
-Connect a number you own to WhatsApp (free to connect, no monthly fee), create
+Connect a number you own to WhatsApp ($9.99 one-time, no monthly fee), create
 Meta-reviewed message templates, and send on the `whatsapp` channel. Connecting
 the first number always ends with a human step: hand the `connect_url` to your
 user - they open it in a browser and log in with Facebook to link their
@@ -1387,8 +1387,11 @@ print(f'Open {signup.connect_url} and log in with Facebook')
 # After the Facebook step it stays 'registering' while WhatsApp activates the
 # number. Activation usually takes a few minutes but can take hours. If it
 # hasn't finished about 6 hours after the session began, the session fails
-# with registration_timeout ('failed', with signup.failure_reasons explaining
-# why).
+# with registration_timeout and the fee is refunded ('failed', with
+# signup.failure_reasons explaining why). The one-time $9.99 connection fee is
+# charged to your card when you start connecting the number and refunded
+# automatically if the connection fails; it is not refundable once the number
+# is connected.
 
 # 2. Create a template (Meta reviews it, usually 24-48h). category is required
 # (UTILITY, AUTHENTICATION or MARKETING) with no default, and an update can't
@@ -1472,7 +1475,7 @@ components = client.whatsapp.senders.get_conversational_components('+15555550123
 client.whatsapp.senders.set_calling('+15555550123', enabled=True)
 
 # Add another number to an account you already connected: no Facebook step.
-# Free, like a Facebook connection. WhatsApp sends the number a 6-digit code
+# Same $9.99 fee, refunded if it fails. WhatsApp sends the number a 6-digit code
 senders = client.whatsapp.senders.list().senders
 account_id = next(
     s.business_account_id for s in senders if s.status == 'active' and s.business_account_id
@@ -1496,7 +1499,7 @@ Senders also carry `business_account_id` (None while `pending`),
 name on file), `calling_enabled`, and `outbound_calling_allowed`, which is
 False for +1, +20, +84 and +234 numbers. A signup that is `verifying` carries
 `verification_method` and `verification_attempts_remaining`; after 5 wrong
-codes it fails with `verification_failed`. Calls carry
+codes it fails with `verification_failed` and the fee is refunded. Calls carry
 `channel` (`phone`, `whatsapp` or `browser`; see `CallChannel`).
 
 `verification_code` comes only from `signup.get()`. Until a code has been
@@ -1529,7 +1532,7 @@ Errors specific to WhatsApp:
   body carries `retryAfter: 3600` and the response a `Retry-After: 3600`
   header. The SDK retries it like any `5xx` before raising;
   `e.response.retry_after` says how many seconds to wait before trying again.
-- `whatsapp_signup_limit_reached` (HTTP 429) after 5 failed signups in
+- `whatsapp_signup_limit_reached` (HTTP 429) after 5 failed, charged signups in
   24 hours. It is final and not retried; try again the next day.
 - `whatsapp_send_failed` on a send: HTTP 422 when WhatsApp refused the message,
   which is final (cached under the idempotency key and replayed for 24 hours),
@@ -1565,8 +1568,8 @@ Errors specific to WhatsApp:
 - Adding a number by code: `whatsapp_business_account_not_found` (HTTP 404),
   `display_name_required` (HTTP 400), `whatsapp_signup_in_progress` and
   `whatsapp_already_enabled` (HTTP 409), and
-  `whatsapp_verification_start_failed` (HTTP 422 refused, 503 unreachable). A
-  Facebook `signup.create()` for a number being
+  `whatsapp_verification_start_failed` (HTTP 422 refused, 503 unreachable; the
+  fee is refunded either way). A Facebook `signup.create()` for a number being
   added by code gets `whatsapp_verification_in_progress` (HTTP 409).
   `verify()`: `invalid_verification_code` (HTTP 400, not 6 digits),
   `whatsapp_verification_code_invalid` (HTTP 422, with

{sendly-4.5.0 → sendly-4.5.1}/README.md

@@ -413,7 +413,7 @@ File uploads (`media.upload()`, `business_upgrade.start()` and `resubmit()`,
 make is the `too_many_concurrent_verifications` wait. `whatsapp.signup.verify()`
 and `whatsapp.signup.create()` with a `business_account_id` also raise a
 timeout, a network error or a `5xx` at once, because repeating them can use up
-a verification attempt or start a new signup; they still wait out a
+a verification attempt or start a new charged signup; they still wait out a
 `429` the API never ran.
 
 After the last attempt the SDK raises the error it last saw (`TimeoutError`,
@@ -1320,7 +1320,7 @@ client.links.update(link.code, True)
 
 ## WhatsApp
 
-Connect a number you own to WhatsApp (free to connect, no monthly fee), create
+Connect a number you own to WhatsApp ($9.99 one-time, no monthly fee), create
 Meta-reviewed message templates, and send on the `whatsapp` channel. Connecting
 the first number always ends with a human step: hand the `connect_url` to your
 user - they open it in a browser and log in with Facebook to link their
@@ -1352,8 +1352,11 @@ print(f'Open {signup.connect_url} and log in with Facebook')
 # After the Facebook step it stays 'registering' while WhatsApp activates the
 # number. Activation usually takes a few minutes but can take hours. If it
 # hasn't finished about 6 hours after the session began, the session fails
-# with registration_timeout ('failed', with signup.failure_reasons explaining
-# why).
+# with registration_timeout and the fee is refunded ('failed', with
+# signup.failure_reasons explaining why). The one-time $9.99 connection fee is
+# charged to your card when you start connecting the number and refunded
+# automatically if the connection fails; it is not refundable once the number
+# is connected.
 
 # 2. Create a template (Meta reviews it, usually 24-48h). category is required
 # (UTILITY, AUTHENTICATION or MARKETING) with no default, and an update can't
@@ -1437,7 +1440,7 @@ components = client.whatsapp.senders.get_conversational_components('+15555550123
 client.whatsapp.senders.set_calling('+15555550123', enabled=True)
 
 # Add another number to an account you already connected: no Facebook step.
-# Free, like a Facebook connection. WhatsApp sends the number a 6-digit code
+# Same $9.99 fee, refunded if it fails. WhatsApp sends the number a 6-digit code
 senders = client.whatsapp.senders.list().senders
 account_id = next(
     s.business_account_id for s in senders if s.status == 'active' and s.business_account_id
@@ -1461,7 +1464,7 @@ Senders also carry `business_account_id` (None while `pending`),
 name on file), `calling_enabled`, and `outbound_calling_allowed`, which is
 False for +1, +20, +84 and +234 numbers. A signup that is `verifying` carries
 `verification_method` and `verification_attempts_remaining`; after 5 wrong
-codes it fails with `verification_failed`. Calls carry
+codes it fails with `verification_failed` and the fee is refunded. Calls carry
 `channel` (`phone`, `whatsapp` or `browser`; see `CallChannel`).
 
 `verification_code` comes only from `signup.get()`. Until a code has been
@@ -1494,7 +1497,7 @@ Errors specific to WhatsApp:
   body carries `retryAfter: 3600` and the response a `Retry-After: 3600`
   header. The SDK retries it like any `5xx` before raising;
   `e.response.retry_after` says how many seconds to wait before trying again.
-- `whatsapp_signup_limit_reached` (HTTP 429) after 5 failed signups in
+- `whatsapp_signup_limit_reached` (HTTP 429) after 5 failed, charged signups in
   24 hours. It is final and not retried; try again the next day.
 - `whatsapp_send_failed` on a send: HTTP 422 when WhatsApp refused the message,
   which is final (cached under the idempotency key and replayed for 24 hours),
@@ -1530,8 +1533,8 @@ Errors specific to WhatsApp:
 - Adding a number by code: `whatsapp_business_account_not_found` (HTTP 404),
   `display_name_required` (HTTP 400), `whatsapp_signup_in_progress` and
   `whatsapp_already_enabled` (HTTP 409), and
-  `whatsapp_verification_start_failed` (HTTP 422 refused, 503 unreachable). A
-  Facebook `signup.create()` for a number being
+  `whatsapp_verification_start_failed` (HTTP 422 refused, 503 unreachable; the
+  fee is refunded either way). A Facebook `signup.create()` for a number being
   added by code gets `whatsapp_verification_in_progress` (HTTP 409).
   `verify()`: `invalid_verification_code` (HTTP 400, not 6 digits),
   `whatsapp_verification_code_invalid` (HTTP 422, with

{sendly-4.5.0 → sendly-4.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sendly"
-version = "4.5.0"
+version = "4.5.1"
 description = "Official Sendly Python SDK for SMS messaging"
 readme = "README.md"
 license = "MIT"

{sendly-4.5.0 → sendly-4.5.1}/sendly/__init__.py

@@ -29,7 +29,7 @@ Async Example:
     >>> asyncio.run(main())
 """
 
-__version__ = "4.5.0"
+__version__ = "4.5.1"
 
 # Main clients
 from .client import AsyncSendly, Sendly

{sendly-4.5.0 → sendly-4.5.1}/sendly/resources/whatsapp.py

@@ -5,7 +5,7 @@ WhatsApp is a first-class Sendly channel: connect a number you own, create
 Meta-reviewed message templates, and send via
 ``client.messages.send(channel='whatsapp', ...)``.
 
-Connecting a number is free (no setup or monthly fee) and always ends
+Connecting a number costs a one-time $9.99 fee (no monthly fee) and always ends
 with a human step: ``signup.create()`` returns a ``connect_url`` that a person
 must open in a browser and log in with Facebook to link their WhatsApp
 Business Account. Hand the URL to your user - that connection cannot be
@@ -99,35 +99,41 @@ class WhatsAppSignupResource:
     ) -> Union[WhatsAppSignupSession, WhatsAppSignup]:
         """Start connecting a number to WhatsApp.
 
-        Connecting a number is free (no setup or monthly fee). Returns a
+        Charges a one-time $9.99 connection fee per number (no monthly fee) to
+        your card when the connection starts, and returns a
         ``connect_url``. Completing the connection requires a human: hand the
         URL to your user - they open it in a browser and log in with Facebook
         to link their WhatsApp Business Account. Then poll :meth:`get` until
         the status is ``active``.
 
         Calling again for a number with an in-flight signup returns the
-        existing signup (same ``connect_url``).
+        existing signup (same ``connect_url``) without charging again.
         Requires a live API key with the ``whatsapp:write`` scope and, in a
         team workspace, an owner or admin (``settings:write``). After the
         Facebook step the signup stays ``registering`` while WhatsApp
         activates the number. Activation usually takes a few minutes but can
         take hours. If it hasn't finished about 6 hours after the session
-        began, the session fails with ``registration_timeout``.
+        began, the session fails with ``registration_timeout`` and the fee is
+        refunded. If the connection fails, the $9.99 fee is refunded
+        automatically; once the number has connected it is not refundable, and
+        a later disconnect gets nothing back.
 
         Pass ``business_account_id`` to add the number to a WhatsApp
         Business Account this workspace has already connected, without the
-        Facebook step. It is free too: WhatsApp sends the number a 6-digit
-        code by text or voice call. This returns a :class:`WhatsAppSignup` with status
+        Facebook step. The same $9.99 fee applies (refunded automatically if the
+        connection fails), then WhatsApp sends the number a 6-digit code by
+        text or voice call. This returns a :class:`WhatsAppSignup` with status
         ``verifying`` and no ``connect_url``: submit the code with
         :meth:`verify`, or read it from :meth:`get` as ``verification_code``
         once the text reaches the number. Calling again for a number that is
-        already verifying returns that signup without a second code, with
-        two exceptions: if the first call stopped before
+        already verifying returns that signup without a second charge or a
+        second code, with two exceptions: if the first call stopped before
         the code was requested, the repeat requests it (201); and a verifying
-        signup more than 3 hours old is failed and a new one is started. With ``business_account_id`` a 5xx, a timeout or a
+        signup more than 3 hours old is failed and refunded, and a new charged
+        one is started. With ``business_account_id`` a 5xx, a timeout or a
         network error is raised at once, never retried: each attempt can
-        start a new signup and ask WhatsApp for another code. Only a 429 the
-        API never ran is retried.
+        start a new signup that is charged and, when it fails, refunded. Only
+        a 429 the API never ran is retried.
 
         Args:
             phone_number: The number to connect, in E.164 format. Must be an
@@ -164,12 +170,12 @@ class WhatsAppSignupResource:
                 lacks ``whatsapp:write`` or the role isn't owner or admin.
             SendlyError: ``whatsapp_requires_live_key`` (403) with a test key.
             SendlyError: ``whatsapp_unavailable`` (503) while WhatsApp
-                connections are unavailable. Only signup
+                connections are unavailable. Nothing is charged. Only signup
                 returns it, with ``retryAfter: 3600`` in the body and a
                 ``Retry-After: 3600`` header. The SDK retries it like any 5xx
                 before raising.
             SendlyError: ``whatsapp_signup_limit_reached`` (429) after 5
-                failed signups (or 20 cancelled) in 24 hours. Not retried;
+                failed, charged signups (or 20 cancelled) in 24 hours. Not retried;
                 try again the next day.
             SendlyError: ``whatsapp_verification_in_progress`` (409) without
                 ``business_account_id`` for a number being added by code;
@@ -184,8 +190,8 @@ class WhatsAppSignupResource:
                 ``whatsapp_already_enabled`` (409) when it is connected.
             SendlyError: ``whatsapp_verification_start_failed``: 422 when
                 WhatsApp refused to send a code (final), 503 when it couldn't
-                be reached. Either way the signup failed; start again. Not
-                retried automatically.
+                be reached. Either way the signup failed and the fee is
+                refunded; start again. Not retried automatically.
         """
         validate_phone_number(phone_number)
         body = _signup_body(phone_number, business_account_id, verification_method, display_name)
@@ -228,7 +234,7 @@ class WhatsAppSignupResource:
                 wrong code; ``e.response.attempts_remaining`` says how many
                 tries are left.
             SendlyError: ``whatsapp_verification_failed`` (409) after 5 wrong
-                codes: the signup failed.
+                codes: the signup failed and the fee is refunded.
             SendlyError: ``whatsapp_verification_busy`` (409) while another
                 code for the number is being checked; try again in a moment.
             SendlyError: ``signup_not_active`` (409) when the signup isn't
@@ -766,7 +772,7 @@ class WhatsAppResource:
     """WhatsApp API resource (sync)
 
     Example:
-        >>> # 1. Connect a number (free, no monthly fee). The connect
+        >>> # 1. Connect a number ($9.99 one-time, no monthly fee). The connect
         >>> #    URL must be opened by a human - they log in with Facebook in
         >>> #    a browser to link their WhatsApp Business Account.
         >>> signup = client.whatsapp.signup.create('+15559876543')

{sendly-4.5.0 → sendly-4.5.1}/sendly/utils/http.py

@@ -28,7 +28,7 @@ T = TypeVar("T")
 DEFAULT_BASE_URL = "https://sendly.live/api/v1"
 DEFAULT_TIMEOUT = 30.0
 DEFAULT_MAX_RETRIES = 3
-SDK_VERSION = "4.5.0"
+SDK_VERSION = "4.5.1"
 
 
 _WAIT_AND_RETRY_CODES = (

{sendly-4.5.0 → sendly-4.5.1}/tests/test_whatsapp_extras.py

@@ -892,7 +892,8 @@ def no_async_sleep(monkeypatch):
 START_FAILED = {
     "error": "whatsapp_verification_start_failed",
     "message": (
-        "WhatsApp couldn't start verifying this number. Please try again shortly."
+        "WhatsApp couldn't start verifying this number. Any setup fee is refunded "
+        "automatically. Please try again shortly."
     ),
 }
 
@@ -943,7 +944,8 @@ class TestServerErrorsOnCallsThatMustNotRepeat:
             json={
                 "error": "internal_error",
                 "message": (
-                    "Something went wrong asking WhatsApp for the code. Please try again."
+                    "Something went wrong asking WhatsApp for the code. Any setup fee is "
+                    "refunded automatically. Please try again."
                 ),
             },
             is_reusable=True,