المساعدة

حل المشكلات

الرسائل والأعراض التي يصادفها الناس أكثر من غيرها في البوابة وعلى API، جدول لكل مجال، ولكل صف السبب المرجح والحل والصفحة التي تشرحه كاملًا.

كل رسالة تعرضها البوابة أو API تُشرح في صفحة الميزة التي تعرضها. تجمع هذه الصفحة الرسائل الأكثر شيوعًا، جدولًا لكل مجال، حتى تجد الكلمات التي تراها على شاشتك، وتقرأ السبب المرجح والحل في سطر لكل منهما، وتفتح المدخل الكامل حين تحتاج إلى المزيد. استخدم البحث في متصفحك بالنص الذي تراه بالضبط.

العرض في الخط العريض هو النص الحرفي الذي تعرضه البوابة أو API. والعرض في النص العادي يصف ما تراه حين لا توجد رسالة. عمود الصفحة يفتح المدخل الكامل، بكل ما يتركه هذا الجدول.

تسجيل الدخول والحساب

ما تراه السبب المرجح ما تفعله الصفحة
Invalid credentials البريد الإلكتروني أو اسم المستخدم وكلمة المرور لا تطابق حسابًا، أو أُنشئ الحساب عبر Google أو Microsoft ولا توجد له كلمة مرور. تحقق من الاثنين من الأخطاء المطبعية، واستخدم هل نسيت كلمة المرور؟، أو سجّل الدخول بزر Google أو Microsoft الذي أُنشئ به الحساب. طرق تسجيل الدخول
User not confirmed الحساب موجود، لكن بريده الإلكتروني لم يُتحقق منه. افتح بريد التحقق، واضغط صفحة التحقق ثم تحقق من البريد الإلكتروني، أو اطلب رمزًا جديدًا بزر إعادة الإرسال. طرق تسجيل الدخول
Invalid verification code الأرقام الستة لا تطابق أحدث رمز أُرسل؛ وبعد 5 محاولات خاطئة يُلغى الرمز. اضغط إعادة الإرسال واستخدم أحدث رسالة. طرق تسجيل الدخول
No active code found or code has expired الرمز أقدم من مدة صلاحيته، أو حلّ محله رمز أحدث. اطلب رمزًا جديدًا. طرق تسجيل الدخول
Duplicate value for email العنوان له حساب بالفعل، بأي طريقة أُنشئ. سجّل الدخول بذلك الحساب، أو استخدم عنوانًا آخر. التسجيل وإنشاء مساحة العمل
رمز غير صالح. عند تسجيل الدخول أو عند تعطيل المصادقة الثنائية، لم يطابق رمز التطبيق الحالي ولا رمز استرداد غير مستخدم. تأكد أن المدخل في التطبيق هو الخاص بهذا الحساب، وانتظر الرمز التالي، أو انتقل إلى فقدت جهازك؟ استخدم رمز الاسترداد. المصادقة الثنائية
Setup session expired; please restart enrollment مرّت أكثر من 10 دقائق بين الضغط على تفعيل وتأكيد الرمز. أغلق النافذة، واضغط تفعيل مرة أخرى، وامسح رمز QR الجديد لا القديم. المصادقة الثنائية

الفوترة

ما تراه السبب المرجح ما تفعله الصفحة
تعذّر بدء عملية الدفع. تعذّر فتح عملية الشراء؛ يحمل النص السبب عند وجوده. اضغط العودة إلى الخطط وحاول مرة أخرى. وإن قال السبب إن مساحة العمل لديها اشتراك نشط، فاستخدم زر ترقية أو تخفيض على بطاقة الخطة بدلًا من ذلك. اختيار الخطة أو تغييرها
Subscription is canceled but still active until period ends. Use reactivate instead. ألغيت الاشتراك، ولم تنتهِ الفترة بعد. اضغط إعادة تفعيل الخطة في صفحة الاشتراك بدلًا من اختيار الخطة. اختيار الخطة أو تغييرها
You lack the required permission(s): billing.manage دورك لا يسمح بتغيير الاشتراك أو فتح الفواتير. اطلب من المالك في مساحة العمل. اختيار الخطة أو تغييرها
فشل الدفع عدت من PayPal دون دفعة موافَق عليها. حاول مرة أخرى يعيد فتح عملية الدفع عبر PayPal؛ وتغيير طريقة الدفع يعيد فتحها عبر تبويب بطاقة (Stripe أو Paymob). الدفع وإدارة طريقة الدفع
فشل التأكيد تعذّر مطابقة الدفعة بمساحة عملك. اضغط الانتقال إلى الاشتراك؛ وإن ظهرت الخطة القديمة بعد إعادة تحميل الصفحة، فتواصل مع التواصل والدعم مع وقت الدفعة. الدفع وإدارة طريقة الدفع
تعذّر تأكيد شراء الرصيد. تعذّر تأكيد الشراء فورًا؛ وإن تم الخصم فسيظهر الرصيد خلال دقائق. أعد تحميل صفحة الاشتراك بعد بضع دقائق قبل أن تشتري مرة أخرى. الدفع وإدارة طريقة الدفع
الرصيد بعد العملية لا يطابق الشريط الجانبي الشريط الجانبي يحسب رصيد الخطة فقط، والرصيد بعد العملية يضيف الرصيد الإضافي. قارنه بالرقم الكبير على بطاقة الأرصدة المتاحة في صفحة الاشتراك. تتبع استخدام الرصيد

تحويل النص إلى كلام

ما تراه السبب المرجح ما تفعله الصفحة
زر الإنشاء معطّل (رمادي) منطقة الكتابة تحوي مسافات فقط، أو قائمة الأصوات لم تكتمل بعد، أو عملية إنشاء تعمل بالفعل. اكتب نصًا، أو انتظر لحظة. إنشاء الكلام
Error: Insufficient subscription balance رصيد مساحة العمل لا يغطي الخصم؛ لم يُخصم شيء ولم يُنشأ شيء. أضف رصيدًا من الاشتراك، ثم اضغط إنشاء مرة أخرى. إنشاء الكلام
Error: Speech generation is temporarily unavailable. Please try again. لم تعمل عملية الإنشاء؛ وأُعيد الخصم إلى الرصيد. انتظر قليلًا ثم أنشئ مرة أخرى. إنشاء الكلام
Error: Voice not found الصوت المحدد سُحب. اضغط تغيير الصوت واختر صوتًا آخر. إنشاء الكلام
Error: text must be shorter than or equal to 5000 characters النص تجاوز 5,000 حرف بعد تشكيل، لأن كل حركة تُحسب حرفًا. اختصر النص، ثم أنشئ مرة أخرى. إنشاء الكلام
مفتاح تشكيل غير ظاهر أو رمادي لم يُختر صوت، أو الصوت إنجليزي، أو النص لا يحوي حروفًا عربية. اضغط تغيير الصوت، واختر صوتًا عربيًا، واكتب نصًا عربيًا. التشكيل
لم يتغير شيء بعد توقف دوّار التحميل النص لا يحوي عربية، أو كل كلمة تحمل حركة بالفعل، أو عدّلت النص أثناء إضافة الحركات. توقف عن الكتابة، ثم أطفئ تشكيل وأشعله مرة أخرى. التشكيل
المقطع يعمل، لكن تنزيل يعطي ملفًا لا تستطيع فتحه الملف بصيغة WAV، والأداة التي ترفضه تتوقع MP3. حوّل ملف WAV بأداة تختارها. البدء السريع: أول ملف كلام

تحويل الكلام إلى نص وتنقية الصوت

ما تراه السبب المرجح ما تفعله الصفحة
يرجى رفع أحد الأنواع التالية: MP3, WAV, FLAC, OGG, M4A, AAC, WEBM. امتداد الملف ليس واحدًا من الأنواع السبعة. صدّر الصوت بأحدها؛ إعادة تسمية الملف لا تكفي. تفريغ ملف
Audio must be 1 hour or shorter. التسجيل أطول مما تقبله الصفحة. قسّم التسجيل، وفرّغ كل جزء. تفريغ ملف
Transcription is temporarily unavailable. Please try again. تعذّر تسليم الملف للتفريغ؛ وأُعيد الخصم. اضغط حاول مرة أخرى مرة واحدة؛ فإن تكرر، فانتظر بضع دقائق. تفريغ ملف
Job timed out — AI server did not respond لم يصل نص خلال 10 دقائق من قبول الملف؛ وأُعيد الخصم. فرّغ ملفًا أقصر، أو قسّم هذا الملف. تفريغ ملف
النص المفرّغ يقول سيظهر النص المفرّغ هنا. انتهى التفريغ بلا نص، ويُحسب كتفريغ مكتمل. تأكد أن التسجيل فيه كلام مسموع، ثم فرّغه مرة أخرى. قراءة النص المفرّغ
المقطع أطول من ساعة واحدة. قسّمه وحاول مجددًا. التسجيل أطول من ساعة. قسّمه إلى أجزاء بمدة ساعة أو أقل، ونظّف كل جزء. تنقية تسجيل
Sound cleaning is temporarily unavailable. Please try again. لم تكتمل عملية التنقية، أو استغرقت أكثر من 10 دقائق؛ وأُعيد الخصم. انتظر لحظة، ثم اضغط حاول مجددًا. تنقية تسجيل
توقفت التنقية قبل اكتمالها. حاول مجددًا. انقطع الاتصال قبل وصول النتيجة. أعد تحميل الصفحة: إن كان الملف تحت آخر التنقيات فقد اكتمل وخُصم؛ وإن لم يكن، فلم يُخصم شيء، فتحقق من اتصالك وأسقط الملف مرة أخرى. تنقية تسجيل

الوكلاء

ما تراه السبب المرجح ما تفعله الصفحة
تم بلوغ حدّ الخطة مساحة العمل بلغت عدد الوكلاء النشطين الذي تسمح به خطتها؛ والوكلاء المؤرشفون لا يُحسبون. أرشف وكيلًا لا تستخدمه، أو رقِّ خطتك. إنشاء وكيل
هذا الوكيل مؤرشف. استعِده أولًا لإجراء تغييرات. أنت تعدّل وكيلًا مؤرشفًا. اضغط استعادة في الشريط العلوي، ثم عدّل. كتابة الشخصية
لم يعد هذا النموذج متاحًا. اختر نموذجًا آخر للحفاظ على عمل هذا الوكيل. النموذج المحفوظ على هذا الوكيل ليس في القائمة الحالية. اختر نموذجًا حاليًا. اختيار النموذج ودرجة التفكير
Storage limit exceeded for this workspace. Delete files or upgrade your plan. حصة التخزين في خطتك ممتلئة. احذف المصادر التي لم تعد تحتاجها، أو انتقل إلى خطة أكبر. إضافة المستندات إلى المكتبة
صف في المعرفة يقول فشل الأسباب الشائعة: ملفات PDF ممسوحة بلا طبقة نص، وملفات محمية بكلمة مرور. افتح الصف لقراءة السبب، وأصلح المستند، واحذف الصف وارفعه مرة أخرى. إضافة المستندات إلى المكتبة
كل شيء جاهز ومحدد، لكن الوكيل ما زال يفوته كلمات المتصل لا ترد في المستند. اسأل بكلمات من المستند كاختبار؛ فإن نجح، فاخفض العتبة أو أضف صياغة المتصل إلى المستند. لم يستخدم الوكيل مستندي
الوكيل يختلق إجابة بدل أن يقول إنه لا يعرف عدم وجود استرجاع لا يمنع النموذج من الإجابة؛ وهذا السلوك يأتي من حقل الشخصية. أضف هناك تعليمة تطلب منه أن يقول إنه لا يعرف حين لا يكون لديه مصدر. لم يستخدم الوكيل مستندي
لا يوجد رد. حاول مرة أخرى. مرّت ستون ثانية بين رسالتك وأول كلمة من الرد؛ والأداة البطيئة والنموذج البطيء يظهران بهذا الشكل. أرسل مرة أخرى، ثم تفقد المحادثة بحثًا عن استدعاء أداة لم يُرجع نتيجة. اختبار وكيلك
تعذّر بدء الجلسة الصوتية. مساحة العمل بلا رصيد، أو أُرشف الوكيل في تبويب آخر. تحقق من الاثنين، وأغلق ساحة التجربة وحاول مرة أخرى؛ وإن استمر الفشل، فتواصل مع التواصل والدعم مع معرّف الوكيل. اختبار وكيلك
انتهت المكالمة لأن مساحة العمل نفدت أرصدتها. تعذّر خصم أحد الأدوار، فانتهت الجلسة. اشحن الرصيد؛ والأدوار التي خُصمت موجودة في المحادثة. اختبار وكيلك
انتهى رصيد الذكاء الاصطناعي في تجربتك. رقِّ خطتك لمواصلة استخدامه. تكلفة نموذج الذكاء الاصطناعي في الفترة التجريبية بلغت دولارًا واحدًا. اختر خطة من الاشتراك؛ وتعمل أدوات الكلام على رصيد التجربة حتى ذلك الحين. الرصيد والشحن والترحيل
أجاب وكيلي خارج ساعات عمله ساعات العمل تسجّل متى تنوي أن يكون الوكيل متاحًا؛ ولا تمنعه من الرد. افصل القناة أو اربطها بوكيل آخر؛ ولكي يقول الوكيل إنه مغلق، ضع الساعات في تعليماته. ساعات العمل
الوكيل لا يستدعي الأداة أبدًا الأداة غير مختارة على هذا الوكيل، أو الوصف لا يذكر المواقف التي وُضعت لها. اخترها للوكيل، ثم أعد كتابة الوصف ووصف كل معامل. أدوات Webhook
الاستدعاء يفشل برسالة Tool request failed or timed out نقطة النهاية لم ترد خلال المهلة، أو فشل الاتصال. ارفع المهلة [مللي ثانية]، وتأكد أن المضيف يُحل علنًا عبر HTTPS. أدوات Webhook
تعذّر الاتصال بقاعدة البيانات. وصف فارغ، أو قاعدة بيانات لا يمكن الوصول إليها، أو فشل مصافحة TLS، أو سلسلة اتصال لا تُقرأ. املأ الوصف، وتحقق من المضيف وTLS، ثم أرسل مرة أخرى. ربط قاعدة بيانات
الاتصال جاهز لكن الوكيل لا يستخدمه أبدًا لم يُعتمد أي سؤال، أو الاتصال غير مرفق بالوكيل الذي تختبره. اعتمد سؤالًا واحدًا على الأقل، وأرفق الاتصال بالوكيل. ربط قاعدة بيانات

القنوات

ما تراه السبب المرجح ما تفعله الصفحة
الوكيل لا يرد على WhatsApp أبدًا انتهت صلاحية وصول الرقم، أو مساحة العمل بلا رصيد، أو لم تكن الرسالة نصًا. تحقق من الصف إن كان يقول انتهت صلاحية الرمز. أعد الربط.، وأعد ربط الرقم باستيراده مرة أخرى؛ وإلا فاشحن، أو أرسل رسالة نصية. ربط WhatsApp
الرد موجود في المحادثة لكن العميل لم يستلمه رفض WhatsApp الرد: غالبًا انتهت صلاحية الرقم (والصف يقول انتهت صلاحية الرمز. أعد الربط.)، أو ألغت Meta الوصول خارج إيكونوڤا، مثلًا أُزيل الرقم من WhatsApp Manager. إن قال الصف انتهت صلاحية الرمز. أعد الربط.، فاضغط استيراد حساب آخر وحدد الرقم نفسه؛ وإلا فافصل القناة وأعد ربطها. حدود WhatsApp
الرقم على وكيل آخر بالفعل إعادة ربطه من هذا الوكيل تنتهي بـنقل هذه القناة؟. أكّد نقل، وهذا يغلق محادثاتها المفتوحة؛ أو استخدم تعيين لوكيل آخر في تبويب القنوات للوكيل الآخر. ربط WhatsApp
الوكيل صامت في قناة Slack الرسالة لا تذكر التطبيق، أو القناة ليست المحفوظة تحت تعديل المحفزات، أو التطبيق ليس في القناة، أو مساحة العمل بلا رصيد. اذكر التطبيق مع نص بعده، وتحقق من المحفزات، وادعُ التطبيق إلى القناة الخاصة، واشحن. Slack
الوكيل صامت في الرسائل المباشرة في Slack الرسائل المباشرة متوقفة لهذا الاتصال. افتح قائمة الصف، واختر تعديل المحفزات، وفعّل الرسائل المباشرة، واضغط تأكيد الاتصال. Slack
الوكيل لا يرد أبدًا على رسالة Messenger الصف ليس على أي وكيل، أو الرسالة بلا نص، أو مساحة العمل بلا رصيد، أو أرسلت الصفحة الرسالة بنفسها. تحقق من كل شيء بهذا الترتيب. Messenger
المتصل يسمع Sorry, this number is not available right now. Goodbye. مساحة العمل بلا رصيد. اشحن، ثم اتصل مرة أخرى؛ لا حاجة إلى إعادة ربط أي شيء. الصوت عبر Twilio
توقفت المكالمات بعد تغيير Auth Token في Twilio كل مكالمة تُفحص مقابل Auth Token المحفوظ وقت الربط. افصل الرقم، وأعد ربطه بالتوكن الجديد. الصوت عبر Twilio
الوكيل لا يرد على تذكرة Zendesk التذكرة تحمل الوسم echonova_escalated، أو آخر تعليق عام ليس لصاحب الطلب، أو حُذف Webhook أو المشغلات في Zendesk، أو مساحة العمل بلا رصيد. أزل الوسم لإعادة التذكرة إليك، وأعد ربط القناة إن ضاع Webhook أو المشغلات، واشحن. Zendesk
إيقاف القناة مؤقتًا لا يفعل شيئًا زر إيقاف القناة مؤقتًا في صفحة تفاصيل القناة لا يوقف القناة حاليًا. افصل القناة، أو عيّنها لوكيل آخر. Slack

API

ما تراه السبب المرجح ما تفعله الصفحة
401 Unauthorized header Authorization مفقود أو لا يستخدم Bearer، أو الرمز لا يبدأ بـ ek_، أو حُذف المفتاح أو عُطّل. تحقق من header، ثم من الحالة للمفتاح في البوابة. احصل على مفتاح API
403 This API key does not have access to Text-to-Speech services المفتاح يقيّد الوصول، والخدمة التي استدعيتها ليست ضمن خدماته؛ الرسالة نفسها تظهر لـ Speech-to-Text. عدّل المفتاح ومنح الوصول للخدمة، أو استخدم مفتاحًا آخر. احصل على مفتاح API
429 Monthly spending limit exhausted استدعاء تحويل نص إلى كلام سيتجاوز حد المفتاح لهذه الدورة. ارفع الحد من تعديل، أو امسحه لتلغيه، أو انتظر الدورة التالية. احصل على مفتاح API
402 Insufficient subscription balance رصيد مساحة العمل لا يغطي الخصم؛ ولم يُنشأ شيء. أضف رصيدًا لمساحة العمل. البدء السريع لتحويل النص إلى كلام
400 Unsupported file type: application/octet-stream. Please upload an audio file. الجزء file أُرسل بلا نوع محتوى audio/؛ والنوع في الرسالة هو ما أرسله عميلك. حدد نوع الجزء، مثلًا audio/wav. البدء السريع لتحويل الكلام إلى نص
400 Audio exceeds the 10-minute limit. الملف أطول من 10 دقائق. قسّم التسجيل إلى أجزاء بمدة 10 دقائق أو أقل. البدء السريع لتحويل الكلام إلى نص
429 ThrottlerException: Too Many Requests أثناء الاستعلام الدوري حلقة الاستعلام ضيقة جدًا، أو عدة عمال يستعلمون بالمفتاح نفسه. انتظر عدد الثواني المذكور في Retry-After، ثم ارفع فترة الاستعلام، أو وزّع العمال على مفاتيح مختلفة. إعادة الطلبات بأمان
النص نفسه أنتج مهمتين وخصمين أرسل عميلك POST مرتين: طبقة إعادة محاولة، أو إعادة تلقائية لـ POST، أو إعادة تشغيل عامل في منتصف الطلب. أوقف الإعادة التلقائية لـ POST؛ المهمتان حقيقيتان، ولا يُعاد خصم الثانية إلا إن فشلت تلك المهمة. إعادة الطلبات بأمان
Webhook تحوّل إلى معطّل وحده فشلت 5 عمليات تسليم متتالية بعد كل المحاولات. اجعل نقطة النهاية تعيد حالة 2xx خلال 10 ثوان، ثم فعّل Webhook من جديد. تهيئة Webhook
التوقيع لا يطابق أبدًا أُعيد تسلسل الجسم قبل التجزئة، أو حُذفت البادئة <timestamp>.، أو استُخدمت البادئة ذات 12 حرفًا بدل السر الكامل، أو السر يخص Webhook آخر. سجّل البايتات الخام والطابع الزمني الذي جزّأته، وقارن أطوالها بما وصل. التحقق من توقيع Webhook

مثال تطبيقي

تضغط إنشاء في تحويل النص إلى كلام فتعرض الصفحة Error: Insufficient subscription balance. ابحث عن الصف تحت تحويل النص إلى كلام: السبب رصيد لا يغطي الخصم، ولم يُخصم شيء. افتح الاشتراك من قائمة المستخدم، وأضف رصيدًا بزر أضف رصيداً إضافياً، ثم ارجع إلى تحويل النص إلى كلام واضغط إنشاء مرة أخرى. وإن كانت الرسالة غير مدرجة في هذه الصفحة، افتح إنشاء الكلام واقرأ قسم حل المشكلات فيها كاملًا.

الأسئلة الشائعة

رسالتي ليست في هذه الصفحة. أين هي؟

في صفحة الميزة التي عرضتها. كل صفحة تحت ساحة التجربة والوكلاء والمطورين والحساب تنتهي بقسم لحل المشكلات، يسرد كل رسالة تستطيع الميزة عرضها. افتح تلك الصفحة وابحث فيها بالبحث في متصفحك. وإن لم تكن هناك أيضًا، فاكتب إلينا كما هو موضح في التواصل والدعم، مع النص الحرفي للرسالة.

هل خُصم مني عند ظهور خطأ؟

العملية الصوتية التي تُرفض قبل أن تعمل لا تُخصم، والتي تفشل بعد أن بدأت تُسترد؛ والمدخل الكامل في كل صفحة يوضح ذلك. ودورات الوكيل التي أُجيبت قبل أن تنتهي المحادثة تبقى محسوبة. تتبع استخدام الرصيد يعرض كل خصم وكل استرداد.

لماذا يقول API الرمز 402 وتقول البوابة Insufficient subscription balance؟

هما الحالة نفسها. البوابة تعرض نص الرسالة، وAPI يعيد الرمز مع النص نفسه في errorMessage. كل رمز وكل رسالة في API موجودة في الأخطاء.

الحل يقول اشحن الرصيد. أين ذلك؟

الاشتراك من قائمة المستخدم، ثم أضف رصيدًا. أي رصيد تضيفه الشحنة، والترتيب الذي يُنفق به، موضحان في الرصيد والشحن والترحيل.