Debug Console

Diagnosing system anomalies and connection failures.

Connection Errors

ERR_QR_TIMEOUT

CODE: 408

The WebSocket stream closed before the phone scanned the code.

FIX: Refresh the instance page to generate a new handshake token.

ERR_MULTIDEVICE_CONFLICT

CODE: 409

Phone has too many active linked sessions.

FIX: Open WhatsApp > Linked Devices > Log out of unused sessions.

AI Logic Failures

WARN_TOKEN_LIMIT

CODE: 429

Conversation history exceeded the context window (e.g. 128k tokens).

FIX: The system automatically truncates older messages. If issues persist, clear chat history manually.

WARN_RAG_MISS

CODE: 404

Vector search returned low confidence score for the query.

FIX: Add more specific documents to Knowledge Base or lower the confidence threshold in Agent Settings.

Permissions

Why is the tool not firing?

Even if a plugin is installed, the Agent cannot use it unless explicit Service Grants are configured for that specific Instance.

CHECK: Dashboard > Integrations > Active Grants

Still Stuck?

If these steps do not resolve your issue, extract the `trace_id` from the logs and contact L2 Support.

OPEN_TICKET