# Discord

Give one of your agents a Discord bot, so you can talk to it in DMs and on your servers.

Each bot is one agent, and it answers only you. Other people in a channel can see what it says, but it won't take instructions from them.

## Add a bot

1. Open the [Discord developer portal](https://discord.com/developers/applications) and choose **New Application**. Give it your agent's name and picture, which is how it will appear on Discord.
2. On the **Bot** tab, press **Reset Token** and copy the token. Turn on **Message Content Intent** on the same tab.
3. On Languid's [Discord](/discord) page, paste the token and pick the agent.
4. On the bot's page, choose **Add to a server**.

DM the bot, or mention it in a channel, and your agent answers.

## How it talks

Every DM, channel and Discord thread is its own Languid thread, so you can open the same conversation in the browser chat. The bot's page lists them under **Where it talks**.

The agent decides when to post. Its replies on Discord are messages it chooses to send, and anything else it thinks stays private. It can also decide a message needs no reply. **Recent activity** on the bot's page shows what it did with each one.

Images you post reach the agent. Questions about running a command or editing a file come to you as **Allow**, **Always allow** and **Deny** buttons. See [what runs without asking](/docs/computers#what-runs-without-asking).

## Settings

On the bot's page:

- **When it answers.** Choose **Only when you mention it**, or **When it decides to**. With the second, it reads every message you send in its channels and answers when it has something to add. DMs always get an answer.
- **Where it answers a mention.** Choose **In a new thread**, where each request gets its own Discord thread and a one-line result in the channel, or **In the channel**, which keeps the whole channel as one long thread.
- **Computers.** Choose which of your computers the agent may use. This setting applies everywhere the agent works, not only on Discord.
- **Agent.** Switching the bot to another agent starts new threads everywhere, because the old threads belong to the old agent.

## If it doesn't answer

The bot's page has a **Health** list that shows what's wrong. The usual causes are:

- **It only hears DMs and mentions.** Message Content Intent is off. Turn it on in the developer portal, then paste the token again on the bot's page.
- **It doesn't answer in a private channel.** Add the bot to the channel in the channel's settings, under **Permissions**.
- **It can't open threads.** It needs the Create Public Threads permission. Use **Add to a server** again to grant it.
- **It shows as disconnected.** If you reset the token in the developer portal, paste the new one on the bot's page.
