Getting Started

طريقة استيراد العملاء من ملف CSV

انقل عملاءك واشتراكاتهم من جدول بيانات إلى متجرك. تعرّف على طريقة التحقق من معرّفات الخطوط على اللوحة، وكيف تربط الخطوط التي لم يكتمل ربطها.

4 min read
Published 25 أكتوبر 2026
Last checked 25 أكتوبر 2026
import
csv
migration
customers
panel

يضيف استيراد CSV عملاءك الحاليين واشتراكاتهم إلى متجرك من جدول بيانات. وهو لا ينشئ أي خط (حساب العميل على اللوحة) على لوحتك، ولا يغيّره ولا يمدّده أبدًا. إنه يسجّل فقط العملاء الموجودين لديك من قبل.

يظهر تبويب CSV Import عندما تكون إضافة CSV Import ضمن متجرك.

1Step 1 of 7جهّز ملفك

افتح Customers → Import customers ثم تبويب CSV Import. تحت CSV Template & Column Reference، اضغط Download Template (.csv) لتنزيل القالب، واملأ صفًا واحدًا لكل اشتراك.

  • العمودان name و status (وقيمته ACTIVE أو EXPIRED أو SUSPENDED) مطلوبان في كل صف. أما email فاختياري: العميل الذي ليس له بريد يضاف كعميل يدوي.
  • الاشتراك النشط يحتاج أيضًا إلى product_name و expiry_date (بصيغة YYYY-MM-DD).
  • العمود username (اسم دخول الخط على لوحتك) هو ما يمكّننا من العثور على الخط على لوحتك. املأه كلما توفر لديك.
  • العمود panel_user_id اختياري، وهو معرّف الخط (ID) على لوحتك. اتركه فارغًا إذا كانت الأرقام آتية من نظامك القديم (1، 2، 3 …) وليست معرّفات الخطوط التي تعرضها لوحتك.

الصف غير النشط، أو الذي لا منتج فيه، أو الذي انتهت مدته، نستورد منه ملف العميل فقط: بلا اشتراك وبلا فاتورة.

2Step 2 of 7ارفع الملف

اسحب الملف إلى مربع الرفع أو اضغط Choose File. تعرض المعاينة عدد الصفوف المقروءة والأخطاء التي يجب إصلاحها إن وجدت.

العملاء الذين لهم بريد إلكتروني يدخلون قائمة عملائك فور قراءة الملف. ولا يضافون مرة ثانية عند تنفيذ الاستيراد.

3Step 3 of 7اقرأ التنبيهات

اقرأ قسم Before you import الموجود فوق الأخطاء. يخبرك مثلًا بعدد الصفوف التي فيها معرّف خط دون اسم مستخدم، وبعدد الصفوف التي ستدخل كملف عميل فقط. وإذا كانت معرّفات الخطوط في ملفك متسلسلة 1، 2، 3 … شبه متصلة بلا فجوات، تنبّهك المعاينة إلى أنها تبدو أرقام صفوف من نظامك القديم. إن كان الأمر كذلك، صحّح العمود، أو أفرغه واملأ أسماء المستخدمين بدلًا منه، ثم ارفع الملف من جديد.

4Step 4 of 7اربط منتجاتك واختر اللوحة

اضغط Continue to Mapping. اختر المتجر، ثم تحت Panel Integration (Optional) اختر اللوحة التي عليها خطوطك، أو No panel. وتحت Map Products، اختر لكل اسم منتج في الملف واحدًا من منتجاتك، أو اختر Skip لاستبعاد صفوفه.

اترك خيار Import as manual subscriptions مفعلًا إذا كنت تحصّل الدفعات بنفسك. عندها يكون التجديد التلقائي متوقفًا في الاشتراكات المستوردة.

5Step 5 of 7نفّذ الاستيراد

اضغط Review & Import، وراجع الملخص، ثم اضغط Start Import.

6Step 6 of 7راجع النتائج

إذا كان في الصف معرّف خط واخترت لوحة، نتحقق من الخط على تلك اللوحة قبل ربطه. ولا نربطه إلا إذا أظهرت لوحتك خطًا واحدًا فقط باسم المستخدم المذكور في الصف، ولم يكن أي اشتراك آخر مربوطًا بهذا الخط. عندها نستخدم معرّف الخط كما هو في اللوحة نفسها، حتى لو كان في ملفك رقم آخر. ويعرض قسم Panel line check ما حدث لهذه الصفوف:

  • linked (مربوط): التجديدات ستمدّد هذا الخط.
  • not found on panel (غير موجود على اللوحة): لا يوجد على لوحتك خط بهذا الاسم.
  • ambiguous (غير محسوم): أكثر من خط يحمل اسم المستخدم نفسه، أو صفّان في ملفك يشيران إلى الخط نفسه.
  • no username – not linked (بلا اسم مستخدم، غير مربوط): في الصف معرّف خط دون اسم مستخدم، فتعذر التحقق منه.
  • not checked (لم يفحص): لم نتمكن من سؤال اللوحة في الوقت المتاح، أو أن اللوحة لا تتيح البحث عن الخطوط.

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

تختلف طريقة التحقق حسب اللوحة. اللوحة التي لها API يعرض قائمة خطوطك (XUI مع مفتاح API) نفحص فيها كل الصفوف بقراءة واحدة. أما لوحات NXT و V12 / MaxOTT فنسألها عن كل خط على حدة، ما دام وقت الاستيراد يسمح. واللوحة التي ندخل إليها عبر المتصفح نفحص فيها 20 خطًا على الأكثر في كل استيراد. وأنواع اللوحات الأخرى لا نفحصها.

7Step 7 of 7اربط الخطوط التي لم تربط

كل اشتراك لم يربط يظهر في Subscriptions → Needs manual set-up. لربط أحدها، ابحث عن العميل في Customers → All customers واضغط على الاشتراك. افتح تبويب Panel Sync، وأدخل في Panel line ID معرّف الخط كما تعرضه لوحتك في قائمة الخطوط، ثم اضغط Save. بعدها تمدّد التجديدات هذا الخط.

نصيحة: لا يعيد النظام أبدًا محاولة هذه الاشتراكات كطلبات جديدة على لوحتك. لذلك لا ينشأ خط ثانٍ ولا يستهلك أي رصيد (credits) أثناء ربطها.

Ready to try it yourself?

Spin up your own IPTVbp store and connect a panel. It's مجاني حتى يبلغ عدد عملائك الدافعين 25, no card needed.

Start free trial