Error code reference

When something genuinely breaks, a visitor sees a single line with a code like BOT-404-1A2B3C4D. The prefix tells you what happened; the suffix is just a unique id for that one occurrence, so support can find it in the logs.

What each prefix means

• BOT-EMPTY, the message was blank, so there was nothing to answer.
• BOT-TOOLONG, the message was longer than 2,000 characters. Send a shorter one.
• BOT-REQUEST, the request was malformed or missing a required field.
• BOT-404, the bot was not found. The Bot ID is wrong, or the bot was deleted.
• BOT-PAUSED, the bot is switched off right now.
• BOT-RATE, too many messages at once. It clears in a moment.
• BOT-LIMIT, this chat reached its message cap. Start a new conversation.
• BOT-QUOTA, the plan ran out of included conversations and credits. The owner tops up or upgrades.
• BOT-CONFIG, a required model or setting is missing. The owner fixes it in the dashboard.
• BOT-KEY, the AI provider key is missing or was rejected.
• BOT-AI, the AI provider errored or was overloaded. A retry usually works.
• BOT-TIMEOUT, the reply took too long and timed out. Try again.
• BOT-TOOL, an action or integration the bot tried to run failed.
• BOT-DATA, a database or storage step failed on our side.
• BOT-RUNTIME, an unexpected error, which usually clears on a retry.

Not every message is an error

Plenty of messages look like problems but are not, and they carry no code: "this chatbot is on hold", "our team is offline right now", or your own "I do not have an answer for that yet". Those are normal replies. Only a line with a BOT- code is a real error worth reporting.