πŸ‡ΆπŸ‡¦Troubleshooting & Log Guide: Discord Autochat

Welcome to the AICORA troubleshooting guide. The Running Logs panel in the app is your best friend. It provides a transparent, real-time window into everything the Autochat engine is doing.

This guide will help you understand the most common log messages, what they mean, and how to fix them.


βœ… Pre-Mission Checklist: Avoid Errors Before They Happen

Most errors occur because of a simple setup issue. Before you click START AUTOCHAT, quickly verify this checklist:

  1. All Accounts in Server: Ensure every single one of your alt accounts has successfully joined the target Discord server.

  2. Speaking Permissions: Make sure those accounts have permission to view the channel and send messages in it. If they are muted or lack permissions, you will get errors.

  3. Correct Channel ID: Double-check that you have copied the correct Channel ID and saved it.

  4. Valid Script & Image Paths: Ensure the paths to your .xlsx script and your image folder are correct and that the files actually exist there.


Critical Errors (Red Flags 🚩)

These errors will stop a specific account from working but, thanks to AICORA's resilience system, will not crash the entire mission.

Error: 401: Unauthorized (Token Expired)

  • Log Message You'll See:

    Generated code

    [Timestamp] Failed to send message. Status code: 401, Error: {"message": "401: Unauthorized", "code": 0}

    This is often followed by:

    Token expired: Automatically removed account [Discord Username] (userX).

  • What It Means: This is the most common error you'll encounter. The Discord Token for one of your accounts has expired. Discord does this periodically for security reasons, and it is normal behavior.

  • How to Fix It:

    What AICORA Does Automatically: You don't need to panic or stop the running task immediately. Our software is designed to handle this gracefully. AICORA will automatically skip any messages assigned to this faulty account and continue executing the rest of your script with the remaining healthy accounts. Your mission will continue without interruption.

    What You Should Do Manually (When you have time): To permanently resolve the issue and get that account back in the action for future tasks:

  1. At your convenience, click STOP AUTOCHAT to end the current mission.

  2. Follow our guide, "How to Find/Update Your Discord Token," to get a fresh, new token from the Discord web app for the affected account.

  3. In the AICORA app, remove the old account from the list (right-click -> Delete).

  4. Add the account back using the new, valid token.

Error: 403: Missing Permissions

  • Log Message You'll See:

    [Timestamp] Failed to send message. Status code: 403, Error: {"message": "Missing Permissions", "code": 50013}

  • What It Means: The account (userX) that was supposed to send the message either is not in the target server or lacks the necessary permissions to speak in that specific channel.

  • How to Fix It:

    1. Manually check that the specific Discord account has joined the server.

    2. In your Discord server's settings, verify that the account's role has "Send Messages" and "View Channel" permissions for the target channel.


Setup & Configuration Errors (Yellow Flags ⚠️)

These messages usually appear right after you click START AUTOCHAT and indicate a problem with your initial setup.

  • Log Message: Error: Channel ID not set

    • Meaning: You forgot to paste the Channel ID into the configuration field and click Save.

  • Log Message: Error: Message file not set or file does not exist

    • Meaning: The path you selected for your .xlsx Chat Script is incorrect, or the file has been moved or deleted.

  • Log Message: Error: No Discord accounts added

    • Meaning: You haven't added any Discord account tokens to the list yet.

  • Log Message: Error: Image folder does not exist or is not set

    • Meaning: Your script uses an :image: command, but you haven't selected a valid folder path under "Script Image".


Script & File Errors

These messages point to issues inside your .xlsx script or image folder.

  • Log Message: Error: Excel file should contain at least two columns

    • Meaning: Your script file is not formatted correctly. It must have at least two columns (Column A for the Actor, Column B for the Content).

  • Log Message: Warning: Unrecognized message format - row X: [command]

    • Meaning: The command you wrote in Column A of your script on a specific row is invalid (e.g., a typo like user1repy2: instead of user1reply2:). AICORA will skip this line and move to the next one.

  • Log Message: Error: Image [filename] not found

    • Meaning: Your script told an account to send an image with a specific filename, but AICORA could not find a matching file in your selected "Script Image" folder. Check for typos in your script or make sure the image is in the folder.

  • Log Message: Warning: Token for user [userX] not found. Skipping this message.

    • Meaning: Your script is trying to use a user (e.g., user15), but you only have 10 accounts added to your list. AICORA will skip this line.


Informational Messages (Just for Context)

These aren't errors, but they explain why the bot might behave in a slightly unexpected way.

  • Log Message: Warning: Message ID for row X not found, sending as regular message

    • Meaning: You used a reply command (e.g., user5reply3:), but the message on Row 3 failed to send for some reason. Since the bot has no message to reply to, it will post the content as a new, regular message instead of a reply.

  • Log Message: Reached end of messages. Restarting message sending...

    • Meaning: You have the "Loop Sending" option checked, and the script has finished its first run. It's now starting over from the top. All reply history is reset for the new loop.

Last updated