نظرة عامة

يتم تعيين رمز خطأ صحيح مكون من 4 أرقام لكل خطأ مخزن في قاعدة البيانات. يرمز الرمز لكل من الفئة الرئيسية ونوع الخطأ المحدد:

الصيغة: MMEE

MM = رمز الفئة الرئيسية (10–28، 99)

EE = خطأ نوعي ضمن الفئة (01–12، 99 = عام)

أمثلة:

1001 = حد معدل المنصة › حد عدد مستخدمي بوت Workspace

1101 = حد معدل مزودي الذكاء الاصطناعي › تم تجاوز الرمز في الدقيقة (TPM)

1901 = فشل في تسليم الرسالة › حظر تفاعل نظام واتساب البيئي

2301 = مهلة اتصال مزود الذكاء الاصطناعي › مهلة SSL إلى نقطة نهاية الذكاء الاصطناعي

الشيفرة | العلامة التجارية | الوصف | رسائل خطأ نموذجية

10 | حد سعر المنصة | حدود المعدلات التي تفرضها منصة الدردشة نفسها — مثل حدود استخدام بوتات مساحة العمل، تقليل التأخير الذكي، أو حدود الرد على التعليقات. | تجاوز الحد الأقصى للسعر. يرجى إعادة المحاولة بعد فترة.مستخدمو البوتات في مساحة العمل تجاوزوا الحدتم استخدام أكثر من 50 تأخير ذكي خلال آخر 24 ساعة.خطأ في الرد على التعليق: المعدل محدود بمنع الرسائل المزعجة في المجتمع

11 | حد سعر مزودي الذكاء الاصطناعي | حدود الرمز لكل دقيقة (TPM) أو الطلب لكل دقيقة (RPM) التي يعيدها مزودو OpenAI أو XAI أو مزودي واجهات برمجة تطبيقات الذكاء الاصطناعي الآخرين. | خطأ OpenAi: تم الوصول إلى حد المعدل ل gpt-4o على الرموز في الدقيقة (TPM): الحد 30000، استخدم 30000خطأ في OpenAi: تم الوصول إلى حد المعدل ل gpt-4o-mini على الطلبات في الدقيقة (RPM)خطأ XAi: تم استنفاد بعض الموارد

12 | الفوترة والحصص | نفاد حصة الفوترة، أو نقص الاعتمادات، أو الوصول إلى ميزات تتطلب خطة اشتراك أعلى. | خطأ في OpenAi: لقد تجاوزت حصتك الحالية، يرجى مراجعة خطتك وتفاصيل الفوترة.هذا الطلب يتجاوز حصتك. تبقى لديك 14 رصيدا.ميزة Pro فقطلقد وصلت إلى الحد الشهري.

13 | المصادقة ومفتاح API | مفاتيح API وبيانات المصادقة غير صالحة أو مفقودة أو غير موثقة لمزودي الذكاء الاصطناعي أو الخدمات الخارجية. | خطأ OpenAi: تم توفير مفتاح API غير صحيح: sk-proj-****.مزود الذكاء الاصطناعي غير موثق. OpenAI{"تفصيل":{"status":"invalid_api_key","message":"مفتاح API غير صحيح"}}

14 | التكامل غير متصل | لم يتم ربط أو تكوين تكامل خدمة خارجية (OpenAI، Meta، Shopify، إلخ) في حساب المنصة. | الذكاء الاصطناعي المفتوح غير متصلواجهة برمجة تطبيقات التحويلات الميتا غير متصلةحساب شوبيفاي غير متصل

15 | التفويض والإذن | أخطاء في البوت أو إذن المستخدم — يتم حظر البوت من قبل المستخدم، أو تعطيل حساب المستخدم، أو لا يسمح له ببدء المحادثات. | ممنوع: تم حظر البوت من قبل المستخدمممنوع: تم تعطيل المستخدمممنوع: البوت لا يمكنه بدء المحادثة مع المستخدم

16 | قيود الحساب والأعمال | حساب واتساب بيزنس مقفل من قبل ميتا، أو مشاكل في الأهلية للدفع أو الأعمال تمنع إرسال الرسائل. | خطأ في واتساب: [{"code":131031,"title":"حساب العمل مقفل","error_data":{"details":"تم قفل حساب الأعمال."}}]خطأ في واتساب: [{"code":131042,"title":"مشكلة دفع أهلية الأعمال","error_data":{"details":"فشل إرسال الرسالة بسبب أخطاء في طريقة الدفع."}}]

17 | الاشتراك وحالة المستخدم | انسحاب المستخدم، إلغاء الاشتراك، حالة إيقاف البوت، المحادثات غير الصالحة أو المغلقة، أو عدم العثور على الدردشة. | فشل البث، وقام مستخدم البوت بإلغاء الاشتراكلم يتم إرسال الرسالة لأن الاشتراك غير مشتركلم ترسل الرسالة لأن البوت توقف مؤقتاالمحادثة غير صالحةطلب سيء: لم يتم العثور على الدردشة

18 | نافذة الرسائل والسياسة | الرسائل المرسلة خارج نافذة المراسلة المسموح بها (قاعدة 24 ساعة في واتساب / ماسنجر)، أو قيود تكرار الرسائل المزعجة، أو الردود على نشاط تم الرد عليه مسبقا. | خطأ في واتساب: [{"code":131047,"title":"رسالة إعادة التفاعل","error_data":{"details":"مر أكثر من 24 ساعة منذ آخر رد للعميل."}}]خطأ ميتا: 2018278 (#10) هذه الرسالة ترسل خارج نافذة المهرجان.لم يتم إرسال الرسالة لأن خارج 24 ساعةخطأ في واتساب: [{"code":131048,"title":"حد معدل الرسائل المزعجة"}]خطأ في الميتا: (#10900) تم الرد بالفعل على النشاط

19 | فشل تسليم الرسالة | رسائل لا يمكن إيصالها إلى المستلم — بسبب قيود النظام البيئي، أو عدم توفر المستلم، أو المشاركة في تجارب A/B، أو انقطاع مؤقت في الخدمة. | خطأ في واتساب: [{"code":131049,"title":"لم يتم تسليم هذه الرسالة للحفاظ على تفاعل صحي مع النظام البيئي."}]خطأ في واتساب: [{"code":131026,"title":"الرسالة غير قابلة للتسليم"}]خطأ الميتا: 1545041 (#551) Esta persona no está disponible en este momento.خطأ في واتساب: [{"code":130472,"title":"رقم المستخدم جزء من تجربة"}]خطأ في الميتا: الخدمة 1545133 غير متاحة مؤقتا

20 | خطأ في قالب واتساب | أخطاء متعلقة بقوالب رسائل واتساب — مثل نقص القوالب، أو عدم تطابق عدد المعلمات أو التنسيق، أو قوالب توقفت الجودة، أو تجاوز النص الحدود. | (#132001) اسم القالب غير موجود في الترجمة(#132000) عدد المعلمات لا يتطابق مع العدد المتوقع من المعلمات(#132012) تنسيق المعلمات لا يتطابق مع التنسيق في القالب الذي تم إنشاؤه(#132015) القالب غير متاح مؤقتا — تم إيقافه مؤقتا بسبب انخفاض الجودة.(#132005) النص المترجم طويل جدا(#132018) يجب أن يكون هناك أحد معرف الوسائط أو الرابطقالب رسالة واتساب لم يعثر عليه

21 | خطأ في الوسائط والملفات | أخطاء في رفع أو تحميل أو التحقق من صحة ملفات الوسائط — نوع MIME خاطئ، ملف كبير جدا، رابط URL غير قابل للوصول، تنسيق صورة غير صالح، أو فشل في نسخ الصوت. | خطأ في واتساب: [{"code":131053,"title":"خطأ رفع الوسائط","error_data":{"details":"غير مدعوم صورة صامت نوع text/html."}}]خطأ في واتساب: [{"code":131053,"title":"خطأ في رفع الوسائط","error_data":{"details":"ملف الصورة له حجم 6097199 بايت لكنه يجب أن يكون 5242880 بايت على الأكثر"}}]خطأ في واتساب: [{"code":131053,"title":"خطأ في رفع الوسائط","error_data":{"details":"فشل تحميل الوسائط من رابط الويب مع رمز http 404"}}]خطأ في OpenAi: مهلة التوقف أثناء التنزيل media.example.comErro ao transcrever audio.Foto não encontradaاسم البطاقة فارغ

22 | وقت الاتصال والشبكة | مهلات على مستوى الشبكة أو فشل الاتصال في واجهات برمجة التطبيقات للمنصة، أو واجهة Meta Graph، أو تيليجرام، أو غيرها من نقاط النهاية غير الذكاء الاصطناعي. | خطأ cURL 28: انتهت العملية بعد 15003 مللي ثانية ل graph.facebook.com...خطأ cURL 28: مهلة اتصال SSL لشبكة توصيل المحتوى في Shopify ...خطأ cURL 7: فشل الاتصال بالروبوتات: مقدمة للمطورين منفذ 443خطأ في الاتصالطلب مهلة مستقطعةخطأ في دالة جافاسكت (js): مهلة الخروج

23 | مهلة الاتصال بمزود الذكاء الاصطناعي | مهلات الشبكة أو فشل الاتصال تحديدا لنقاط نهاية OpenAI أو XAI، منفصلة عن مهلات الشبكة العامة لتنبيهات أوضح. | خطأ OpenAi: خطأ cURL 28: توقفت العملية بعد 30002 مللي ثانية api.openai.comخطأ OpenAi: خطأ cURL 28: مهلة اتصال SSL ل api.openai.comخطأ OpenAi: خطأ cURL 7: فشل في الاتصال بمنفذ 443 api.openai.comخطأ XAi: خطأ cURL 28: توقفت العملية بعد 30002 مللي ثانية ل api.x.aiخطأ في OpenAi: مهلة التوقف أثناء التنزيل media.example.com

24 | التحكم في التدفق والتنفيذ | أخطاء منطقية تدفق البوت — تجاوز إجمالي وقت التنفيذ، أو كثرة الخطوات دون تدخل المستخدم، أو تجاوز حدود حلقات العقد، أو اكتشاف حلقات استدعاء لا نهائية للوظائف. | تجاوز الحد الأقصى لوقت التنفيذ وهو 40 ثانية.أكثر من 30 خطوة بدون تفاعل.تجاوز عدد حد التنفيذ لهذه العقدة.استدعاء الدالة المتكرر: confirmar_pedido_en_dropiتجاوز الحد الأقصى لنقاط الخطوة وهو 80.

25 | خطأ البيانات والحمولة | أخطاء حمولة الطلب أو الرسالة — البيانات تتجاوز حدود الحجم، أو نص رسالة فارغ، أو كيانات HTML مشوهة، أو إصدار API غير صالح، أو المعلمات المطلوبة مفقودة. | حجم البيانات يزيد عن 20000 حرف لرسائل ai_messages الوكيل الذكاء الاصطناعيطلب سيء: نص الرسالة فارغطلب خاطئ: لا يمكن تحليل الكيانات: علامة نهاية غير مطابقة عند إزاحة بايت 152النسخة غير الصالحة في حمولة JSONالإجراء غير الصحيح(#131008) المعلمة المطلوبة مفقودة — معلمة من نوع النص تفتقد قيمة النص

26 | خطأ في تنسيق رسالة الذكاء الاصطناعي | أخطاء هيكلية في مصفوفة الرسائل المرسلة إلى OpenAI — روابط الصور التي توضع في أدوار غير مستخدمة، أو رسائل مساعد مع tool_calls ردود أدوات مقابلة مفقودة. | خطأ OpenAi: 'messages[5]' غير صالحة. يسمح بروابط الصور فقط للرسائل التي تحمل 'user'، لكن هذه الرسالة التي تحتوي على 'مساعد' دور تحتوي على عنوان URL للصورة.خطأ في OpenAi: يجب أن تتبع رسالة المساعد التي تحتوي على 'tool_calls' رسائل أداة ترد على كل 'tool_call_id'. tool_call_ids التالية لم يكن لديها رسائل رد: call_XPe1ktCU

27 | خطأ التكامل مع الطرف الثالث | أخطاء تعرضها تكاملات طرف ثالث مثل UazAPI (بوابة واتساب BSP) أو Shopify، والتي لا تتطابق مع فئة أخطاء أكثر تحديدا. | خطأ UazApi: 1فشل الحصول على عنوان URL للملف من معرف الرسالة. خطأ AC6966BC8BF44303C32B54CA329512CC cURL 28: انتهت مدة العمليةخطأ cURL 28: انتهى وقت الاتصال ل store.myshopify.com...

28 | خطأ داخلي في المنصة | أخطاء داخلية غير متوقعة من منصة الدردشة أو واجهة برمجة التطبيقات الميتا أو مزودي الذكاء الاصطناعي التي لا تندرج تحت فئة أكثر تحديدا. | خطأ في OpenAi: تعرض الخادم لخطأ أثناء معالجة طلبك. آسف على ذلك!(#135000) خطأ المستخدم العامخطأ ميتا: 2018012 (#-1) خطأ داخلي غير متوقع(#131000) حدث خطأ ماخطأ غير معروفخطأ في الميتا: (#10903) هذا المستخدم لا يستطيع الرد على هذا النشاط

99 | غير معروف / غير مصنف | لم يكن بالإمكان مطابقة وصف الخطأ مع أي فئة معروفة. يوصى بمراجعة الوصف الخام يدويا. | خطأ في التحليلخطأ ميتا:Tipo de mensagem não suportada (file)

ملاحظات

• EE = 99 يشير إلى أن الخطأ تطابق الفئة الرئيسية ولكن لا يوجد نوع فرعي محدد — اعتبرها كنسخة عامة من تلك الفئة.

• الرمز الرئيسي 99 (الرمز 9999) يعني أن الخطأ لا يمكن تطابقه مع أي فئة ويتطلب مراجعة يدوية.

• قد تكون أوصاف الأخطاء بعدة لغات (الإنجليزية، الإسبانية، البرتغالية، التايلاندية). مطابقة الأنماط واعية لغويا للأخطاء متعددة اللغات عالية التكرار.

{
"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)"
]
}
]
}