Reference Triggers Discord

Discord triggers

Also on the Cuebot Docs site.

Bot connected

Runs when your Discord bot comes online in Cuebot.

Variables you get

Variable	What it holds
%botName%	Your bot's name

Type id: discord.connected

Bot disconnected

Runs when your Discord bot goes offline, for example when the internet drops. Cuebot tries to bring it back by itself.

Variables you get

Variable	What it holds
%reason%	Why it went offline, in plain words

Type id: discord.disconnected

Member joined the server

Runs when someone joins your Discord server. Good for a welcome message or a starter role. Needs "Server Members Intent" switched on, on the Discord bot page and in the Developer Portal.

Variables you get

Variable	What it holds
%user%	The new member's name
%userName%	Their Discord user name
%userId%	Their Discord user ID
%mention%	Pings them when put in a message, like "Welcome %mention%!"
%serverName%	The name of the server they joined
%isBot%	True when the new member is a bot

Type id: discord.memberJoined

Message posted in a channel

Runs when someone posts a message in a channel your bot can see. To read the text, tick "Message Content Intent" on the Discord bot page and in the Developer Portal.

Setting	What to put in
Channel	Only messages in this channel. Pick it from the list or type its name, like #suggestions. Leave it empty for every channel.
Text contains	Only messages with these words in them, like "!clip". Capital letters do not matter. Leave it empty for every message.

Variables you get

Variable	What it holds
%message%	What they wrote (empty unless Message Content Intent is switched on)
%user%	The person's name as the server shows it
%userName%	Their Discord user name
%userId%	Their Discord user ID
%channelName%	The channel's name, without the #
%channelId%	The channel's ID
%serverName%	The name of your server
%messageLink%	A link to the message
%discordMessageId%	The message's ID

Type id: discord.messagePosted

Slash command used

Runs when someone uses one of your bot's slash commands in your Discord server, like /socials. Answer with the "Reply to slash command" step.

Setting	What to put in
Command	The command name without the slash, like "socials". Several names separated by commas work too. Leave it empty to run for every command.

Variables you get

Variable	What it holds
%command%	The command that was used, without the slash, like socials
%option%	What the person typed in the command's text box (empty when there is none)
%optionName%	The name of that text box
%user%	The person's name as the server shows it (their nickname if they have one)
%userName%	Their Discord user name
%userId%	Their Discord user ID. Handy for the "Give a role" step
%channelId%	The ID of the channel where they used it
%channelName%	The name of that channel, without the #
%serverName%	The name of your server
%discordInteractionId%	Tells the "Reply to slash command" step which command use to answer. Leave it alone

Type id: discord.slashCommand