Skip to main content

​
Supported capabilities

Core integration
  • Core integration: Discord bot — Add the Sazabi bot to your Discord server so your team can mention it, message it directly, or use /sazabi to investigate without leaving Discord.
Each connection method has its own setup and permissions. Connecting one method does not enable the others.

​
Core integration

​
About

The Sazabi bot brings the Sazabi agent into your Discord server. Mention it in a channel, send it a direct message, or use the /sazabi command, and it answers grounded in your project’s data. Each server you add is its own connection. The bot is separate from the Discord integration, which posts issue alerts to channels through webhooks; you can use either or both.
Limited releaseThe Discord bot is in limited release and is not yet enabled for every organization. Contact support to request access.

​
Prerequisites

  • Manage Server permission in the Discord server you add the bot to. Discord only lists servers you can manage.
  • Organization admin access in Sazabi.

​
Permissions the bot requests

The bot asks for a fixed set of permissions when you add it. It never asks for Administrator, Manage Messages, or Mention Everyone. The bot also registers the /sazabi slash command in your server.

​
Set up in the dashboard

1

​
Open the Discord bot integration

In the dashboard, go to Settings > Integrations > Discord bot.
2

​
Add to Discord

Click Add to Discord. On Discord’s screen, pick the server, review the permissions, then authorize. Discord adds the bot to the server and sends you back to Sazabi. Repeat to add the bot to more servers.
3

​
Choose a default project

Open the new connection and pick a Default project. Conversations started from this server land in that project unless their channel is routed to another one.
Adding the bot to a server that is already connected refreshes that connection instead of creating a second one. A Discord server can be connected to only one Sazabi organization; if another organization already has it, Sazabi asks before moving it.

​
Set up with the CLI

The Discord bot is added from the dashboard only, because Discord shows its server picker and permissions in the browser. The Sazabi CLI lists the connection once it exists:

​
Chat with Sazabi

  • Mention the bot. Write @Sazabi and your question in any channel the bot can see. It answers in a thread under your message. Reply in that thread to continue; you don’t need to mention it again.
  • Send a direct message. Message the bot directly for a private conversation. If you belong to more than one Sazabi organization, it asks which one to use and remembers your choice.
  • Use /sazabi. /sazabi ask starts a thread with your question. /sazabi status shows which Sazabi organization and project the channel you run it in uses and whether your account is linked, /sazabi link links your Discord account, and /sazabi org changes the organization your direct messages use.
The bot never pings @everyone, @here, roles, or users in its answers. See Chat outside the dashboard.

​
Route channels to projects

On the connection’s page, Channel routing sends conversations in a channel to a specific project. Click Add channel routing, pick a text or announcement channel the bot can see, then pick the project. A mention of the bot in that channel, or in any thread under it, then runs in that project. Channels without a route and direct messages use the default project, and conversations that already started keep their project. You can manage the same routes with the public API (integrations.discordChannelProjectMappings.list, .upsert and .delete; integrations.discordChannels.list lists the channels a route can name) the CLI (sazabi integrations discord-routes), or the sazabi_integration_discord_channel_project_mapping Terraform resource. Deleting a project removes its routes, and disconnecting the bot removes the connection’s routes. Discord does not share email addresses with bots, so Sazabi identifies you by your linked Discord account. The first time you talk to the bot, it replies with a link to connect your Discord account to your Sazabi account. After you connect, the bot works with your Sazabi permissions.

​
Alerts and threads

Issue alerts go to the Discord channels you set up in the Discord integration’s delivery rules. When the bot is in the same server and can post in that channel, it sends the alert itself: updates (resolved, ignored, updated, still ongoing) go into a thread on the alert, the original alert shows the issue’s current status, and the alert has Resolve, Ignore, and Investigate buttons. Clicking a button requires a linked Discord account. If the bot can’t post in the channel, the alert goes through the channel webhook as before. Conversations with the bot stay in their thread, so each investigation keeps its own history.

​
Verify

Mention @Sazabi in a channel the bot can see. It reacts to your message, starts a thread, and answers there.

​
Troubleshooting

The bot doesn’t answer in a channel — Check that the bot’s role can view the channel, send messages, and create threads there. Channel permission overrides can hide a channel from the bot. The bot asks me to connect my account again — Your Discord account link was removed, or you are writing from a different Discord account. Follow the link the bot sends. Connection shows needs attention — The bot was removed from the server. Click Add to Discord again on Settings > Integrations > Discord bot.

​
Further reading

Chat

Ask the Sazabi agent questions from Discord.

Discord

Post issue alerts to Discord channels.