The Toktra Slack app brings LLM usage monitoring into your team’s daily workflow. Security alerts appear in channels as they fire, and managers can approve or reject reimbursement requests without leaving Slack.Documentation Index
Fetch the complete documentation index at: https://docs.toktra.dev/llms.txt
Use this file to discover all available pages before exploring further.
Installing the Toktra Slack app
Start the OAuth flow
In your Toktra dashboard, go to Integrations → Slack (
/integrations/slack). Click Install to Slack.Toktra redirects you to Slack’s OAuth authorization page at https://slack.com/oauth/v2/authorize.Authorize the app
Review the requested permissions and click Allow. The Toktra app requests the following scopes:
| Scope | Purpose |
|---|---|
app_mentions:read | Respond to @Toktra mentions |
chat:write | Post messages and alerts |
commands | Register slash commands |
channels:read | List channels for alert routing |
im:read + im:write | Send direct messages |
users:read + users:read.email | Map Slack users to Toktra users |
Confirm installation
Slack redirects back to Toktra at
/integrations/slack/oauth/callback. Toktra stores the workspace access token and shows a confirmation.Configure notification channels
In Integrations → Slack, select the channels where you want alert notifications sent. See Setting up alert channels.
Only Toktra admins can install the Slack app. The app is installed per Slack workspace. If your organization uses multiple workspaces, repeat the installation for each one.
Slash commands
After installation, the following slash commands are available to all workspace members./toktra-usage
Shows the calling user’s token usage for the current billing period, formatted as a Slack Block Kit card.
/toktra-budget
Shows the organization’s current budget status and remaining allocation.
- Green — below 75%
- Orange — 75–90%
- Red — above 90%
/toktra-alerts
Lists recent policy violation alerts for your organization.
| Argument | Description |
|---|---|
severity:<level> | Filter by low, medium, high, or critical |
limit:<n> | Number of alerts to return (default: 10, max: 50) |
Interactive actions
Acknowledge alerts
Click Acknowledge on any alert card from/toktra-alerts or a channel notification. Toktra marks the alert as acknowledged and updates the card to show who acknowledged it.
Approve or reject reimbursements
When an employee submits a personal usage reimbursement request, the assigned approver receives a Slack DM with the request details and two action buttons:- Approve — marks the request as approved and queues it for payroll export
- Reject — marks the request as rejected and notifies the employee
Create ITSM tickets from Slack
Click Create ticket on any alert card to open an ITSM ticket directly. Toktra creates the ticket in your configured ITSM connector (ServiceNow or Jira) and replies with the ticket URL.The Create ticket button is available on alert cards when at least one active ITSM connector is configured. See ITSM integration.
Setting up alert notification channels
After installing the Toktra app, configure which Slack channels receive alert notifications:Select a channel
Choose a public channel from the dropdown, or type a channel name. Toktra must be invited to private channels before they appear.
Set severity filter
Choose which severity levels trigger notifications in this channel. For example, route
critical alerts to #security-incidents and high alerts to #it-alerts.Environment variables
The Toktra Slack app requires the following environment variables in theintegrations/slack service:
Slack environment variables