voiceml 0.9.1 → 0.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f65ec54117bee65194bbf24028d00c20d820cee04cc9200472a42b329cd942f8
-  data.tar.gz: 3e2104d7267e31948f3160b37e527cec42acf4a68cb366b4963435f71e55f8ca
+  metadata.gz: ce6f40c38ff553e748881a1b57f940e977cd24983da928988a7dcc77640cc32d
+  data.tar.gz: d6d26a2ab6ee10d9df572f24c6b667cb87cb03bb68ef40234fb05308db3d3789
 SHA512:
-  metadata.gz: dbbe6c38b68861d43ed68d7d3ffa335fb9caf7582fa47b091ca37e29ed3fda725f3b492aab06501c7a61d686c2db1e123fa0fd75e5440ed407a4304646feb19a
-  data.tar.gz: '09ced634a9e275031687a7d3647795a4c7a287928a8da4ffe5f61babd10c86eee840890e5233552e64ddf4aa68a50319ef42cd2a37afe68975d87cddb16dbe69'
+  metadata.gz: 28fe625cbe02ccd47894507e8c28d8eecd06f0caae4aea040f5e21af82980072e39a74aa7cb788fc885f9b24e58239099a87dac639a79b9f3a3c248769e0a652
+  data.tar.gz: 85fd838a671b848768a791d590fbcdefa40c49e89d80b8f2c2c98f475af7035489a727ca3d1ecd7e5988296a5a62f32e3784344fc9fcc11f24beec16d5d9619e

data/README.md

@@ -1,11 +1,11 @@
 # 📞 VoiceML Ruby SDK
 
-The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/api/v0.8/voiceml/) — Twilio-compatible outbound voice and answering-machine-detection from VoiceTel, with idiomatic snake_case kwargs, structured errors, and a Twilio-compatible wire format.
+The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/api/v0.9/voiceml/) — Twilio-compatible outbound voice and answering-machine-detection from VoiceTel, with idiomatic snake_case kwargs, structured errors, and a Twilio-compatible wire format.
 
-![Version](https://img.shields.io/badge/version-0.9.1-blue)
+![Version](https://img.shields.io/badge/version-0.9.2-blue)
 ![Ruby](https://img.shields.io/badge/ruby-3.0%2B-red)
 ![License](https://img.shields.io/badge/license-MIT-green)
-![Tests](https://img.shields.io/badge/tests-65%20specs-brightgreen)
+![Tests](https://img.shields.io/badge/tests-188%20examples-brightgreen)
 ![Gem](https://img.shields.io/badge/gem-voiceml-blue)
 
 ## 📚 Table of Contents
@@ -49,10 +49,15 @@ The official Ruby client for the [VoiceML REST API](https://voicetel.com/docs/ap
 - **Notifications** — fetch, list.
 - **SIP** — SIP Trunking: Domains (CRUD), CredentialLists + Credentials (CRUD), IpAccessControlLists + IpAddresses (CRUD), Domain↔ACL/CredentialList mappings (historical, Auth/Calls, Auth/Registrations namespaces).
 - **Routes V2** — Twilio Inbound Processing Region API: `client.routes_v2.sip_domains.fetch(name)` / `update(name, voice_region:, friendly_name:)`.
+- **Messaging Service** — `client.messaging_v1.services` CRUD (`MG...` services), routed automatically at the `messaging.voicetel.com` product host.
+- **Pricing** — read-only `client.pricing.v1` / `client.pricing.v2` for Voice, Messaging, PhoneNumbers, and Trunking country + number lookups.
 - **Diagnostics** — `/health` deep probe, OpenAPI spec.
 
+### 🌐 Per-product hosts
+VoiceML mirrors Twilio's product-per-subdomain model. The whole `conversations_v1` group is routed to `conversations.voicetel.com` and `messaging_v1` to `messaging.voicetel.com`, while everything else stays on the default `voiceml.voicetel.com`. These hosts are derived automatically from `base_url`; a non-`voicetel.com` base (e.g. a self-hosted instance) keeps every product on that single host. Override per product with `messaging_base_url:` / `conversations_base_url:` on the client constructor.
+
 ### 🧪 Tested
-- **81 specs** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
+- **188 examples** with mocked HTTP layer (`webmock`) covering every resource and pagination edge cases — spec drift gets caught at parse time.
 - Integration smoke spec gated by env vars — safe for CI.
 
 ### 📦 Clean Distribution
@@ -110,7 +115,7 @@ client = VoiceML::Client.new(account_sid: 'AC...', api_key: '...')
 client.diagnostics.health  # uses your AccountSid + key on every call
 ```
 
-> Don't have credentials yet? See **[voicetel.com/docs/api/v0.8/voiceml/](https://voicetel.com/docs/api/v0.8/voiceml/)** for issuance and rotation.
+> Don't have credentials yet? See **[voicetel.com/docs/api/v0.9/voiceml/](https://voicetel.com/docs/api/v0.9/voiceml/)** for issuance and rotation.
 
 ## 🗺️ Resource Reference
 
@@ -124,6 +129,8 @@ client.diagnostics.health  # uses your AccountSid + key on every call
 | `client.messages` | create, fetch, list, update, delete | To/From/DateSent filters; Body redaction; Status=canceled |
 | `client.incoming_phone_numbers` | list, fetch, update | |
 | `client.notifications` | fetch, list | |
+| `client.messaging_v1.services` | create, list, fetch, update, delete | Messaging Service (`MG...`); routed at `messaging.voicetel.com` |
+| `client.pricing.v1` / `.v2` | countries.list / fetch, numbers.fetch | Voice, Messaging, PhoneNumbers, Trunking (read-only, default host) |
 | `client.diagnostics` | `/health`, OpenAPI spec | |
 
 Methods accept idiomatic snake_case keyword arguments — they're translated to Twilio's PascalCase wire field names internally:
@@ -245,7 +252,7 @@ gem build voiceml.gemspec
 
 ## 📖 API Documentation
 
-- **Reference docs:** [voicetel.com/docs/api/v0.8/voiceml/](https://voicetel.com/docs/api/v0.8/voiceml/)
+- **Reference docs:** [voicetel.com/docs/api/v0.9/voiceml/](https://voicetel.com/docs/api/v0.9/voiceml/)
 - **Validator:** [voicetel.com/voiceml/validator/](https://voicetel.com/voiceml/validator/)
 - **SDK catalogue:** [voicetel.com/docs/voiceml-sdks/](https://voicetel.com/docs/voiceml-sdks/)
 - **YARD comments:** every resource method carries `@param` / `@return` docs — `yard doc lib` builds them locally.

data/lib/voiceml/client.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'transport'
+require_relative 'hosts'
 require_relative 'resources/calls'
 require_relative 'resources/conferences'
 require_relative 'resources/queues'
@@ -15,6 +16,8 @@ require_relative 'resources/routes_v2'
 require_relative 'resources/voice_v1'
 require_relative 'resources/conversations_v1'
 require_relative 'resources/assistants_v1'
+require_relative 'resources/messaging_v1'
+require_relative 'resources/pricing'
 
 module VoiceML
   # Synchronous client for the VoiceML REST API.
@@ -34,7 +37,8 @@ module VoiceML
   class Client
     attr_reader :calls, :conferences, :queues, :applications, :recordings,
                 :incoming_phone_numbers, :notifications, :diagnostics, :messages,
-                :sip, :routes_v2, :voice_v1, :conversations_v1, :assistants_v1
+                :sip, :routes_v2, :voice_v1, :conversations_v1, :assistants_v1,
+                :messaging_v1, :pricing
 
     # @param account_sid [String] Twilio-format AccountSid (`AC` + 32 hex).
     # @param api_key     [String, nil] per-tenant API key. Pass either `api_key:` or the
@@ -46,11 +50,16 @@ module VoiceML
     # @param max_retries [Integer] retry attempts for 429/5xx and transport errors. Defaults to 2.
     # @param user_agent  [String, nil] override the `User-Agent` header. Defaults to
     #   `"voiceml-ruby/#{VERSION}"`.
+    # @param messaging_base_url     [String, nil] override the host for `messaging_v1`. Defaults to
+    #   the `messaging.*.voicetel.com` subdomain derived from `base_url` (else `base_url` itself).
+    # @param conversations_base_url [String, nil] override the host for `conversations_v1`. Defaults
+    #   to the `conversations.*.voicetel.com` subdomain derived from `base_url` (else `base_url`).
     def initialize(account_sid:, api_key: nil, auth_token: nil,
                    base_url: Transport::DEFAULT_BASE_URL,
                    timeout: Transport::DEFAULT_TIMEOUT,
                    max_retries: Transport::DEFAULT_MAX_RETRIES,
-                   user_agent: nil, http_client: nil)
+                   user_agent: nil, http_client: nil,
+                   messaging_base_url: nil, conversations_base_url: nil)
       if !api_key.nil? && !auth_token.nil?
         raise ArgumentError, 'pass either api_key: or auth_token:, not both'
       end
@@ -67,6 +76,16 @@ module VoiceML
         http_client: http_client
       )
 
+      # VoiceML mirrors Twilio's product-per-subdomain model: the whole Conversations group
+      # rides `conversations.voicetel.com` and Messaging Service rides `messaging.voicetel.com`,
+      # while everything else stays on the default host. See VoiceML::Hosts.
+      _default, messaging_host, conversations_host =
+        Hosts.resolve_product_base_urls(base_url,
+                                        messaging_base_url: messaging_base_url,
+                                        conversations_base_url: conversations_base_url)
+      messaging_transport     = ScopedTransport.new(@transport, messaging_host)
+      conversations_transport = ScopedTransport.new(@transport, conversations_host)
+
       @calls                  = CallsResource.new(@transport)
       @conferences            = ConferencesResource.new(@transport)
       @queues                 = QueuesResource.new(@transport)
@@ -79,8 +98,10 @@ module VoiceML
       @sip                    = SipResource.new(@transport)
       @routes_v2              = RoutesV2Resource.new(@transport)
       @voice_v1               = VoiceV1Resource.new(@transport)
-      @conversations_v1       = ConversationsV1Resource.new(@transport)
+      @conversations_v1       = ConversationsV1Resource.new(conversations_transport)
       @assistants_v1          = AssistantsV1Resource.new(@transport)
+      @messaging_v1           = MessagingV1Resource.new(messaging_transport)
+      @pricing                = PricingResource.new(@transport)
     end
 
     def account_sid

data/lib/voiceml/hosts.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+require_relative 'transport'
+
+module VoiceML
+  # Per-product host resolution for the VoiceML API.
+  #
+  # Twilio splits its products across dedicated subdomains (`api.twilio.com`,
+  # `conversations.twilio.com`, `messaging.twilio.com`, ...). VoiceML mirrors that
+  # shape on `voicetel.com`: the Conversations product answers on
+  # `conversations.voicetel.com` and the Messaging Service product on
+  # `messaging.voicetel.com`, while everything else stays on the default
+  # `voiceml.voicetel.com` host. Conversation Service and Messaging Service share
+  # the identical `/v1/Services` path shape, so the *host* is what disambiguates
+  # them on the wire.
+  #
+  # Given the configured `base_url` this module derives the two product hosts by
+  # swapping the leftmost `voiceml` label — but only for recognised
+  # `*.voicetel.com` hosts. For any other base URL (a self-hosted callBroadcast
+  # instance, a test stub, a regional override) the product hosts fall back to the
+  # configured host unchanged, so a single-host deployment keeps working. A caller
+  # who needs Messaging Service against a custom host points `messaging_base_url`
+  # (or `conversations_base_url`) at their own subdomain explicitly.
+  module Hosts
+    module_function
+
+    # Swap the `voiceml` label of a `*.voicetel.com` host for `product`.
+    #
+    # Returns `base_url` unchanged when the host is not a `voiceml.*.voicetel.com`
+    # style host (e.g. a self-hosted instance), so single-host deployments keep
+    # working without special-casing.
+    def derive_product_host(base_url, product)
+      uri = URI.parse(base_url)
+      host = uri.host
+      return base_url if host.nil? || !host.end_with?('.voicetel.com')
+
+      labels = host.split('.')
+      idx = labels.index('voiceml')
+      return base_url if idx.nil?
+
+      labels[idx] = product
+      uri.host = labels.join('.')
+      uri.query = nil
+      uri.fragment = nil
+      uri.to_s
+    end
+
+    # Return `[default, messaging, conversations]` base URLs.
+    #
+    # Explicit overrides win; otherwise each product host is derived from
+    # `base_url` (see module docstring). All three are returned without a
+    # trailing slash.
+    def resolve_product_base_urls(base_url, messaging_base_url: nil, conversations_base_url: nil)
+      default       = Transport.strip_trailing_slashes(base_url)
+      messaging     = Transport.strip_trailing_slashes(messaging_base_url || derive_product_host(default, 'messaging'))
+      conversations = Transport.strip_trailing_slashes(conversations_base_url || derive_product_host(default, 'conversations'))
+      [default, messaging, conversations]
+    end
+  end
+end

data/lib/voiceml/models/messaging_v1.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative 'common'
+require_relative 'voice_v1' # V1Pageable lives here; Messaging v1 reuses the same `meta` envelope
+
+module VoiceML
+  # Twilio Messaging v1 (messaging.twilio.com/v1) resources.
+  #
+  # A Messaging Service (`MG...`) shares the `/v1/Services` path shape with the
+  # Conversations Service (`IS...`); the two are disambiguated on the wire by host
+  # (`messaging.voicetel.com` vs `conversations.voicetel.com`). This SDK routes
+  # `client.messaging_v1.*` at the messaging host automatically — see VoiceML::Hosts.
+
+  # MessagingService — `MG...`. The feature-toggle fields are accept-and-echo on
+  # VoiceML; the service's operative role is gating scheduled sends.
+  class MessagingService
+    ATTRIBUTES = %w[
+      sid account_sid friendly_name date_created date_updated
+      inbound_request_url inbound_method fallback_url fallback_method status_callback
+      sticky_sender mms_converter smart_encoding scan_message_content
+      fallback_to_long_code area_code_geomatch synchronous_validation validity_period
+      url usecase use_inbound_webhook_on_number
+    ].freeze
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+    def initialize(attrs = {})
+      ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs[f] || attrs[f.to_sym]) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  # List envelope for `GET /v1/Services` on the messaging host.
+  class MessagingServiceList
+    include V1Pageable
+    attr_reader :services
+    def initialize(hash = {})
+      assign_meta_fields(hash)
+      @services = (hash['services'] || []).map { |h| MessagingService.from_hash(h) }
+    end
+  end
+end

data/lib/voiceml/models/pricing.rb

@@ -0,0 +1,231 @@
+# frozen_string_literal: true
+
+require_relative 'common'
+require_relative 'voice_v1' # V1Pageable lives here; PricingCountriesList reuses the `meta` envelope
+
+module VoiceML
+  # Twilio Pricing (pricing.twilio.com) v1/v2 response models.
+  #
+  # VoiceML has no dedicated pricing subdomain, so these ride the default host
+  # (`voiceml.voicetel.com`) under `/v1` and `/v2`. All operations are read-only GETs.
+  # Every field is permissive/nullable — VoiceML is NANP-only, so a `Countries` list
+  # carries exactly one entry and a `Numbers` fetch 404s for non-NANP destinations.
+
+  # --- Price leaves ---------------------------------------------------------
+
+  class PricingInboundCallPrice
+    ATTRIBUTES = %w[base_price current_price number_type].freeze
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+    def initialize(attrs = {})
+      ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs[f] || attrs[f.to_sym]) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingOutboundCallPrice
+    ATTRIBUTES = %w[base_price current_price].freeze
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+    def initialize(attrs = {})
+      ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs[f] || attrs[f.to_sym]) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingOutboundCallPriceWithOrigin
+    attr_reader :origination_prefixes, :base_price, :current_price
+    def initialize(attrs = {})
+      @origination_prefixes = attrs['origination_prefixes'] || attrs[:origination_prefixes] || []
+      @base_price    = attrs['base_price'] || attrs[:base_price]
+      @current_price = attrs['current_price'] || attrs[:current_price]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingOutboundPrefixPrice
+    attr_reader :prefixes, :base_price, :current_price, :friendly_name
+    def initialize(attrs = {})
+      @prefixes      = attrs['prefixes'] || attrs[:prefixes] || []
+      @base_price    = attrs['base_price'] || attrs[:base_price]
+      @current_price = attrs['current_price'] || attrs[:current_price]
+      @friendly_name = attrs['friendly_name'] || attrs[:friendly_name]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingOutboundPrefixPriceWithOrigin
+    attr_reader :origination_prefixes, :destination_prefixes, :base_price, :current_price, :friendly_name
+    def initialize(attrs = {})
+      @origination_prefixes = attrs['origination_prefixes'] || attrs[:origination_prefixes] || []
+      @destination_prefixes = attrs['destination_prefixes'] || attrs[:destination_prefixes] || []
+      @base_price    = attrs['base_price'] || attrs[:base_price]
+      @current_price = attrs['current_price'] || attrs[:current_price]
+      @friendly_name = attrs['friendly_name'] || attrs[:friendly_name]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingOutboundSMSPrice
+    attr_reader :carrier, :mcc, :mnc, :prices
+    def initialize(attrs = {})
+      @carrier = attrs['carrier'] || attrs[:carrier]
+      @mcc     = attrs['mcc'] || attrs[:mcc]
+      @mnc     = attrs['mnc'] || attrs[:mnc]
+      @prices  = (attrs['prices'] || attrs[:prices] || []).map { |h| PricingInboundCallPrice.from_hash(h) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingPhoneNumberPrice
+    ATTRIBUTES = %w[number_type base_price current_price].freeze
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+    def initialize(attrs = {})
+      ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs[f] || attrs[f.to_sym]) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  # --- Countries list envelope ----------------------------------------------
+
+  class PricingCountryRef
+    ATTRIBUTES = %w[country iso_country url].freeze
+    attr_reader(*ATTRIBUTES.map(&:to_sym))
+    def initialize(attrs = {})
+      ATTRIBUTES.each { |f| instance_variable_set("@#{f}", attrs[f] || attrs[f.to_sym]) }
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingCountriesList
+    include V1Pageable
+    attr_reader :countries
+    def initialize(hash = {})
+      assign_meta_fields(hash)
+      @countries = (hash['countries'] || []).map { |h| PricingCountryRef.from_hash(h) }
+    end
+  end
+
+  # --- Pricing v1 country / number bodies -----------------------------------
+
+  class PricingVoiceCountry
+    attr_reader :country, :iso_country, :outbound_prefix_prices, :inbound_call_prices, :price_unit, :url
+    def initialize(attrs = {})
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @outbound_prefix_prices =
+        (attrs['outbound_prefix_prices'] || []).map { |h| PricingOutboundPrefixPrice.from_hash(h) }
+      @inbound_call_prices =
+        (attrs['inbound_call_prices'] || []).map { |h| PricingInboundCallPrice.from_hash(h) }
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingVoiceNumber
+    attr_reader :number, :country, :iso_country, :outbound_call_price, :inbound_call_price, :price_unit, :url
+    def initialize(attrs = {})
+      @number      = attrs['number'] || attrs[:number]
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @outbound_call_price = PricingOutboundCallPrice.from_hash(attrs['outbound_call_price'])
+      @inbound_call_price  = PricingInboundCallPrice.from_hash(attrs['inbound_call_price'])
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingMessagingCountry
+    attr_reader :country, :iso_country, :outbound_sms_prices, :inbound_sms_prices, :price_unit, :url
+    def initialize(attrs = {})
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @outbound_sms_prices =
+        (attrs['outbound_sms_prices'] || []).map { |h| PricingOutboundSMSPrice.from_hash(h) }
+      @inbound_sms_prices =
+        (attrs['inbound_sms_prices'] || []).map { |h| PricingInboundCallPrice.from_hash(h) }
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingPhoneNumberCountry
+    attr_reader :country, :iso_country, :phone_number_prices, :price_unit, :url
+    def initialize(attrs = {})
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @phone_number_prices =
+        (attrs['phone_number_prices'] || []).map { |h| PricingPhoneNumberPrice.from_hash(h) }
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  # --- Pricing v2 country / number bodies -----------------------------------
+
+  class PricingVoiceCountryV2
+    attr_reader :country, :iso_country, :outbound_prefix_prices, :inbound_call_prices, :price_unit, :url
+    def initialize(attrs = {})
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @outbound_prefix_prices =
+        (attrs['outbound_prefix_prices'] || []).map { |h| PricingOutboundPrefixPriceWithOrigin.from_hash(h) }
+      @inbound_call_prices =
+        (attrs['inbound_call_prices'] || []).map { |h| PricingInboundCallPrice.from_hash(h) }
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingVoiceNumberV2
+    attr_reader :destination_number, :origination_number, :country, :iso_country,
+                :outbound_call_prices, :inbound_call_price, :price_unit, :url
+    def initialize(attrs = {})
+      @destination_number = attrs['destination_number'] || attrs[:destination_number]
+      @origination_number = attrs['origination_number'] || attrs[:origination_number]
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @outbound_call_prices =
+        (attrs['outbound_call_prices'] || []).map { |h| PricingOutboundCallPriceWithOrigin.from_hash(h) }
+      @inbound_call_price = PricingInboundCallPrice.from_hash(attrs['inbound_call_price'])
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingTrunkingCountry
+    attr_reader :country, :iso_country, :terminating_prefix_prices, :originating_call_prices, :price_unit, :url
+    def initialize(attrs = {})
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @terminating_prefix_prices =
+        (attrs['terminating_prefix_prices'] || []).map { |h| PricingOutboundPrefixPriceWithOrigin.from_hash(h) }
+      @originating_call_prices =
+        (attrs['originating_call_prices'] || []).map { |h| PricingInboundCallPrice.from_hash(h) }
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+
+  class PricingTrunkingNumber
+    attr_reader :destination_number, :origination_number, :country, :iso_country,
+                :terminating_prefix_prices, :originating_call_price, :price_unit, :url
+    def initialize(attrs = {})
+      @destination_number = attrs['destination_number'] || attrs[:destination_number]
+      @origination_number = attrs['origination_number'] || attrs[:origination_number]
+      @country     = attrs['country'] || attrs[:country]
+      @iso_country = attrs['iso_country'] || attrs[:iso_country]
+      @terminating_prefix_prices =
+        (attrs['terminating_prefix_prices'] || []).map { |h| PricingOutboundPrefixPriceWithOrigin.from_hash(h) }
+      @originating_call_price = PricingInboundCallPrice.from_hash(attrs['originating_call_price'])
+      @price_unit = attrs['price_unit'] || attrs[:price_unit]
+      @url        = attrs['url'] || attrs[:url]
+    end
+    def self.from_hash(h); h.nil? ? nil : new(h); end
+  end
+end

data/lib/voiceml/resources/messaging_v1.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative '../models/messaging_v1'
+
+module VoiceML
+  # `client.messaging_v1` — Twilio Messaging v1 (messaging.twilio.com/v1).
+  # The whole group is routed at the messaging host (`messaging.voicetel.com`) by the
+  # client, which is what disambiguates a Messaging Service (`MG...`) from a
+  # Conversation Service (`IS...`) — they share the `/v1/Services` path shape.
+  class MessagingV1Resource
+    attr_reader :services
+
+    def initialize(transport)
+      @services = MessagingV1ServicesResource.new(transport)
+    end
+  end
+
+  # Operations on `/v1/Services` at the messaging host.
+  #
+  # `create` / `list` / `fetch` / `delete` reuse the shared path; `update`
+  # (`POST /v1/Services/{sid}`) is unique to Messaging Service.
+  class MessagingV1ServicesResource
+    SERVICE_FIELDS = {
+      'FriendlyName' => :friendly_name,
+      'InboundRequestUrl' => :inbound_request_url,
+      'InboundMethod' => :inbound_method,
+      'FallbackUrl' => :fallback_url,
+      'FallbackMethod' => :fallback_method,
+      'StatusCallback' => :status_callback,
+      'StickySender' => :sticky_sender,
+      'MmsConverter' => :mms_converter,
+      'SmartEncoding' => :smart_encoding,
+      'ScanMessageContent' => :scan_message_content,
+      'FallbackToLongCode' => :fallback_to_long_code,
+      'AreaCodeGeomatch' => :area_code_geomatch,
+      'SynchronousValidation' => :synchronous_validation,
+      'ValidityPeriod' => :validity_period,
+      'Usecase' => :usecase,
+      'UseInboundWebhookOnNumber' => :use_inbound_webhook_on_number
+    }.freeze
+
+    def initialize(transport)
+      @transport = transport
+    end
+
+    def create(friendly_name:, **kwargs)
+      kwargs[:friendly_name] = friendly_name
+      MessagingService.from_hash(
+        @transport.request(:post, '/v1/Services', form: build_form(kwargs))
+      )
+    end
+
+    def list(page_size: nil)
+      params = {}
+      params['PageSize'] = page_size unless page_size.nil?
+      MessagingServiceList.new(@transport.request(:get, '/v1/Services', params: params))
+    end
+
+    def fetch(sid)
+      MessagingService.from_hash(@transport.request(:get, "/v1/Services/#{sid}"))
+    end
+
+    def update(sid, **kwargs)
+      MessagingService.from_hash(
+        @transport.request(:post, "/v1/Services/#{sid}", form: build_form(kwargs))
+      )
+    end
+
+    def delete(sid)
+      @transport.request(:delete, "/v1/Services/#{sid}")
+      nil
+    end
+
+    private
+
+    def build_form(kwargs)
+      out = {}
+      SERVICE_FIELDS.each do |wire, k|
+        value = kwargs[k]
+        next if value.nil?
+
+        out[wire] = value
+      end
+      out
+    end
+  end
+end

data/lib/voiceml/resources/pricing.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+require_relative '../models/pricing'
+
+module VoiceML
+  # `client.pricing` — Twilio Pricing v1/v2 (pricing.twilio.com) surface.
+  #
+  # Read-only. Served on the default host (VoiceML has no pricing subdomain). Layout:
+  #
+  #   client.pricing.v1.voice.countries.list / fetch
+  #   client.pricing.v1.voice.numbers.fetch
+  #   client.pricing.v1.messaging.countries.list / fetch
+  #   client.pricing.v1.phone_numbers.countries.list / fetch
+  #   client.pricing.v2.voice.countries.list / fetch
+  #   client.pricing.v2.voice.numbers.fetch
+  #   client.pricing.v2.trunking.countries.list / fetch
+  #   client.pricing.v2.trunking.numbers.fetch
+  #
+  # Every `countries.list` returns the shared PricingCountriesList envelope; `fetch`
+  # returns the product-specific country/number body. Number path segments are
+  # URL-encoded (E.164 `+` -> `%2B`).
+  class PricingResource
+    attr_reader :v1, :v2
+
+    def initialize(transport)
+      @v1 = PricingV1Resource.new(transport)
+      @v2 = PricingV2Resource.new(transport)
+    end
+  end
+
+  # A pricing product group exposing `.countries` and optionally `.numbers`.
+  class PricingProduct
+    attr_reader :countries, :numbers
+
+    def initialize(countries, numbers = nil)
+      @countries = countries
+      @numbers   = numbers
+    end
+  end
+
+  # `.../Countries` list + per-country fetch. `model` is the fetch body class.
+  class PricingCountriesResource
+    def initialize(transport, base_path, model)
+      @transport = transport
+      @base      = base_path
+      @model     = model
+    end
+
+    def list(page_size: nil)
+      params = {}
+      params['PageSize'] = page_size unless page_size.nil?
+      PricingCountriesList.new(@transport.request(:get, @base, params: params))
+    end
+
+    def fetch(iso_country)
+      @model.from_hash(@transport.request(:get, "#{@base}/#{iso_country}"))
+    end
+  end
+
+  # `/v1/Voice/Numbers/{Number}` — single-number fetch.
+  class PricingV1VoiceNumbersResource
+    def initialize(transport)
+      @transport = transport
+    end
+
+    def fetch(number)
+      PricingVoiceNumber.from_hash(
+        @transport.request(:get, "/v1/Voice/Numbers/#{URI.encode_www_form_component(number)}")
+      )
+    end
+  end
+
+  # `/v2/Voice/Numbers/{Destination}` — origin-aware single-number fetch.
+  class PricingV2VoiceNumbersResource
+    def initialize(transport)
+      @transport = transport
+    end
+
+    def fetch(destination_number, origination_number: nil)
+      params = {}
+      params['OriginationNumber'] = origination_number unless origination_number.nil?
+      PricingVoiceNumberV2.from_hash(
+        @transport.request(:get, "/v2/Voice/Numbers/#{URI.encode_www_form_component(destination_number)}",
+                           params: params)
+      )
+    end
+  end
+
+  # `/v2/Trunking/Numbers/{Destination}` — origin-aware single-number fetch.
+  class PricingV2TrunkingNumbersResource
+    def initialize(transport)
+      @transport = transport
+    end
+
+    def fetch(destination_number, origination_number: nil)
+      params = {}
+      params['OriginationNumber'] = origination_number unless origination_number.nil?
+      PricingTrunkingNumber.from_hash(
+        @transport.request(:get, "/v2/Trunking/Numbers/#{URI.encode_www_form_component(destination_number)}",
+                           params: params)
+      )
+    end
+  end
+
+  # `client.pricing.v1.*` — Voice, Messaging, PhoneNumbers.
+  class PricingV1Resource
+    attr_reader :voice, :messaging, :phone_numbers
+
+    def initialize(transport)
+      @voice = PricingProduct.new(
+        PricingCountriesResource.new(transport, '/v1/Voice/Countries', PricingVoiceCountry),
+        PricingV1VoiceNumbersResource.new(transport)
+      )
+      @messaging = PricingProduct.new(
+        PricingCountriesResource.new(transport, '/v1/Messaging/Countries', PricingMessagingCountry)
+      )
+      @phone_numbers = PricingProduct.new(
+        PricingCountriesResource.new(transport, '/v1/PhoneNumbers/Countries', PricingPhoneNumberCountry)
+      )
+    end
+  end
+
+  # `client.pricing.v2.*` — Voice, Trunking.
+  class PricingV2Resource
+    attr_reader :voice, :trunking
+
+    def initialize(transport)
+      @voice = PricingProduct.new(
+        PricingCountriesResource.new(transport, '/v2/Voice/Countries', PricingVoiceCountryV2),
+        PricingV2VoiceNumbersResource.new(transport)
+      )
+      @trunking = PricingProduct.new(
+        PricingCountriesResource.new(transport, '/v2/Trunking/Countries', PricingTrunkingCountry),
+        PricingV2TrunkingNumbersResource.new(transport)
+      )
+    end
+  end
+end

data/lib/voiceml/transport.rb

@@ -66,10 +66,14 @@ module VoiceML
     # Perform a request. Pass `form:` for a form-urlencoded POST body, `json:` for a JSON body,
     # or neither for a plain GET/DELETE. `params:` are query-string params.
     #
+    # `base_url:` overrides the client's default host for this one call (used to route product
+    # resources at their subdomain — Conversations, Messaging Service). When set, the request
+    # goes to an absolute URL so the correct host/SNI is used per request; see `ScopedTransport`.
+    #
     # @return [Hash, Array, nil] the parsed JSON body (or `nil` for empty 2xx).
     # @raise [VoiceML::ApiError] for non-2xx responses (subclasses by status family).
-    def request(method, path, params: nil, form: nil, json: nil)
-      uri = build_uri(path, params)
+    def request(method, path, params: nil, form: nil, json: nil, base_url: nil)
+      uri = build_uri(request_path(path, base_url), params)
 
       attempt = 0
       loop do
@@ -95,8 +99,8 @@ module VoiceML
     # redirect that `GET /Recordings/{sid}.wav` issues when audio has been archived.
     #
     # @return [Array(Integer, String, Hash)] status code, response body bytes, header hash.
-    def fetch_bytes(path)
-      uri = build_uri(path, nil)
+    def fetch_bytes(path, base_url: nil)
+      uri = build_uri(request_path(path, base_url), nil)
       visited = []
       loop do
         raise ApiError.new('too many redirects', status_code: 0) if visited.length > 5
@@ -126,6 +130,14 @@ module VoiceML
        Errno::EHOSTUNREACH, SocketError, EOFError]
     end
 
+    # Prefix `path` with a per-request `base_url` override, if any. Leaves absolute paths and
+    # the default-host case untouched so `build_uri` handles them as before.
+    def request_path(path, base_url)
+      return path if base_url.nil? || base_url.empty?
+
+      "#{base_url}#{path}"
+    end
+
     def build_uri(path, params)
       uri = if path.start_with?('http://', 'https://')
               URI.parse(path)
@@ -293,4 +305,32 @@ module VoiceML
       [8.0, 0.5 * (2**attempt)].min
     end
   end
+
+  # A transport view pinned to a specific product base URL.
+  #
+  # Wraps a real `Transport` and forwards every call, injecting a `base_url` override so an
+  # entire resource group lands on its product subdomain (`conversations.voicetel.com` /
+  # `messaging.voicetel.com`) without each resource needing to know its own host.
+  #
+  # @api private
+  class ScopedTransport
+    attr_reader :base_url
+
+    def initialize(inner, base_url)
+      @inner    = inner
+      @base_url = Transport.strip_trailing_slashes(base_url)
+    end
+
+    def account_sid
+      @inner.account_sid
+    end
+
+    def request(method, path, params: nil, form: nil, json: nil)
+      @inner.request(method, path, params: params, form: form, json: json, base_url: @base_url)
+    end
+
+    def fetch_bytes(path)
+      @inner.fetch_bytes(path, base_url: @base_url)
+    end
+  end
 end

data/lib/voiceml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module VoiceML
-  VERSION = '0.9.1'
+  VERSION = '0.9.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: voiceml
 version: !ruby/object:Gem::Version
-  version: 0.9.1
+  version: 0.9.2
 platform: ruby
 authors:
 - VoiceTel
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-28 00:00:00.000000000 Z
+date: 2026-07-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -64,6 +64,7 @@ files:
 - lib/voiceml.rb
 - lib/voiceml/client.rb
 - lib/voiceml/errors.rb
+- lib/voiceml/hosts.rb
 - lib/voiceml/models/accounts.rb
 - lib/voiceml/models/applications.rb
 - lib/voiceml/models/assistants_v1.rb
@@ -75,9 +76,11 @@ files:
 - lib/voiceml/models/incoming_phone_numbers.rb
 - lib/voiceml/models/media.rb
 - lib/voiceml/models/messages.rb
+- lib/voiceml/models/messaging_v1.rb
 - lib/voiceml/models/notifications.rb
 - lib/voiceml/models/outgoing_caller_ids.rb
 - lib/voiceml/models/payments.rb
+- lib/voiceml/models/pricing.rb
 - lib/voiceml/models/queues.rb
 - lib/voiceml/models/recordings.rb
 - lib/voiceml/models/routes_v2.rb
@@ -96,7 +99,9 @@ files:
 - lib/voiceml/resources/diagnostics.rb
 - lib/voiceml/resources/incoming_phone_numbers.rb
 - lib/voiceml/resources/messages.rb
+- lib/voiceml/resources/messaging_v1.rb
 - lib/voiceml/resources/notifications.rb
+- lib/voiceml/resources/pricing.rb
 - lib/voiceml/resources/queues.rb
 - lib/voiceml/resources/recordings.rb
 - lib/voiceml/resources/routes_v2.rb