Bot Installation

This guide walks you through adding ACOToolbox to your Discord server and basic setup.

Adding the Bot

1. Invite ACOToolbox

Use the official invite link to add the bot:

Invite ACOToolbox

Requested Permissions:

• Send Messages - Post bot responses, notifications, and data exports

• Embed Links - Create rich embeds for checkout data, forms, and announcements

• Attach Files - Export CSV files for checkout data and order tracking

• Use Slash Commands - Enable all bot commands and interactions

• Manage Webhooks - Create and manage webhook endpoints for checkout processing

• Read Message History - Access channel messages for success tracking and moderation

• Add Reactions - Auto-react to success logs and form submissions

• Create Expressions - Add custom emojis for community engagement

• Manage Expressions - Manage server emojis through bot commands

• Mention Everyone - Send important announcements with @everyone/@here

• Manage Messages - Delete bot messages and moderate content

• Manage Roles - Assign verification roles and manage permissions

• Manage Channels - Set up success tracking and webhook channels

2. Verify Installation

Test that the bot is working:

/ping

If the bot responds, installation was successful!

Essential Setup

3. Set Up Success Tracking Channel

Create a dedicated channel for community success logs:

Step 1: Create the Channel

1. Create a new text channel (e.g., #success-logs or #wins)

2. Set appropriate permissions:

   • @everyone: View Channel, Read Message History

   • Members/VIP Role: Send Messages (for success posts)

   • ACOToolbox: All permissions

Step 2: Configure Success Tracking

/success add_channel channel:#success-logs

Step 3: Set Up Auto-Reactions Add celebratory reactions to success posts:

/success add_reaction emoji:🎉
/success add_reaction emoji:🔥
/success add_reaction emoji:💯

Step 4: Configure Response Mode Choose how the bot responds to success posts:

/success set_response_mode

• Disabled: No response given, points still update

• Public: Public thank you message with point update

• DM: DM thank you message with point update

Success Channel Best Practices:

• Clear guidelines: Pin rules about what constitutes a "success"

• Set React Mode: Decide bot should react to all messages or media only /success set_react_mode

4. Set Up Public Webhook for Checkout Notifications

Create a webhook to receive checkout data from external tools:

Step 1: Create Checkout Channel

1. Create a channel for checkout notifications (e.g., #checkout-feed)

2. Set permissions:

   • @everyone: View Channel, Read Message History

   • ACOToolbox: All permissions

   • Admins: Manage Messages (for cleanup)

Step 2: Create Webhook Receiver

/checkoutsadmin create

This command will:

• Generate a unique webhook URL

• Send all checkouts to both a private log and a public checkout feed

• Optionally DM users with checkout details and payment links

Step 3: Configure Webhook Settings

/checkoutsadmin configure

• Data filtering: Success-only or all attempts

• Format style: Edit Successful and failed checkout titles

• Hyperlinking: Enable or disable product hyperlinking in public log

Step 4: Test the Webhook

• Enter the webhook URL into your automation software and click test

5. Points System Configuration

Set up community points for engagement tracking:

/success set_points user:@member points:100

Points Management:

• Reward success posts automatically

• Manual point adjustments for events/giveaways

. Form Integration (Optional)

For Google Forms integration, see the dedicated Google OAuth Setup guide.

Troubleshooting Common Issues

Bot not responding:

• Check bot is online and has proper permissions

• Verify bot role is above managed roles in hierarchy

• Ensure channel permissions allow bot to send messages

Commands not appearing:

• Wait up to 1 hour for slash commands to sync if first boot and custom branding

• Try in a different channel or DM

Success tracking not working:

• Confirm channel is added with /success add_channel

• Check bot can read message history

• Verify auto-reactions are configured

Next Steps

1. Train your team: Share Admin Commands reference

2. Set up integrations: Configure Google OAuth for forms

3. Community onboarding: Share user guides with members

Getting Help

• Support Server: https://discord.gg/NcRUenes9m

• Command Help: Use Discord's built-in command help