sendly 4.1.0__tar.gz → 4.2.0__tar.gz

{sendly-4.1.0 → sendly-4.2.0}/CHANGELOG.md

@@ -1,5 +1,16 @@
 # sendly (Python)
 
+## 4.2.0
+
+### Minor Changes
+
+- **Voice configuration: `client.voice`.** Everything a phone call depends on is now configurable from code. `voice.numbers.list()`, `get(number)`, `update(number, voice_enabled=..., voice_mode=..., agent_id=...)` and `register_emergency_address(number, street=..., unit=..., city=..., state=..., zip=..., country=...)` switch voice on for a number, choose how it answers and register the emergency address it needs before it can place calls; `number` is the number's id or its E.164 phone number. `voice.agents.list()`, `create(name, ...)`, `get(id)`, `update(id, ...)` and `delete(id)` manage the AI agents that talk, and `voice.voices.list()` lists the voices they can use. Sync and async clients. Reads need the `calls:read` scope, writes `calls:write` and a live API key. Deleting an agent that still answers a number raises `SendlyError` with code `agent_in_use` (HTTP 409) and the numbers in `e.response.model_extra['numbers']`.
+- New types: `VoiceNumber`, `VoiceNumberListResponse`, `VoiceNumberEmergencyAddress`, `EmergencyAddress`, `VoiceNumberRates`, `VoiceMode`, `VoiceAgent`, `VoiceAgentListResponse`, `VoiceAgentTools`, `Voice`, `VoiceListResponse`, `CreateVoiceAgentRequest`, `UpdateVoiceAgentRequest`, `UpdateVoiceNumberRequest` and `DeletedVoiceAgent`.
+
+### Patch Changes
+
+- The `calls.recording()` docstring had the channels the wrong way round. Agent calls are recorded with the agent on the left channel and the other party on the right.
+
 ## 4.1.0
 
 ### Minor Changes

{sendly-4.1.0 → sendly-4.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sendly
-Version: 4.1.0
+Version: 4.2.0
 Summary: Official Sendly Python SDK for SMS messaging
 Project-URL: Homepage, https://sendly.live
 Project-URL: Documentation, https://sendly.live/docs
@@ -884,21 +884,28 @@ print(registration.stage)  # 'in_review' -> 'brand_verification' -> 'agent_revie
 # 5. Once in testing: invite devices, describe the campaign, then request launch
 if registration.stage == RcsCustomerStage.TESTING:
     client.rcs.agents.set_test_devices(agent.id, [
-        '+15551234567',
-        {'phone_number': '+15557654321', 'label': 'Sam'},
+        '+15125550142',
+        {'phone_number': '+15125550177', 'label': 'Sam'},
     ])
     client.rcs.agents.update(
         agent.id,
         campaign={
+            'company_overview': 'Acme Coffee runs 12 cafes and an online store.',
             'agent_overview': 'Order updates and support replies',
             'interactions': [{'interaction_type': 'TRANSACTIONAL_UPDATES',
                               'description': 'Shipping and delivery updates'}],
-            'message_examples': ['Your order #123 has shipped!',
-                                 'Your table is ready!',
-                                 'Reply HELP for help'],
+            'message_examples': ['Acme Coffee: order #123 has shipped. Reply STOP to opt out.',
+                                 'Acme Coffee: your table is ready!',
+                                 'Acme Coffee: reply HELP for help.'],
             'consent_settings': {
                 'opt_in_methods': [{'method_type': 'WEBSITE',
                                     'description': 'Checkout checkbox'}],
+                'call_to_action': 'Get order updates by message',
+                'call_to_action_url': 'https://acme.example/checkout',
+                'call_to_action_media_url': 'https://acme.example/rcs/opt-in.png',
+                'double_opt_in': False,
+                'opt_in_message': 'Acme Coffee: you are subscribed. Reply HELP for help, STOP to opt out.',
+                'help_response': 'Acme Coffee: email help@acme.example for help.',
                 'opt_out_response': 'You are unsubscribed.',
             },
         },
@@ -925,13 +932,14 @@ for yours, every call method raises `SendlyError` with code `voice_not_enabled`
 Calls are prepaid from your balance per started minute: 2 credits a minute
 outbound plus 8 a minute while an AI agent is on the line (10 credits a minute
 for an agent-handled outbound call); unanswered calls cost nothing. The number
-you call from must be voice-enabled in the dashboard (Calls, then Settings),
-with an emergency address registered; `client.numbers.list()` shows each
-number's `voice_enabled` and `voice_mode`. Destinations are US and Canada.
+you call from must be voice-enabled, with an emergency address registered (see
+[Configure voice](#configure-voice)); `client.voice.numbers.list()` shows each
+number's `voice_enabled`, `voice_mode` and `emergency_address`. Destinations
+are US and Canada.
 
 ```python
 # Pick a voice-enabled number (optional when exactly one is voice-enabled)
-voice_numbers = [n for n in client.numbers.list().numbers if n.voice_enabled]
+voice_numbers = [n for n in client.voice.numbers.list().data if n.voice_enabled]
 
 # Place a call; the agent speaks first, using the context you pass
 call = client.calls.create(
@@ -974,6 +982,84 @@ Refusals come back as `SendlyError` with a code that says what to do:
 `call.completed` and `call.recording.ready` carry the same call object in
 snake_case, including `billing` and your `metadata`.
 
+### Configure voice
+
+Everything a call depends on can be set up from code: switch voice on for a
+number and choose how it answers, register its emergency address, and create
+the AI agents that talk. Reads need `calls:read`; writes need `calls:write` and
+a live key. In a team workspace, changing numbers and managing agents needs an
+owner or admin role (`forbidden` otherwise). These settings change how real
+phone calls to your numbers are answered.
+
+```python
+from sendly import SendlyError
+
+# The voices an agent can speak with
+for v in client.voice.voices.list().data:
+    print(v.id, v.label, v.language)
+
+# Create an agent (up to 20 per workspace); it gets its own key for texting
+agent = client.voice.agents.create(
+    name='Front desk',
+    voice='ashley',
+    greeting='Thanks for calling Acme, how can I help?',
+    instructions='Answer questions about opening hours and take a message for anything else.',
+    tools={'send_sms': True},
+)
+print(agent.id, agent.voice_label, agent.can_send_sms)
+
+# Edit it later; only the fields you pass change
+client.voice.agents.update(agent.id, greeting='Hi, you have reached Acme.')
+
+# Numbers with their voice settings; pass either the id or the E.164 number
+for n in client.voice.numbers.list().data:
+    e911 = n.emergency_address.status if n.emergency_address else 'none'
+    print(n.phone_number, n.voice_mode, n.agent_id, e911)
+
+# Register the emergency address a number needs before it can place calls
+# (US and Canadian numbers; the first registration adds 1.50 USD a month)
+number = client.voice.numbers.register_emergency_address(
+    '+15555550188',
+    street='500 Example Ave',
+    unit='Suite 2',
+    city='Austin',
+    state='TX',
+    zip='78701',
+)
+
+# Let the agent answer the number (voice_mode='ring_dashboard' rings your team)
+number = client.voice.numbers.update(
+    '+15555550188', voice_enabled=True, voice_mode='agent', agent_id=agent.id
+)
+print(number.voice_mode, number.rate_per_minute.agent)  # credits a minute
+
+# Switch voice off (the same as voice_mode='none')
+client.voice.numbers.update('+15555550188', voice_enabled=False)
+
+# Deleting an agent revokes its key; refused while a number still points at it
+try:
+    client.voice.agents.delete(agent.id)
+except SendlyError as e:
+    if e.code == 'agent_in_use':
+        print(e.response.model_extra['numbers'])
+```
+
+Without `voice_enabled`, `voice_mode='ring_dashboard'` or `'agent'` switches
+voice on and `voice_mode='none'` switches it off; `voice_enabled=False` always
+switches voice off.
+
+Refusals: `agent_required` (agent mode with no agent), `agent_not_found`,
+`agent_disabled` (turn the agent on first), `agent_limit`, `agent_in_use`,
+`number_not_found`, `invalid_voice_mode`, `voice_attach_failed` (HTTP 502,
+retry shortly), `carrier_refused` (HTTP 502, retry shortly unless the message
+says the number couldn't be found for emergency registration: contact
+support), `voice_unavailable` (HTTP 503),
+`e911_not_applicable` (only US and Canadian numbers take an emergency
+address) and `invalid_address`; on HTTP 422 the closest valid address is in
+`e.response.model_extra['suggested']`. An agent's `tools.transfer_to` is
+stored, but agents do not transfer calls yet: when a caller asks for a person,
+the agent offers to pass a message on and takes their name and number.
+
 ## Error Handling
 
 The SDK provides typed exception classes:
@@ -1290,6 +1376,48 @@ End a call (live key, `calls:write`). `ringing` becomes `cancelled`, `active` be
 
 Where to download the recording. `url` and `expires_at` are set only while `status` is `ready`; the link is valid for 5 minutes.
 
+### `client.voice`
+
+#### `numbers.list() -> VoiceNumberListResponse`
+
+Active numbers in the workspace with `voice_enabled`, `voice_mode`, `agent_id`, `emergency_address` and `rate_per_minute`.
+
+#### `numbers.get(number) -> VoiceNumber`
+
+One number's voice settings. `number` is the number's id or its E.164 phone number.
+
+#### `numbers.update(number, voice_enabled=None, voice_mode=None, agent_id=None, idempotency_key=None) -> VoiceNumber`
+
+Change how a number answers calls (live key, `calls:write`). Without `voice_enabled`, `ring_dashboard` or `agent` switches voice on and `none` switches it off; `voice_enabled=False` always switches it off. `agent` needs an enabled agent.
+
+#### `numbers.register_emergency_address(number, street, city, state, zip, unit=None, country=None, idempotency_key=None) -> VoiceNumber`
+
+Register the emergency address a number needs before it can place calls (live key, `calls:write`). US and Canadian numbers only.
+
+#### `agents.list() -> VoiceAgentListResponse`
+
+The workspace's AI agents.
+
+#### `agents.create(name, enabled=None, voice=None, language=None, greeting=None, instructions=None, tools=None, idempotency_key=None) -> VoiceAgent`
+
+Create an AI agent (live key, `calls:write`). Up to 20 per workspace.
+
+#### `agents.get(id) -> VoiceAgent`
+
+Fetch one agent.
+
+#### `agents.update(id, name=None, enabled=None, voice=None, language=None, greeting=None, instructions=None, tools=None, idempotency_key=None) -> VoiceAgent`
+
+Edit an agent; only the fields you pass change, and `tools` may be partial.
+
+#### `agents.delete(id, idempotency_key=None) -> DeletedVoiceAgent`
+
+Delete an agent and revoke its sending key. Raises `agent_in_use` (HTTP 409) while a number still points at it.
+
+#### `voices.list() -> VoiceListResponse`
+
+The voices an agent can speak with; pass a voice's `id` as `voice`.
+
 ## Enterprise
 
 The Enterprise API lets you programmatically manage workspaces, verification, credits, and API keys for multi-tenant platforms. Requires an enterprise master key (`sk_live_v1_master_*`).

{sendly-4.1.0 → sendly-4.2.0}/README.md

@@ -849,21 +849,28 @@ print(registration.stage)  # 'in_review' -> 'brand_verification' -> 'agent_revie
 # 5. Once in testing: invite devices, describe the campaign, then request launch
 if registration.stage == RcsCustomerStage.TESTING:
     client.rcs.agents.set_test_devices(agent.id, [
-        '+15551234567',
-        {'phone_number': '+15557654321', 'label': 'Sam'},
+        '+15125550142',
+        {'phone_number': '+15125550177', 'label': 'Sam'},
     ])
     client.rcs.agents.update(
         agent.id,
         campaign={
+            'company_overview': 'Acme Coffee runs 12 cafes and an online store.',
             'agent_overview': 'Order updates and support replies',
             'interactions': [{'interaction_type': 'TRANSACTIONAL_UPDATES',
                               'description': 'Shipping and delivery updates'}],
-            'message_examples': ['Your order #123 has shipped!',
-                                 'Your table is ready!',
-                                 'Reply HELP for help'],
+            'message_examples': ['Acme Coffee: order #123 has shipped. Reply STOP to opt out.',
+                                 'Acme Coffee: your table is ready!',
+                                 'Acme Coffee: reply HELP for help.'],
             'consent_settings': {
                 'opt_in_methods': [{'method_type': 'WEBSITE',
                                     'description': 'Checkout checkbox'}],
+                'call_to_action': 'Get order updates by message',
+                'call_to_action_url': 'https://acme.example/checkout',
+                'call_to_action_media_url': 'https://acme.example/rcs/opt-in.png',
+                'double_opt_in': False,
+                'opt_in_message': 'Acme Coffee: you are subscribed. Reply HELP for help, STOP to opt out.',
+                'help_response': 'Acme Coffee: email help@acme.example for help.',
                 'opt_out_response': 'You are unsubscribed.',
             },
         },
@@ -890,13 +897,14 @@ for yours, every call method raises `SendlyError` with code `voice_not_enabled`
 Calls are prepaid from your balance per started minute: 2 credits a minute
 outbound plus 8 a minute while an AI agent is on the line (10 credits a minute
 for an agent-handled outbound call); unanswered calls cost nothing. The number
-you call from must be voice-enabled in the dashboard (Calls, then Settings),
-with an emergency address registered; `client.numbers.list()` shows each
-number's `voice_enabled` and `voice_mode`. Destinations are US and Canada.
+you call from must be voice-enabled, with an emergency address registered (see
+[Configure voice](#configure-voice)); `client.voice.numbers.list()` shows each
+number's `voice_enabled`, `voice_mode` and `emergency_address`. Destinations
+are US and Canada.
 
 ```python
 # Pick a voice-enabled number (optional when exactly one is voice-enabled)
-voice_numbers = [n for n in client.numbers.list().numbers if n.voice_enabled]
+voice_numbers = [n for n in client.voice.numbers.list().data if n.voice_enabled]
 
 # Place a call; the agent speaks first, using the context you pass
 call = client.calls.create(
@@ -939,6 +947,84 @@ Refusals come back as `SendlyError` with a code that says what to do:
 `call.completed` and `call.recording.ready` carry the same call object in
 snake_case, including `billing` and your `metadata`.
 
+### Configure voice
+
+Everything a call depends on can be set up from code: switch voice on for a
+number and choose how it answers, register its emergency address, and create
+the AI agents that talk. Reads need `calls:read`; writes need `calls:write` and
+a live key. In a team workspace, changing numbers and managing agents needs an
+owner or admin role (`forbidden` otherwise). These settings change how real
+phone calls to your numbers are answered.
+
+```python
+from sendly import SendlyError
+
+# The voices an agent can speak with
+for v in client.voice.voices.list().data:
+    print(v.id, v.label, v.language)
+
+# Create an agent (up to 20 per workspace); it gets its own key for texting
+agent = client.voice.agents.create(
+    name='Front desk',
+    voice='ashley',
+    greeting='Thanks for calling Acme, how can I help?',
+    instructions='Answer questions about opening hours and take a message for anything else.',
+    tools={'send_sms': True},
+)
+print(agent.id, agent.voice_label, agent.can_send_sms)
+
+# Edit it later; only the fields you pass change
+client.voice.agents.update(agent.id, greeting='Hi, you have reached Acme.')
+
+# Numbers with their voice settings; pass either the id or the E.164 number
+for n in client.voice.numbers.list().data:
+    e911 = n.emergency_address.status if n.emergency_address else 'none'
+    print(n.phone_number, n.voice_mode, n.agent_id, e911)
+
+# Register the emergency address a number needs before it can place calls
+# (US and Canadian numbers; the first registration adds 1.50 USD a month)
+number = client.voice.numbers.register_emergency_address(
+    '+15555550188',
+    street='500 Example Ave',
+    unit='Suite 2',
+    city='Austin',
+    state='TX',
+    zip='78701',
+)
+
+# Let the agent answer the number (voice_mode='ring_dashboard' rings your team)
+number = client.voice.numbers.update(
+    '+15555550188', voice_enabled=True, voice_mode='agent', agent_id=agent.id
+)
+print(number.voice_mode, number.rate_per_minute.agent)  # credits a minute
+
+# Switch voice off (the same as voice_mode='none')
+client.voice.numbers.update('+15555550188', voice_enabled=False)
+
+# Deleting an agent revokes its key; refused while a number still points at it
+try:
+    client.voice.agents.delete(agent.id)
+except SendlyError as e:
+    if e.code == 'agent_in_use':
+        print(e.response.model_extra['numbers'])
+```
+
+Without `voice_enabled`, `voice_mode='ring_dashboard'` or `'agent'` switches
+voice on and `voice_mode='none'` switches it off; `voice_enabled=False` always
+switches voice off.
+
+Refusals: `agent_required` (agent mode with no agent), `agent_not_found`,
+`agent_disabled` (turn the agent on first), `agent_limit`, `agent_in_use`,
+`number_not_found`, `invalid_voice_mode`, `voice_attach_failed` (HTTP 502,
+retry shortly), `carrier_refused` (HTTP 502, retry shortly unless the message
+says the number couldn't be found for emergency registration: contact
+support), `voice_unavailable` (HTTP 503),
+`e911_not_applicable` (only US and Canadian numbers take an emergency
+address) and `invalid_address`; on HTTP 422 the closest valid address is in
+`e.response.model_extra['suggested']`. An agent's `tools.transfer_to` is
+stored, but agents do not transfer calls yet: when a caller asks for a person,
+the agent offers to pass a message on and takes their name and number.
+
 ## Error Handling
 
 The SDK provides typed exception classes:
@@ -1255,6 +1341,48 @@ End a call (live key, `calls:write`). `ringing` becomes `cancelled`, `active` be
 
 Where to download the recording. `url` and `expires_at` are set only while `status` is `ready`; the link is valid for 5 minutes.
 
+### `client.voice`
+
+#### `numbers.list() -> VoiceNumberListResponse`
+
+Active numbers in the workspace with `voice_enabled`, `voice_mode`, `agent_id`, `emergency_address` and `rate_per_minute`.
+
+#### `numbers.get(number) -> VoiceNumber`
+
+One number's voice settings. `number` is the number's id or its E.164 phone number.
+
+#### `numbers.update(number, voice_enabled=None, voice_mode=None, agent_id=None, idempotency_key=None) -> VoiceNumber`
+
+Change how a number answers calls (live key, `calls:write`). Without `voice_enabled`, `ring_dashboard` or `agent` switches voice on and `none` switches it off; `voice_enabled=False` always switches it off. `agent` needs an enabled agent.
+
+#### `numbers.register_emergency_address(number, street, city, state, zip, unit=None, country=None, idempotency_key=None) -> VoiceNumber`
+
+Register the emergency address a number needs before it can place calls (live key, `calls:write`). US and Canadian numbers only.
+
+#### `agents.list() -> VoiceAgentListResponse`
+
+The workspace's AI agents.
+
+#### `agents.create(name, enabled=None, voice=None, language=None, greeting=None, instructions=None, tools=None, idempotency_key=None) -> VoiceAgent`
+
+Create an AI agent (live key, `calls:write`). Up to 20 per workspace.
+
+#### `agents.get(id) -> VoiceAgent`
+
+Fetch one agent.
+
+#### `agents.update(id, name=None, enabled=None, voice=None, language=None, greeting=None, instructions=None, tools=None, idempotency_key=None) -> VoiceAgent`
+
+Edit an agent; only the fields you pass change, and `tools` may be partial.
+
+#### `agents.delete(id, idempotency_key=None) -> DeletedVoiceAgent`
+
+Delete an agent and revoke its sending key. Raises `agent_in_use` (HTTP 409) while a number still points at it.
+
+#### `voices.list() -> VoiceListResponse`
+
+The voices an agent can speak with; pass a voice's `id` as `voice`.
+
 ## Enterprise
 
 The Enterprise API lets you programmatically manage workspaces, verification, credits, and API keys for multi-tenant platforms. Requires an enterprise master key (`sk_live_v1_master_*`).

{sendly-4.1.0 → sendly-4.2.0}/pyproject.toml

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

{sendly-4.1.0 → sendly-4.2.0}/sendly/__init__.py

@@ -29,7 +29,7 @@ Async Example:
     >>> asyncio.run(main())
 """
 
-__version__ = "4.1.0"
+__version__ = "4.2.0"
 
 # Main clients
 from .client import AsyncSendly, Sendly
@@ -57,6 +57,7 @@ from .resources.media import AsyncMediaResource, MediaResource
 from .resources.numbers import AsyncNumbersResource, NumbersResource
 from .resources.rcs import AsyncRcsResource, RcsResource
 from .resources.tendlc import AsyncTenDlcResource, TenDlcResource
+from .resources.voice import AsyncVoiceResource, VoiceResource
 from .resources.whatsapp import AsyncWhatsAppResource, WhatsAppResource
 
 # Types
@@ -209,6 +210,22 @@ from .types import (
     CallTranscriptLine,
     CreateCallRequest,
     ListCallsOptions,
+    # Voice configuration types
+    CreateVoiceAgentRequest,
+    DeletedVoiceAgent,
+    EmergencyAddress,
+    UpdateVoiceAgentRequest,
+    UpdateVoiceNumberRequest,
+    Voice,
+    VoiceAgent,
+    VoiceAgentListResponse,
+    VoiceAgentTools,
+    VoiceListResponse,
+    VoiceMode,
+    VoiceNumber,
+    VoiceNumberEmergencyAddress,
+    VoiceNumberListResponse,
+    VoiceNumberRates,
     OptInPage,
     PricingTier,
     QuotaSettings,
@@ -435,6 +452,22 @@ __all__ = [
     "CallTranscriptLine",
     "CreateCallRequest",
     "ListCallsOptions",
+    # Voice configuration types
+    "CreateVoiceAgentRequest",
+    "DeletedVoiceAgent",
+    "EmergencyAddress",
+    "UpdateVoiceAgentRequest",
+    "UpdateVoiceNumberRequest",
+    "Voice",
+    "VoiceAgent",
+    "VoiceAgentListResponse",
+    "VoiceAgentTools",
+    "VoiceListResponse",
+    "VoiceMode",
+    "VoiceNumber",
+    "VoiceNumberEmergencyAddress",
+    "VoiceNumberListResponse",
+    "VoiceNumberRates",
     # Links resources
     "LinksResource",
     "AsyncLinksResource",
@@ -459,6 +492,9 @@ __all__ = [
     # Voice call resources
     "CallsResource",
     "AsyncCallsResource",
+    # Voice configuration resources
+    "VoiceResource",
+    "AsyncVoiceResource",
     # Errors
     "SendlyError",
     "AuthenticationError",

{sendly-4.1.0 → sendly-4.2.0}/sendly/client.py

@@ -27,6 +27,7 @@ from .resources.rules import AsyncRulesResource, RulesResource
 from .resources.templates import AsyncTemplatesResource, TemplatesResource
 from .resources.tendlc import AsyncTenDlcResource, TenDlcResource
 from .resources.verify import AsyncVerifyResource, VerifyResource
+from .resources.voice import AsyncVoiceResource, VoiceResource
 from .resources.webhooks import AsyncWebhooksResource, WebhooksResource
 from .resources.whatsapp import AsyncWhatsAppResource, WhatsAppResource
 from .types import RateLimitInfo, SendlyConfig
@@ -134,6 +135,7 @@ class Sendly:
         self.whatsapp = WhatsAppResource(self._http)
         self.rcs = RcsResource(self._http)
         self.calls = CallsResource(self._http)
+        self.voice = VoiceResource(self._http)
 
     def __enter__(self) -> "Sendly":
         return self
@@ -278,6 +280,7 @@ class AsyncSendly:
         self.whatsapp = AsyncWhatsAppResource(self._http)
         self.rcs = AsyncRcsResource(self._http)
         self.calls = AsyncCallsResource(self._http)
+        self.voice = AsyncVoiceResource(self._http)
 
     async def __aenter__(self) -> "AsyncSendly":
         return self

{sendly-4.1.0 → sendly-4.2.0}/sendly/resources/__init__.py

@@ -15,11 +15,14 @@ from .rules import AsyncRulesResource, RulesResource
 from .templates import AsyncTemplatesResource, TemplatesResource
 from .tendlc import AsyncTenDlcResource, TenDlcResource
 from .verify import AsyncVerifyResource, VerifyResource
+from .voice import AsyncVoiceResource, VoiceResource
 from .whatsapp import AsyncWhatsAppResource, WhatsAppResource
 
 __all__ = [
     "CallsResource",
     "AsyncCallsResource",
+    "VoiceResource",
+    "AsyncVoiceResource",
     "CampaignsResource",
     "AsyncCampaignsResource",
     "ContactsResource",

{sendly-4.1.0 → sendly-4.2.0}/sendly/resources/calls.py

@@ -5,7 +5,7 @@ A workspace phone number can take and place phone calls. Over the API you
 place an outbound call that one of your AI agents handles, list and inspect
 calls, end a call, and fetch recordings. Switching voice on for a number,
 choosing how it answers, registering an emergency address and creating agents
-are dashboard steps in this release; ``client.numbers.list()`` reports each
+live in ``client.voice``; ``client.voice.numbers.list()`` reports each
 number's ``voice_enabled`` and ``voice_mode`` so you can pick a ``from_``.
 
 Reads need an API key with the ``calls:read`` scope, writes ``calls:write``.
@@ -96,7 +96,8 @@ class CallsResource:
                 the agent rate (``credits_needed``, ``current_balance``).
             SendlyError: With ``code`` ``agent_not_found``, ``agent_disabled``,
                 ``no_voice_number``, ``number_not_found``, ``e911_required``
-                (register an emergency address for the number first),
+                (register an emergency address for the number first with
+                ``client.voice.numbers.register_emergency_address``),
                 ``lines_busy`` (retry shortly), ``daily_call_limit``,
                 ``outbound_calls_not_enabled`` or ``voice_not_enabled``.
 
@@ -199,8 +200,9 @@ class CallsResource:
         ``url`` and ``expires_at`` are set only while ``status`` is ``ready``;
         the link is signed and valid for 5 minutes, so fetch it right before
         downloading. Recordings are Ogg/Opus; agent calls are recorded
-        dual-channel (caller left, agent right). ``status`` is ``none`` when
-        nothing was recorded (recording off, or the call was never answered).
+        dual-channel, the agent on the left channel and the other party on
+        the right. ``status`` is ``none`` when nothing was recorded
+        (recording off, or the call was never answered).
 
         Args:
             id: Call identifier.