trycourier 6.2.0 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0f0b22ca9267f965731c89199aa8d49077c5ac53f12c307946893c67a9ee7896
-  data.tar.gz: abeea8195ccb031cebe6a83096665851ee7d6bae0e2743e2d7a3504af35b8f47
+  metadata.gz: 93e2579390eb091bbda837c472c4554b06267a4e1dfb01b3b7cc63098f4a0d19
+  data.tar.gz: 2c0beb4dfe94f8d7cf39d222fd1ffb8cd9e3dc54e334e86546ac31d9919b286e
 SHA512:
-  metadata.gz: 6c81dbe75df19bf95658f341e62e7475db0007be7ead3a8f822e3e8ce9a8c7424dcaefe76ee629c47bc798211e49e574a81d55b62426fd46a0d022ec61122fa3
-  data.tar.gz: 14dfa346c595b581a2ebbe8467e5452af68d04a64638b7347139287f79e05417394ae5ae5508634e209d2618bd821b00b688ecdc1320c6146e6e5587599a4e28
+  metadata.gz: 7a321f3202f3ca7858c453483d0fa0e537433a7c73afadd8cccc30d213fb18f6bb02f54db13a373a608e6f29595d0bf34bf3623b4086525da19773745e1c9a21
+  data.tar.gz: 33ef6a817cc05de26e64963c146c7ede6f8842ed1175949ba81ada5937261b0986ba9006522fd74e4dbf4cf5c0d5863021ab0e9e53ad5c3a839b35f7dc1f746f

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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)
 
 

data/README.md

@@ -9,7 +9,7 @@ Add the gem to your `Gemfile`:
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "trycourier", "~> 6.2.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/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]

data/lib/courier/models/send_to_ms_teams_channel_name.rb

@@ -8,25 +8,28 @@ module Courier
       #   @return [String]
       required :channel_name, String
 
-      # @!attribute service_url
-      #
-      #   @return [String]
-      required :service_url, String
-
       # @!attribute team_id
       #
       #   @return [String]
       required :team_id, String
 
+      # @!attribute service_url
+      #
+      #   @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_name:, service_url:, team_id:, tenant_id:)
+      # @!method initialize(channel_name:, team_id:, service_url: nil, tenant_id: nil)
+      #   `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.
+      #
       #   @param channel_name [String]
-      #   @param service_url [String]
       #   @param team_id [String]
+      #   @param service_url [String]
       #   @param tenant_id [String]
     end
   end

data/lib/courier/models/send_to_ms_teams_email.rb

@@ -10,15 +10,18 @@ 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(email:, service_url:, tenant_id:)
+      # @!method initialize(email:, service_url: nil, tenant_id: nil)
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
+      #
       #   @param email [String]
       #   @param service_url [String]
       #   @param tenant_id [String]

data/lib/courier/models/send_to_ms_teams_user_id.rb

@@ -3,25 +3,28 @@
 module Courier
   module Models
     class SendToMsTeamsUserID < Courier::Internal::Type::BaseModel
-      # @!attribute service_url
+      # @!attribute user_id
       #
       #   @return [String]
-      required :service_url, String
+      required :user_id, String
 
-      # @!attribute tenant_id
+      # @!attribute service_url
       #
-      #   @return [String]
-      required :tenant_id, String
+      #   @return [String, nil]
+      optional :service_url, String
 
-      # @!attribute user_id
+      # @!attribute tenant_id
       #
-      #   @return [String]
-      required :user_id, String
+      #   @return [String, nil]
+      optional :tenant_id, String
 
-      # @!method initialize(service_url:, tenant_id:, user_id:)
+      # @!method initialize(user_id:, service_url: nil, tenant_id: nil)
+      #   Provide at least one of `tenant_id` or `service_url`. If you provide both, they
+      #   must agree.
+      #
+      #   @param user_id [String]
       #   @param service_url [String]
       #   @param tenant_id [String]
-      #   @param user_id [String]
     end
   end
 end

data/lib/courier/models/user_profile.rb

@@ -106,6 +106,8 @@ module Courier
       optional :middle_name, String, nil?: true
 
       # @!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, nil]
       optional :ms_teams, union: -> { Courier::MsTeams }, nil?: true
@@ -210,7 +212,7 @@ module Courier
       #
       #   @param middle_name [String, nil]
       #
-      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName, nil]
+      #   @param ms_teams [Courier::Models::SendToMsTeamsUserID, Courier::Models::SendToMsTeamsEmail, Courier::Models::SendToMsTeamsChannelID, Courier::Models::SendToMsTeamsConversationID, Courier::Models::SendToMsTeamsChannelName, nil] Provide at least one of `tenant_id` or `service_url`. If you provide both, they
       #
       #   @param name [String, nil]
       #

data/lib/courier/models.rb

@@ -320,6 +320,16 @@ module Courier
 
   JourneySendNode = Courier::Models::JourneySendNode
 
+  JourneySendNodeToMsTeams = Courier::Models::JourneySendNodeToMsTeams
+
+  JourneySendNodeToSlack = Courier::Models::JourneySendNodeToSlack
+
+  JourneySendNodeToSlackChannel = Courier::Models::JourneySendNodeToSlackChannel
+
+  JourneySendNodeToSlackEmail = Courier::Models::JourneySendNodeToSlackEmail
+
+  JourneySendNodeToSlackUserID = Courier::Models::JourneySendNodeToSlackUserID
+
   JourneysInvokeRequest = Courier::Models::JourneysInvokeRequest
 
   JourneysInvokeResponse = Courier::Models::JourneysInvokeResponse

data/lib/courier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Courier
-  VERSION = "6.2.0"
+  VERSION = "6.3.0"
 end

data/lib/courier.rb

@@ -244,6 +244,11 @@ require_relative "courier/models/journeys/template_retrieve_content_params"
 require_relative "courier/models/journeys/template_retrieve_params"
 require_relative "courier/models/journey_segment_trigger_node"
 require_relative "courier/models/journey_send_node"
+require_relative "courier/models/journey_send_node_to_ms_teams"
+require_relative "courier/models/journey_send_node_to_slack"
+require_relative "courier/models/journey_send_node_to_slack_channel"
+require_relative "courier/models/journey_send_node_to_slack_email"
+require_relative "courier/models/journey_send_node_to_slack_user_id"
 require_relative "courier/models/journeys_invoke_response"
 require_relative "courier/models/journeys_list_response"
 require_relative "courier/models/journey_state"