# Discord bot identity

> Send your project's DMs and channel posts from a bot with your own name and avatar, managed by Joely or your own, and what happens to each bot when you switch.

Source: https://joely.io/documentation/integrations/discord-bot-identity
Last updated: 2026-11-10

| What you need | |
|---|---|
| Plan | **Team** or **Enterprise** |
| Permission | Configure Discord integration |
| Where | When you [connect your server](https://joely.io/documentation/integrations/discord.md#connect-your-server), or later from the gear of the Discord card |

| Bot | What it is |
|---|---|
| Joely's bot | The default, on every plan |
| Managed by Joely | Joely provides a bot with the name and avatar you choose |
| Your own bot | A bot from your own Discord application, by its token |

## Managed bot

Nothing is set up until you choose a name, an avatar, or both.

| Setting | Rule |
|---|---|
| Name | Optional, "Support" when empty. Discord refuses a name too many accounts use (such as "test"): nothing is changed. |
| Avatar | Optional upload: JPG, PNG or GIF, 5 MB max. Square, 256×256 or more, works best. Default: your project logo, else Joely's avatar. |
| Renames | Discord allows 2 per hour. Past that, the save is refused with the time to wait, avatar included. Changing only the avatar is not limited. |

When you give the managed bot back, Joely does not keep your name and avatar.

## Use your own bot

1. In the [Discord Developer Portal](https://discord.com/developers/applications), create an application.
2. In **General Information**, leave **Interactions Endpoint URL** empty. Otherwise the **Reply** buttons of your DMs stop working, and Joely refuses the bot.
3. In the **Bot** tab, click **Reset Token** and copy it. No privileged gateway intent is needed.
4. In Joely, open the gear of the Discord card, choose **Your own bot**, paste the token, verify it, then confirm.
5. [Invite your bot to your server](#invite-your-bot-to-your-server).

## Invite your bot to your server

Discord only delivers a DM when the bot shares a server with the recipient. A new bot is on none of your servers.

- Joely asks you to invite it after setup. Later, use **Invite the bot** on the Discord card.
- The link asks for Joely's bot permissions: view channels, send messages, embed links, manage webhooks, manage roles. Without them, your bot cannot post.
- Until it joins, **Post on Discord** is hidden, and an alert icon shows on **Settings**, the project selector and the card's gear.
- Private channels opened to Joely's bot are not opened to yours. Give your bot the same access in the channel settings.

## A single bot on your main server

Once your bot is set up, Joely's bot leaves your main server. Your bot then makes every post there: embeds, CSAT ratings, automation posts.

- Joely's bot stays while another of your projects on that server relies on it.
- Your other servers are not taken over. Invite your bot there, and remove Joely's bot yourself if you want.

## Switch bots

Use the **⋮** menu next to your bot: **Switch to my own bot** or **Switch to a bot managed by Joely**. You do not need to revert first. Then invite the new bot: until it joins, the card may show the bot as missing.

## What happens to your bots

| When you… | Which bot leaves which server |
|---|---|
| Set up a managed or own bot | Joely's bot leaves your main server (unless another of your projects uses it), not your other servers |
| Switch from a managed bot to your own | The managed bot leaves all your servers and goes back to Joely |
| Switch from your own bot to a managed one | Your bot leaves all your servers and goes offline. Joely deletes its token. |
| Revert to Joely's bot | Your bot leaves all your servers. Joely asks you to invite Joely's bot if it is gone. |
| Disconnect Discord, or delete the project | Your bot leaves all your servers. Joely's bot leaves each one unless another of your projects uses it. |
| Remove one other server | See [Removing a server](https://joely.io/documentation/integrations/discord.md#removing-a-server) |
| Your plan drops below Team | No bot leaves. Your bot goes offline (below). |

## If your plan drops below Team

This covers a downgrade, a cancellation, a failed payment and the end of a trial.

- Joely's bot sends from the next notification. Your bot goes offline: its DMs' buttons stop working, and replies to them no longer reach the ticket.
- Your bot's name, avatar and token stay saved. It comes back on its own with the plan. You can also delete it from the card.
- Channel posts go back to Joely's bot. It left your main server, so the card asks you to invite it again.
