Passa al contenuto principale

Bot interactions

Slash commands, context menus, buttons, dropdowns and modals.

Wait for message​

Pauses the flow until a message matching one of your answer branches is sent in the channel, or the timeout expires. Waits up to 30 days and survives bot restarts; each pending wait holds execution state and counts against a per-server pool. Add an answer branch per expected reply (match type + pattern); anything else runs "On message". Messages from bots are always ignored.

Inputs

NameTypeRequiredDetails
ChannelText channelYesThe channel to watch for a reply.
TimeoutDurationYesHow long to wait for a message (5 seconds up to the 30-day cap; default 10 minutes). Value: 5000 to 2592000000. Default: 600000.
Restrict to userUserNoOnly messages from this user are considered; everyone else is ignored.

Branches

NameDetails
On messageRuns when a message in the channel matches no answer branch. Optional. Provides to its steps: Message (The message that resolved the wait), Content (The message's text content), Author (The user who sent the message)
On timeoutRuns when no matching message arrives within the timeout. Optional.
Match typeHow to match the message content. Added by you, one per entry. Provides to its steps: Message (The message that resolved the wait), Content (The message's text content), Author (The user who sent the message)
PatternText or regex to match against the message content. Added by you, one per entry. Provides to its steps: Message (The message that resolved the wait), Content (The message's text content), Author (The user who sent the message)

Wait for interaction​

Pauses the flow until someone uses a button or dropdown on the watched message, or the timeout expires. Waits up to 30 days and survives bot restarts; each pending wait holds execution state and counts against a per-server pool - for buttons that should work permanently (panels, ticket controls), use a button that starts a flow instead. Add an answer branch per expected button id / option value; anything else runs "On interaction".

Inputs

NameTypeRequiredDetails
MessageMessageYesA message this flow sent whose buttons/dropdowns are watched.
TimeoutDurationYesHow long to wait for an answer (5 seconds up to the 30-day cap; default 10 minutes). Value: 5000 to 2592000000. Default: 600000.
Restrict to userUserNoOnly this user may answer; everyone else gets an ephemeral "this isn't for you" notice.
After finishingComponent cleanupYesWhat happens to the watched components once the wait resolves or times out. Default: Disable.

Branches

NameDetails
On interactionRuns when an interaction on the watched message matches no answer branch. Optional. Provides to its steps: Interaction (The button/select interaction that resolved the wait), Custom ID (Raw custom id of the used component), Values (Chosen option values (empty for buttons)), State (State text the component carried (the custom id set on a flow-linked component), if any)
On timeoutRuns when nobody answers within the timeout. Optional.
MatchRuns this branch when the clicked button's custom id or the chosen option value equals this value. Added by you, one per entry. Provides to its steps: Interaction (The button/select interaction that resolved the wait), Custom ID (Raw custom id of the used component), Values (Chosen option values (empty for buttons)), State (State text the component carried (the custom id set on a flow-linked component), if any)

Ask for confirmation​

Replies to the interaction with a prompt plus confirm/cancel buttons and pauses the flow until the user answers or the timeout expires. Waits up to 30 days and survives bot restarts; for confirmations that should work permanently, use a button that starts a flow instead.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to reply to with the confirmation prompt.
PromptMessage contentYesThe question to show, e.g. "Are you sure you want to delete 14 messages?".
Confirm labelTextYesText on the confirm button. Maximum length: 80 characters. Default: Confirm.
Cancel labelTextYesText on the cancel button. Maximum length: 80 characters. Default: Cancel.
EphemeralYes/NoYesWhether only the asked user can see the prompt. Default: Yes.
TimeoutDurationYesHow long to wait for an answer (5 seconds up to the 30-day cap; default 10 minutes). Value: 5000 to 2592000000. Default: 600000.

Branches

NameDetails
ConfirmedRuns when the user clicks the confirm button. Optional. Provides to its steps: Interaction (The confirm button click (already acknowledged)), State (State text the component carried (the custom id set on a flow-linked component), if any)
CancelledRuns when the user clicks the cancel button. Optional. Provides to its steps: Interaction (The cancel button click (already acknowledged)), State (State text the component carried (the custom id set on a flow-linked component), if any)
On timeoutRuns when the user does not answer within the timeout. Optional.

Ask a question with a dropdown​

Shows a dropdown and waits for the user to pick an option, then continues down the matching branch.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to answer with the dropdown.
MessageMessage contentYesThe message shown above the dropdown.
PlaceholderTextNoGreyed-out text shown before anything is picked. Maximum length: 150 characters.
OptionsList of Select optionNoA fixed list of options. Use this or "Items", not both. Maximum items: 25. Use only one of these: Items.
ItemsList of AnyNoBuild the options from a list of data. Use this or "Options", not both. Use only one of these: Options.
Label pathTextNoWhich field of each item to show, e.g. "name". Leave blank to use the item itself. Maximum length: 100 characters.
Value pathTextNoWhich field of each item to use as its value, e.g. "id". Defaults to the label. Maximum length: 100 characters.
Description pathTextNoWhich field of each item to show as a subtitle. Optional. Maximum length: 100 characters.
Pre-selected valuesList of TextNoValues that start out already selected, e.g. the roles the member already has. Maximum items: 25.
Minimum picksWhole numberYesHow few options may be picked. Value: 0 to 25. Default: 1.
Maximum picksWhole numberYesHow many options may be picked at once. Value: 1 to 25. Default: 1.
Only this userUserNoOnly this user may answer. Anyone else gets a private notice.
Only visible to the userYes/NoYesShow the dropdown privately to the person who triggered it. Default: Yes.
TimeoutDurationYesHow long to wait before giving up and running the timeout branch. Value: 5000 to 2592000000. Default: 600000.
When finishedComponent cleanupYesWhat to do with the dropdown once someone has answered. Default: Disable.

Branches

NameDetails
Something else was pickedRuns when the pick did not match any of the branches above. Optional. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Values (The selected option value(s)), State (State text the component carried (the custom id set on a flow-linked component), if any)
Nobody answeredRuns when the timeout passes with no answer. Optional.
MatchRuns this branch when the picked value equals this value. Added by you, one per entry. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Values (The selected option value(s)), State (State text the component carried (the custom id set on a flow-linked component), if any)

Ask the user to pick members​

Shows a member picker and waits for the user to choose, then continues down the matching branch.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to answer with the member picker.
MessageMessage contentYesThe message shown above the picker.
PlaceholderTextNoGreyed-out text shown before anything is picked. Maximum length: 150 characters.
Minimum picksWhole numberYesHow few members may be picked. Value: 0 to 25. Default: 1.
Maximum picksWhole numberYesHow many members may be picked at once. Value: 1 to 25. Default: 1.
Only this userUserNoOnly this user may answer. Anyone else gets a private notice.
Only visible to the userYes/NoYesShow the picker privately to the person who triggered it. Default: Yes.
TimeoutDurationYesHow long to wait before giving up and running the timeout branch. Value: 5000 to 2592000000. Default: 600000.
When finishedComponent cleanupYesWhat to do with the picker once someone has answered. Default: Disable.

Branches

NameDetails
Members pickedRuns when the user picks one or more members. Optional. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Picked members (The members that were picked), State (State text the component carried (the custom id set on a flow-linked component), if any)
Nobody answeredRuns when the timeout passes with no answer. Optional.

Ask the user to pick roles​

Shows a role picker and waits for the user to choose, then continues down the matching branch.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to answer with the role picker.
MessageMessage contentYesThe message shown above the picker.
PlaceholderTextNoGreyed-out text shown before anything is picked. Maximum length: 150 characters.
Minimum picksWhole numberYesHow few roles may be picked. Value: 0 to 25. Default: 1.
Maximum picksWhole numberYesHow many roles may be picked at once. Value: 1 to 25. Default: 1.
Only this userUserNoOnly this user may answer. Anyone else gets a private notice.
Only visible to the userYes/NoYesShow the picker privately to the person who triggered it. Default: Yes.
TimeoutDurationYesHow long to wait before giving up and running the timeout branch. Value: 5000 to 2592000000. Default: 600000.
When finishedComponent cleanupYesWhat to do with the picker once someone has answered. Default: Disable.

Branches

NameDetails
Roles pickedRuns when the user picks one or more roles. Optional. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Picked roles (The roles that were picked), State (State text the component carried (the custom id set on a flow-linked component), if any)
Nobody answeredRuns when the timeout passes with no answer. Optional.

Ask the user to pick channels​

Shows a channel picker and waits for the user to choose, then continues down the matching branch.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to answer with the channel picker.
MessageMessage contentYesThe message shown above the picker.
PlaceholderTextNoGreyed-out text shown before anything is picked. Maximum length: 150 characters.
Channel typesList of Channel typeNoRestrict the picker to these channel types. Leave empty to allow any.
Minimum picksWhole numberYesHow few channels may be picked. Value: 0 to 25. Default: 1.
Maximum picksWhole numberYesHow many channels may be picked at once. Value: 1 to 25. Default: 1.
Only this userUserNoOnly this user may answer. Anyone else gets a private notice.
Only visible to the userYes/NoYesShow the picker privately to the person who triggered it. Default: Yes.
TimeoutDurationYesHow long to wait before giving up and running the timeout branch. Value: 5000 to 2592000000. Default: 600000.
When finishedComponent cleanupYesWhat to do with the picker once someone has answered. Default: Disable.

Branches

NameDetails
Channels pickedRuns when the user picks one or more channels. Optional. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Picked channels (The channels that were picked), State (State text the component carried (the custom id set on a flow-linked component), if any)
Nobody answeredRuns when the timeout passes with no answer. Optional.

Ask the user to pick members or roles​

Shows a picker that can select members or roles and waits for the user to choose, then continues down the matching branch.

Inputs

NameTypeRequiredDetails
InteractionInteractionYesThe interaction to answer with the picker.
MessageMessage contentYesThe message shown above the picker.
PlaceholderTextNoGreyed-out text shown before anything is picked. Maximum length: 150 characters.
Minimum picksWhole numberYesHow few entries may be picked. Value: 0 to 25. Default: 1.
Maximum picksWhole numberYesHow many entries may be picked at once. Value: 1 to 25. Default: 1.
Only this userUserNoOnly this user may answer. Anyone else gets a private notice.
Only visible to the userYes/NoYesShow the picker privately to the person who triggered it. Default: Yes.
TimeoutDurationYesHow long to wait before giving up and running the timeout branch. Value: 5000 to 2592000000. Default: 600000.
When finishedComponent cleanupYesWhat to do with the picker once someone has answered. Default: Disable.

Branches

NameDetails
PickedRuns when the user picks one or more members or roles. Optional. Provides to its steps: Interaction (The dropdown interaction that resolved the wait), Picked entries (The members or roles that were picked), State (State text the component carried (the custom id set on a flow-linked component), if any)
Nobody answeredRuns when the timeout passes with no answer. Optional.
Need more help?
Can't find what you're looking for? Our team is happy to help.