Discord Bot

Discord Bot Setup

The Soteria bot brings your Oracle key management into Discord. Staff can whitelist, blacklist, and generate keys with slash commands, and your members can pull their own key-system links without ever leaving the server. The bot holds no state of its own, every command talks to your Soteria account in real time.

How it works

Each Discord server is linked to one Soteria account and bound to a single Oracle service. Once linked, every command in that server operates on the keys, scripts, and settings of that one service. There is nothing to install or host, invite the bot and run the setup commands below.

Prerequisites

A Soteria account with at least one Oracle service created on the dashboard.
Your Soteria API key, found under Dashboard, then Settings, then API Key.
The Manage Server permission in the Discord server you want to link.

Linking your server

Setup takes two commands. Both require the Manage Server permission and both reply privately, so your API key is never shown to other members.

1. Link the account. Run /login with your API key. The bot confirms the account and lists your Oracle services with their IDs.

/login api_key: sk_live_your_api_key_here

2. Bind a service. Copy one of the service IDs from the login reply and run /setservice. The server is now ready to use.

/setservice id: svc_a1b2c3d4

Your API key links the whole account, and the bound service decides which keys and scripts the commands act on. To point the server at a different service later, just run /setservice again with the new ID.

Permissions and staff roles

Commands fall into three tiers:

Everyone can run /getkey and /help.
Staff can run the key management commands (whitelist, blacklist, generate, and more). A member counts as staff if they have the Manage Server permission, or if they hold a role you have granted with /manager add.
Admins (Manage Server) can run the setup commands: login, logout, setservice, unsetservice, and manager.

To let a non-admin role use staff commands without giving them Manage Server, grant it access:

/manager add role: @Support Team
/manager list
/manager remove role: @Support Team

Obfuscation from Discord

The bot can also obfuscate scripts with /obfuscate, drawing on the linked account's membership quota. By default only staff can use it. If you want to open it to everyone in the server, enable it under Dashboard, then Discord Bot, then the Settings tab. See the Commands page for the full reference.

Using the Oracle SDK Commands