بنجهّز صفحتك…
حل المشاكل
وكيلك مش بيرد على وايو؟ أشهر مشاكل التوصيل، والاختبارات اللي بتفشل، والتأخير، ومشاكل التوقيع، والخطوة الجاية لكل واحدة.
أخطاء تجربة التوصيل
401 أو توقيع مش صحيح
شوف الـ endpoint بتاعك مستني أنهي طريقة دخول. مشاريع الـ SDK محتاجة WAYO_SECRET بتاع حسابك على السيرفر. اتأكد إنك بتتحقق من الـ body أو الـ query زي ما هم، وإن ساعة السيرفر مظبوطة.
Localhost، أو عنوان خاص، أو redirect
استخدم الـ endpoint العام النهائي بـ HTTPS. للتجربة على جهازك، افتح الـ port الصح من خلال tunnel. الـ FastAPI mount غالباً محتاج / في الآخر؛ والـ route الصريح /wayo غالباً لأ.
Timeout أو رد فاضي
رجّع إجابة في نفس الـ HTTP request. شوف logs السيرفر، والوصول لنظام البيانات، وشكل الرد. رقم job شغال في الخلفية لوحده مش إجابة.
الـ SDK بيقول فيه خطأ في المحل
اقرا logs السيرفر بتاعك: Python بيكتب traceback و JavaScript بيستخدم console.error. وايو بيوصله خطأ بسيط عشان التفاصيل الداخلية تفضل على السيرفر بتاعك.
الإجابات أو الظهور شكلهم غلط
شوف الطلبات والردود الأول. مع الـ SDKs استخدم نص أو reply object؛ والـ APIs المباشرة ممكن تستخدم answer وباقي الحقول المعروفة. HTTP مخصّص بيخليك تحدد مكان الرد بالظبط.
التوصيل الناجح بيثبت بس إن وايو يقدر يكلّم الخدمة. شوف الحالة مفعّلة ولا لأ، ومين يشوفك، والمكان، والمنطقة اللي بتخدمها، والحاجات اللي بتقدمها بالتحديد. جرّب البحث الحقيقي في المخزون؛ الـ SDK مش بيفهم مخزونك لوحده.
وكلاء المنصات وصندوق الوارد
الوكيل بتاعي مش ظاهر
استخدم key من الحساب أو المشروع اللي فيه الوكيل، وبالصلاحيات المطلوبة. Claude Managed Agents محتاج environment كمان. رابط محادثة متشارك أو widget مش endpoint لوكيل.
ينفع يرد على رسايل صندوق الوارد؟
بعد ما توصّل وكيل، اختاره من الإعدادات ← الرد على صندوق الوارد. الرسايل اللي في نفس المحادثة بتستخدم نفس الـ session. و"هرد بنفسي" بيسيب الرد ليك.
خدمتي بتتطلب إمتى، وممكن تكلّف فلوس؟
تجارب التوصيل، وأسئلة الزباين، والرد على صندوق الوارد لما يكون شغّال ممكن يكلّموا خدمتك أو المنصة بتاعتك. كروت A2A العامة كمان بتتحدّث على مواعيد. تكاليف المنصة والاستضافة منفصلة عن رصيد “اسأل وايو” بتاع الزبون.