sendly 4.0.0__tar.gz → 4.2.0__tar.gz

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

@@ -1,5 +1,27 @@
 # 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
+
+- **Voice calls: `client.calls`.** `create(to, agent_id, from_=..., context=..., metadata=...)` places a phone call that one of your workspace's AI agents handles; `list(...)`, `get(id)`, `hangup(id)` and `recording(id)` follow it, end it early and fetch the recording. Sync and async clients. Reads need the `calls:read` scope, writes `calls:write` and a live API key; until voice is enabled for your workspace the routes answer 404 `voice_not_enabled`.
+- `voice_enabled` and `voice_mode` on owned numbers.
+
+### Patch Changes
+
+- `MessageStatus` gains `RECEIVED` and `UNDELIVERED`. `messages.list()` returns inbound rows by default and their status is `received`, which the strict enum rejected, so listing failed for any workspace with inbound traffic. Any status this version does not know now maps to `MessageStatus.UNKNOWN` instead of raising.
+
 ## 4.0.0
 
 **Upgrading from 3.40.0:** that release already contained the breaking changes below, published by mistake as a minor version. 4.0.0 carries them under the correct major. Relative to 3.40.0, the only new changes are under **Security**.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sendly
-Version: 4.0.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.',
             },
         },
@@ -913,6 +920,146 @@ Writes accept an `idempotency_key` like the other write methods; `submit()` and
 `request_launch()` replays return the original response without notifying the
 reviewers again.
 
+## Voice Calls
+
+Place phone calls that one of your AI agents handles, follow them while they
+ring and after they end, end them early, and download recordings. Requires an
+API key with the `calls:read` / `calls:write` scopes; placing and ending calls
+needs a live key. Voice is enabled workspace by workspace: until it is enabled
+for yours, every call method raises `SendlyError` with code `voice_not_enabled`
+(HTTP 404).
+
+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, 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.voice.numbers.list().data if n.voice_enabled]
+
+# Place a call; the agent speaks first, using the context you pass
+call = client.calls.create(
+    to='+15555550123',
+    agent_id='3c4d5e6f-7081-4293-a4b5-c6d7e8f90a1b',
+    from_=voice_numbers[0].phone_number,
+    context='You are calling Jordan to confirm the 3pm appointment on Tuesday.',
+    metadata={'crmId': 'lead_8812'},
+)
+print(call.id, call.status)  # ... 'ringing'
+
+# Follow it: status moves ringing -> active -> completed (or no_answer, busy, ...)
+call = client.calls.get(call.id)
+print(call.status, call.duration_secs, call.credits_charged, call.hangup_class)
+for line in call.transcript or []:   # agent calls only; None on other calls
+    print(f'[{line.at_ms} ms] {line.speaker}: {line.text}')
+
+# List calls, newest first, with filters and paging
+page = client.calls.list(status='completed', direction='outbound', limit=20)
+for c in page.data:
+    print(c.id, c.to, c.duration_secs, c.credits_charged)
+if page.pagination.has_more:
+    page = client.calls.list(status='completed', direction='outbound', limit=20, offset=20)
+
+# End a call early (idempotent: an ended call is returned unchanged)
+client.calls.hangup(call.id)
+
+# Fetch the recording; the signed URL is valid for 5 minutes
+recording = client.calls.recording(call.id)
+if recording.status == 'ready':
+    print(recording.url, recording.expires_at, recording.content_type)  # audio/ogg
+```
+
+Refusals come back as `SendlyError` with a code that says what to do:
+`insufficient_credits` (raised as `InsufficientCreditsError`; top up),
+`e911_required` (register an emergency address for the number), `lines_busy`
+(retry with backoff), `daily_call_limit` (try again tomorrow),
+`agent_not_found` / `agent_disabled`, `from_number_required` / `no_voice_number`,
+`destination_not_supported`, `live_key_required`. Webhooks `call.started`,
+`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:
@@ -1207,6 +1354,70 @@ Submit the agent and its brand for review by Sendly, then the carrier network. `
 
 Ask for the launch review once the agent is in `testing` and has been tried on an invited device.
 
+### `client.calls`
+
+#### `create(to, agent_id, from_=None, context=None, metadata=None, idempotency_key=None) -> Call`
+
+Place a phone call handled by an AI agent (live key, `calls:write`). Returns the call while it is `ringing`; `from_` is required when more than one number is voice-enabled.
+
+#### `list(limit=None, offset=None, status=None, direction=None, kind=None, agent_id=None, to=None, from_=None) -> CallListResponse`
+
+List calls newest first; `pagination.has_more` says whether another page exists.
+
+#### `get(id) -> Call`
+
+Fetch one call. Agent-handled calls carry `transcript`; on other calls it is `None`.
+
+#### `hangup(id, idempotency_key=None) -> Call`
+
+End a call (live key, `calls:write`). `ringing` becomes `cancelled`, `active` becomes `completed`; an ended call is returned unchanged.
+
+#### `recording(id) -> CallRecording`
+
+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.0.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.',
             },
         },
@@ -878,6 +885,146 @@ Writes accept an `idempotency_key` like the other write methods; `submit()` and
 `request_launch()` replays return the original response without notifying the
 reviewers again.
 
+## Voice Calls
+
+Place phone calls that one of your AI agents handles, follow them while they
+ring and after they end, end them early, and download recordings. Requires an
+API key with the `calls:read` / `calls:write` scopes; placing and ending calls
+needs a live key. Voice is enabled workspace by workspace: until it is enabled
+for yours, every call method raises `SendlyError` with code `voice_not_enabled`
+(HTTP 404).
+
+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, 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.voice.numbers.list().data if n.voice_enabled]
+
+# Place a call; the agent speaks first, using the context you pass
+call = client.calls.create(
+    to='+15555550123',
+    agent_id='3c4d5e6f-7081-4293-a4b5-c6d7e8f90a1b',
+    from_=voice_numbers[0].phone_number,
+    context='You are calling Jordan to confirm the 3pm appointment on Tuesday.',
+    metadata={'crmId': 'lead_8812'},
+)
+print(call.id, call.status)  # ... 'ringing'
+
+# Follow it: status moves ringing -> active -> completed (or no_answer, busy, ...)
+call = client.calls.get(call.id)
+print(call.status, call.duration_secs, call.credits_charged, call.hangup_class)
+for line in call.transcript or []:   # agent calls only; None on other calls
+    print(f'[{line.at_ms} ms] {line.speaker}: {line.text}')
+
+# List calls, newest first, with filters and paging
+page = client.calls.list(status='completed', direction='outbound', limit=20)
+for c in page.data:
+    print(c.id, c.to, c.duration_secs, c.credits_charged)
+if page.pagination.has_more:
+    page = client.calls.list(status='completed', direction='outbound', limit=20, offset=20)
+
+# End a call early (idempotent: an ended call is returned unchanged)
+client.calls.hangup(call.id)
+
+# Fetch the recording; the signed URL is valid for 5 minutes
+recording = client.calls.recording(call.id)
+if recording.status == 'ready':
+    print(recording.url, recording.expires_at, recording.content_type)  # audio/ogg
+```
+
+Refusals come back as `SendlyError` with a code that says what to do:
+`insufficient_credits` (raised as `InsufficientCreditsError`; top up),
+`e911_required` (register an emergency address for the number), `lines_busy`
+(retry with backoff), `daily_call_limit` (try again tomorrow),
+`agent_not_found` / `agent_disabled`, `from_number_required` / `no_voice_number`,
+`destination_not_supported`, `live_key_required`. Webhooks `call.started`,
+`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:
@@ -1172,6 +1319,70 @@ Submit the agent and its brand for review by Sendly, then the carrier network. `
 
 Ask for the launch review once the agent is in `testing` and has been tried on an invited device.
 
+### `client.calls`
+
+#### `create(to, agent_id, from_=None, context=None, metadata=None, idempotency_key=None) -> Call`
+
+Place a phone call handled by an AI agent (live key, `calls:write`). Returns the call while it is `ringing`; `from_` is required when more than one number is voice-enabled.
+
+#### `list(limit=None, offset=None, status=None, direction=None, kind=None, agent_id=None, to=None, from_=None) -> CallListResponse`
+
+List calls newest first; `pagination.has_more` says whether another page exists.
+
+#### `get(id) -> Call`
+
+Fetch one call. Agent-handled calls carry `transcript`; on other calls it is `None`.
+
+#### `hangup(id, idempotency_key=None) -> Call`
+
+End a call (live key, `calls:write`). `ringing` becomes `cancelled`, `active` becomes `completed`; an ended call is returned unchanged.
+
+#### `recording(id) -> CallRecording`
+
+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.0.0 → sendly-4.2.0}/pyproject.toml

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

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

@@ -29,7 +29,7 @@ Async Example:
     >>> asyncio.run(main())
 """
 
-__version__ = "4.0.0"
+__version__ = "4.2.0"
 
 # Main clients
 from .client import AsyncSendly, Sendly
@@ -51,11 +51,13 @@ from .resources.business_upgrade import (
     AsyncBusinessUpgradeResource,
     BusinessUpgradeResource,
 )
+from .resources.calls import AsyncCallsResource, CallsResource
 from .resources.links import AsyncLinksResource, LinksResource
 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
@@ -194,6 +196,36 @@ from .types import (
     RcsTestDeviceInput,
     RcsTestDeviceListResponse,
     RcsTesting,
+    # Voice call types
+    Call,
+    CallBilling,
+    CallDirection,
+    CallHandledBy,
+    CallKind,
+    CallListResponse,
+    CallPagination,
+    CallRecording,
+    CallRecordingStatus,
+    CallStatus,
+    CallTranscriptLine,
+    CreateCallRequest,
+    ListCallsOptions,
+    # Voice configuration types
+    CreateVoiceAgentRequest,
+    DeletedVoiceAgent,
+    EmergencyAddress,
+    UpdateVoiceAgentRequest,
+    UpdateVoiceNumberRequest,
+    Voice,
+    VoiceAgent,
+    VoiceAgentListResponse,
+    VoiceAgentTools,
+    VoiceListResponse,
+    VoiceMode,
+    VoiceNumber,
+    VoiceNumberEmergencyAddress,
+    VoiceNumberListResponse,
+    VoiceNumberRates,
     OptInPage,
     PricingTier,
     QuotaSettings,
@@ -406,6 +438,36 @@ __all__ = [
     "RcsTestDeviceInput",
     "RcsTestDeviceListResponse",
     "RcsTesting",
+    # Voice call types
+    "Call",
+    "CallBilling",
+    "CallDirection",
+    "CallHandledBy",
+    "CallKind",
+    "CallListResponse",
+    "CallPagination",
+    "CallRecording",
+    "CallRecordingStatus",
+    "CallStatus",
+    "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",
@@ -427,6 +489,12 @@ __all__ = [
     # RCS resources
     "RcsResource",
     "AsyncRcsResource",
+    # Voice call resources
+    "CallsResource",
+    "AsyncCallsResource",
+    # Voice configuration resources
+    "VoiceResource",
+    "AsyncVoiceResource",
     # Errors
     "SendlyError",
     "AuthenticationError",