sendly 4.5.1__tar.gz → 4.6.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sendly
-Version: 4.5.1
+Version: 4.6.0
 Summary: Official Sendly Python SDK for SMS messaging
 Project-URL: Homepage, https://sendly.live
 Project-URL: Documentation, https://sendly.live/docs
@@ -552,8 +552,8 @@ contents.
 
 Write methods that accept `idempotency_key` include `messages.send`,
 `messages.schedule`, `messages.send_batch`, `messages.send_group`,
-`calls.create`, `calls.hangup`, every `voice.*` write, and every
-`rcs.brands` / `rcs.agents` write.
+`calls.create`, `calls.hangup`, `calls.transfer`, every `voice.*` write but
+`voice.agents.test`, and every `rcs.brands` / `rcs.agents` write.
 
 Full details: https://sendly.live/docs/idempotency
 
@@ -1874,9 +1874,9 @@ if event.type.startswith('short_code.'):
 ## 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
+ring and after they end, transfer callers, end calls early, and download
+recordings. Requires an API key with the `calls:read` / `calls:write` scopes;
+placing, transferring 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).
 
@@ -1915,6 +1915,15 @@ for c in page.data:
 if page.pagination.has_more:
     page = client.calls.list(status='completed', direction='outbound', limit=20, offset=20)
 
+# Only calls answered by one kind of agent (sendly, custom_llm, sip, websocket)
+page = client.calls.list(agent_kind='websocket')
+
+# Transfer the caller on an incoming phone call; without `to`, the agent's
+# transfer number (tools.transfer_to) is used
+incoming = client.calls.list(direction='inbound', status='active').data[0]
+incoming = client.calls.transfer(incoming.id, to='+15551234500')
+print(incoming.transfer.status)  # 'pending', then 'completed' or 'failed'
+
 # End a call early (idempotent: an ended call is returned unchanged)
 client.calls.hangup(call.id)
 
@@ -1938,10 +1947,23 @@ Refusals come back as `SendlyError` with a code that says what to do:
 `agent_not_found` / `agent_disabled`, `from_number_required` / `no_voice_number`,
 `from_number_not_supported` (calls are placed from US and Canadian numbers only),
 `number_not_found`, `destination_not_supported`, `outbound_calls_not_enabled`,
-`live_key_required`. Webhooks `call.started`, `call.completed`
+`live_key_required`, and `agent_kind_unsupported` (`sip` and `websocket`
+agents answer incoming calls only). Webhooks `call.started`, `call.completed`
 and `call.recording.ready` carry the same call object in snake_case, including
 `billing` and your `metadata`.
 
+Each call carries `agent_kind` (the kind of agent that answered, or None),
+`agent_fallback` (True when your own agent could not be reached, so Sendly
+said a short line and transferred the caller or took a message) and
+`transfer` (None, or `to`, `status` and `failure_reason`). A transfer answers
+at once with `transfer.status` `pending`; once the caller is handed over the
+call ends `completed` with `hangup_class` `transferred`, and a failed transfer
+leaves the caller on the call. Transfer refusals: `transfer_to_required`,
+`outbound_not_enabled` (a number other than the agent's needs calling out
+switched on), `insufficient_credits`, `call_not_active`,
+`call_not_transferable` (not an incoming phone call) and
+`transfer_in_progress`.
+
 ### Configure voice
 
 Everything a call depends on can be set up from code: switch voice on for a
@@ -2025,9 +2047,83 @@ 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.
+`e.response.model_extra['suggested']`. An agent's `tools.transfer_to` is the
+number it transfers a caller to when asked for a person.
+
+### Bring your own agent
+
+An agent's `kind` says who writes the replies: `sendly` (the default, from the
+agent's `instructions`), `custom_llm` (Sendly listens and speaks, and your chat
+completions endpoint writes each reply), `sip` (Sendly connects the caller to
+your SIP address) or `websocket` (Sendly streams the call audio to your
+`wss://` server). Your own agents need the workspace's bring-your-own-agent
+feature, which support switches on (`byo_agents_not_enabled` otherwise).
+
+```python
+from sendly import VoiceAgentWebsocketConnectionInput
+
+agent = client.voice.agents.create(
+    'Support line',
+    kind='websocket',
+    connection=VoiceAgentWebsocketConnectionInput(
+        url='wss://agent.example.com/calls', auth_token='tok_123'
+    ),
+)
+secret = agent.signing_secret  # save it now; it is never shown again
+print(agent.connection.url, agent.connection.has_auth_token, agent.has_signing_secret)
+
+# Same kind: the connection is merged, so only what you pass changes
+client.voice.agents.update(agent.id, connection={'custom_parameters': {'tenant': 'acme'}})
+
+# A new signing secret; the old one stops working at once
+secret = client.voice.agents.update(agent.id, rotate_signing_secret=True).signing_secret
+```
+
+`connection` is a `VoiceAgentCustomLlmConnectionInput` (`base_url`, `model`,
+`api_key`, `headers`), `VoiceAgentSipConnectionInput` (`uri`, `transport`,
+`media_encryption`, `username`, `password`, `headers`),
+`VoiceAgentWebsocketConnectionInput` (`url`, `audio_format`, `auth_token`,
+`custom_parameters`) or a dict. A secret you leave out keeps its saved value
+and None removes it. Secrets are never returned: `agent.connection` reports
+`has_api_key`, `has_password` or `has_auth_token` instead. Sendly signs every
+request to your agent with the signing secret
+(`X-Sendly-Signature: t=<unix>,v1=<hex HMAC-SHA256>`); `signing_secret` is set
+only on the create or update response that made it. A `connection` that breaks
+a rule raises `ValidationError` with a message like
+`connection.url: <reason>`.
+
+#### Test an agent's connection
+
+`voice.agents.test` reaches your own agent the way a call would, without
+placing one: `custom_llm` gets a signed, streamed chat completion with a test
+message, `websocket` gets a signed connection with a `start` carrying
+`test: true`, half a second of silence and a `stop`, and `sip` gets an
+`OPTIONS` request. Pass `kind`, `connection` or `instructions` to test settings
+before saving them; nothing is saved.
+
+```python
+result = client.voice.agents.test(agent.id)
+if not result.ok:
+    print(result.outcome, result.message)  # e.g. 'auth_failed'
+for step in result.steps:
+    print(step.step, step.ok, step.detail)
+
+# Try a new SIP address before saving it
+client.voice.agents.test(
+    agent.id,
+    kind='sip',
+    connection={'uri': 'sip:+15125550100@sip.example.com', 'transport': 'tls'},
+)
+```
+
+A failed test is still a successful request, so check `ok`. `outcome` is
+`ok`, `blocked_destination`, `unreachable`, `timeout`, `tls_failed`,
+`auth_required`, `auth_failed`, `not_found`, `rejected` or `bad_reply` (see
+`VoiceAgentTestOutcome`; a value added later comes through as a plain string),
+and each step is `address`, `connect`, `login` or `reply`. The result also
+carries `status` (the HTTP or SIP status, or None), `latency_ms` and `signed`.
+It needs the `calls:write` scope and a live key, takes no `idempotency_key`,
+and a workspace can run 10 tests a minute (`RateLimitError` after that).
 
 ## Error Handling
 

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

@@ -517,8 +517,8 @@ contents.
 
 Write methods that accept `idempotency_key` include `messages.send`,
 `messages.schedule`, `messages.send_batch`, `messages.send_group`,
-`calls.create`, `calls.hangup`, every `voice.*` write, and every
-`rcs.brands` / `rcs.agents` write.
+`calls.create`, `calls.hangup`, `calls.transfer`, every `voice.*` write but
+`voice.agents.test`, and every `rcs.brands` / `rcs.agents` write.
 
 Full details: https://sendly.live/docs/idempotency
 
@@ -1839,9 +1839,9 @@ if event.type.startswith('short_code.'):
 ## 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
+ring and after they end, transfer callers, end calls early, and download
+recordings. Requires an API key with the `calls:read` / `calls:write` scopes;
+placing, transferring 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).
 
@@ -1880,6 +1880,15 @@ for c in page.data:
 if page.pagination.has_more:
     page = client.calls.list(status='completed', direction='outbound', limit=20, offset=20)
 
+# Only calls answered by one kind of agent (sendly, custom_llm, sip, websocket)
+page = client.calls.list(agent_kind='websocket')
+
+# Transfer the caller on an incoming phone call; without `to`, the agent's
+# transfer number (tools.transfer_to) is used
+incoming = client.calls.list(direction='inbound', status='active').data[0]
+incoming = client.calls.transfer(incoming.id, to='+15551234500')
+print(incoming.transfer.status)  # 'pending', then 'completed' or 'failed'
+
 # End a call early (idempotent: an ended call is returned unchanged)
 client.calls.hangup(call.id)
 
@@ -1903,10 +1912,23 @@ Refusals come back as `SendlyError` with a code that says what to do:
 `agent_not_found` / `agent_disabled`, `from_number_required` / `no_voice_number`,
 `from_number_not_supported` (calls are placed from US and Canadian numbers only),
 `number_not_found`, `destination_not_supported`, `outbound_calls_not_enabled`,
-`live_key_required`. Webhooks `call.started`, `call.completed`
+`live_key_required`, and `agent_kind_unsupported` (`sip` and `websocket`
+agents answer incoming calls only). Webhooks `call.started`, `call.completed`
 and `call.recording.ready` carry the same call object in snake_case, including
 `billing` and your `metadata`.
 
+Each call carries `agent_kind` (the kind of agent that answered, or None),
+`agent_fallback` (True when your own agent could not be reached, so Sendly
+said a short line and transferred the caller or took a message) and
+`transfer` (None, or `to`, `status` and `failure_reason`). A transfer answers
+at once with `transfer.status` `pending`; once the caller is handed over the
+call ends `completed` with `hangup_class` `transferred`, and a failed transfer
+leaves the caller on the call. Transfer refusals: `transfer_to_required`,
+`outbound_not_enabled` (a number other than the agent's needs calling out
+switched on), `insufficient_credits`, `call_not_active`,
+`call_not_transferable` (not an incoming phone call) and
+`transfer_in_progress`.
+
 ### Configure voice
 
 Everything a call depends on can be set up from code: switch voice on for a
@@ -1990,9 +2012,83 @@ 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.
+`e.response.model_extra['suggested']`. An agent's `tools.transfer_to` is the
+number it transfers a caller to when asked for a person.
+
+### Bring your own agent
+
+An agent's `kind` says who writes the replies: `sendly` (the default, from the
+agent's `instructions`), `custom_llm` (Sendly listens and speaks, and your chat
+completions endpoint writes each reply), `sip` (Sendly connects the caller to
+your SIP address) or `websocket` (Sendly streams the call audio to your
+`wss://` server). Your own agents need the workspace's bring-your-own-agent
+feature, which support switches on (`byo_agents_not_enabled` otherwise).
+
+```python
+from sendly import VoiceAgentWebsocketConnectionInput
+
+agent = client.voice.agents.create(
+    'Support line',
+    kind='websocket',
+    connection=VoiceAgentWebsocketConnectionInput(
+        url='wss://agent.example.com/calls', auth_token='tok_123'
+    ),
+)
+secret = agent.signing_secret  # save it now; it is never shown again
+print(agent.connection.url, agent.connection.has_auth_token, agent.has_signing_secret)
+
+# Same kind: the connection is merged, so only what you pass changes
+client.voice.agents.update(agent.id, connection={'custom_parameters': {'tenant': 'acme'}})
+
+# A new signing secret; the old one stops working at once
+secret = client.voice.agents.update(agent.id, rotate_signing_secret=True).signing_secret
+```
+
+`connection` is a `VoiceAgentCustomLlmConnectionInput` (`base_url`, `model`,
+`api_key`, `headers`), `VoiceAgentSipConnectionInput` (`uri`, `transport`,
+`media_encryption`, `username`, `password`, `headers`),
+`VoiceAgentWebsocketConnectionInput` (`url`, `audio_format`, `auth_token`,
+`custom_parameters`) or a dict. A secret you leave out keeps its saved value
+and None removes it. Secrets are never returned: `agent.connection` reports
+`has_api_key`, `has_password` or `has_auth_token` instead. Sendly signs every
+request to your agent with the signing secret
+(`X-Sendly-Signature: t=<unix>,v1=<hex HMAC-SHA256>`); `signing_secret` is set
+only on the create or update response that made it. A `connection` that breaks
+a rule raises `ValidationError` with a message like
+`connection.url: <reason>`.
+
+#### Test an agent's connection
+
+`voice.agents.test` reaches your own agent the way a call would, without
+placing one: `custom_llm` gets a signed, streamed chat completion with a test
+message, `websocket` gets a signed connection with a `start` carrying
+`test: true`, half a second of silence and a `stop`, and `sip` gets an
+`OPTIONS` request. Pass `kind`, `connection` or `instructions` to test settings
+before saving them; nothing is saved.
+
+```python
+result = client.voice.agents.test(agent.id)
+if not result.ok:
+    print(result.outcome, result.message)  # e.g. 'auth_failed'
+for step in result.steps:
+    print(step.step, step.ok, step.detail)
+
+# Try a new SIP address before saving it
+client.voice.agents.test(
+    agent.id,
+    kind='sip',
+    connection={'uri': 'sip:+15125550100@sip.example.com', 'transport': 'tls'},
+)
+```
+
+A failed test is still a successful request, so check `ok`. `outcome` is
+`ok`, `blocked_destination`, `unreachable`, `timeout`, `tls_failed`,
+`auth_required`, `auth_failed`, `not_found`, `rejected` or `bad_reply` (see
+`VoiceAgentTestOutcome`; a value added later comes through as a plain string),
+and each step is `address`, `connect`, `login` or `reply`. The result also
+carries `status` (the HTTP or SIP status, or None), `latency_ms` and `signed`.
+It needs the `calls:write` scope and a live key, takes no `idempotency_key`,
+and a workspace can run 10 tests a minute (`RateLimitError` after that).
 
 ## Error Handling
 

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

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

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

@@ -29,7 +29,7 @@ Async Example:
     >>> asyncio.run(main())
 """
 
-__version__ = "4.5.1"
+__version__ = "4.6.0"
 
 # Main clients
 from .client import AsyncSendly, Sendly
@@ -216,24 +216,42 @@ from .types import (
     CallRecordingStatus,
     CallStatus,
     CallTranscriptLine,
+    CallTransfer,
+    CallTransferFailureReason,
+    CallTransferStatus,
     CreateCallRequest,
     ListCallsOptions,
+    TransferCallRequest,
     # Voice configuration types
     CreateVoiceAgentRequest,
     DeletedVoiceAgent,
     EmergencyAddress,
+    SipMediaEncryption,
+    SipTransport,
+    TestVoiceAgentRequest,
     UpdateVoiceAgentRequest,
     UpdateVoiceNumberRequest,
     Voice,
     VoiceAgent,
+    VoiceAgentConnection,
+    VoiceAgentConnectionInput,
+    VoiceAgentCustomLlmConnectionInput,
+    VoiceAgentKind,
     VoiceAgentListResponse,
+    VoiceAgentSipConnectionInput,
+    VoiceAgentTest,
+    VoiceAgentTestOutcome,
+    VoiceAgentTestStep,
+    VoiceAgentTestStepName,
     VoiceAgentTools,
+    VoiceAgentWebsocketConnectionInput,
     VoiceListResponse,
     VoiceMode,
     VoiceNumber,
     VoiceNumberEmergencyAddress,
     VoiceNumberListResponse,
     VoiceNumberRates,
+    WebsocketAudioFormat,
     OptInPage,
     PricingTier,
     QuotaSettings,
@@ -466,24 +484,42 @@ __all__ = [
     "CallRecordingStatus",
     "CallStatus",
     "CallTranscriptLine",
+    "CallTransfer",
+    "CallTransferFailureReason",
+    "CallTransferStatus",
     "CreateCallRequest",
     "ListCallsOptions",
+    "TransferCallRequest",
     # Voice configuration types
     "CreateVoiceAgentRequest",
     "DeletedVoiceAgent",
     "EmergencyAddress",
+    "SipMediaEncryption",
+    "SipTransport",
+    "TestVoiceAgentRequest",
     "UpdateVoiceAgentRequest",
     "UpdateVoiceNumberRequest",
     "Voice",
     "VoiceAgent",
+    "VoiceAgentConnection",
+    "VoiceAgentConnectionInput",
+    "VoiceAgentCustomLlmConnectionInput",
+    "VoiceAgentKind",
     "VoiceAgentListResponse",
+    "VoiceAgentSipConnectionInput",
+    "VoiceAgentTest",
+    "VoiceAgentTestOutcome",
+    "VoiceAgentTestStep",
+    "VoiceAgentTestStepName",
     "VoiceAgentTools",
+    "VoiceAgentWebsocketConnectionInput",
     "VoiceListResponse",
     "VoiceMode",
     "VoiceNumber",
     "VoiceNumberEmergencyAddress",
     "VoiceNumberListResponse",
     "VoiceNumberRates",
+    "WebsocketAudioFormat",
     # Links resources
     "LinksResource",
     "AsyncLinksResource",

{sendly-4.5.1 → sendly-4.6.0}/sendly/resources/calls.py

@@ -3,13 +3,15 @@ Calls Resource - Phone calls handled by your AI agents
 
 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
-live in ``client.voice``; ``client.voice.numbers.list()`` reports each
+calls, transfer a caller to another number, end a call, and fetch
+recordings. Switching voice on for a number, choosing how it answers,
+registering an emergency address and creating agents 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``.
-Placing and ending calls needs a live key (``live_key_required`` otherwise).
+Placing, transferring and ending calls needs a live key
+(``live_key_required`` otherwise).
 Voice is enabled workspace by workspace; until it is enabled for yours every
 method raises ``SendlyError`` with code ``voice_not_enabled`` (HTTP 404).
 
@@ -103,6 +105,9 @@ class CallsResource:
                 (register an emergency address for the number first with
                 ``client.voice.numbers.register_emergency_address``),
                 ``lines_busy`` (retry shortly), ``daily_call_limit``,
+                ``agent_kind_unsupported`` (HTTP 409: the agent's ``kind`` is
+                ``sip`` or ``websocket``, which answer incoming calls only;
+                ``custom_llm`` agents can place calls),
                 ``outbound_calls_not_enabled`` or ``voice_not_enabled``.
 
         Example:
@@ -129,6 +134,7 @@ class CallsResource:
         direction: Optional[EnumLike] = None,
         kind: Optional[EnumLike] = None,
         agent_id: Optional[str] = None,
+        agent_kind: Optional[EnumLike] = None,
         to: Optional[str] = None,
         from_: Optional[str] = None,
     ) -> CallListResponse:
@@ -145,6 +151,10 @@ class CallsResource:
             direction: ``inbound`` or ``outbound``.
             kind: ``pstn`` or ``internal``.
             agent_id: Only calls handled by this agent.
+            agent_kind: Only calls answered by this kind of agent:
+                ``sendly``, ``custom_llm``, ``sip`` or ``websocket`` (see
+                :class:`~sendly.types.VoiceAgentKind`). Calls from before
+                agent kinds existed count as ``sendly``.
             to: Exact E.164 match on the called number.
             from_: Exact E.164 match on the calling number.
 
@@ -155,7 +165,9 @@ class CallsResource:
             >>> if page.pagination.has_more:
             ...     page = client.calls.list(status='completed', limit=20, offset=20)
         """
-        params = _list_params(limit, offset, status, direction, kind, agent_id, to, from_)
+        params = _list_params(
+            limit, offset, status, direction, kind, agent_id, agent_kind, to, from_
+        )
         data = self._http.request(
             method="GET", path="/calls", params=params if params else None
         )
@@ -197,6 +209,62 @@ class CallsResource:
         )
         return _parse(Call, data)
 
+    def transfer(
+        self,
+        id: str,
+        to: Optional[str] = None,
+        *,
+        idempotency_key: Optional[str] = None,
+    ) -> Call:
+        """Transfer the caller on an incoming phone call to another number.
+        Requires the ``calls:write`` scope and a live API key.
+
+        Works whatever kind of agent is on the call. Returns at once with
+        ``transfer.status`` ``pending``; the outcome shows on :meth:`get`
+        (``transfer.status``) and, once the caller is handed over, the call
+        ends ``completed`` with ``hangup_class`` ``transferred`` (also in the
+        ``call.completed`` webhook). A failed transfer leaves the caller on
+        the call, with ``transfer.failure_reason`` saying why.
+
+        Args:
+            id: Call identifier.
+            to: Number to transfer the caller to, in E.164 format: US or
+                Canadian, not premium-rate, not the number the caller dialled
+                and not a number the agent answers. Left out (not sent), the
+                agent's transfer number (``tools.transfer_to``) is used. Any
+                other number needs calling out switched on for the workspace.
+            idempotency_key: Optional key sent as the Idempotency-Key header;
+                generated automatically when omitted.
+
+        Raises:
+            ValidationError: ``id`` is empty, or the API answered
+                ``invalid_request`` (``to`` is malformed, outside the US and
+                Canada, premium-rate, the dialled number or a number the agent
+                answers).
+            InsufficientCreditsError: The workspace has no credits left.
+            SendlyError: With ``code`` ``transfer_to_required`` (HTTP 400, no
+                ``to`` and the agent has no transfer number),
+                ``outbound_not_enabled`` (HTTP 403, ``to`` is not the agent's
+                transfer number and calling out is not switched on),
+                ``call_not_found`` (HTTP 404), ``call_not_active`` (HTTP 409,
+                the call is not in progress), ``call_not_transferable``
+                (HTTP 409, not an incoming phone call), ``transfer_in_progress``
+                (HTTP 409, a transfer is already under way, or the call has had
+                3 transfer attempts) or ``voice_internal_error`` (HTTP 500).
+
+        Example:
+            >>> call = client.calls.transfer(call.id, to='+15555550142')
+            >>> print(call.transfer.status)  # 'pending'
+        """
+        _require(id, "id")
+        data = self._http.request(
+            method="POST",
+            path=f"/calls/{quote(id, safe='')}/transfer",
+            body=_transfer_body(to),
+            idempotency_key=idempotency_key,
+        )
+        return _parse(Call, data)
+
     def recording(self, id: str) -> CallRecording:
         """Fetch where to download a call's recording. Requires the
         ``calls:read`` scope.
@@ -254,11 +322,14 @@ class AsyncCallsResource:
         direction: Optional[EnumLike] = None,
         kind: Optional[EnumLike] = None,
         agent_id: Optional[str] = None,
+        agent_kind: Optional[EnumLike] = None,
         to: Optional[str] = None,
         from_: Optional[str] = None,
     ) -> CallListResponse:
         """List calls, newest first. See :meth:`CallsResource.list`."""
-        params = _list_params(limit, offset, status, direction, kind, agent_id, to, from_)
+        params = _list_params(
+            limit, offset, status, direction, kind, agent_id, agent_kind, to, from_
+        )
         data = await self._http.request(
             method="GET", path="/calls", params=params if params else None
         )
@@ -281,6 +352,24 @@ class AsyncCallsResource:
         )
         return _parse(Call, data)
 
+    async def transfer(
+        self,
+        id: str,
+        to: Optional[str] = None,
+        *,
+        idempotency_key: Optional[str] = None,
+    ) -> Call:
+        """Transfer the caller on an incoming phone call to another number.
+        See :meth:`CallsResource.transfer`."""
+        _require(id, "id")
+        data = await self._http.request(
+            method="POST",
+            path=f"/calls/{quote(id, safe='')}/transfer",
+            body=_transfer_body(to),
+            idempotency_key=idempotency_key,
+        )
+        return _parse(Call, data)
+
     async def recording(self, id: str) -> CallRecording:
         """Fetch where to download a call's recording.
         See :meth:`CallsResource.recording`."""
@@ -323,6 +412,13 @@ def _create_body(
     return body
 
 
+def _transfer_body(to: Optional[str]) -> Dict[str, Any]:
+    body: Dict[str, Any] = {}
+    if to is not None:
+        body["to"] = to
+    return body
+
+
 def _list_params(
     limit: Optional[int],
     offset: Optional[int],
@@ -330,6 +426,7 @@ def _list_params(
     direction: Optional[EnumLike],
     kind: Optional[EnumLike],
     agent_id: Optional[str],
+    agent_kind: Optional[EnumLike],
     to: Optional[str],
     from_: Optional[str],
 ) -> Dict[str, Any]:
@@ -341,6 +438,7 @@ def _list_params(
         "direction": _value(direction),
         "kind": _value(kind),
         "agentId": agent_id,
+        "agentKind": _value(agent_kind),
         "to": to,
         "from": from_,
     }