واجهة وكالات الشركاء — اربط أي وكالة بعملياتك

تكامل واحد يخدم كل تجار COD Scale

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

وللوكالات المعادلة أفضل: ابنِ التكامل مرة واحدة، وكل تاجر COD Scale يربطك يصبح عميلًا تخدمه من اليوم الأول — دون تكامل مخصص لكل تاجر.

ثلاث طرق لاتصال الوكالة

• الواجهة البرمجية — للوكالات التي لديها مطورون (أو وكيل ذكاء اصطناعي للبرمجة): REST مع مواصفة OpenAPI ونقاط نهاية لكل مسار وكتابات آمنة التكرار وعزل صارم لكل اتصال.
• Google Sheets — للوكالات غير التقنية: تحافظ المنصة على جدول حي لكل مسار عمل. الأعمدة المقفلة تحمل قائمة العمل؛ وتسجل الوكالة نتائجها في أعمدتها ✏️ عبر قوائم منسدلة؛ وتتم المزامنة تلقائيًا كل نحو 10 دقائق، وعمود «النتيجة» يُظهر بدقة ما تم تطبيقه.
• لوحة الوكالة — حساب مجاني واحد لمدير الوكالة يعرض كل التجار المرتبطين وعدادات العمل لكل مسار وجداول Google والتوثيق. يربط التاجر وكالته بتسليمها رمز دعوة يُستخدم مرة واحدة.

نموذج الصلاحيات

يحمل الاتصال أي تركيبة من أربع صلاحيات: confirm (مكالمات التأكيد)، وfulfillment (التغليف والتسليم)، وcourier (التوصيل والتتبع)، وsuivi (متابعة التوصيل). الوكالة الهجينة — كشركة نقل تقدم التغليف أيضًا — تأخذ الصلاحيتين معًا ويمكنها إسناد الطرود إلى نفسها.

ويبقى التاجر مسيطرًا دائمًا: تُعدَّل الصلاحيات مباشرة وتسري من الطلب التالي، ويُبدَّل المفتاح بنقرة واحدة (يموت القديم فورًا)، ويمكن تعليق الاتصال ثم استئنافه في أي وقت.

للمطورين ووكلاء الذكاء الاصطناعي

الواجهة موثقة بثلاثة ملفات صديقة للآلة، كلها عامة ومتزامنة دائمًا مع الإنتاج: مواصفة OpenAPI 3 على https://app.codscale.io/api/partner/openapi.json (ولّد عميلك منها)، ودليل التكامل الكامل بصيغة ماركداون خام على https://app.codscale.io/api/partner/integration.md، وفهرس llms.txt على https://app.codscale.io/api/partner/llms.txt.

تبني بوكيل ذكاء اصطناعي؟ الصق له هذا: «أنت تُكامل وكالتي مع واجهة وكالات الشركاء في COD Scale. اجلب https://app.codscale.io/api/partner/integration.md و https://app.codscale.io/api/partner/openapi.json، والتزم بالقواعد الذهبية وقائمة التحقق في الدليل، وابنِ التكامل لمساري.» الدليل يحوي نموذج المصادقة وسلّم البداية وأمثلة كل مسار وعقد الأخطاء ومنطق إعادة المحاولة — كل ما يحتاجه الوكيل ليبني دون تخمين.

أمان بالتصميم

• لا ترى الوكالة إلا العمل الذي وجهه إليها التاجر — بقية الطلبات والطرود غير مرئية، لكل الوكالات، دائمًا.
• البيانات المشاركة مختزلة إلى ما يلزم للمهمة: العميل والعنوان والأصناف ومبلغ الدفع عند الاستلام — لا تكاليفك ولا هوامشك ولا ماليتك أبدًا.
• لا تضبط الوكالة حالة الطلب مباشرة أبدًا؛ بل تُشتق عبر قواعد الانتقال الخاصة بك، نفس قواعد فريقك الداخلي.
• كتابات آمنة التكرار (إعادة محاولة دون تكرار)، وتحديد لمعدل الطلبات، وكل إجراء يُسجَّل في الخط الزمني للطلب باسم الوكالة — تدقيق كامل.

كيف يربط التاجر وكالة

• افتح الإعدادات ← اتصالات الوكالات في لوحة التحكم (خطط OMS Pro).
• أنشئ الاتصال، وحدد الصلاحيات المطلوبة، وسلّم المفتاح (يظهر مرة واحدة).
• أنشئ عند الحاجة جداول Google لكل مسار، وادعُ الوكالة إلى اللوحة برمز يُستخدم مرة واحدة.
• وراقب العمل يتدفق: تصل الإسنادات إلى الوكالة، وتعود النتائج عبر نفس المسار، وكل إجراء قابل للتدقيق في الخط الزمني.

أسئلة شائعة