Slash command invocation

Altkit Discord includes a user-account helper for invoking commands exposed by installed applications. This is distinct from the bot application-command lifecycle: a user account cannot use this library to register commands or handle bot-owned interactions. Discord can change command schemas and user-account invocation behavior independently of this package, so handle rejected or timed-out requests explicitly.

Invoke a slash command

Text-based channels expose the fork-specific sendSlash() helper:

const response = await channel.sendSlash(process.env.APPLICATION_ID, 'command_name', 'first option', 42);

The first argument identifies the application, the second identifies a command path, and remaining values map to command options in order. Subcommands and groups can be expressed in the command path:

await channel.sendSlash(process.env.APPLICATION_ID, 'animal chat', 'bye');

Command definitions can become stale. Fetch or inspect the current command before building automation that depends on option ordering.

Optional command values

Use undefined to skip an optional positional value while preserving later positions:

await channel.sendSlash(process.env.APPLICATION_ID, 'image make', 'model-name', 'portrait', undefined, 30);

Choice values may be strings even when they look numeric. Use the exact value from the command definition.

Attachments

const { AttachmentBuilder } = require('@altkit/discord');

const image = new AttachmentBuilder('./image.png', 'image.png');
await channel.sendSlash(process.env.APPLICATION_ID, 'inspect', image);

Modal responses

A slash invocation can return a message or a modal. Inspect the result before responding:

const response = await channel.sendSlash(process.env.APPLICATION_ID, 'profile edit');

if (!response.isMessage) {
  response.components[0].components[0].setValue('New value');
  await response.reply();
}

This only fills and submits a modal returned by another application's command. It does not create or register a modal owned by the logged-in user account.

File upload components

Modals returned by an application can contain file upload components. You can inspect and restrict the file types Discord accepts for a component before submitting:

const upload = response.components.flatMap(row => row.components).find(component => component.type === 'FILE_UPLOAD');

if (upload) {
  upload.setFileTypes('image', '.png', '.jpg');
  await response.reply();
}

setFileTypes() accepts Discord's FileUploadType values — 'audio', 'image', 'video', or a dot-prefixed extension — up to 10 entries. Existing components expose the parsed list on component.fileTypes. When only dot-prefixed extensions are specified, Discord still requires .jpg for images and both .mp4 and .mov for video due to mobile limitations.

Deferred responses

Applications may first return a loading message and edit it later. Listen for the matching message update and impose a timeout so the listener cannot remain forever. The complete pattern is in the slash command example.

Unsupported bot workflows

Do not copy upstream bot examples that deploy slash commands, send custom-ID buttons or select menus, open owned modals, or listen for their interaction submissions. Those workflows require a bot application and bot token.