Error Logs - Error Code Category Table
Overview Each error is assigned a 4-digit integer error code stored in the database. The code encodes both the major category and the specific error type: Format: MMEE MM = Major category code (10–28, 99) EE = Specific error within category (…
Overview
Each error is assigned a 4-digit integer error code stored in the database. The code encodes both the major category and the specific error type:
Format: MMEE
MM = Major category code (10–28, 99)
EE = Specific error within category (01–12, 99 = generic)
Examples:
1001 = Platform Rate Limit › Workspace bot user count limit
1101 = AI Provider Rate Limit › Token-per-minute (TPM) exceeded
1901 = Message Delivery Failure › WhatsApp ecosystem engagement block
2301 = AI Provider Connection Timeout › SSL timeout to AI endpoint
Category Reference Table
Code | Label | Description | Sample Error Messages |
10 | Platform Rate Limit | Rate limits enforced by the chatbot platform itself — workspace bot user caps, smart delay throttling, or comment reply limits. |
|
11 | AI Provider Rate Limit | Token-per-minute (TPM) or request-per-minute (RPM) limits returned by OpenAI, XAI, or other AI API providers. |
|
12 | Billing & Quota | Billing quota exhaustion, insufficient credits, or access to features that require a higher subscription plan. |
|
13 | Authentication & API Key | Invalid, missing, or unverified API keys and authentication credentials for AI providers or external services. |
|
14 | Integration Not Connected | An external service integration (OpenAI, Meta, Shopify, etc.) has not been linked or configured in the platform account. |
|
15 | Authorization & Permission | Bot or user permission errors — the bot is blocked by the user, the user account is deactivated, or the bot is not permitted to initiate conversations. |
|
16 | Account & Business Restriction | WhatsApp Business account locked by Meta, or payment / business eligibility issues that prevent message sending. |
|
17 | Subscription & User State | User opt-outs, unsubscribes, bot paused state, invalid or closed conversations, or chat not found. |
|
18 | Messaging Window & Policy | Messages sent outside the allowed messaging window (24-hour rule for WhatsApp / Messenger), spam frequency restrictions, or replies to already-answered activity. |
|
19 | Message Delivery Failure | Messages that could not be delivered to the recipient — due to ecosystem restrictions, recipient unavailability, A/B experiment participation, or temporary service outage. |
|
20 | WhatsApp Template Error | Errors related to WhatsApp message templates — missing templates, parameter count or format mismatches, quality-paused templates, or text exceeding limits. |
|
21 | Media & File Error | Errors uploading, downloading, or validating media files — wrong MIME type, file too large, URL not reachable, invalid image format, or audio transcription failure. |
|
22 | Connection & Network Timeout | Network-level timeouts or connection failures to platform APIs, Meta Graph API, Telegram, or other non-AI endpoints. |
|
23 | AI Provider Connection Timeout | Network-level timeouts or connection failures specifically to OpenAI or XAI API endpoints, separated from general network timeouts for clearer alerting. |
|
24 | Flow & Execution Control | Bot flow logic errors — total execution time exceeded, too many steps without user interaction, node loop limits exceeded, or infinite function call loops detected. |
|
25 | Data & Payload Error | Request or message payload errors — data exceeds size limits, empty message text, malformed HTML entities, invalid API version, or missing required parameters. |
|
26 | AI Message Format Error | Structural errors in the messages array sent to OpenAI — image URLs placed in non-user roles, or assistant messages with tool_calls missing corresponding tool responses. |
|
27 | Third-Party Integration Error | Errors returned by third-party integrations such as UazAPI (WhatsApp BSP gateway) or Shopify, that do not match a more specific error category. |
|
28 | Platform Internal Error | Unexpected internal errors from the chatbot platform, Meta API, or AI providers that do not fall into a more specific category. |
|
99 | Unknown / Unclassified | Error description could not be matched to any known category. Manual review of the raw description is recommended. |
|
Notes
EE = 99 indicates the error matched the major category but no specific sub-type — treat it as a generic instance of that category.
Major code 99 (code 9999) means the error could not be matched to any category and requires manual review.
Error descriptions may be in multiple languages (English, Spanish, Portuguese, Thai). Pattern matching is language-aware for high-frequency multilingual errors.
{
"version": "1.0",
"generated": "2026-03-07",
"description": "Chatbot platform error code taxonomy. Each code is a 4-digit integer stored as MM*100+EE where MM=major category and EE=specific error within that category.",
"format": {
"code": "MMEE (4-digit integer, e.g. 1001)",
"major": "MM — first 2 digits, identifies the error category (Math.floor(code/100))",
"specific": "EE — last 2 digits, identifies the specific error within the category (code%100). 99 = generic/unclassified within category."
},
"categories": [
{
"major": 10,
"label": "Platform Rate Limit",
"description": "Rate limits enforced by the chatbot platform itself — workspace bot user caps, smart delay throttling, or comment reply limits.",
"samples": [
"The rate limit has exceeded. Please retry again after some time.",
"Bot users in workspace is over limit",
"Over 50 smart delay used in last 24 hours.",
"Comment reply error: rate limited by community spam prevention"
]
},
{
"major": 11,
"label": "AI Provider Rate Limit",
"description": "Token-per-minute (TPM) or request-per-minute (RPM) limits returned by OpenAI, XAI, or other AI API providers.",
"samples": [
"OpenAi Error: Rate limit reached for gpt-4o on tokens per min (TPM): Limit 30000, Used 30000",
"OpenAi Error: Rate limit reached for gpt-4o-mini on requests per minute (RPM)",
"XAi Error: Some resource has been exhausted"
]
},
{
"major": 12,
"label": "Billing & Quota",
"description": "Billing quota exhaustion, insufficient credits, or access to features that require a higher subscription plan.",
"samples": [
"OpenAi Error: You exceeded your current quota, please check your plan and billing details.",
"This request exceeds your quota. You have 14 credits remaining.",
"Pro feature only",
"You have reached your monthly limit."
]
},
{
"major": 13,
"label": "Authentication & API Key",
"description": "Invalid, missing, or unverified API keys and authentication credentials for AI providers or external services.",
"samples": [
"OpenAi Error: Incorrect API key provided: sk-proj-****.",
"AI Provider is not verified. openai",
"{\"detail\":{\"status\":\"invalid_api_key\",\"message\":\"Invalid API key\"}}"
]
},
{
"major": 14,
"label": "Integration Not Connected",
"description": "An external service integration (OpenAI, Meta, Shopify, etc.) has not been linked or configured in the platform account.",
"samples": [
"Open AI not connected",
"Meta Conversions API not connected",
"Shopify account is not connected"
]
},
{
"major": 15,
"label": "Authorization & Permission",
"description": "Bot or user permission errors — the bot is blocked by the user, the user account is deactivated, or the bot is not permitted to initiate conversations.",
"samples": [
"Forbidden: bot was blocked by the user",
"Forbidden: user is deactivated",
"Forbidden: bot can't initiate conversation with a user"
]
},
{
"major": 16,
"label": "Account & Business Restriction",
"description": "WhatsApp Business account locked by Meta, or payment / business eligibility issues that prevent message sending.",
"samples": [
"WhatsApp Error: [{\"code\":131031,\"title\":\"Business Account locked\",\"error_data\":{\"details\":\"Business account has been locked.\"}}]",
"WhatsApp Error: [{\"code\":131042,\"title\":\"Business eligibility payment issue\",\"error_data\":{\"details\":\"Message failed to send due to payment method errors.\"}}]"
]
},
{
"major": 17,
"label": "Subscription & User State",
"description": "User opt-outs, unsubscribes, bot paused state, invalid or closed conversations, or chat not found.",
"samples": [
"Broadcast failed, Bot user unsubscribed",
"Message not sent because not subscribed",
"Message not sent because bot paused",
"Conversation is invalid",
"Bad Request: chat not found"
]
},
{
"major": 18,
"label": "Messaging Window & Policy",
"description": "Messages sent outside the allowed messaging window (24-hour rule for WhatsApp / Messenger), spam frequency restrictions, or replies to already-answered activity.",
"samples": [
"WhatsApp Error: [{\"code\":131047,\"title\":\"Re-engagement message\",\"error_data\":{\"details\":\"More than 24 hours have passed since the customer last replied.\"}}]",
"Meta error: 2018278 (#10) This message is sent outside of allowed window.",
"Message not sent because outside 24 hours",
"WhatsApp Error: [{\"code\":131048,\"title\":\"Spam Rate limit hit\"}]",
"Meta error: (#10900) Activity already replied to"
]
},
{
"major": 19,
"label": "Message Delivery Failure",
"description": "Messages that could not be delivered to the recipient — due to ecosystem restrictions, recipient unavailability, A/B experiment participation, or temporary service outage.",
"samples": [
"WhatsApp Error: [{\"code\":131049,\"title\":\"This message was not delivered to maintain healthy ecosystem engagement.\"}]",
"WhatsApp Error: [{\"code\":131026,\"title\":\"Message undeliverable\"}]",
"Meta error: 1545041 (#551) Esta persona no está disponible en este momento.",
"WhatsApp Error: [{\"code\":130472,\"title\":\"User's number is part of an experiment\"}]",
"Meta error: 1545133 Service temporarily unavailable"
]
},
{
"major": 20,
"label": "WhatsApp Template Error",
"description": "Errors related to WhatsApp message templates — missing templates, parameter count or format mismatches, quality-paused templates, or text exceeding limits.",
"samples": [
"(#132001) Template name does not exist in the translation",
"(#132000) Number of parameters does not match the expected number of params",
"(#132012) Parameter format does not match format in the created template",
"(#132015) Template is temporarily unavailable — paused due to low quality.",
"(#132005) Translated text too long",
"(#132018) Either one of media ID or link must be present",
"WhatsApp Message Template not found"
]
},
{
"major": 21,
"label": "Media & File Error",
"description": "Errors uploading, downloading, or validating media files — wrong MIME type, file too large, URL not reachable, invalid image format, or audio transcription failure.",
"samples": [
"WhatsApp Error: [{\"code\":131053,\"title\":\"Media upload error\",\"error_data\":{\"details\":\"Unsupported Image mime type text/html.\"}}]",
"WhatsApp Error: [{\"code\":131053,\"title\":\"Media upload error\",\"error_data\":{\"details\":\"Image file has size 6097199 bytes but must be atmost 5242880 bytes\"}}]",
"WhatsApp Error: [{\"code\":131053,\"title\":\"Media upload error\",\"error_data\":{\"details\":\"Downloading media from weblink failed with http code 404\"}}]",
"OpenAi Error: Timeout while downloading https://media.example.com/image.jpg",
"Erro ao transcrever audio.",
"Foto não encontrada",
"Card title is empty"
]
},
{
"major": 22,
"label": "Connection & Network Timeout",
"description": "Network-level timeouts or connection failures to platform APIs, Meta Graph API, Telegram, or other non-AI endpoints.",
"samples": [
"cURL error 28: Operation timed out after 15003 milliseconds for https://graph.facebook.com/...",
"cURL error 28: SSL connection timeout for https://cdn.shopify.com/...",
"cURL error 7: Failed to connect to api.telegram.org port 443",
"connection error",
"Request timeout",
"Js function error: timeout"
]
},
{
"major": 23,
"label": "AI Provider Connection Timeout",
"description": "Network-level timeouts or connection failures specifically to OpenAI or XAI API endpoints, separated from general network timeouts for clearer alerting.",
"samples": [
"OpenAi Error: cURL error 28: Operation timed out after 30002 milliseconds for https://api.openai.com/v1/chat/completions",
"OpenAi Error: cURL error 28: SSL connection timeout for https://api.openai.com/v1/responses",
"OpenAi Error: cURL error 7: Failed to connect to api.openai.com port 443",
"XAi Error: cURL error 28: Operation timed out after 30002 milliseconds for https://api.x.ai/v1/chat/completions",
"OpenAi Error: Timeout while downloading https://media.example.com/image.jpg"
]
},
{
"major": 24,
"label": "Flow & Execution Control",
"description": "Bot flow logic errors — total execution time exceeded, too many steps without user interaction, node loop limits exceeded, or infinite function call loops detected.",
"samples": [
"Over max execution time limit of 40 seconds.",
"Over 30 steps without interaction step.",
"Over number of execution limit for this node.",
"repeating function call: confirmar_pedido_en_dropi",
"Over max step points limit of 80."
]
},
{
"major": 25,
"label": "Data & Payload Error",
"description": "Request or message payload errors — data exceeds size limits, empty message text, malformed HTML entities, invalid API version, or missing required parameters.",
"samples": [
"Data size is over 20000 characters for ai_messages, AI Agent Messages",
"Bad Request: message text is empty",
"Bad Request: can't parse entities: Unmatched end tag at byte offset 152",
"invalid version in json payload",
"invalid action",
"(#131008) Required parameter is missing — Parameter of type text is missing text value"
]
},
{
"major": 26,
"label": "AI Message Format Error",
"description": "Structural errors in the messages array sent to OpenAI — image URLs placed in non-user roles, or assistant messages with tool_calls missing corresponding tool responses.",
"samples": [
"OpenAi Error: Invalid 'messages[5]'. Image URLs are only allowed for messages with role 'user', but this message with role 'assistant' contains an image URL.",
"OpenAi Error: An assistant message with 'tool_calls' must be followed by tool messages responding to each 'tool_call_id'. The following tool_call_ids did not have response messages: call_XPe1ktCU"
]
},
{
"major": 27,
"label": "Third-Party Integration Error",
"description": "Errors returned by third-party integrations such as UazAPI (WhatsApp BSP gateway) or Shopify, that do not match a more specific error category.",
"samples": [
"UazApi error: 1",
"get file url from message id failed. AC6966BC8BF44303C32B54CA329512CC cURL error 28: Operation timed out",
"cURL error 28: Connection timed out for https://store.myshopify.com/admin/api/2023-10/orders/..."
]
},
{
"major": 28,
"label": "Platform Internal Error",
"description": "Unexpected internal errors from the chatbot platform, Meta API, or AI providers that do not fall into a more specific category.",
"samples": [
"OpenAi Error: The server had an error while processing your request. Sorry about that!",
"(#135000) Generic user error",
"Meta error: 2018012 (#-1) Unexpected internal error",
"(#131000) Something went wrong",
"Unknown Error",
"Meta error: (#10903) This user cant reply to this activity"
]
},
{
"major": 99,
"label": "Unknown / Unclassified",
"description": "Error description could not be matched to any known category. Manual review of the raw description is recommended.",
"samples": [
"parse error",
"Meta error: ",
"Tipo de mensagem não suportada (file)"
]
}
]
}