Getting Started
Get Help Buddy running on your Discord server in a few minutes.
Step 1: Invite the Bot
Use the invite link from the Help Buddy website to add the bot to your server. You will need the Manage Server permission to authorize the bot. During the OAuth2 flow, grant all requested permissions so the bot can manage channels, roles, and messages.
Step 2: Log In to the Dashboard
Visit the Help Buddy web dashboard and sign in with Discord. You will see a list of servers where you have the Manage Guild permission. Select your server to open its configuration panel.
Step 3: Configure General Settings
In the General tab of the dashboard, configure the following:
| Setting | Description |
|---|---|
| Support Role | The role whose members can see and respond to all tickets |
| Log Channel | Where ticket open and close events are posted |
| Transcript Channel | Where transcript embeds are sent when a ticket closes |
| Category | The channel category under which ticket channels are created |
| Ticket Number Format | Prefix and zero-padding for ticket channel names |
Step 4: Create a Ticket Type
Go to the Ticket Types tab and create at least one type (e.g., General Support). Each type has its own name, button label, button color, and welcome message. Ticket types appear as buttons on panels deployed in your server.
Step 5: Deploy a Panel
In the Panels tab, create a panel and assign it to a channel. The bot posts an embed with buttons. Users click a button to open a ticket of that type.
Step 6: Test It
Open a ticket as a regular user to verify the channel is created correctly and the welcome message appears. Then close the ticket with /ticket close and confirm the transcript is posted to the configured channel.
Bot Permission Checklist
Warning
| Permission | Required For |
|---|---|
| View Channels | Reading ticket channel content |
| Manage Channels | Creating and deleting ticket channels |
| Manage Roles / Permissions | Setting per-channel permission overwrites |
| Send Messages | Posting embeds and replies in ticket channels |
| Embed Links | Sending rich embed messages |
| Attach Files | Sending HTML transcript files |
| Read Message History | Generating transcripts |
| Manage Messages | Pinning and editing bot messages |
| Use Application Commands | Registering slash commands |