Haruno Knowledge base

Discord

Connect a Discord bot that you create, so Haruno can read recent messages in a channel and, when you approve, post messages and files there.

  • Mac appAvailableA scheduled task holds its posts for your approval.
  • Windows appAvailable

What it connects

Discord connects a bot that you create yourself, set to one server and one default channel. Find it in Settings ▸ Connectors, under the Messaging button. Messages go out from the bot, not from you.

Telegram, Discord and Slack sit under the Messaging button.
The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off.The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off.

What Haruno can do

  • Read the recent messages in the default channel, or in another channel or thread the bot can see.
  • Post a text message. Long ones are split.
  • Send a file.
  • Say which bot and channel are connected.

How to connect

  1. Make the bot in Discord
    Create an application at the Discord developer site, add a bot and copy its token. Treat the token like a password. Turn on Message Content Intent. Invite the bot to your server with View Channels, Read Message History, and Send Messages or Attach Files if you want it to post.
  2. Turn it on in Haruno
    Open the Discord card and turn on Enable.
  3. Paste the token
    Paste it into Bot token and choose Load servers and channels.
  4. Pick where
    Choose the Server and the Channel, then Connect. Only text and announcement channels are offered. Save channel changes the default later.

What needs your approval

Posting a message and sending a file each show an approval card that names the channel. Choose Allow once or Allow for this session. A remembered approval covers only the same channel. Reading messages asks nothing.

A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. In the advanced view you can set each action to On, Off or Confirm.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    PR #2944Commit a2a7836The page at this version
    What changed
    @@ -0,0 +1,35 @@
+---
+title: Discord
+summary: Connect a Discord bot that you create, so Haruno can read recent messages in a channel and, when you approve, post messages and files there.
+feature: connector-discord
+covers:
+  - Integrations/discord/**
+---
+
+## What it connects
+
+Discord connects a bot that you create yourself, set to one server and one default channel. Find it in <Ui>Settings ▸ Connectors</Ui>, under the **Messaging** button. Messages go out from the bot, not from you.
+
+<Shot src="/m/0d7c0e7d3978-windows-connector-messaging-light.png" dark="/m/d0e8197aa780-windows-connector-messaging-dark.png" alt="The Connectors list narrowed to Messaging, showing the Telegram card connected and the Discord and Slack cards switched off." caption="Telegram, Discord and Slack sit under the Messaging button." />
+
+## What Haruno can do
+
+- Read the recent messages in the default channel, or in another channel or thread the bot can see.
+- Post a text message. Long ones are split.
+- Send a file.
+- Say which bot and channel are connected.
+
+## How to connect
+
+<Steps>
+<Step title="Make the bot in Discord">Create an application at the Discord developer site, add a bot and copy its token. Treat the token like a password. Turn on **Message Content Intent**. Invite the bot to your server with **View Channels**, **Read Message History**, and **Send Messages** or **Attach Files** if you want it to post.</Step>
+<Step title="Turn it on in Haruno">Open the Discord card and turn on <Ui>Enable</Ui>.</Step>
+<Step title="Paste the token">Paste it into <Ui>Bot token</Ui> and choose <Ui>Load servers and channels</Ui>.</Step>
+<Step title="Pick where">Choose the <Ui>Server</Ui> and the <Ui>Channel</Ui>, then <Ui>Connect</Ui>. Only text and announcement channels are offered. <Ui>Save channel</Ui> changes the default later.</Step>
+</Steps>
+
+## What needs your approval
+
+Posting a message and sending a file each show an approval card that names the channel. Choose **Allow once** or **Allow for this session**. A remembered approval covers only the same channel. Reading messages asks nothing.
+
+A scheduled task or a hook has nobody to ask, so these steps are refused and the run says the step needed approval. In the advanced view you can set each action to **On**, **Off** or **Confirm**.