Skip to main content

Triggers

triggers.slack.new_message()​

Description​

Listen to new messages that match trigger conditions.

Parameters​

  • channel_id: channel id string.
    • Trigger condition: when a new message posted to a channel that matches the given channel id.
    • Optional. Default: None.
  • mentioned_user_id: user id string.
    • Trigger condition: when a user is mentioned in a new message.
    • Optional. Default: None.
  • trigger_string: message string.
    • Trigger condition: when a new message contains the given string.
    • Optional. Default: None.
    • It's case sensitive.
  • trigger_for_bot_messages: boolean.
    • Trigger condition: whether trigger a workflow when new message sent by bots.
    • Optional. Default: False.
info

If multiple parameters are given, the trigger condition will be constructed as 'condition 1' AND 'condition 2'...

Example: triggers.slack.new_message(channel_id='C12345678', trigger_string='kudos') -> Trigger condition: new messages that are sent to channel 'C12345678', and contains string "kudos".

danger

Be careful to set up the trigger and action in a workflow, it may cause infinite loops.

Example: A workflow triggered by bot messages sent in a channel, then send new messages to the same channel.

Return​

Example data structure:

Expand

{
   "client_msg_id":"...",
   "type":"message",
   "text":"ask llama: ...",
   "user":"useid...",
   "ts":"1693582549.746649",
   "blocks":[...],
   "team":"...",
   "thread_ts":"1693536314.270179",
   "parent_user_id":"...",
   "channel":"C05PRRJ0H4N",
   "event_ts":"1693582549.746649",
   "channel_type":"group"
}

Last updated on