sentdm 0.38.1 → 0.40.0

data/lib/sentdm/resources/voice.rb

@@ -0,0 +1,142 @@
+# 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`.
+      # @return [Sentdm::Resources::Voice::Calls]
+      attr_reader :calls
+
+      # 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::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]
+      def initialize(client:)
+        @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
+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.38.1"
+  VERSION = "0.40.0"
 end

data/lib/sentdm.rb

@@ -56,15 +56,13 @@ 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/mutation_request"
 require_relative "sentdm/models/channels/voice_number"
+require_relative "sentdm/models/mutation_request"
 require_relative "sentdm/models/template_body_content"
 require_relative "sentdm/models/api_meta"
-require_relative "sentdm/models/api_response_of_call"
-require_relative "sentdm/models/api_response_of_call_recordings"
-require_relative "sentdm/models/api_response_of_calls_list"
 require_relative "sentdm/models/api_response_of_contact"
 require_relative "sentdm/models/api_response_of_contact_message_summary"
 require_relative "sentdm/models/api_response_of_conversation_messages_list"
@@ -78,27 +76,8 @@ require_relative "sentdm/models/brand_business_info"
 require_relative "sentdm/models/brand_compliance_info"
 require_relative "sentdm/models/brand_contact_info"
 require_relative "sentdm/models/brands_brand_data"
-require_relative "sentdm/models/call"
 require_relative "sentdm/models/call_event"
 require_relative "sentdm/models/call_event_payload"
-require_relative "sentdm/models/call_hangup_params"
-require_relative "sentdm/models/call_list_params"
-require_relative "sentdm/models/call_list_recordings_params"
-require_relative "sentdm/models/call_party"
-require_relative "sentdm/models/call_recording"
-require_relative "sentdm/models/call_recordings"
-require_relative "sentdm/models/call_record_params"
-require_relative "sentdm/models/call_retrieve_params"
-require_relative "sentdm/models/calls/api_response_of_list_of_call_participant"
-require_relative "sentdm/models/calls/call_participant"
-require_relative "sentdm/models/calls/call_participant_target"
-require_relative "sentdm/models/calls/participant_add_params"
-require_relative "sentdm/models/calls/participant_list_params"
-require_relative "sentdm/models/calls/participant_remove_all_params"
-require_relative "sentdm/models/calls/participant_remove_params"
-require_relative "sentdm/models/calls/participant_update_params"
-require_relative "sentdm/models/calls_list"
-require_relative "sentdm/models/call_timeline_entry"
 require_relative "sentdm/models/channel_event"
 require_relative "sentdm/models/channel_event_payload"
 require_relative "sentdm/models/channels/api_response_of_list_of_voice_number"
@@ -106,20 +85,17 @@ require_relative "sentdm/models/channels/api_response_of_voice_callback_test"
 require_relative "sentdm/models/channels/api_response_of_voice_number"
 require_relative "sentdm/models/channels/api_response_of_voice_number_created"
 require_relative "sentdm/models/channels/api_response_of_voice_secret"
-require_relative "sentdm/models/channels/api_response_of_voice_token"
 require_relative "sentdm/models/channels/voice_callback_test"
 require_relative "sentdm/models/channels/voice_callback_test_error_info"
 require_relative "sentdm/models/channels/voice_callback_test_request_info"
 require_relative "sentdm/models/channels/voice_callback_test_response_info"
 require_relative "sentdm/models/channels/voice_create_params"
-require_relative "sentdm/models/channels/voice_create_token_params"
 require_relative "sentdm/models/channels/voice_list_params"
 require_relative "sentdm/models/channels/voice_number_created"
 require_relative "sentdm/models/channels/voice_retrieve_params"
 require_relative "sentdm/models/channels/voice_rotate_secret_params"
 require_relative "sentdm/models/channels/voice_secret"
 require_relative "sentdm/models/channels/voice_test_params"
-require_relative "sentdm/models/channels/voice_token"
 require_relative "sentdm/models/channels/voice_update_params"
 require_relative "sentdm/models/contact_create_params"
 require_relative "sentdm/models/contact_delete_params"
@@ -197,6 +173,57 @@ 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"
+require_relative "sentdm/models/voice/call_list_params"
+require_relative "sentdm/models/voice/call_list_recordings_params"
+require_relative "sentdm/models/voice/call_party"
+require_relative "sentdm/models/voice/call_recording"
+require_relative "sentdm/models/voice/call_recordings"
+require_relative "sentdm/models/voice/call_record_params"
+require_relative "sentdm/models/voice/call_retrieve_params"
+require_relative "sentdm/models/voice/calls/api_response_of_list_of_call_participant"
+require_relative "sentdm/models/voice/calls/call_participant"
+require_relative "sentdm/models/voice/calls/call_participant_target"
+require_relative "sentdm/models/voice/calls/participant_add_params"
+require_relative "sentdm/models/voice/calls/participant_list_params"
+require_relative "sentdm/models/voice/calls/participant_remove_all_params"
+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"
 require_relative "sentdm/models/webhook_event_type"
@@ -214,8 +241,6 @@ require_relative "sentdm/models/webhook_test_response"
 require_relative "sentdm/models/webhook_toggle_status_params"
 require_relative "sentdm/models/webhook_update_params"
 require_relative "sentdm/models"
-require_relative "sentdm/resources/calls"
-require_relative "sentdm/resources/calls/participants"
 require_relative "sentdm/resources/channels"
 require_relative "sentdm/resources/channels/voice"
 require_relative "sentdm/resources/contacts"
@@ -227,4 +252,10 @@ require_relative "sentdm/resources/profiles"
 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/client.rbi

@@ -115,25 +115,8 @@ module Sentdm
     sig { returns(Sentdm::Resources::Conversations) }
     attr_reader :conversations
 
-    # 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/channels/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/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.
-    sig { returns(Sentdm::Resources::Calls) }
-    attr_reader :calls
+    sig { returns(Sentdm::Resources::Voice) }
+    attr_reader :voice
 
     sig { returns(Sentdm::Resources::Channels) }
     attr_reader :channels

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