💬

Message sent

messageCreateMESSAGE_CREATETrigger

Fires when a message is sent in a channel the bot can see.

When to use this

On the canvas

This is what the trigger looks like in your bot's Triggers tab. The sparks listed are available in every node inside the linked flow.

💬

Message sent

messageCreate

Trigger

Filters

ignoreBots

true

Sparks in this flow

{{input.guild.id}}Your Discord server's unique ID

{{input.guild.name}}Your server's name

{{input.guild.memberCount}}How many members are in the server

{{input.guild.icon}}Your server's icon image (empty if it has none)

{{message.id}}The message's unique ID

{{message.content}}The full text of the message

{{message.channelId}}ID of the channel the message was sent in

{{message.author.id}}Discord ID of who sent the message

{{message.author.username}}Sender's Discord username

{{message.author.displayName}}Sender's display name (or username if they have none)

{{message.author.name}}Sender's username (alias for message.author.username)

{{channel.id}}ID of the channel (same as message.channelId)

{{channel.name}}Name of the channel

{{message.image}}First image on the message — attachment, embed image or sticker

{{message.images}}Every image on the message, as a list

{{message.imageCount}}How many images the message carries

{{message.attachments}}Every file attached to the message (images or not)

{{message.author.avatar}}Avatar of whoever sent the message

{{message.url}}Link that jumps straight to the message

{{message.replyTo}}ID of the message this one replies to (empty if it isn't a reply)

Use these in any piece config field inside flows triggered by this event.

Spark	Type	Description
`{{input.guild.id}}`	string	Your Discord server's unique ID
`{{input.guild.name}}`	string	Your server's name
`{{input.guild.memberCount}}`	string	How many members are in the server
`{{input.guild.icon}}`	image	Your server's icon image (empty if it has none)
`{{message.id}}`	string	The message's unique ID
`{{message.content}}`	string	The full text of the message
`{{message.channelId}}`	string	ID of the channel the message was sent in
`{{message.author.id}}`	string	Discord ID of who sent the message
`{{message.author.username}}`	string	Sender's Discord username
`{{message.author.displayName}}`	string	Sender's display name (or username if they have none)
`{{message.author.name}}`	string	Sender's username (alias for message.author.username)
`{{channel.id}}`	string	ID of the channel (same as message.channelId)
`{{channel.name}}`	string	Name of the channel
`{{message.image}}`	image	First image on the message — attachment, embed image or sticker
`{{message.images}}`	array	Every image on the message, as a list
`{{message.imageCount}}`	number	How many images the message carries
`{{message.attachments}}`	array	Every file attached to the message (images or not)
`{{message.author.avatar}}`	image	Avatar of whoever sent the message
`{{message.url}}`	string	Link that jumps straight to the message
`{{message.replyTo}}`	string	ID of the message this one replies to (empty if it isn't a reply)

Configure these in the trigger's filter panel to narrow when the flow fires.

Filter	Type	Description
`ignoreBots`	boolean	Skip messages from bot accounts (default: true)

📐

Not something you need to write — Kitcord registers these listeners automatically from your Kit.

TypeScript

client.on("messageCreate", (message) => {
  if (message.author.bot) return;
  // {{message.content}}, {{message.author.id}}, {{channel.id}}
});