voicetel 2.2.10 → 2.2.14

data/lib/voicetel/models/support.rb

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module VoiceTel
+  module Models
+    # Note on SupportConversation#ticket_number: the OpenAPI spec types the
+    # wire field `number` as an integer — it's the human-readable ticket
+    # sequence (e.g. 1015), not a phone number. The model exposes it as
+    # ticket_number so callers don't confuse it with TNs.
+
+    # ------------------------------------------------------------- requests ---
+    # Body for POST /v2.2/support/tickets.
+    TicketCreateRequest = Data.define(:subject, :message, :email) do
+      include Request
+    end
+
+    # Body for PUT /v2.2/support/tickets/{id}. status is "active",
+    # "pending", "closed", or "spam".
+    TicketUpdateRequest = Data.define(:status) do
+      include Request
+    end
+
+    # Body for POST /v2.2/support/tickets/{id}/replies.
+    TicketReplyRequest = Data.define(:message) do
+      include Request
+    end
+
+    # --------------------------------------------------------- shared subtypes ---
+    # Provenance of a ticket or thread.
+    TicketSource = Data.define(:via, :type) do
+      extend Base
+    end
+
+    # Action descriptor on a thread.
+    TicketAction = Data.define(:text, :type) do
+      extend Base
+    end
+
+    # createdBy / assignee / assignedTo / closedByUser shape.
+    TicketActor = Data.define(
+      :id, :type, :email, :first_name, :last_name, :photo_url
+    ) do
+      extend Base
+    end
+
+    # One custom-field row on a conversation.
+    CustomFieldValue = Data.define(:id, :value, :text) do
+      extend Base
+    end
+
+    # A single {id, value, type} entry under embedded emails/phones/
+    # socialProfiles.
+    CustomerContactEntry = Data.define(:id, :value, :type) do
+      extend Base
+    end
+
+    # A single {id, value} entry under embedded.websites.
+    CustomerWebsiteEntry = Data.define(:id, :value) do
+      extend Base
+    end
+
+    # embedded.address shape on a support customer.
+    CustomerAddress = Data.define(:street, :city, :state, :country, :zip) do
+      extend Base
+    end
+
+    # embedded shape on SupportCustomer.
+    CustomerEmbedded = Data.define(
+      :address, :emails, :phones, :social_profiles, :websites
+    ) do
+      extend Base
+
+      def self.nested
+        { address: CustomerAddress, emails: CustomerContactEntry,
+          phones: CustomerContactEntry, social_profiles: CustomerContactEntry,
+          websites: CustomerWebsiteEntry }
+      end
+    end
+
+    # -------------------------------------------------------------- attachments ---
+    # One file attached to a support thread.
+    SupportAttachment = Data.define(:id, :mime_type, :file_name, :file_url, :size) do
+      extend Base
+    end
+
+    # embedded shape on SupportThread.
+    ThreadEmbedded = Data.define(:attachments) do
+      extend Base
+
+      def self.nested
+        { attachments: SupportAttachment }
+      end
+    end
+
+    # embedded shape on SupportConversation — typically wraps threads.
+    ConversationEmbedded = Data.define(:threads) do
+      extend Base
+
+      def self.nested
+        { threads: SupportThread }
+      end
+    end
+
+    # ----------------------------------------------------------------- entities ---
+    # End-user profile attached to a support ticket.
+    SupportCustomer = Data.define(
+      :id, :first_name, :last_name, :email, :company, :job_title, :photo_type, :photo_url,
+      :notes, :type, :created_at, :updated_at, :embedded
+    ) do
+      extend Base
+
+      def self.nested
+        { embedded: CustomerEmbedded }
+      end
+    end
+
+    # One thread (message) within a ticket conversation. type is "customer"
+    # (from the user), "message" (staff reply), or "note" (internal note).
+    SupportThread = Data.define(
+      :id, :status, :state, :type, :body, :rating, :rating_comment, :opened_at, :created_at,
+      :source, :action, :created_by, :assigned_to, :customer, :to, :cc, :bcc, :embedded
+    ) do
+      extend Base
+
+      def self.nested
+        { source: TicketSource, action: TicketAction, created_by: TicketActor,
+          assigned_to: TicketActor, customer: SupportCustomer, embedded: ThreadEmbedded }
+      end
+    end
+
+    # A support ticket. Returned by GET /v2.2/support/tickets/{id} and as
+    # the items of the list endpoint.
+    SupportConversation = Data.define(
+      :id, :ticket_number, :status, :state, :subject, :preview, :type, :mailbox_id,
+      :folder_id, :threads_count, :closed_by, :closed_at, :created_at, :updated_at,
+      :user_updated_at, :customer_waiting_since, :source, :created_by, :assignee,
+      :closed_by_user, :customer, :cc, :bcc, :custom_fields, :embedded
+    ) do
+      extend Base
+
+      def self.nested
+        { source: TicketSource, created_by: TicketActor, assignee: TicketActor,
+          closed_by_user: TicketActor, customer: SupportCustomer,
+          custom_fields: CustomFieldValue, embedded: ConversationEmbedded }
+      end
+
+      def self.wire_keys
+        { ticket_number: "number" }
+      end
+    end
+
+    # ------------------------------------------------------ response data ---
+    # Data payload from GET /v2.2/support/tickets/{id}.
+    TicketData = Data.define(:ticket) do
+      extend Base
+
+      def self.nested
+        { ticket: SupportConversation }
+      end
+    end
+
+    # Data payload from GET /v2.2/support/tickets.
+    TicketsListData = Data.define(:tickets) do
+      extend Base
+
+      def self.nested
+        { tickets: SupportConversation }
+      end
+    end
+
+    # Data payload from GET /v2.2/support/tickets/{id}/messages.
+    TicketThreadsData = Data.define(:messages) do
+      extend Base
+
+      def self.nested
+        { messages: SupportThread }
+      end
+    end
+
+    # Data payload from POST /v2.2/support/tickets/{id}/replies.
+    TicketReplyData = Data.define(:message) do
+      extend Base
+    end
+
+    # Data payload from PUT /v2.2/support/tickets/{id}.
+    TicketUpdateData = Data.define(:id, :status) do
+      extend Base
+    end
+  end
+end

data/lib/voicetel/models.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Hub for the model layer — mirrors the spec's schemas one file per
+# resource. Response models are built by the resource layer via .build;
+# request models are accepted wherever a plain Hash body is.
+
+require_relative "models/base"
+require_relative "models/common"
+require_relative "models/account"
+require_relative "models/acl"
+require_relative "models/authentication"
+require_relative "models/e911"
+require_relative "models/gateways"
+require_relative "models/i_numbering"
+require_relative "models/lookups"
+require_relative "models/messaging"
+require_relative "models/numbers"
+require_relative "models/support"

data/lib/voicetel/resources/account.rb

@@ -9,55 +9,78 @@ module VoiceTel
     # Rate-limited endpoints (6 req/hour/IP, shared with Client#login):
     # `cdr`, `recurring_charges`, `payments`, `registration`, and `info`.
     class Account < Base
-      # GET /v2.2/account — return the authenticated account profile.
+      # GET /v2.2/account — the authenticated account profile.
+      #
+      # @return [Models::AccountData]
       def get
-        @transport.request(:get, "/v2.2/account")
+        Models::AccountData.build(@transport.request(:get, "/v2.2/account"))
       end
 
       # PUT /v2.2/account — partial-update account settings.
+      #
+      # @return [Models::AccountPutData]
       def update(body)
-        @transport.request(:put, "/v2.2/account", body: body)
+        Models::AccountPutData.build(@transport.request(:put, "/v2.2/account", body: payload(body)))
       end
 
       # POST /v2.2/account — create a sub-account (admin-only).
+      #
+      # @return [Models::AccountAddData]
       def add(body)
-        @transport.request(:post, "/v2.2/account", body: body)
+        Models::AccountAddData.build(@transport.request(:post, "/v2.2/account", body: payload(body)))
       end
 
       # POST /v2.2/accounts — public sign-up flow.
+      #
+      # @return [Models::AccountSignupData]
       def signup(body)
-        @transport.request(:post, "/v2.2/accounts", body: body)
+        Models::AccountSignupData.build(@transport.request(:post, "/v2.2/accounts", body: payload(body)))
       end
 
       # GET /v2.2/account/cdr — call detail records. Rate-limited.
+      #
+      # @return [Models::AccountCdrData]
       def cdr(start: nil, end_at: nil)
         q = compact_query("start" => start, "end" => end_at)
-        @transport.request(:get, "/v2.2/account/cdr", query: q)
+        Models::AccountCdrData.build(@transport.request(:get, "/v2.2/account/cdr", query: q))
       end
 
       # GET /v2.2/account/credits — credit history.
+      #
+      # @return [Models::AccountCreditsData]
       def credits
-        @transport.request(:get, "/v2.2/account/credits")
+        Models::AccountCreditsData.build(@transport.request(:get, "/v2.2/account/credits"))
       end
 
-      # GET /v2.2/account/recurring-charges — active monthly recurring charges. Rate-limited.
+      # GET /v2.2/account/recurring-charges — active monthly recurring
+      # charges. Rate-limited.
+      #
+      # @return [Models::AccountMrcData]
       def recurring_charges
-        @transport.request(:get, "/v2.2/account/recurring-charges")
+        Models::AccountMrcData.build(@transport.request(:get, "/v2.2/account/recurring-charges"))
       end
 
       # GET /v2.2/account/payments — payment history. Rate-limited.
+      #
+      # @return [Models::AccountPaymentsData]
       def payments
-        @transport.request(:get, "/v2.2/account/payments")
+        Models::AccountPaymentsData.build(@transport.request(:get, "/v2.2/account/payments"))
       end
 
       # GET /v2.2/account/registration — current SIP registration. Rate-limited.
+      #
+      # @return [Models::AccountRegistrationData]
       def registration
-        @transport.request(:get, "/v2.2/account/registration")
+        Models::AccountRegistrationData.build(@transport.request(:get, "/v2.2/account/registration"))
       end
 
       # POST /v2.2/account/recovery — start password recovery. No auth required.
+      #
+      # @return [Models::AccountRecoverData]
       def recover(body)
-        @transport.request(:post, "/v2.2/account/recovery", body: body, require_auth: false)
+        Models::AccountRecoverData.build(
+          @transport.request(:post, "/v2.2/account/recovery", body: payload(body), require_auth: false)
+        )
       end
     end
   end

data/lib/voicetel/resources/acl.rb

@@ -8,19 +8,28 @@ module VoiceTel
     #
     # The DELETE /v2.2/acl endpoint is unusual: it returns 200 with a body
     # (not 204). 409 conflicts include partial success/failure detail in the
-    # body — surfaced through ApiError#body so callers can inspect it.
+    # body — surfaced through ApiError#body so callers can inspect it (or
+    # build a Models::AclConflictData from it).
     class Acl < Base
+      # GET /v2.2/acl — the current allowlist.
+      #
+      # @return [Models::AclListData]
       def list
-        @transport.request(:get, "/v2.2/acl")
+        Models::AclListData.build(@transport.request(:get, "/v2.2/acl"))
       end
 
-      # body example: { acl: [{ cidr: "1.2.3.0/24" }] }
+      # POST /v2.2/acl — body example: { acl: [{ cidr: "1.2.3.0/24" }] }
+      #
+      # @return [Models::AclAddData]
       def add(body)
-        @transport.request(:post, "/v2.2/acl", body: body)
+        Models::AclAddData.build(@transport.request(:post, "/v2.2/acl", body: payload(body)))
       end
 
+      # DELETE /v2.2/acl — returns 200 with a body, not 204.
+      #
+      # @return [Models::AclRemoveData]
       def remove(body)
-        @transport.request(:delete, "/v2.2/acl", body: body)
+        Models::AclRemoveData.build(@transport.request(:delete, "/v2.2/acl", body: payload(body)))
       end
     end
   end

data/lib/voicetel/resources/authentication.rb

@@ -6,19 +6,26 @@ module VoiceTel
   module Resources
     # AuthenticationService — SIP/HTTP authentication settings (mode + password).
     #
-    # auth_type values: 0 = Digest, 1 = IP Auth, 2 = Digest OR IP, 3 = Digest AND IP.
+    # auth_type values: 0=Digest, 1=Lax (Digest | IP), 2=IP, 3=Strict
+    # (Digest + IP).
     class Authentication < Base
-      AUTH_TYPE_DIGEST         = 0
-      AUTH_TYPE_IP             = 1
-      AUTH_TYPE_DIGEST_OR_IP   = 2
-      AUTH_TYPE_DIGEST_AND_IP  = 3
+      AUTH_TYPE_DIGEST = 0
+      AUTH_TYPE_LAX    = 1
+      AUTH_TYPE_IP     = 2
+      AUTH_TYPE_STRICT = 3
 
+      # GET /v2.2/auth — the active auth mode.
+      #
+      # @return [Models::AuthGetData]
       def get
-        @transport.request(:get, "/v2.2/auth")
+        Models::AuthGetData.build(@transport.request(:get, "/v2.2/auth"))
       end
 
+      # PUT /v2.2/auth — update the auth mode and/or password.
+      #
+      # @return [Models::AuthPutData]
       def update(body)
-        @transport.request(:put, "/v2.2/auth", body: body)
+        Models::AuthPutData.build(@transport.request(:put, "/v2.2/auth", body: payload(body)))
       end
     end
   end

data/lib/voicetel/resources/base.rb

@@ -16,6 +16,12 @@ module VoiceTel
       def compact_query(hash)
         hash.reject { |_, v| v.nil? || v == "" }
       end
+
+      # Request bodies accept either a plain Hash (snake_case keys) or a
+      # Models request object; the transport only speaks Hashes.
+      def payload(body)
+        body.respond_to?(:to_payload) ? body.to_payload : body
+      end
     end
   end
 end

data/lib/voicetel/resources/e911.rb

@@ -9,27 +9,43 @@ module VoiceTel
     # Note: request bodies take a 10-digit TN in `dn`; responses return the
     # 11-digit E.164 US form (leading 1).
     class E911 < Base
+      # GET /v2.2/e911 — every e911 record on the account.
+      #
+      # @return [Models::E911AllData]
       def list
-        @transport.request(:get, "/v2.2/e911")
+        Models::E911AllData.build(@transport.request(:get, "/v2.2/e911"))
       end
 
+      # POST /v2.2/e911 — validate and provision in one call.
+      #
+      # @return [Models::E911RecordData]
       def create(body)
-        @transport.request(:post, "/v2.2/e911", body: body)
+        Models::E911RecordData.build(@transport.request(:post, "/v2.2/e911", body: payload(body)))
       end
 
+      # POST /v2.2/e911/validations — validate an address without
+      # provisioning it.
+      #
+      # @return [Models::E911ValidateData]
       def validate(body)
-        @transport.request(:post, "/v2.2/e911/validations", body: body)
+        Models::E911ValidateData.build(@transport.request(:post, "/v2.2/e911/validations", body: payload(body)))
       end
 
+      # GET /v2.2/e911/{dn} — one record.
+      #
+      # @return [Models::E911RecordData]
       def get(dn)
-        @transport.request(:get, "/v2.2/e911/#{dn}")
+        Models::E911RecordData.build(@transport.request(:get, "/v2.2/e911/#{dn}"))
       end
 
+      # PUT /v2.2/e911/{dn} — provision with a previously-validated address.
+      #
+      # @return [Models::E911RecordData]
       def provision(dn, body)
-        @transport.request(:put, "/v2.2/e911/#{dn}", body: body)
+        Models::E911RecordData.build(@transport.request(:put, "/v2.2/e911/#{dn}", body: payload(body)))
       end
 
-      # Returns nil on 204 No Content.
+      # DELETE /v2.2/e911/{dn}. Returns nil on 204 No Content.
       def remove(dn)
         @transport.request(:delete, "/v2.2/e911/#{dn}")
       end

data/lib/voicetel/resources/gateways.rb

@@ -5,30 +5,47 @@ require_relative "base"
 module VoiceTel
   module Resources
     # GatewaysService — outbound termination gateways on the account.
+    #
+    # System route types: USER, T30, VOICEML, DID, T38, RTC_BRIDGE, SDN.
     class Gateways < Base
+      # GET /v2.2/gateways — every gateway on the account.
+      #
+      # @return [Models::GatewaysListData]
       def list
-        @transport.request(:get, "/v2.2/gateways")
+        Models::GatewaysListData.build(@transport.request(:get, "/v2.2/gateways"))
       end
 
+      # POST /v2.2/gateways — add a gateway.
+      #
+      # @return [Models::GatewayEntry]
       def add(body)
-        @transport.request(:post, "/v2.2/gateways", body: body)
+        Models::GatewayEntry.build(@transport.request(:post, "/v2.2/gateways", body: payload(body)))
       end
 
+      # GET /v2.2/gateways/{id} — one gateway.
+      #
+      # @return [Models::GatewayEntry]
       def get(id)
-        @transport.request(:get, "/v2.2/gateways/#{id}")
+        Models::GatewayEntry.build(@transport.request(:get, "/v2.2/gateways/#{id}"))
       end
 
+      # PUT /v2.2/gateways/{id} — update a gateway.
+      #
+      # @return [Models::GatewayEntry]
       def update(id, body)
-        @transport.request(:put, "/v2.2/gateways/#{id}", body: body)
+        Models::GatewayEntry.build(@transport.request(:put, "/v2.2/gateways/#{id}", body: payload(body)))
       end
 
-      # Returns nil on 204 No Content.
+      # DELETE /v2.2/gateways/{id}. Returns nil on 204 No Content.
       def remove(id)
         @transport.request(:delete, "/v2.2/gateways/#{id}")
       end
 
+      # GET /v2.2/gateways/{id}/numbers — numbers bound to a gateway.
+      #
+      # @return [Models::GatewayNumbersData]
       def numbers(id)
-        @transport.request(:get, "/v2.2/gateways/#{id}/numbers")
+        Models::GatewayNumbersData.build(@transport.request(:get, "/v2.2/gateways/#{id}/numbers"))
       end
     end
   end

data/lib/voicetel/resources/i_numbering.rb

@@ -10,43 +10,58 @@ module VoiceTel
     # `rate_center_tier` alongside `number`, `portable`, `losing_carrier`, `reason`.
     class INumbering < Base
       # GET /v2.2/inventory — search available TNs.
+      #
+      # @return [Models::InventorySearchData]
       def search_inventory(npa: nil, nxx: nil, state: nil, ratecenter: nil, contains: nil, endswith: nil, limit: nil)
         q = compact_query(
           "npa" => npa, "nxx" => nxx, "state" => state, "ratecenter" => ratecenter,
           "contains" => contains, "endswith" => endswith, "limit" => limit
         )
-        @transport.request(:get, "/v2.2/inventory", query: q)
+        Models::InventorySearchData.build(@transport.request(:get, "/v2.2/inventory", query: q))
       end
 
       # GET /v2.2/inventory/coverage — aggregated availability buckets.
+      #
+      # @return [Models::InventoryCoverageData]
       def coverage(state: nil, ratecenter: nil)
         q = compact_query("state" => state, "ratecenter" => ratecenter)
-        @transport.request(:get, "/v2.2/inventory/coverage", query: q)
+        Models::InventoryCoverageData.build(@transport.request(:get, "/v2.2/inventory/coverage", query: q))
       end
 
       # POST /v2.2/orders — purchase new TNs.
+      #
+      # @return [Models::OrderCreateData]
       def order(body)
-        @transport.request(:post, "/v2.2/orders", body: body)
+        Models::OrderCreateData.build(@transport.request(:post, "/v2.2/orders", body: payload(body)))
       end
 
       # GET /v2.2/ports — list every port-in record.
+      #
+      # @return [Models::PortListData]
       def ports
-        @transport.request(:get, "/v2.2/ports")
+        Models::PortListData.build(@transport.request(:get, "/v2.2/ports"))
       end
 
       # GET /v2.2/ports/{id} — detail for one port-in.
+      #
+      # @return [Models::PortDetailData]
       def port(id)
-        @transport.request(:get, "/v2.2/ports/#{id}")
+        Models::PortDetailData.build(@transport.request(:get, "/v2.2/ports/#{id}"))
       end
 
       # POST /v2.2/ports — submit a port-in.
+      #
+      # @return [Models::PortSubmitData]
       def submit_port(body)
-        @transport.request(:post, "/v2.2/ports", body: body)
+        Models::PortSubmitData.build(@transport.request(:post, "/v2.2/ports", body: payload(body)))
       end
 
-      # GET /v2.2/ports/availability/{number} — check whether a TN can be ported in.
+      # GET /v2.2/ports/availability/{number} — check whether a TN can be
+      # ported in.
+      #
+      # @return [Models::PortAvailabilityData]
       def port_availability(number)
-        @transport.request(:get, "/v2.2/ports/availability/#{number}")
+        Models::PortAvailabilityData.build(@transport.request(:get, "/v2.2/ports/availability/#{number}"))
       end
     end
   end

data/lib/voicetel/resources/lookups.rb

@@ -8,12 +8,18 @@ module VoiceTel
     #
     # Each call costs money; meter accordingly.
     class Lookups < Base
+      # GET /v2.2/cnam/{number} — CNAM dip.
+      #
+      # @return [Models::CnamData]
       def cnam(number)
-        @transport.request(:get, "/v2.2/cnam/#{number}")
+        Models::CnamData.build(@transport.request(:get, "/v2.2/cnam/#{number}"))
       end
 
+      # GET /v2.2/lrn/{number}/{ani} — LRN dip.
+      #
+      # @return [Models::LrnLookupData]
       def lrn(number, ani)
-        @transport.request(:get, "/v2.2/lrn/#{number}/#{ani}")
+        Models::LrnLookupData.build(@transport.request(:get, "/v2.2/lrn/#{number}/#{ani}"))
       end
     end
   end

data/lib/voicetel/resources/messaging.rb

@@ -11,6 +11,8 @@ module VoiceTel
     # transport will translate them when serializing.
     class Messaging < Base
       # GET /v2.2/messages — fetch message history.
+      #
+      # @return [Models::MessageHistoryData]
       def history(number: nil, start: nil, end_at: nil, type: nil)
         q = compact_query(
           "number" => number,
@@ -18,36 +20,54 @@ module VoiceTel
           "end" => end_at,
           "type" => type
         )
-        @transport.request(:get, "/v2.2/messages", query: q)
+        Models::MessageHistoryData.build(@transport.request(:get, "/v2.2/messages", query: q))
       end
 
       # POST /v2.2/messages — send an SMS or MMS.
+      #
+      # @return [Models::MessageSendData]
       def send_message(body)
-        @transport.request(:post, "/v2.2/messages", body: body)
+        Models::MessageSendData.build(@transport.request(:post, "/v2.2/messages", body: payload(body)))
       end
 
       # POST /v2.2/messaging/brands — register a 10DLC brand.
+      #
+      # @return [Models::MessagingBrandCreateData]
       def create_brand(body)
-        @transport.request(:post, "/v2.2/messaging/brands", body: body)
+        Models::MessagingBrandCreateData.build(
+          @transport.request(:post, "/v2.2/messaging/brands", body: payload(body))
+        )
       end
 
-      # GET /v2.2/messaging/campaigns — current 10DLC campaign statuses.
+      # GET /v2.2/messaging/campaigns — current 10DLC campaign statuses,
+      # including carrier (DCA) review progress per campaign.
+      #
+      # @return [Models::MessagingCampaignStatusData]
       def campaign_status
-        @transport.request(:get, "/v2.2/messaging/campaigns")
+        Models::MessagingCampaignStatusData.build(@transport.request(:get, "/v2.2/messaging/campaigns"))
       end
 
-      # POST /v2.2/messaging/campaigns — register a 10DLC campaign.
+      # POST /v2.2/messaging/campaigns — register a 10DLC campaign. The body
+      # is passed through to the campaign registration service;
+      # campaignClassName (from the campaign registry) and
+      # campaignStartDate (today) are auto-populated if omitted.
+      #
+      # @return [Models::MessagingCampaignCreateData]
       def create_campaign(body)
-        @transport.request(:post, "/v2.2/messaging/campaigns", body: body)
+        Models::MessagingCampaignCreateData.build(
+          @transport.request(:post, "/v2.2/messaging/campaigns", body: payload(body))
+        )
       end
 
       # GET /v2.2/numbers/messaging — messaging state for many numbers.
       # Pass an empty array (or omit) for "all numbers on the account".
+      #
+      # @return [Models::NumbersMessagingListData]
       def numbers_state(numbers: nil)
         q = compact_query(
           "numbers" => (numbers && !numbers.empty? ? Array(numbers).join(",") : nil)
         )
-        @transport.request(:get, "/v2.2/numbers/messaging", query: q)
+        Models::NumbersMessagingListData.build(@transport.request(:get, "/v2.2/numbers/messaging", query: q))
       end
     end
   end