sentdm 0.39.0 → 0.40.0

data/lib/sentdm/resources/voice/calls.rb

@@ -20,6 +20,17 @@ module Sentdm
       # once one is ready, hang it up, start or stop recording, and add, mute or remove
       # conference participants while it is live. A leg to a phone number runs for at
       # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
       class Calls
         # Phone calls from the numbers you hold, driven by your own callback URL.
         #
@@ -38,15 +49,28 @@ module Sentdm
         # once one is ready, hang it up, start or stop recording, and add, mute or remove
         # conference participants while it is live. A leg to a phone number runs for at
         # most what your balance affords at the destination's rate.
+        #
+        # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+        # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+        # call as text (speech recognised and spoken for the agent) or as audio,
+        # `websocket_url` is where the gateway dials the agent for each call (leave it out
+        # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+        # `fallback` and `limits` say what it may do on a call. The agent's
+        # `signing_secret` is shown on create and on
+        # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+        # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+        # it is bound to it on `/v3/channels/voice`.
         # @return [Sentdm::Resources::Voice::Calls::Participants]
         attr_reader :participants
 
         # Some parameter documentations has been truncated, see
         # {Sentdm::Models::Voice::CallRetrieveParams} for more details.
         #
-        # Retrieves one of your calls by id: the parties, the owning number, the current
-        # status with its failure reason, duration, price, recording availability, and a
-        # timeline of when the call entered each status.
+        # Retrieves one of your calls by id: the parties, the owning number, the phone
+        # number the call was connected to and the caller id it showed, the current status
+        # with its failure reason, duration, price with the billed legs and what each
+        # cost, recording availability, and a timeline of when the call entered each
+        # status.
         #
         # @overload retrieve(id, x_profile_id: nil, request_options: {})
         #
@@ -74,16 +98,23 @@ module Sentdm
         # {Sentdm::Models::Voice::CallListParams} for more details.
         #
         # Retrieves a paginated list of your calls, most recent first. Filter by
-        # direction, status, the owning number, and the time the call started (from and to
-        # are inclusive). Use the call webhooks for real-time updates; this list is for
-        # looking calls up afterwards.
+        # direction, status, the owning number, the mode (inapp, or agent for calls your
+        # voice agents answered), the agent that answered, and the time the call started
+        # (from and to are inclusive). Each call carries the phone number it was connected
+        # to, the caller id it showed, and the billed legs with what each cost. Use the
+        # call webhooks for real-time updates; this list is for looking calls up
+        # afterwards.
         #
-        # @overload list(direction: nil, from: nil, number: nil, page: nil, page_size: nil, status: nil, to: nil, x_profile_id: nil, request_options: {})
+        # @overload list(agent_id: nil, direction: nil, from: nil, mode: nil, number: nil, page: nil, page_size: nil, status: nil, to: nil, x_profile_id: nil, request_options: {})
+        #
+        # @param agent_id [String, nil] Query param: Optional filter on the voice agent that answered the call, such as
         #
         # @param direction [String, nil] Query param: Optional direction filter: outbound for calls placed from your app,
         #
         # @param from [Time, nil] Query param: Only calls started at or after this time (ISO 8601)
         #
+        # @param mode [String, nil] Query param: Optional mode filter: inapp for calls routed by your number's callb
+        #
         # @param number [String, nil] Query param: Optional filter on the number that owns the call, one of your voice
         #
         # @param page [Integer] Query param: Page number (1-indexed)
@@ -102,7 +133,7 @@ module Sentdm
         #
         # @see Sentdm::Models::Voice::CallListParams
         def list(params = {})
-          query_params = [:direction, :from, :number, :page, :page_size, :status, :to]
+          query_params = [:agent_id, :direction, :from, :mode, :number, :page, :page_size, :status, :to]
           parsed, options = Sentdm::Voice::CallListParams.dump_request(params)
           query = Sentdm::Internal::Util.encode_query_params(parsed.slice(*query_params))
           @client.request(
@@ -122,8 +153,8 @@ module Sentdm
         # Ends one of your live calls. The call then ends the way any other call does once
         # the disconnect is reported: an answered call as COMPLETED with call.completed, a
         # call still ringing as NO_ANSWER, REJECTED or FAILED with call.failed. A call
-        # that has already ended answers 409, and so does a call with no phone leg, such
-        # as one between two app users.
+        # that has already ended answers 409, as do a call with no phone leg, such as one
+        # between two app users, and a call one of your voice agents answers.
         #
         # @overload hangup(id, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
         #
@@ -191,9 +222,9 @@ module Sentdm
         #
         # Starts or stops recording one of your live calls. Use start to begin recording
         # mid-call, or stop to end a recording, whether it was started here or by a
-        # connect answer with record set. A call that has already ended answers 409, and
-        # so does a call with no phone leg, such as one between two app users, which can't
-        # be recorded.
+        # connect answer with record set. A call that has already ended answers 409, as do
+        # a call with no phone leg, such as one between two app users, and a call one of
+        # your voice agents answers, neither of which can be recorded this way.
         #
         # @overload record(id, action: nil, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
         #

data/lib/sentdm/resources/voice/catalogue.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Resources
+    class Voice
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
+      class Catalogue
+        # Some parameter documentations has been truncated, see
+        # {Sentdm::Models::Voice::CatalogueListParams} for more details.
+        #
+        # The names a voice agent's `speech.voice` and `speech.language` accept, with the
+        # default marked. The list grows as voices are added; a name is never removed
+        # without notice.
+        #
+        # @overload list(x_profile_id: nil, request_options: {})
+        #
+        # @param x_profile_id [String] Profile UUID to scope the request to a child profile. Only organization API keys
+        #
+        # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Sentdm::Models::Voice::APIResponseOfVoiceCatalogue]
+        #
+        # @see Sentdm::Models::Voice::CatalogueListParams
+        def list(params = {})
+          parsed, options = Sentdm::Voice::CatalogueListParams.dump_request(params)
+          @client.request(
+            method: :get,
+            path: "v3/voice/voices",
+            headers: parsed.transform_keys(x_profile_id: "x-profile-id"),
+            model: Sentdm::Voice::APIResponseOfVoiceCatalogue,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Sentdm::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/sentdm/resources/voice/tokens.rb

@@ -20,6 +20,17 @@ module Sentdm
       # once one is ready, hang it up, start or stop recording, and add, mute or remove
       # conference participants while it is live. A leg to a phone number runs for at
       # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
       class Tokens
         # Some parameter documentations has been truncated, see
         # {Sentdm::Models::Voice::TokenCreateParams} for more details.

data/lib/sentdm/resources/voice.rb

@@ -20,6 +20,17 @@ module Sentdm
       # once one is ready, hang it up, start or stop recording, and add, mute or remove
       # conference participants while it is live. A leg to a phone number runs for at
       # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
       # @return [Sentdm::Resources::Voice::Calls]
       attr_reader :calls
 
@@ -40,9 +51,82 @@ module Sentdm
       # once one is ready, hang it up, start or stop recording, and add, mute or remove
       # conference participants while it is live. A leg to a phone number runs for at
       # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
       # @return [Sentdm::Resources::Voice::Tokens]
       attr_reader :tokens
 
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
+      # @return [Sentdm::Resources::Voice::Agents]
+      attr_reader :agents
+
+      # Phone calls from the numbers you hold, driven by your own callback URL.
+      #
+      # `POST /v3/channels/voice` enables a number for calls, with the callback URL Sent
+      # asks what to do with each call on it, and `POST /v3/voice/tokens` mints a
+      # short-lived token that lets a user of your app place and receive calls as that
+      # number. When a call arrives or a caller presses a key, a signed question is
+      # POSTed to the callback URL and the answer decides the call;
+      # `POST /v3/channels/voice/{number}/test` checks the URL answers the way we need
+      # before a real call reaches it, and
+      # `POST /v3/channels/voice/{number}/rotate-secret` replaces the signing secret.
+      # The call events themselves (`call.completed` and the rest) arrive through your
+      # webhooks.
+      #
+      # Every call is a record under `/v3/voice/calls`: read it, list its recordings
+      # once one is ready, hang it up, start or stop recording, and add, mute or remove
+      # conference participants while it is live. A leg to a phone number runs for at
+      # most what your balance affords at the destination's rate.
+      #
+      # **Voice agents.** `POST /v3/voice/agents` creates an agent that answers calls
+      # through the Sent Voice Gateway: `session_type` says whether Sent carries the
+      # call as text (speech recognised and spoken for the agent) or as audio,
+      # `websocket_url` is where the gateway dials the agent for each call (leave it out
+      # and the agent dials in with your API key), and `tools`, `transfer_targets`,
+      # `fallback` and `limits` say what it may do on a call. The agent's
+      # `signing_secret` is shown on create and on
+      # `POST /v3/voice/agents/{id}/rotate-secret` only. Voices and languages for text
+      # sessions come from `GET /v3/voice/voices`. A number takes calls to an agent once
+      # it is bound to it on `/v3/channels/voice`.
+      # @return [Sentdm::Resources::Voice::Catalogue]
+      attr_reader :catalogue
+
       # @api private
       #
       # @param client [Sentdm::Client]
@@ -50,6 +134,8 @@ module Sentdm
         @client = client
         @calls = Sentdm::Resources::Voice::Calls.new(client: client)
         @tokens = Sentdm::Resources::Voice::Tokens.new(client: client)
+        @agents = Sentdm::Resources::Voice::Agents.new(client: client)
+        @catalogue = Sentdm::Resources::Voice::Catalogue.new(client: client)
       end
     end
   end

data/lib/sentdm/resources/webhooks.rb

@@ -17,9 +17,17 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookCreateParams} for more details.
       #
-      # Creates a new webhook endpoint for the authenticated customer.
-      #
-      # @overload create(display_name: nil, endpoint_url: nil, event_filters: nil, event_types: nil, retry_count: nil, sandbox: nil, sender_profile: nil, timeout_seconds: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      # Creates a new webhook endpoint for the authenticated customer. A webhook is
+      # version 2 unless the request sets webhook_version to 1: Svix delivers it, signed
+      # with the webhook-id, webhook-timestamp and webhook-signature headers, and
+      # retries it on its own schedule, so retry_count and timeout_seconds apply to
+      # version 1 only. sender_profile applies to version 1 only and is ignored on
+      # version 2; is_inheritable applies to version 2 only. A version 1 webhook's
+      # response returns its sender_profile selection, with an empty event_types when it
+      # is not cloned onto sender profiles; a version 2 webhook's response leaves
+      # sender_profile out.
+      #
+      # @overload create(display_name: nil, endpoint_url: nil, event_filters: nil, event_types: nil, is_inheritable: nil, retry_count: nil, sandbox: nil, sender_profile: nil, timeout_seconds: nil, webhook_version: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param display_name [String] Body param
       #
@@ -29,13 +37,17 @@ module Sentdm
       #
       # @param event_types [Array<String>] Body param
       #
-      # @param retry_count [Integer] Body param
+      # @param is_inheritable [Boolean] Body param: Also delivers every sender profile's events to this webhook, at the
+      #
+      # @param retry_count [Integer] Body param: Delivery retries. Applies to version 1 only: Svix retries a version
       #
       # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
       # @param sender_profile [Sentdm::Models::WebhookCreateParams::SenderProfile, nil] Body param: Request-only: the events an organization webhook's sender profile cl
       #
-      # @param timeout_seconds [Integer] Body param
+      # @param timeout_seconds [Integer] Body param: Delivery timeout. Applies to version 1 only.
+      #
+      # @param webhook_version [Integer, nil] Body param: Who delivers the webhook: 2, the default, is delivered by Svix and s
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
@@ -62,7 +74,8 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookRetrieveParams} for more details.
       #
-      # Retrieves a single webhook by ID for the authenticated customer.
+      # Retrieves a single webhook by ID for the authenticated customer. A version 1
+      # webhook includes its sender_profile selection.
       #
       # @overload retrieve(id, x_profile_id: nil, request_options: {})
       #
@@ -89,9 +102,13 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookUpdateParams} for more details.
       #
-      # Updates an existing webhook for the authenticated customer.
+      # Updates an existing webhook for the authenticated customer. Its version does not
+      # change. sender_profile applies to a version 1 webhook and is_inheritable to a
+      # version 2 one; retry_count and timeout_seconds apply to version 1 only. A
+      # version 1 webhook's response returns its sender_profile selection as saved; a
+      # version 2 webhook's response leaves sender_profile out.
       #
-      # @overload update(id, display_name: nil, endpoint_url: nil, event_filters: nil, event_types: nil, retry_count: nil, sandbox: nil, sender_profile: nil, timeout_seconds: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      # @overload update(id, display_name: nil, endpoint_url: nil, event_filters: nil, event_types: nil, is_inheritable: nil, retry_count: nil, sandbox: nil, sender_profile: nil, timeout_seconds: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param id [String] Path param
       #
@@ -103,6 +120,8 @@ module Sentdm
       #
       # @param event_types [Array<String>] Body param
       #
+      # @param is_inheritable [Boolean, nil] Body param: Makes this webhook inheritable by the organization's sender profiles
+      #
       # @param retry_count [Integer] Body param
       #
       # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
@@ -136,7 +155,8 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookListParams} for more details.
       #
-      # Retrieves a paginated list of webhooks for the authenticated customer.
+      # Retrieves a paginated list of webhooks for the authenticated customer. Each
+      # version 1 webhook includes its sender_profile selection.
       #
       # @overload list(is_active: nil, page: nil, page_size: nil, search: nil, x_profile_id: nil, request_options: {})
       #
@@ -225,9 +245,11 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookListEventsParams} for more details.
       #
-      # Retrieves a paginated list of delivery events for the specified webhook. If the
-      # webhook is cloned onto your sender profiles, the list includes what those clones
-      # received; read payload.account_id to tell whose event it is.
+      # Retrieves a paginated list of delivery events for the specified webhook, newest
+      # first. If the webhook is cloned onto your sender profiles (version 1) or
+      # inheritable by them (version 2, is_inheritable), the list includes their events;
+      # read payload.account_id to tell whose event it is. A sender profile may read its
+      # organization's inheritable webhook too, and gets the events about itself.
       #
       # @overload list_events(id, page: nil, page_size: nil, search: nil, x_profile_id: nil, request_options: {})
       #
@@ -264,8 +286,11 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookRotateSecretParams} for more details.
       #
-      # Generates a new signing secret for the specified webhook. The old secret is
-      # immediately invalidated.
+      # Generates a new signing secret for the specified webhook. A version 1 webhook's
+      # old secret stops verifying at once. A version 2 webhook's deliveries are signed
+      # with the new secret at once, and with the old one as well for the next 24 hours,
+      # so a receiver can switch over without rejecting any; after that the old secret
+      # no longer verifies.
       #
       # @overload rotate_secret(id, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
@@ -298,7 +323,10 @@ module Sentdm
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::WebhookTestParams} for more details.
       #
-      # Sends a test event to the specified webhook endpoint to verify connectivity.
+      # Sends a test event to the specified webhook endpoint to verify connectivity. A
+      # version 1 webhook is tested at once and the answer says whether it was
+      # delivered; a version 2 webhook's test is queued with Svix, which delivers it
+      # right after, and the answer says it was queued.
       #
       # @overload test_(id, event_type: nil, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #

data/lib/sentdm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sentdm
-  VERSION = "0.39.0"
+  VERSION = "0.40.0"
 end

data/lib/sentdm.rb

@@ -56,6 +56,7 @@ require_relative "sentdm/internal/calls_page"
 require_relative "sentdm/internal/contacts_page"
 require_relative "sentdm/internal/conversations_page"
 require_relative "sentdm/internal/templates_page"
+require_relative "sentdm/internal/voice_agents_page"
 require_relative "sentdm/internal/webhook_events_page"
 require_relative "sentdm/internal/webhooks_page"
 require_relative "sentdm/models/channels/voice_number"
@@ -172,9 +173,19 @@ require_relative "sentdm/models/user_remove_params"
 require_relative "sentdm/models/user_response"
 require_relative "sentdm/models/user_retrieve_params"
 require_relative "sentdm/models/user_update_role_params"
+require_relative "sentdm/models/voice/agent_create_params"
+require_relative "sentdm/models/voice/agent_delete_params"
+require_relative "sentdm/models/voice/agent_list_params"
+require_relative "sentdm/models/voice/agent_retrieve_params"
+require_relative "sentdm/models/voice/agent_rotate_secret_params"
+require_relative "sentdm/models/voice/agent_update_params"
 require_relative "sentdm/models/voice/api_response_of_call"
 require_relative "sentdm/models/voice/api_response_of_call_recordings"
 require_relative "sentdm/models/voice/api_response_of_calls_list"
+require_relative "sentdm/models/voice/api_response_of_voice_agent"
+require_relative "sentdm/models/voice/api_response_of_voice_agent_secret"
+require_relative "sentdm/models/voice/api_response_of_voice_agents_list"
+require_relative "sentdm/models/voice/api_response_of_voice_catalogue"
 require_relative "sentdm/models/voice/api_response_of_voice_token"
 require_relative "sentdm/models/voice/call"
 require_relative "sentdm/models/voice/call_hangup_params"
@@ -195,7 +206,23 @@ require_relative "sentdm/models/voice/calls/participant_remove_params"
 require_relative "sentdm/models/voice/calls/participant_update_params"
 require_relative "sentdm/models/voice/calls_list"
 require_relative "sentdm/models/voice/call_timeline_entry"
+require_relative "sentdm/models/voice/catalogue_list_params"
 require_relative "sentdm/models/voice/token_create_params"
+require_relative "sentdm/models/voice/voice_agent"
+require_relative "sentdm/models/voice/voice_agent_audio"
+require_relative "sentdm/models/voice/voice_agent_audio_spec"
+require_relative "sentdm/models/voice/voice_agent_limits"
+require_relative "sentdm/models/voice/voice_agent_limits_spec"
+require_relative "sentdm/models/voice/voice_agent_party"
+require_relative "sentdm/models/voice/voice_agent_party_spec"
+require_relative "sentdm/models/voice/voice_agent_secret"
+require_relative "sentdm/models/voice/voice_agents_list"
+require_relative "sentdm/models/voice/voice_agent_speech"
+require_relative "sentdm/models/voice/voice_agent_speech_spec"
+require_relative "sentdm/models/voice/voice_agent_transcripts"
+require_relative "sentdm/models/voice/voice_agent_transcripts_spec"
+require_relative "sentdm/models/voice/voice_catalogue"
+require_relative "sentdm/models/voice/voice_catalogue_voice"
 require_relative "sentdm/models/voice/voice_token"
 require_relative "sentdm/models/webhook_create_params"
 require_relative "sentdm/models/webhook_delete_params"
@@ -226,7 +253,9 @@ require_relative "sentdm/resources/profiles/campaigns"
 require_relative "sentdm/resources/templates"
 require_relative "sentdm/resources/users"
 require_relative "sentdm/resources/voice"
+require_relative "sentdm/resources/voice/agents"
 require_relative "sentdm/resources/voice/calls"
 require_relative "sentdm/resources/voice/calls/participants"
+require_relative "sentdm/resources/voice/catalogue"
 require_relative "sentdm/resources/voice/tokens"
 require_relative "sentdm/resources/webhooks"

data/rbi/sentdm/internal/voice_agents_page.rbi

@@ -0,0 +1,71 @@
+# typed: strong
+
+module Sentdm
+  module Internal
+    class VoiceAgentsPage
+      include Sentdm::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(Data) }
+      attr_accessor :data
+
+      # @api private
+      sig { returns(String) }
+      def inspect
+      end
+
+      class Data < Sentdm::Internal::Type::BaseModel
+        OrHash = T.type_alias { T.any(Data, Sentdm::Internal::AnyHash) }
+
+        sig { returns(T.nilable(T::Array[T.anything])) }
+        attr_reader :agents
+
+        sig { params(agents: T::Array[T.anything]).void }
+        attr_writer :agents
+
+        sig { returns(T.nilable(Data::Pagination)) }
+        attr_reader :pagination
+
+        sig { params(pagination: Data::Pagination::OrHash).void }
+        attr_writer :pagination
+
+        sig do
+          params(
+            agents: T::Array[T.anything],
+            pagination: Data::Pagination::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(agents: nil, pagination: nil)
+        end
+
+        sig do
+          override.returns(
+            { agents: T::Array[T.anything], pagination: Data::Pagination }
+          )
+        end
+        def to_hash
+        end
+
+        class Pagination < Sentdm::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias { T.any(Data::Pagination, Sentdm::Internal::AnyHash) }
+
+          sig { returns(T.nilable(T::Boolean)) }
+          attr_reader :has_more
+
+          sig { params(has_more: T::Boolean).void }
+          attr_writer :has_more
+
+          sig { params(has_more: T::Boolean).returns(T.attached_class) }
+          def self.new(has_more: nil)
+          end
+
+          sig { override.returns({ has_more: T::Boolean }) }
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/sentdm/models/call_event.rbi

@@ -20,15 +20,17 @@ module Sentdm
       sig { params(field: String).void }
       attr_writer :field
 
-      # Body of a call.initiated, call.answered, call.completed, call.failed or
-      # call.recording_ready event. Which of them occurred is the envelope's event.
+      # Body of a call.initiated, call.answered, call.agent_connected, call.completed,
+      # call.failed or call.recording_ready event. Which of them occurred is the
+      # envelope's event.
       #
       # Shaped like the message, inbound, template and channel payloads: account_id
       # names the account the event is about, channel names the channel, and updated_at
       # is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-      # duration_seconds and price are added on call.completed, reason on call.failed
-      # and recording_id on call.recording_ready; each is omitted rather than sent as
-      # null when it does not apply.
+      # Every event says how the call is handled in mode, and an agent call names its
+      # agent in agent_id. duration_seconds and price are added on call.completed,
+      # reason on call.failed and recording_id on call.recording_ready; each is omitted
+      # rather than sent as null when it does not apply.
       #
       # Casing is snake_case because these ride the same webhook stream customers
       # already parse message_id from; the question/answer contract is a separate
@@ -72,15 +74,17 @@ module Sentdm
         # The event family, for example message, templates or contact. Route on this
         # first, then on event for the specific change.
         field: nil,
-        # Body of a call.initiated, call.answered, call.completed, call.failed or
-        # call.recording_ready event. Which of them occurred is the envelope's event.
+        # Body of a call.initiated, call.answered, call.agent_connected, call.completed,
+        # call.failed or call.recording_ready event. Which of them occurred is the
+        # envelope's event.
         #
         # Shaped like the message, inbound, template and channel payloads: account_id
         # names the account the event is about, channel names the channel, and updated_at
         # is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-        # duration_seconds and price are added on call.completed, reason on call.failed
-        # and recording_id on call.recording_ready; each is omitted rather than sent as
-        # null when it does not apply.
+        # Every event says how the call is handled in mode, and an agent call names its
+        # agent in agent_id. duration_seconds and price are added on call.completed,
+        # reason on call.failed and recording_id on call.recording_ready; each is omitted
+        # rather than sent as null when it does not apply.
         #
         # Casing is snake_case because these ride the same webhook stream customers
         # already parse message_id from; the question/answer contract is a separate