# تكامل Flash Manager — مزامنة تلقائية للطلبات

**الفئة:** منصات خارجية  ·  **أدنى خطة:** مجاني  ·  **المعرّف:** `flash-manager`

**Flash Manager** (`flash-manager.com`) منصة لإدارة الطلبات عند الاستلام وتأكيدها — شعارها الخاص هو *COD order management, WhatsApp confirmations & Meta ROAS*. يستعملها التجار الجزائريون كمساحة عمل لمركز اتصال: يتصل فريق التأكيد بكل طلب جديد أو يراسله عبر WhatsApp، يضعه مؤكدًا أو ملغيًا، ثم يتابع توصيله. وDZBuild يوفّر **تكاملًا مدمجًا** معها، فيصل كل طلب في متجرك إلى Flash Manager تلقائيًا، بلا تصدير ملفات وبلا نسخ ولصق.

## شرح بالفيديو[​](#شرح-بالفيديو "رابط مباشر إلى شرح بالفيديو")

[تكامل Flash Manager — مزامنة تلقائية للطلبات](https://www.youtube-nocookie.com/embed/uOLAkJ-ik60)

## المميزات[​](#المميزات "رابط مباشر إلى المميزات")

* **مزامنة الطلبات** — الطلبات الجديدة في DZBuild تُرسل إلى Flash Manager تلقائيًا.
* **مركز تأكيد الطلبات** — فريقك يؤكد الطلبات داخل Flash Manager، بما في ذلك عبر WhatsApp.
* **تتبع التوصيل** — حالات التوصيل الخاصة بـ Flash Manager تظهر لك داخل DZBuild.
* **تقارير متقدمة** — تقارير Flash Manager على مسار طلباتك.
* **تتبع ROAS للحملات**: رؤية Flash Manager لعائد إنفاقك الإعلاني على Meta. يمرّر DZBuild معرّف الحملة عندما يحمل الرابط الذي وصل منه العميل معاملاً `campaign_id` أو `utm_campaign` أو `campaignid`.
* **API متقدم** — الربط يتم بمفتاح API الخاص بحسابك، ويُحفظ مشفّرًا.

## ماذا يفعل[​](#ماذا-يفعل "رابط مباشر إلى ماذا يفعل")

بمجرد ربط متجرك، يرسل DZBuild كل **طلب جديد** إلى Flash Manager خلال ثوانٍ من إنشائه. وهذا يشمل كل مصادر البيع: صفحة الدفع في متجرك، و[صفحات الهبوط](https://dzbuild.com/ar/ar/docs/selling/landing-pages.md)، والطلبات التي تنشئها يدويًا من صفحة [الطلبات](https://dzbuild.com/ar/ar/docs/selling/orders.md)، والطلبات المنشأة عبر `API` الخاص بـ DZBuild.

لا شيء يحتاج نقرة لكل طلب، ولا وجود لملفات CSV. وبمجرد أن تقبل Flash Manager الطلب، يسجّله DZBuild كمُرسَل ويتخطاه في كل محاولة لاحقة، فإعادة الإرسال أو الضغط على **إرسال الطلبات غير المُرسلة** مرة أخرى لا ينشئ نسخة ثانية. الحالة الوحيدة التي قد تمرّ هي أن تبدأ محاولتا إرسال للطلب نفسه في اللحظة ذاتها؛ وهي نادرة، لكن إن شككت فيها فابحث داخل Flash Manager عن طلبين يحملان رقم طلب DZBuild نفسه. أما جدول **آخر الطلبات** في DZBuild فيعرض كل طلب مرة واحدة، فلا يمكنه إظهار التكرار.

وفي الاتجاه المعاكس، يستعلم DZBuild من Flash Manager بانتظام ويعرض حالة التأكيد وحالة التوصيل لكل طلب مُرسل داخل صفحة التكامل: الطلب الموصَّل يظهر خلال نحو 5 دقائق، وبقية تغييرات التأكيد والتوصيل خلال نحو 30 دقيقة. ولا تُنسخ هذه الحالات إلى **طلباتك في DZBuild** إلا إذا فعّلت خيار النسخ، وهو مُعطّل افتراضيًا.

### نسخ الحالات[​](#نسخ-الحالات "رابط مباشر إلى نسخ الحالات")

عند تفعيل **تحديث حالة الطلب من FlashManager**، تُترجم مصطلحات Flash Manager إلى حالات طلبات DZBuild هكذا:

| حالة Flash Manager                           | تصبح حالة الطلب في DZBuild |
| -------------------------------------------- | -------------------------- |
| جديد، إعادة اتصال، لا يرد                    | قيد الانتظار               |
| مؤكد، مؤكد من العميل، تأكيد ذاتي             | مؤكد                       |
| ملغي، مكرر، رقم خاطئ                         | ملغي                       |
| تم إنشاء الملصق، جاهز للاستلام               | جاري التحضير               |
| تم الاستلام، قيد التوصيل، محاولة توصيل، مؤجل | تم الشحن                   |
| تم التوصيل                                   | تم التوصيل                 |
| فشل التوصيل                                  | مرتجع                      |

warning

هناك حمايتان تعملان دائمًا حتى مع تفعيل النسخ. الطلب الذي **أُرسل إلى شركة التوصيل** من DZBuild لا يُعدَّل أبدًا — تتبع شركة التوصيل يبقى المرجع. والطلب الموجود في حالة نهائية (`delivered` أو `returned` أو `cancelled`) لا يعود إلى الوراء.

## الفوائد[​](#الفوائد "رابط مباشر إلى الفوائد")

* **لا إعادة إدخال يدوية.** يتوقف فريق التأكيد عن إعادة كتابة الأسماء والهواتف والولايات والمبالغ في أداة ثانية — الطلب موجود هناك كاملًا.
* **تأكيد أسرع.** تصل الطلبات إلى قائمة التأكيد بعد ثوانٍ من إتمامها، والمشتري ما زال يتذكر طلبه. الاتصال المبكر هو ما يحافظ على نسبة تأكيد عالية.
* **مرتجعات أقل.** الأرقام الخاطئة والطلبات المكررة والمترددون يُفلترون *قبل* تسليم الطرد لشركة التوصيل، بدل أن يعودوا كمرتجع مدفوع التكلفة.
* **مكان واحد للمتابعة.** تعرض صفحة التكامل كم طلبًا أُرسل، وكم ما زال قيد المتابعة، وماذا تقول Flash Manager عن كل طلب، إلى جانب حالة متجرك.
* **وضوح في ROAS.** بما أن كل الطلبات تصل إلى Flash Manager، فإن تقارير ROAS الخاصة بها ترى حجم طلباتك كاملًا، لا جزءًا مُصدَّرًا يدويًا.

## كيف تفعّله[​](#كيف-تفعّله "رابط مباشر إلى كيف تفعّله")

1. افتح **لوحة التحكم → الإضافات** على [`/dashboard/addons`](https://dzbuild.com/dashboard/addons).
2. انزل إلى قسم **منصات خارجية** وابحث عن بطاقة **FlashManager**.
3. انقر **ربط FlashManager** — تُفتح صفحة الإدارة على `/dashboard/addons/flash-manager`.
4. من داخل Flash Manager، أنشئ مفتاح `API` يحمل صلاحية `orders:write` وانسخه. قوائمهم تتغيّر من حين لآخر، فابحث عن قسم `API` في إعداداتهم أو اسأل دعم Flash Manager. ولا يقبل DZBuild سوى المفاتيح التي تبدأ بـ `fm_`.
5. الصقه في حقل **مفتاح API** وانقر **ربط الحساب**.

التكامل **مجاني على كل خطط DZBuild** — مجاني، Pro، Unlimited، وEnterprise. لا يوجد ما تشتريه من جهة DZBuild.

## طريقة الاستعمال[​](#طريقة-الاستعمال "رابط مباشر إلى طريقة الاستعمال")

### بطاقة الربط[​](#بطاقة-الربط "رابط مباشر إلى بطاقة الربط")

* يعرض رأس الصفحة شارة **متصل** أو **غير متصل**.
* اضغط **اختبار الاتصال** لتعرض الصفحة **الحساب** و**الباقة** و**الطلبات المستعملة** من حصة باقتك الشهرية في Flash Manager. بعد **ربط الحساب** تظهر للحظة ثم يُعاد تحميل الصفحة دونها.
* مفتاح API **محفوظ مشفّرًا ولا يظهر أبدًا في المتصفح**. بعد الربط يظهر الحقل بصيغة مقنّعة مثل `fm_live_••••••••abcd` فقط، وكتابة مفتاح جديد تستبدل القديم.
* زر **فصل الاتصال** يزيل الربط متى شئت. وعند إعادة الربط يعود الإعدادان إلى قيمهما الافتراضية (**إرسال الطلبات الجديدة تلقائيًا** مفعّل، **تحديث حالة الطلب من FlashManager** مُعطّل)، فأعد تفعيل خيار النسخ واضغط **حفظ الإعدادات** إن كنت تستعمله.

warning

المفتاح الذي تنشئه يجب أن يملك صلاحية `orders:write`. المفتاح الذي لا يملكها يُرفض عند الربط برسالة واضحة — أنشئ مفتاحًا جديدًا في Flash Manager مع تفعيل هذه الصلاحية.

### العدّادات[​](#العدّادات "رابط مباشر إلى العدّادات")

أربع بطاقات تلخّص المزامنة — **طلبات مُرسلة**، و**قيد المتابعة**، و**مكتملة**، و**لم تُرسل بعد**.

### الإعدادات[​](#الإعدادات "رابط مباشر إلى الإعدادات")

* **إرسال الطلبات الجديدة تلقائيًا** — مفعّل افتراضيًا، وهو ما يجعل الطلبات الجديدة تنساب دون أي تدخل منك.
* **تحديث حالة الطلب من FlashManager** — مُعطّل افتراضيًا. فعّله فقط إذا كان Flash Manager مصدرك الأساسي لحالات الطلبات.

اضغط **حفظ الإعدادات** للتطبيق.

### إرسال الطلبات القديمة[​](#إرسال-الطلبات-القديمة "رابط مباشر إلى إرسال الطلبات القديمة")

إذا وُجدت طلبات لم تُرسل قط، كالطلبات التي أُنشئت قبل الربط مثلًا، يظهر زر **إرسال الطلبات غير المُرسلة**. يطلب الزر تأكيدًا أولًا، لأن هذه الطلبات تُحتسب من حصة باقتك الشهرية في Flash Manager. كل ضغطة تضيف حتى 200 من أحدث طلباتك غير المُرسلة إلى قائمة الانتظار أيًّا كانت حالتها (بما فيها الملغاة والموصَّلة) وتُرسلها تدريجيًا في الخلفية؛ وبعد إرسالها اضغط الزر مجددًا للطلبات الأقدم.

### جدول آخر الطلبات[​](#جدول-آخر-الطلبات "رابط مباشر إلى جدول آخر الطلبات")

تُعرض آخر الطلبات المُرسلة بأعمدة **الطلب** و**العميل** و**المجموع** و**حالة المتجر** و**رقم FlashManager** و**حالة FlashManager** و**أُرسل في**. الصفوف المؤكدة والموصّلة تظهر بالأخضر، والملغاة والفاشلة بالأحمر.

### إذا حدث خطأ[​](#إذا-حدث-خطأ "رابط مباشر إلى إذا حدث خطأ")

عندما ترفض Flash Manager طلبًا، يظهر شريط **آخر خطأ** أعلى الصفحة مع السبب: بلوغ الحد الشهري للطلبات في باقة Flash Manager، أو صلاحيات ناقصة. وإذا رفضت Flash Manager المفتاح نفسه، يفصل DZBuild الربط بدل ذلك وتعرض الصفحة **غير متصل**: الصق مفتاحًا صالحًا وانقر **ربط الحساب**. وبعد معالجة السبب تعود الطلبات الجديدة إلى الانسياب تلقائيًا؛ وبعد بلوغ حد الباقة قد يستغرق ذلك حتى ساعة. أما الطلبات التي فشلت في الأثناء فلا تُعاد محاولتها: تبقى ضمن **لم تُرسل بعد**، فاضغط **إرسال الطلبات غير المُرسلة** لإرسالها.

## أسئلة شائعة[​](#أسئلة-شائعة "رابط مباشر إلى أسئلة شائعة")

### هل تكامل Flash Manager مدفوع في DZBuild؟[​](#هل-تكامل-flash-manager-مدفوع-في-dzbuild "رابط مباشر إلى هل تكامل Flash Manager مدفوع في DZBuild؟")

لا. هو مجاني على جميع خطط DZBuild. أنت تدفع لـ Flash Manager مقابل باقتهم فقط، وباقاتهم تحمل حصة شهرية من الطلبات تحدّدها Flash Manager وتعرضها في صفحة أسعارها. هذه الحصة من جهتهم وحدها، وكل ما يراه DZBuild هو لحظة بلوغها: يتوقف الإرسال ويقول شريط **آخر خطأ** إن حدّ الباقة قد اكتمل. والطلبات التي تصل أثناء التوقف لا تُرسل لاحقًا من تلقاء نفسها: اضغط **إرسال الطلبات غير المُرسلة** بعد عودة حصتك.

### هل يمكن أن يُرسل الطلب مرتين؟[​](#هل-يمكن-أن-يُرسل-الطلب-مرتين "رابط مباشر إلى هل يمكن أن يُرسل الطلب مرتين؟")

نادرًا جدًا. يتذكّر DZBuild كل طلب قبلته Flash Manager ويتجاهله في المحاولات اللاحقة، فإعادة الإرسال أو إرسال الطلبات القديمة لا يُنتج أي تكرار. والتكرار ممكن فقط إذا بدأت محاولتا إرسال للطلب نفسه في اللحظة ذاتها قبل أن تُسجَّل أي منهما. وإن رأيت طلبًا مكررًا فاحذفه من داخل Flash Manager؛ جانب DZBuild يبقى صحيحًا.

### هل يجب أن أضغط شيئًا مع كل طلب جديد؟[​](#هل-يجب-أن-أضغط-شيئًا-مع-كل-طلب-جديد "رابط مباشر إلى هل يجب أن أضغط شيئًا مع كل طلب جديد؟")

لا. مع تفعيل **إرسال الطلبات الجديدة تلقائيًا** (وهو الوضع الافتراضي)، تغادر الطلبات إلى Flash Manager خلال ثوانٍ من إنشائها، من المتجر أو صفحة الهبوط أو الطلبات اليدوية أو عبر `API`. أما زر **إرسال الطلبات غير المُرسلة** فوجوده للطلبات القديمة فقط.

### أنا أرسل طلباتي إلى شركة توصيل من DZBuild. هل ستغيّر Flash Manager حالاتي؟[​](#أنا-أرسل-طلباتي-إلى-شركة-توصيل-من-dzbuild-هل-ستغيّر-flash-manager-حالاتي "رابط مباشر إلى أنا أرسل طلباتي إلى شركة توصيل من DZBuild. هل ستغيّر Flash Manager حالاتي؟")

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

### أين أجد بقية التكاملات؟[​](#أين-أجد-بقية-التكاملات "رابط مباشر إلى أين أجد بقية التكاملات؟")

كل الإضافات والمنصات الخارجية في الصفحة نفسها — راجع [كتالوج الإضافات](https://dzbuild.com/ar/ar/docs/addons/overview.md) وقسم **منصات خارجية** في [`/dashboard/addons`](https://dzbuild.com/dashboard/addons).