تكامل توترز (Toters)
🛵 تكامل توترز (Toters)
📌 نبذة سريعة
| المعلومة | القيمة |
|---|---|
| 🌍 المنطقة | لبنان، العراق، الأردن |
| 💰 السعر | 10 د.أ / فرع / شهر |
| 📋 الباقة المطلوبة | Ultimate |
| 🔄 المزامنة | أوتوماتيكية (Webhook) |
| 🔐 التوقيع | HMAC-SHA256 |
🎯 ما فائدة تكامل توترز؟
ربط نظام إيصال مع تطبيق توترز (Toters) يتيح لك:
📲 استقبال الطلبات تلقائياً من توترز
📋 مزامنة القائمة — تعديلات تنعكس على توترز
🔄 تحديث حالة الطلب (7 حالات)
🚚 تتبع السائق — موقع السائق مباشر
📊 إدارة الطلبات من لوحة تحكم إيصال
👤 لمن هذه الصفحة؟
| الدور | الفائدة |
|---|---|
| 🏪 صاحب مطعم (لبنان، العراق، الأردن) | استقبال طلبات توترز |
| 👨💼 مدير النظام | إعداد ومتابعة التكامل |
| 👨🍳 الشيف | رؤية الطلبات على شاشة المطبخ |
🚀 دليل الإعداد
الخطوة 1: اشتراك توترز
سجل في Toters Partner
- أكمل عملية التسجيل والتحقق
- احصل على بيانات الحساب:
🔑 API Key 🔐 API Secret 🆔 Store ID 🔐 Webhook Secret
الخطوة 2: تفعيل الإضافة في إيصال
- سجل الدخول إلى بوابة المشترك
اذهب إلى الإضافات ← تكامل توترز
اضغط تفعيل (10 د.أ / فرع / شهر)
الخطوة 3: إعداد التكامل
اذهب إلى الإعدادات ← التكاملات ← توترز
- أدخل بيانات حساب توترز:
┌─────────────────────────────────────────┐ │ 🔗 إعداد تكامل توترز │ ├─────────────────────────────────────────┤ │ 🔑 API Key: [أدخل المفتاح] │ │ 🔐 API Secret: [أدخل السر] │ │ 🆔 Store ID: [أدخل الرقم] │ │ 🔐 Webhook Secret: [أدخل السر] │ │ │ │ 🌐 البيئة: │ │ ● إنتاج (Production) │ │ ○ اختبار (Sandbox) │ │ │ │ ⏱️ وقت التحضير الافتراضي: 15 دقيقة │ │ 🤖 القبول التلقائي: ✅ │ │ │ │ [🔌 اختبار الاتصال] [💾 حفظ] │ └─────────────────────────────────────────┘ اضغط اختبار الاتصال
✅ إذا ظهر "اتصال ناجح"، اضغط حفظ
الخطوة 4: مزامنة القائمة
اضغط مزامنة القائمة الآن
- ⏳ انتظر حتى تنتهي المزامنة
- ✅ تحقق من تطابق المنتجات والأسعار
الخطوة 5: تفعيل الاستقبال التلقائي
فعّل القبول التلقائي للطلبات
- ✅ من الآن، أي طلب من توترز يصل تلقائياً
❓ الأسئلة الشائعة
كيف أحصل على API Key من توترز؟
سجل في لوحة تحكم توترز، اذهب إلى الإعدادات ← Developer ← API Keys.
هل توترز متاح في الأردن؟
نعم، توترز متاح في لبنان، العراق، والأردن.
ما هو HMAC-SHA256؟
نظام أمان للتحقق من أن الطلبات الواردة من توترز أصلية. يتم ضبطه تلقائياً عند إعداد التكامل.
كم من الوقت تستغرق المزامنة الأولية؟
عادةً 1-2 دقيقة.
هل يدعم توترز وقت التحضير الافتراضي؟
نعم، يمكنك ضبط وقت التحضير الافتراضي (Default Prep Time) من إعدادات التكامل. يظهر للعميل كوقت تقديري.
🔧 استكشاف المشاكل
| المشكلة | السبب المحتمل | الحل |
|---|---|---|
| ❌ فشل اختبار الاتصال | API Key أو API Secret غير صحيحين | تحقق من API Key و API Secret |
| ❌ القائمة لا تتزامن | لا توجد منتجات نشطة في النظام | تأكد من وجود منتجات نشطة |
| ❌ الطلبات لا تصل | webhook Secret غير صحيح | تحقق من webhook Secret |
| ❌ توقيع HMAC غير صحيح | Webhook Secret غير متطابق | تأكد من Webhook Secret المطابق |
| ❌ وقت التحضير لا يظهر | وقت التحضير الافتراضي غير مضبوط | ضبط وقت التحضير الافتراضي في الإعدادات |