trycourier 6.1.0 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 62f640ccc5d992cd807b750192ee8ca02b3ffe5fa09537eeadf67ba086c518b3
-  data.tar.gz: bd638a13b9a78b54e849e76a30614bed55afbcb6e7fb7a1a2edf60a74cb1531b
+  metadata.gz: 93e2579390eb091bbda837c472c4554b06267a4e1dfb01b3b7cc63098f4a0d19
+  data.tar.gz: 2c0beb4dfe94f8d7cf39d222fd1ffb8cd9e3dc54e334e86546ac31d9919b286e
 SHA512:
-  metadata.gz: ed8c416e8431f1a50aa7fff01b939ba42b03acabe3a42a5a9f14da078f9dcf11bfd8cfe6cb88f642d48444aa0131c3eb9a9164fdbd6fec8a6d80d07c2f360403
-  data.tar.gz: 971c6a9a71bfdbc8faec0796d2b591d3635e55aece1ab1c208c6f68f3943a5fb39214c8a5944815b1f70f6e9912b8c77d8db2971d836116c543660a0951ef4a2
+  metadata.gz: 7a321f3202f3ca7858c453483d0fa0e537433a7c73afadd8cccc30d213fb18f6bb02f54db13a373a608e6f29595d0bf34bf3623b4086525da19773745e1c9a21
+  data.tar.gz: 33ef6a817cc05de26e64963c146c7ede6f8842ed1175949ba81ada5937261b0986ba9006522fd74e4dbf4cf5c0d5863021ab0e9e53ad5c3a839b35f7dc1f746f

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [6.3.0](https://github.com/trycourier/courier-ruby/compare/v6.2.0...v6.3.0) (2026-08-27)
+
+
+### Features
+
+* **api:** document Slack and MS Teams on journey send nodes, and fix over-strict MsTeams tenant requirements [C-20302] ([#136](https://github.com/trycourier/courier-ruby/issues/136)) ([2d63cc0](https://github.com/trycourier/courier-ruby/commit/2d63cc0ab0e936625484ed6610e423e1ff04e8b5))
+
+## [6.2.0](https://github.com/trycourier/courier-ruby/compare/v6.1.0...v6.2.0) (2026-08-26)
+
+
+### Features
+
+* **api:** document the template send metrics endpoint ([#134](https://github.com/trycourier/courier-ruby/issues/134)) ([cd882b5](https://github.com/trycourier/courier-ruby/commit/cd882b5a4e1b1dee40c24fd2bec65f07ed10db8a))
+
 ## [6.1.0](https://github.com/trycourier/courier-ruby/compare/v6.0.0...v6.1.0) (2026-08-19)
 
 

data/README.md

@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier", "~> 6.1.0"
+gem "trycourier", "~> 6.3.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/courier/models/journey_send_node.rb

@@ -79,6 +79,9 @@ module Courier
         optional :template, String
 
         # @!attribute to
+        #   Recipient override for this send. Provide exactly one of `email_override`,
+        #   `phone_number_override`, `user_id_override`, `slack`, or `ms_teams` — not a
+        #   combination.
         #
         #   @return [Courier::Models::JourneySendNode::Message::To, nil]
         optional :to, -> { Courier::JourneySendNode::Message::To }
@@ -95,7 +98,7 @@ module Courier
         #
         #   @param template [String]
         #
-        #   @param to [Courier::Models::JourneySendNode::Message::To]
+        #   @param to [Courier::Models::JourneySendNode::Message::To] Recipient override for this send. Provide exactly one of `email_override`, `phon
 
         # @see Courier::Models::JourneySendNode::Message#context
         class Context < Courier::Internal::Type::BaseModel
@@ -149,19 +152,52 @@ module Courier
           #   @return [String, nil]
           optional :email_override, String
 
+          # @!attribute ms_teams
+          #   Send to a Microsoft Teams address directly, bypassing the recipient's stored
+          #   profile. Requires exactly one target: `channel_id`, `channel_name` (with
+          #   `team_id`), `user_id`, or `email`. `channel_name`, `user_id`, and `email` also
+          #   need at least one of `service_url` or `tenant_id` — if you provide both, they
+          #   must agree. `channel_id` doesn't require tenant context to publish, but provide
+          #   `service_url` or `tenant_id` anyway: sends without either have failed at
+          #   delivery in testing. `conversation_id` and `reply_to_activity_id`, available on
+          #   the send API's `MsTeams` profile, aren't supported here yet.
+          #
+          #   @return [Courier::Models::JourneySendNodeToMsTeams, nil]
+          optional :ms_teams, -> { Courier::JourneySendNodeToMsTeams }
+
           # @!attribute phone_number_override
           #
           #   @return [String, nil]
           optional :phone_number_override, String
 
+          # @!attribute slack
+          #   Send to a Slack address directly, bypassing the recipient's stored profile.
+          #   Requires exactly one of `channel`, `user_id`, or `email`.
+          #
+          #   @return [Courier::Models::JourneySendNodeToSlackChannel, Courier::Models::JourneySendNodeToSlackUserID, Courier::Models::JourneySendNodeToSlackEmail, nil]
+          optional :slack, union: -> { Courier::JourneySendNodeToSlack }
+
           # @!attribute user_id_override
           #
           #   @return [String, nil]
           optional :user_id_override, String
 
-          # @!method initialize(email_override: nil, phone_number_override: nil, user_id_override: nil)
+          # @!method initialize(email_override: nil, ms_teams: nil, phone_number_override: nil, slack: nil, user_id_override: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Courier::Models::JourneySendNode::Message::To} for more details.
+          #
+          #   Recipient override for this send. Provide exactly one of `email_override`,
+          #   `phone_number_override`, `user_id_override`, `slack`, or `ms_teams` — not a
+          #   combination.
+          #
           #   @param email_override [String]
+          #
+          #   @param ms_teams [Courier::Models::JourneySendNodeToMsTeams] Send to a Microsoft Teams address directly, bypassing the recipient's stored pro
+          #
           #   @param phone_number_override [String]
+          #
+          #   @param slack [Courier::Models::JourneySendNodeToSlackChannel, Courier::Models::JourneySendNodeToSlackUserID, Courier::Models::JourneySendNodeToSlackEmail] Send to a Slack address directly, bypassing the recipient's stored profile. Requ
+          #
           #   @param user_id_override [String]
         end
       end

data/lib/courier/models/journey_send_node_to_ms_teams.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneySendNodeToMsTeams < Courier::Internal::Type::BaseModel
+      # @!attribute channel_id
+      #   Bot Framework channel ID to send to.
+      #
+      #   @return [String, nil]
+      optional :channel_id, String
+
+      # @!attribute channel_name
+      #   Teams channel name to send to. Requires `team_id`.
+      #
+      #   @return [String, nil]
+      optional :channel_name, String
+
+      # @!attribute email
+      #   Email address of the Teams user to send to.
+      #
+      #   @return [String, nil]
+      optional :email, String
+
+      # @!attribute service_url
+      #   The regional Bot Framework host for this conversation, e.g.
+      #   `https://smba.trafficmanager.net/amer`. A path segment naming the Microsoft
+      #   tenant may follow it and is used to derive `tenant_id` when it is not supplied
+      #   directly.
+      #
+      #   @return [String, nil]
+      optional :service_url, String
+
+      # @!attribute team_id
+      #   Microsoft Teams team ID. Required alongside `channel_name`.
+      #
+      #   @return [String, nil]
+      optional :team_id, String
+
+      # @!attribute tenant_id
+      #   The Microsoft (Azure AD) tenant this send targets or authenticates against.
+      #   Unrelated to `message.context.tenant_id`, which is the Courier customer's own
+      #   multi-tenant context.
+      #
+      #   @return [String, nil]
+      optional :tenant_id, String
+
+      # @!attribute user_id
+      #   Microsoft Teams user ID to send to.
+      #
+      #   @return [String, nil]
+      optional :user_id, String
+
+      # @!method initialize(channel_id: nil, channel_name: nil, email: nil, service_url: nil, team_id: nil, tenant_id: nil, user_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::JourneySendNodeToMsTeams} for more details.
+      #
+      #   Send to a Microsoft Teams address directly, bypassing the recipient's stored
+      #   profile. Requires exactly one target: `channel_id`, `channel_name` (with
+      #   `team_id`), `user_id`, or `email`. `channel_name`, `user_id`, and `email` also
+      #   need at least one of `service_url` or `tenant_id` — if you provide both, they
+      #   must agree. `channel_id` doesn't require tenant context to publish, but provide
+      #   `service_url` or `tenant_id` anyway: sends without either have failed at
+      #   delivery in testing. `conversation_id` and `reply_to_activity_id`, available on
+      #   the send API's `MsTeams` profile, aren't supported here yet.
+      #
+      #   @param channel_id [String] Bot Framework channel ID to send to.
+      #
+      #   @param channel_name [String] Teams channel name to send to. Requires `team_id`.
+      #
+      #   @param email [String] Email address of the Teams user to send to.
+      #
+      #   @param service_url [String] The regional Bot Framework host for this conversation, e.g. `https://smba.traffi
+      #
+      #   @param team_id [String] Microsoft Teams team ID. Required alongside `channel_name`.
+      #
+      #   @param tenant_id [String] The Microsoft (Azure AD) tenant this send targets or authenticates against. Unre
+      #
+      #   @param user_id [String] Microsoft Teams user ID to send to.
+    end
+  end
+end

data/lib/courier/models/journey_send_node_to_slack.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # Send to a Slack address directly, bypassing the recipient's stored profile.
+    # Requires exactly one of `channel`, `user_id`, or `email`.
+    module JourneySendNodeToSlack
+      extend Courier::Internal::Type::Union
+
+      variant -> { Courier::JourneySendNodeToSlackChannel }
+
+      variant -> { Courier::JourneySendNodeToSlackUserID }
+
+      variant -> { Courier::JourneySendNodeToSlackEmail }
+
+      # @!method self.variants
+      #   @return [Array(Courier::Models::JourneySendNodeToSlackChannel, Courier::Models::JourneySendNodeToSlackUserID, Courier::Models::JourneySendNodeToSlackEmail)]
+    end
+  end
+end

data/lib/courier/models/journey_send_node_to_slack_channel.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackChannel < Courier::Internal::Type::BaseModel
+      # @!attribute channel
+      #   Slack channel to send to, by name or ID.
+      #
+      #   @return [String]
+      required :channel, String
+
+      # @!attribute access_token
+      #   A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      #   Literal values are rejected — they'd be stored permanently with no way to rotate
+      #   them. Omit to use the token on the recipient's stored Slack profile.
+      #
+      #   @return [String, nil]
+      optional :access_token, String
+
+      # @!method initialize(channel:, access_token: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::JourneySendNodeToSlackChannel} for more details.
+      #
+      #   @param channel [String] Slack channel to send to, by name or ID.
+      #
+      #   @param access_token [String] A runtime reference to a Slack access token, such as `{{data.slack_token}}`. Lit
+    end
+  end
+end

data/lib/courier/models/journey_send_node_to_slack_email.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackEmail < Courier::Internal::Type::BaseModel
+      # @!attribute email
+      #   Email address of the Slack user to send to, resolved via the workspace
+      #   directory.
+      #
+      #   @return [String]
+      required :email, String
+
+      # @!attribute access_token
+      #   A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      #   Literal values are rejected — they'd be stored permanently with no way to rotate
+      #   them. Omit to use the token on the recipient's stored Slack profile.
+      #
+      #   @return [String, nil]
+      optional :access_token, String
+
+      # @!method initialize(email:, access_token: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::JourneySendNodeToSlackEmail} for more details.
+      #
+      #   @param email [String] Email address of the Slack user to send to, resolved via the workspace directory
+      #
+      #   @param access_token [String] A runtime reference to a Slack access token, such as `{{data.slack_token}}`. Lit
+    end
+  end
+end

data/lib/courier/models/journey_send_node_to_slack_user_id.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    class JourneySendNodeToSlackUserID < Courier::Internal::Type::BaseModel
+      # @!attribute user_id
+      #   Slack user ID to send to.
+      #
+      #   @return [String]
+      required :user_id, String
+
+      # @!attribute access_token
+      #   A runtime reference to a Slack access token, such as `{{data.slack_token}}`.
+      #   Literal values are rejected — they'd be stored permanently with no way to rotate
+      #   them. Omit to use the token on the recipient's stored Slack profile.
+      #
+      #   @return [String, nil]
+      optional :access_token, String
+
+      # @!method initialize(user_id:, access_token: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::JourneySendNodeToSlackUserID} for more details.
+      #
+      #   @param user_id [String] Slack user ID to send to.
+      #
+      #   @param access_token [String] A runtime reference to a Slack access token, such as `{{data.slack_token}}`. Lit
+    end
+  end
+end

data/lib/courier/models/ms_teams.rb

@@ -2,17 +2,23 @@
 
 module Courier
   module Models
+    # Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+    # must agree.
     module MsTeams
       extend Courier::Internal::Type::Union
 
+      # Provide at least one of `tenant_id` or `service_url`. If you provide both, they must agree.
       variant -> { Courier::SendToMsTeamsUserID }
 
+      # Provide at least one of `tenant_id` or `service_url`. If you provide both, they must agree.
       variant -> { Courier::SendToMsTeamsEmail }
 
+      # Sends directly to a Microsoft Teams channel by its Bot Framework ID. Still provide at least one of `tenant_id` or `service_url` — sends without either have failed Bot Framework authentication in testing.
       variant -> { Courier::SendToMsTeamsChannelID }
 
       variant -> { Courier::SendToMsTeamsConversationID }
 
+      # `team_id` is required alongside `channel_name`. Also provide at least one of `tenant_id` or `service_url`; if you provide both, they must agree.
       variant -> { Courier::SendToMsTeamsChannelName }
 
       # @!method self.variants

data/lib/courier/models/ms_teams_base_properties.rb

@@ -5,15 +5,20 @@ module Courier
     class MsTeamsBaseProperties < Courier::Internal::Type::BaseModel
       # @!attribute service_url
       #
-      #   @return [String]
-      required :service_url, String
+      #   @return [String, nil]
+      optional :service_url, String
 
       # @!attribute tenant_id
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(service_url:, tenant_id:)
+      # @!method initialize(service_url: nil, tenant_id: nil)
+      #   Tenant context shared by every MS Teams send variant. Provide at least one of
+      #   `tenant_id` or `service_url`. If you provide both, they must agree — a
+      #   `service_url` pointing at a different Microsoft tenant than `tenant_id` is
+      #   rejected.
+      #
       #   @param service_url [String]
       #   @param tenant_id [String]
     end

data/lib/courier/models/ms_teams_recipient.rb

@@ -4,14 +4,19 @@ module Courier
   module Models
     class MsTeamsRecipient < Courier::Internal::Type::BaseModel
       # @!attribute ms_teams
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
       #
       #   @return [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName]
       required :ms_teams, union: -> { Courier::MsTeams }
 
       # @!method initialize(ms_teams:)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::MsTeamsRecipient} for more details.
+      #
       #   Send via Microsoft Teams
       #
-      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName]
+      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName] Provide at least one of `tenant_id` or `service_url`. If you provide both, they
     end
   end
 end

data/lib/courier/models/notification_get_metrics_params.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#get_metrics
+    class NotificationGetMetricsParams < Courier::Internal::Type::BaseModel
+      extend Courier::Internal::Type::RequestParameters::Converter
+      include Courier::Internal::Type::RequestParameters
+
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute end_
+      #   The end of the window, as an ISO 8601 timestamp with an offset. Must be supplied
+      #   together with `start`. An `end` in the future is accepted and not clamped — the
+      #   trailing buckets come back empty.
+      #
+      #   @return [Time, nil]
+      optional :end_, Time
+
+      # @!attribute granularity
+      #   The size of each bucket in the series. Defaults to `DAY`. `WEEK` buckets start
+      #   on Sunday. A fine granularity caps the window it can cover: `HOUR` spans at most
+      #   7 days and `DAY` at most 90 days, and a wider window returns `400` — request a
+      #   coarser granularity instead. `WEEK` and `MONTH` are uncapped, subject to the
+      #   1000-bucket limit on a single response.
+      #
+      #   @return [Symbol, Courier::Models::NotificationGetMetricsParams::Granularity, nil]
+      optional :granularity, enum: -> { Courier::NotificationGetMetricsParams::Granularity }
+
+      # @!attribute lookback
+      #   The length of the window, counted back from now, as an ISO 8601 duration
+      #   (`P30D`, `P12W`, `PT12H`). Defaults to `P30D`, and is ignored when `start` and
+      #   `end` are supplied. A malformed or non-positive duration returns `400`.
+      #
+      #   @return [String, nil]
+      optional :lookback, String
+
+      # @!attribute start
+      #   The inclusive start of the window, as an ISO 8601 timestamp with an offset
+      #   (`2026-04-01T00:00:00Z`). Must be supplied together with `end` and be earlier
+      #   than it; either one alone returns `400`.
+      #
+      #   @return [Time, nil]
+      optional :start, Time
+
+      # @!method initialize(id:, end_: nil, granularity: nil, lookback: nil, start: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationGetMetricsParams} for more details.
+      #
+      #   @param id [String]
+      #
+      #   @param end_ [Time] The end of the window, as an ISO 8601 timestamp with an offset. Must be supplied
+      #
+      #   @param granularity [Symbol, Courier::Models::NotificationGetMetricsParams::Granularity] The size of each bucket in the series. Defaults to `DAY`. `WEEK` buckets start o
+      #
+      #   @param lookback [String] The length of the window, counted back from now, as an ISO 8601 duration (`P30D`
+      #
+      #   @param start [Time] The inclusive start of the window, as an ISO 8601 timestamp with an offset (`202
+      #
+      #   @param request_options [Courier::RequestOptions, Hash{Symbol=>Object}]
+
+      # The size of each bucket in the series. Defaults to `DAY`. `WEEK` buckets start
+      # on Sunday. A fine granularity caps the window it can cover: `HOUR` spans at most
+      # 7 days and `DAY` at most 90 days, and a wider window returns `400` — request a
+      # coarser granularity instead. `WEEK` and `MONTH` are uncapped, subject to the
+      # 1000-bucket limit on a single response.
+      module Granularity
+        extend Courier::Internal::Type::Enum
+
+        HOUR = :HOUR
+        DAY = :DAY
+        WEEK = :WEEK
+        MONTH = :MONTH
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/courier/models/notification_metrics_response.rb

@@ -0,0 +1,165 @@
+# frozen_string_literal: true
+
+module Courier
+  module Models
+    # @see Courier::Resources::Notifications#get_metrics
+    class NotificationMetricsResponse < Courier::Internal::Type::BaseModel
+      # @!attribute end_
+      #   End of the window actually queried, ceiled onto the granularity grid.
+      #   Second-precision UTC.
+      #
+      #   @return [Time]
+      required :end_, Time, api_name: :end
+
+      # @!attribute granularity
+      #   Bucket size the series was built at.
+      #
+      #   @return [Symbol, Courier::Models::NotificationMetricsResponse::Granularity]
+      required :granularity, enum: -> { Courier::NotificationMetricsResponse::Granularity }
+
+      # @!attribute notification_id
+      #   The template the series describes, echoed from the request.
+      #
+      #   @return [String]
+      required :notification_id, String, api_name: :notificationId
+
+      # @!attribute series
+      #   One entry per bucket between `start` and `end`, oldest first, including buckets
+      #   with no activity.
+      #
+      #   @return [Array<Courier::Models::NotificationMetricsResponse::Series>]
+      required :series, -> { Courier::Internal::Type::ArrayOf[Courier::NotificationMetricsResponse::Series] }
+
+      # @!attribute start
+      #   Inclusive start of the window actually queried, floored onto the granularity
+      #   grid. Second-precision UTC.
+      #
+      #   @return [Time]
+      required :start, Time
+
+      # @!method initialize(end_:, granularity:, notification_id:, series:, start:)
+      #   Some parameter documentations has been truncated, see
+      #   {Courier::Models::NotificationMetricsResponse} for more details.
+      #
+      #   @param end_ [Time] End of the window actually queried, ceiled onto the granularity grid. Second-pre
+      #
+      #   @param granularity [Symbol, Courier::Models::NotificationMetricsResponse::Granularity] Bucket size the series was built at.
+      #
+      #   @param notification_id [String] The template the series describes, echoed from the request.
+      #
+      #   @param series [Array<Courier::Models::NotificationMetricsResponse::Series>] One entry per bucket between `start` and `end`, oldest first, including buckets
+      #
+      #   @param start [Time] Inclusive start of the window actually queried, floored onto the granularity gri
+
+      # Bucket size the series was built at.
+      #
+      # @see Courier::Models::NotificationMetricsResponse#granularity
+      module Granularity
+        extend Courier::Internal::Type::Enum
+
+        HOUR = :HOUR
+        DAY = :DAY
+        WEEK = :WEEK
+        MONTH = :MONTH
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Series < Courier::Internal::Type::BaseModel
+        # @!attribute data
+        #   One entry per provider and channel that handled a message in this bucket. Empty
+        #   when nothing was sent.
+        #
+        #   @return [Array<Courier::Models::NotificationMetricsResponse::Series::Data>]
+        required :data,
+                 -> { Courier::Internal::Type::ArrayOf[Courier::NotificationMetricsResponse::Series::Data] }
+
+        # @!attribute period
+        #   Start of the bucket, second-precision UTC.
+        #
+        #   @return [Time]
+        required :period, Time
+
+        # @!method initialize(data:, period:)
+        #   Some parameter documentations has been truncated, see
+        #   {Courier::Models::NotificationMetricsResponse::Series} for more details.
+        #
+        #   @param data [Array<Courier::Models::NotificationMetricsResponse::Series::Data>] One entry per provider and channel that handled a message in this bucket. Empty
+        #
+        #   @param period [Time] Start of the bucket, second-precision UTC.
+
+        class Data < Courier::Internal::Type::BaseModel
+          # @!attribute channel
+          #   Channel the provider delivered on, e.g. `email`.
+          #
+          #   @return [String]
+          required :channel, String
+
+          # @!attribute clicked
+          #   Messages with at least one tracked link click.
+          #
+          #   @return [Integer]
+          required :clicked, Integer
+
+          # @!attribute delivered
+          #   Messages the provider confirmed as delivered.
+          #
+          #   @return [Integer]
+          required :delivered, Integer
+
+          # @!attribute errors
+          #   Messages the provider rejected or failed on, including ones a later provider
+          #   then delivered.
+          #
+          #   @return [Integer]
+          required :errors, Integer
+
+          # @!attribute opened
+          #   Messages opened at least once. Always `0` on channels with no open tracking.
+          #
+          #   @return [Integer]
+          required :opened, Integer
+
+          # @!attribute provider
+          #   Provider that handled the messages, e.g. `sendgrid`.
+          #
+          #   @return [String]
+          required :provider, String
+
+          # @!attribute sent
+          #   Messages handed to the provider.
+          #
+          #   @return [Integer]
+          required :sent, Integer
+
+          # @!attribute undeliverable
+          #   Messages Courier could not deliver on any provider for the channel.
+          #
+          #   @return [Integer]
+          required :undeliverable, Integer
+
+          # @!method initialize(channel:, clicked:, delivered:, errors:, opened:, provider:, sent:, undeliverable:)
+          #   Some parameter documentations has been truncated, see
+          #   {Courier::Models::NotificationMetricsResponse::Series::Data} for more details.
+          #
+          #   @param channel [String] Channel the provider delivered on, e.g. `email`.
+          #
+          #   @param clicked [Integer] Messages with at least one tracked link click.
+          #
+          #   @param delivered [Integer] Messages the provider confirmed as delivered.
+          #
+          #   @param errors [Integer] Messages the provider rejected or failed on, including ones a later provider the
+          #
+          #   @param opened [Integer] Messages opened at least once. Always `0` on channels with no open tracking.
+          #
+          #   @param provider [String] Provider that handled the messages, e.g. `sendgrid`.
+          #
+          #   @param sent [Integer] Messages handed to the provider.
+          #
+          #   @param undeliverable [Integer] Messages Courier could not deliver on any provider for the channel.
+        end
+      end
+    end
+  end
+end

data/lib/courier/models/send_to_ms_teams_channel_id.rb

@@ -10,15 +10,19 @@ module Courier
 
       # @!attribute service_url
       #
-      #   @return [String]
-      required :service_url, String
+      #   @return [String, nil]
+      optional :service_url, String
 
       # @!attribute tenant_id
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(channel_id:, service_url:, tenant_id:)
+      # @!method initialize(channel_id:, service_url: nil, tenant_id: nil)
+      #   Sends directly to a Microsoft Teams channel by its Bot Framework ID. Still
+      #   provide at least one of `tenant_id` or `service_url` — sends without either have
+      #   failed Bot Framework authentication in testing.
+      #
       #   @param channel_id [String]
       #   @param service_url [String]
       #   @param tenant_id [String]