Troubleshooting Common Issues

ACO Not Matching Products

Issue: Created ACO but no products are matching

Step 1: Verify Site is Monitored

/sites

• Check if your site is in the list

• If not, use /add_site to request it

Step 2: Check Blacklists

/badkws
/site_blacklistkeywords

• Master blacklist applies globally

• Site-specific blacklist may be filtering your keywords

• Blacklisted keywords ALWAYS prevent matches

Step 3: Review Your Keywords

/keywords

• Verify keywords are correct spelling

• Check for typos in site URL

• Ensure keywords use exact word matching

• Example: "vinyl" won't match "vinyls"

Step 4: Check ACO Status

/keywords

• Make sure ACO shows [On], not [Off]

• If [Off], use /toggle_keyword to enable

Step 5: Test with Broader Keywords Create a test ACO with very broad keywords:

Site: [your site]
Keywords: vinyl
Quantity: 1
Variant: (blank)
Price: (blank)

If this matches, your filters are too restrictive.

Issue: ACO worked before but stopped working

Possible Causes:

1. ACO Auto-Disabled

• ACOs turn off after successful match

• Solution: /toggle_keyword to re-enable

2. Site Blacklist Updated

• New keywords added to site blacklist

• Solution: Check /site_blacklistkeywords

3. Site Removed from Monitoring

• Site may have been removed

• Solution: Check /sites and request re-add if needed

4. Product Naming Changed

• Site changed how they name products

• Solution: Update ACO keywords with /remove_keyword and /create_keyword

Task Creation Issues

Issue: Product matched but no task created

Check Discord Notifications:

• Did you receive a webhook notification?

• If yes → Task should be in CyberAIO

• If no → Product likely didn't match criteria

Verify CyberAIO Connection:

1. Check if CyberAIO instance is online

2. Bot status should show instance connected

3. Contact admin if instance appears offline

Check Your Profile:

/aco

• Ensure your Discord ID is linked to CyberAIO profile

• Re-fill form if you've changed profiles

Review ACO Settings:

/keywords

• Variant filter too restrictive?

• Price limit too low?

• Keywords have negatives that excluded the product?

Issue: Wrong variant in task

Problem: Task created for Medium but you wanted Large

Why This Happens: Variant matching requires ALL keywords to match in the variant title.

Example:

Your Variant Filter: Large
Product Variants:
- Small Blue
- Medium Blue
- Large Blue ✅ MATCHES
- XL Blue

Solutions:

1. Don't use variant filter: Let CyberAIO handle size selection

2. Use more specific keywords: Large,Blue matches only Large Blue

3. Check variant names on site: Visit product page to see exact variant naming

Issue: Multiple tasks created for same product

Why This Happens:

• ACO was re-enabled multiple times

• Product restocked multiple times

• Multiple ACOs have similar keywords

Solutions:

1. Delete duplicate tasks: /cyber_delete_task

2. Disable ACO after first match: /toggle_keyword

3. Review your ACOs: /keywords for overlapping keywords

Command Issues

Issue: Commands not responding

Bot May Be Restarting:

• Wait 30-60 seconds and try again

• Check bot status in Discord (offline/online)

Wrong Command Format:

• Use / prefix for slash commands

• Commands are case-sensitive for options

• Use autocomplete when available

Permission Issues:

• Some commands require specific roles

• Admin commands (like /add_site_blacklistkeywords) restricted

• Try in different channels if one isn't responding

Issue: Autocomplete not showing options

No Results Found:

• /toggle_keyword: You have no ACOs

• /cyber_toggle_task: You have no CyberAIO tasks

• /remove_keyword: You have no ACOs

Wrong Account:

• Make sure you're logged into correct Discord account

• ACOs are tied to Discord User ID

• Use /aco to verify your ID

Bot Lag:

• Database may be slow

• Wait 5-10 seconds for autocomplete to load

• Try typing part of the option name

Notification Issues

Issue: Not receiving Discord notifications

Check Webhook Channel:

• Each site sends to specific channel

• You may need access to that channel

• Ask admin for channel permissions

Webhook Disabled:

• Site's webhook may be temporarily disabled

• Contact admin to verify webhook configuration

Keywords Too Specific:

• Webhooks sent for ALL new products/restocks

• Your ACO filters may be too narrow to match

• Check general channel for all site notifications

Issue: Getting too many notifications

Solutions:

1. Mute Specific Channels:

• Right-click channel → Mute Channel

• Still allows checking manually

2. Use Keywords Instead:

• Discord search: from:webhookname keyword

• Filter notifications by content

3. Request Filter Adjustments:

• Ask admin to add blacklist keywords

• Reduce notification spam for whole community

Rate Limiting and Errors

Issue: "Failed to create task" error

Possible Causes:

1. CyberAIO Instance Full:

• Task limit reached for your plan

• Solution: Delete old tasks in CyberAIO dashboard

2. Profile Not Found:

• Discord ID not linked to profile

• Solution: Fill out /aco form

3. Proxy Group Invalid:

• Configured proxy group doesn't exist

• Solution: Contact admin

4. API Rate Limit:

• Too many tasks created rapidly

• Solution: Wait 30-60 seconds, usually auto-retries

Issue: "Maximum allowed number of total tasks"

Problem: You've hit the 25 ACO limit

Solution:

/remove_keyword

Delete old/unused ACOs to make room for new ones.

Best Practices:

• Remove ACOs after successful checkout

• Delete ACOs for past drops

• Keep only active ACOs you're currently using

Product-Specific Issues

Issue: Product shows as available but bot doesn't detect it

Reasons:

1. Not a "New" Product:

• Bot detects NEW products and RESTOCKS

• Existing products already in catalog don't trigger

• Only new additions or out-of-stock → in-stock changes

2. Restock Timeout Active:

• 10-second cooldown on restock notifications

• Prevents spam from rapid stock fluctuations

• Wait a bit and restock should be detected next cycle

3. Product in Wrong Collection:

• If monitoring specific collection URL

• Product may be in different collection

• Solution: Request full site monitoring

4. Password-Protected:

• Some sites require password temporarily

• Bot cannot access password-protected stores

• Wait for public release

Issue: Product matched wrong keywords

Example: Searched for "poster" but matched "poster t-shirt"

Why: ACO keywords use exact word boundaries

• "poster" matches any product with word "poster"

• Does not check if other words are present

Solutions:

1. Add negative keywords: poster,-shirt,-tee,-apparel

2. Use more specific keywords: poster,print (AND logic)

3. Check site blacklist: Add "t-shirt" to site blacklist (admin)

Getting Help

Before Asking for Help

Gather Information:

1. Your Discord User ID (for profile lookup)

2. Exact ACO settings (from /keywords)

3. Site URL having issues

4. Error messages (screenshot if possible)

5. Product example that should have matched

Things to Check:

• Site is in /sites list

• Keywords not in /badkws or /site_blacklistkeywords

• ACO is enabled ([On] in /keywords)

• Discord ID linked via /aco form

• CyberAIO instance is online

Where to Get Help

Discord Support Channels:

• Post in #support or designated help channel

• Tag admin/mod if urgent

• Include information gathered above

Common Questions Document:

• Check pinned messages

• Review FAQ if available

GitHub Issues (if available):

• For bug reports

• For feature requests

Quick Diagnostic Checklist

Use this checklist to troubleshoot issues:

For ACO Not Matching:

• Site in /sites?

• Keywords not blacklisted?

• ACO showing [On]?

• Keywords spelled correctly?

• Tested with broad keywords?

For Task Not Creating:

• Webhook notification received?

• Discord ID linked via /aco?

• CyberAIO instance online?

• Task limit not reached?

For Wrong Tasks:

• Variant filter correct?

• Price limit reasonable?

• Checked product page for variant names?

For Commands Not Working:

• Used / prefix?

• Bot online/not restarting?

• Have required permissions?

• Tried in different channel?