Haruno Knowledge base

Discord

Let Haruno read and post in a Discord channel through a bot you create. Haruno asks before it posts, and a scheduled task holds its posts for your approval.

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

Discord is a connector in the Communication section of the Connectors window. Its row reads Read and post messages in your server's channels.

Haruno does not use your own Discord account. You create a bot in Discord, invite it to your server, and give Haruno the bot's token. Haruno posts as that bot.

What Haruno can do

  • Read the recent messages in a channel.
  • Post a text message. A long message is split into several, up to five. Anything longer is refused and has to be sent as a file.
  • Send a file.
  • Say which bot it is connected as.

Haruno uses the channel you pick when you connect, unless it is told to use another channel the bot can see.

Connect

  1. Make a bot in Discord

    In Discord's developer portal, create an application. Open its Bot page and reset the token to show it. Invite the bot to your server with permission to send messages and attach files. The window has an Open Discord Developer Portal link.

  2. Paste the token

    In Connectors, click Connect on the Discord row. Paste the token into Bot token and click Continue.

  3. Pick a server and a channel

    Choose a Server, then a Channel. Click Use this channel. Haruno checks that the bot can see the channel before it saves anything.

The row then shows the bot and the channel, and the connector is on. Haruno keeps the token in your Mac's keychain. Treat it like a password.

The ⋯ menu has Change bot or channel and Disconnect.

If something is missing

  • This bot has not been invited to a server yet. Invite it from the developer portal, then reopen this window.
  • The bot cannot see any text channels in that server. Give it access to a channel, then pick the server again.
  • A warning says Message Content is off for this bot. Messages Haruno reads come back blank unless they mention the bot. Turn on the Message Content Intent on the bot's page in the developer portal. Posting still works.

What Haruno asks first

Require confirmation before posting to Discord appears under the row once Discord is connected. It is on until you turn it off. Everyone in the channel sees a post the moment it lands, and Haruno cannot take it back.

In a scheduled task

Reading a channel works. A post or a file Haruno would send is prepared and held in The Waiting queue. It goes out only when you approve it. A task you allowed to send on its own does not hold its posts. See Scheduled tasks.

Who has it

Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use Discord. See The Connectors window.

What to tell a customer

Discord needs a bot, so it takes a few minutes the first time. The customer creates the bot, pastes its token, and picks one channel. Haruno posts as the bot and asks first.

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)
    What changed
    @@ -0,0 +1,63 @@
    +---
    +title: Discord
    +summary: Let Haruno read and post in a Discord channel through a bot you create. Haruno asks before it posts, and a scheduled task holds its posts for your approval.
    +feature: connector-discord
    +covers:
    +  - Integrations/discord/**
    +  - apple/Sources/ConnectorsFeature/DiscordConnectorRow.swift
    +  - apple/Sources/ConnectorsFeature/DiscordConnectSheet.swift
    +  - vc-tools/VcTools.McpServer/Servers/Discord/**
    +---
    +
    +Discord is a connector in the <Ui>Communication</Ui> section of the [Connectors window](/macos/connectors/connectors-window/). Its row reads <Ui>Read and post messages in your server's channels.</Ui>
    +
    +Haruno does not use your own Discord account. You create a bot in Discord, invite it to your server, and give Haruno the bot's token. Haruno posts as that bot.
    +
    +## What Haruno can do
    +
    +- Read the recent messages in a channel.
    +- Post a text message. A long message is split into several, up to five. Anything longer is refused and has to be sent as a file.
    +- Send a file.
    +- Say which bot it is connected as.
    +
    +Haruno uses the channel you pick when you connect, unless it is told to use another channel the bot can see.
    +
    +## Connect
    +
    +<Steps>
    +<Step title="Make a bot in Discord">
    +In Discord's developer portal, create an application. Open its Bot page and reset the token to show it. Invite the bot to your server with permission to send messages and attach files. The window has an <Ui>Open Discord Developer Portal</Ui> link.
    +</Step>
    +<Step title="Paste the token">
    +In Connectors, click <Ui>Connect</Ui> on the Discord row. Paste the token into <Ui>Bot token</Ui> and click <Ui>Continue</Ui>.
    +</Step>
    +<Step title="Pick a server and a channel">
    +Choose a <Ui>Server</Ui>, then a <Ui>Channel</Ui>. Click <Ui>Use this channel</Ui>. Haruno checks that the bot can see the channel before it saves anything.
    +</Step>
    +</Steps>
    +
    +The row then shows the bot and the channel, and the connector is on. Haruno keeps the token in your Mac's keychain. Treat it like a password.
    +
    +The ⋯ menu has <Ui>Change bot or channel</Ui> and <Ui>Disconnect</Ui>.
    +
    +## If something is missing
    +
    +- <Ui>This bot has not been invited to a server yet. Invite it from the developer portal, then reopen this window.</Ui>
    +- <Ui>The bot cannot see any text channels in that server. Give it access to a channel, then pick the server again.</Ui>
    +- A warning says <Ui>Message Content is off for this bot</Ui>. Messages Haruno reads come back blank unless they mention the bot. Turn on the Message Content Intent on the bot's page in the developer portal. Posting still works.
    +
    +## What Haruno asks first
    +
    +<Ui>Require confirmation before posting to Discord</Ui> appears under the row once Discord is connected. It is on until you turn it off. Everyone in the channel sees a post the moment it lands, and Haruno cannot take it back.
    +
    +## In a scheduled task
    +
    +Reading a channel works. A post or a file Haruno would send is prepared and held in [The Waiting queue](/macos/automation/waiting-queue/). It goes out only when you approve it. A task you allowed to send on its own does not hold its posts. See [Scheduled tasks](/macos/automation/scheduled-tasks/).
    +
    +## Who has it
    +
    +Everyone, in the normal view and the advanced view. A chat that belongs to a project does not use Discord. See [The Connectors window](/macos/connectors/connectors-window/).
    +
    +## What to tell a customer
    +
    +Discord needs a bot, so it takes a few minutes the first time. The customer creates the bot, pastes its token, and picks one channel. Haruno posts as the bot and asks first.