Discord Setup

Three ways to use Discord with Chamade, depending on what you need.

DM only (text)

The simplest option. Users DM the Chamade bot directly — your agent receives the messages and can reply. No server invite needed, text only.

In your Dashboard → Platforms, click "Connect Discord" and sign in with your Discord account

Done. Users can now DM the Chamade bot, and your agent receives the messages via chamade_inbox.

Capabilities: readwritetypingfiles

Shared bot on your server (voice + text)

Invite the Chamade bot to your Discord server. Your agent can join voice channels and receive DMs. The bot appears as "chamade".

In your Dashboard → Platforms, click "Connect Discord" and sign in with your Discord account

Click the "Invite bot to server" link that appears, and add the Chamade bot to your Discord server

Done. Your agent can now join any voice channel on that server.

Note

The Chamade bot needs to be in the server where the voice channel is. You only need to invite it once per server. DMs also work — users can message the Chamade bot directly.

Capabilities: audio_inaudio_outreadwritetypingfiles

Custom bot (your branding)

Create your own Discord application so the bot appears with your name and avatar. Same capabilities as the shared bot, but under your brand.

Go to the Discord Developer Portal and create a new application

Go to Bot → click Reset Token → copy the token

Under Privileged Gateway Intents, enable "Message Content Intent"

Go to OAuth2 → URL Generator. Select the bot scope, then tick these permissions: Connect, Speak, Send Messages, Read Message History

Copy the generated URL and open it to invite your bot to your Discord server

In your Chamade Dashboard → My Bots, click "Add Discord bot" and paste the token + app ID

Tip

You can customize your bot's name, avatar, and bio in the Discord Developer Portal. The bot token is stored encrypted in Chamade and only used to connect to voice channels.

Capabilities: audio_inaudio_outreadwritetypingfiles

Message limits & formatting

Max length	2,000 characters per message
Formatting	Markdown — `bold`, `italic`, `~~strikethrough~~`, `code`, ```code blocks```, headers, `[links](url)`

Message too long?

If your message exceeds 2,000 characters, the API returns an error. Split long messages into multiple calls at natural boundaries (paragraphs, sentences). Chamade does not split messages automatically.

File attachments

Discord supports send and receive on DMs and channels. Inbound messages with attachments are delivered to your agent with a Chamade-signed URL in the attachments[] array. Outbound: pass attachments: [{file_id} | {url} | {bytes_b64, name, mime}] on chamade_dm_chat or chamade_call_chat. Cap 25 MB per file (Discord’s own non-Nitro limit). See Files API.