Your AI Connector Docs

استيراد جهات الاتصال من ملف

إذا كانت لديك قائمة جهات اتصال في جدول بيانات، يمكنك تحميلها جميعاً دفعة واحدة بدلاً من إضافتها واحدة تلو الأخرى. يستخدم التطبيق معالجاً مكوناً من 3 خطوات — تحميل ← تعيين الأعمدة ← مراجعة — يعمل مع ملف CSV الذي تمتلكه بالفعل، دون الحاجة إلى تنزيل قالب أولاً.


كيفية استيراد جهات الاتصال

  1. انقر على جهات الاتصال (Contacts) في الشريط الجانبي الأيسر، ثم انقر على استيراد (Import) في أعلى الصفحة.
  2. التحميل. اسحب ملف CSV الخاص بك وأفلته في منطقة الإسقاط، أو انقر عليها للاستعراض. لا يوجد قالب لتنزيله أولاً — استخدم الملف الذي لديك بالفعل.
  1. تعيين الأعمدة. يقرأ المعالج صف الرأس في ملفك ويحاول مطابقة كل عمود تلقائياً بحقل مستهدف: الاسم الأول، اسم العائلة، الهاتف، البريد الإلكتروني، الوسوم، الملاحظات، أو عدم الاستيراد. تحقق من تخمين كل عمود وقم بتصحيح أي خطأ باستخدام أداة الاختيار المجاورة له. يعرض جدول المعاينة الصفوف القليلة الأولى تماماً كما سيتم استيرادها.
    • عمود رقم الهاتف مطلوب — لا يمكنك المتابعة دون تعيينه.
    • العمود الذي يتم تعيينه إلى الوسوم يصبح وسوماً حقيقية على كل جهة اتصال. لا بأس بوجود عدة وسوم في خلية واحدة — افصل بينها بفاصلة أو فاصلة منقوطة (vip; newsletter; hotmart). يتم إنشاء الوسوم غير الموجودة مسبقاً لك؛ أما الوسوم الموجودة بالفعل فيتم إعادة استخدامها، مع تجاهل حالة الأحرف.
  1. المراجعة. اختر:
    • القناة الافتراضية — WhatsApp Business، أو WhatsApp Web، أو SMS. ينطبق هذا على أي جهة اتصال مستوردة لا تحدد قناة بالفعل.
    • القائمة — اختر قائمة موجودة من القائمة المنسدلة، أو اكتب اسماً لإنشاء قائمة جديدة في الحال. يمكنك القيام بأحد الخيارين فقط، وليس كلاهما.
    • تحديث جهات الاتصال الموجودة — متوقف افتراضياً. عند إيقافه، يتم تخطي الصفوف التي تطابق جهة اتصال لديك بالفعل (نفس رقم الهاتف) باعتبارها مكررة: لا يتغير شيء في جهة الاتصال هذه ولا تتم إضافتها إلى القائمة. عند تشغيله، تقوم تلك الصفوف بتحديث جهة الاتصال بدلاً من ذلك: يتم استبدال الاسم والبريد الإلكتروني والملاحظات الموجودة في ملفك بما هو موجود (الخلايا الفارغة تترك القيمة الحالية كما هي)، وتتم إضافة أي وسوم في الصف، وتتم إضافة جهة الاتصال إلى القائمة التي اخترتها. هذه هي الطريقة التي تعيد بها استيراد ملف لإصلاح أو إثراء جهات الاتصال التي لديك بالفعل.
  1. انقر على استيراد [count]. ستصل إلى شاشة النتائج التي توضح عدد جهات الاتصال التي تم إنشاؤها، وعدد جهات الاتصال الموجودة التي تم تحديثها (عند تشغيل هذا الخيار)، وإذا تم تخطي أي صفوف، فستظهر تفاصيل السبب (رقم هاتف غير صالح، رقم هاتف مفقود، تكرار، الوصول إلى حد جهات الاتصال، إلخ).

تفاصيل تعيين الأعمدة

  • الهاتف هو العمود الوحيد المطلوب. يتم إسقاط الصفوف التي لا تحتوي على رقم هاتف على الإطلاق قبل الاستيراد ويتم احتسابها بشكل منفصل في شاشة النتائج.
  • الاسم الأول / اسم العائلة / البريد الإلكتروني يتم تعيينها مباشرة على الحقول الأساسية لجهة الاتصال.
  • الملاحظات يتم تعيينها على حقل الملاحظات / ملف تعريف العميل المحتمل الخاص بجهة الاتصال.
  • الوسوم تنشئ (أو تعيد استخدام) وسوماً حقيقية وتطبقها على جهة الاتصال — وهي نفس الوسوم التي تقوم بالتصفية بواسطتها، واستهداف البث بها، وإطلاق خطافات الويب (webhooks) منها. ضع عدة وسوم في خلية واحدة مفصولة بفواصل أو فواصل منقوطة. قبل 19 أغسطس 2026، كان يتم حفظ هذا العمود كحقل مخصص باسم tags بدلاً من ذلك؛ إذا قمت بالاستيراد قبل ذلك التاريخ، أعد استيراد نفس الملف مع تشغيل تحديث جهات الاتصال الموجودة وسيتم تطبيق الوسوم بشكل صحيح (الحقل المخصص tags المتبقي لا يسبب أي ضرر؛ اتصل بالدعم إذا كنت ترغب في مسحه من كل جهة اتصال).
  • لا يوجد حالياً تعيين أعمدة للحقول المخصصة العشوائية (مثل أعمدة custom_<fieldname> الكلاسيكية) — راجع التحميل المجمع للحقول المخصصة للحصول على الحل البديل الحالي.

نصائح

  • تأكد مرتين من أن أرقام الهواتف تتضمن رمز البلد. وبدونه، لن يتم تسليم الرسائل — ويتم تخطي الصفوف التي لا تحتوي على رقم هاتف صالح بالكامل.
  • لست بحاجة إلى إزالة المسافات أو الشرطات أو الأقواس من أرقام الهواتف — فالمستورد يتحمل التنسيق الشائع، ولكنه لا يزال يحتاج إلى رمز البلد.
  • يتم تحليل الملفات بالكامل في متصفحك، لذا لا يوجد حد ثابت لحجم التحميل من المعالج نفسه — ولكن إجمالي عدد جهات الاتصال الخاصة بك لا يزال مقيداً بخطتك. إذا كان الاستيراد سيؤدي إلى تجاوز حد خطتك، فسيتم رفض تلك الصفوف وستظهر في شاشة النتائج كـ contact_limit_reached.
  • إذا كانت جهة الاتصال التي تحمل نفس رقم الهاتف موجودة بالفعل، فسيتم تخطي هذا الصف افتراضياً — ويظهر كـ duplicate على شاشة النتائج. لا يقوم الاستيراد أبداً بإنشاء نسخة ثانية من أي شخص. لتعديل جهات الاتصال التي لديك بالفعل بشكل مجمع (إصلاح الأسماء أو رسائل البريد الإلكتروني، إضافة وسوم، وضعها في قائمة)، قم بتشغيل تحديث جهات الاتصال الموجودة في خطوة المراجعة وأعد استيراد الملف.

الأسئلة الشائعة

يحتوي ملف CSV الخاص بي على عمود custom_company من تصدير قديم — هل سيتم تعيينه بشكل صحيح؟ ليس تلقائياً. يتعرف المطابق التلقائي في المعالج فقط على رؤوس الاسم/الهاتف/البريد الإلكتروني/العلامات/الملاحظات؛ أي شيء آخر يتم تعيينه افتراضياً إلى عدم الاستيراد، لذا لن يتم ملء عمود custom_company في الحقل المخصص company من تلقاء نفسه. أضف القيم لاحقاً عبر الحقول المخصصة، أو من خلال واجهة برمجة التطبيقات (API).

أين ذهب زر “تنزيل القالب”؟ لقد اختفى — يعمل المعالج مباشرة مع أي ملف CSV تمتلكه بالفعل ويسمح لك بإصلاح أي أعمدة غير متطابقة في خطوة التعيين بدلاً من ذلك.

لقد قمت بالفعل باستيراد جهات الاتصال الخاصة بي — كيف يمكنني إضافة وسوم أو إصلاح الحقول لها جميعاً في وقت واحد؟ أعد استيراد نفس الملف (أو ملف محدث) مع تشغيل تحديث جهات الاتصال الموجودة في خطوة المراجعة. الصفوف التي تطابق رقم هاتف موجود تقوم بتحديث جهة الاتصال تلك — الاسم، البريد الإلكتروني، الملاحظات، الوسوم، والقائمة — بدلاً من تخطيها. تُستخدم أرقام الهواتف فقط للمطابقة، لذا احتفظ بهذا العمود تماماً كما كان.

هل يمكنني استيراد جهات اتصال Instagram أو Messenger من ملف؟ لا. يدعم الاستيراد فقط WhatsApp Business وWhatsApp Web وSMS، لأن هذه القنوات تصل إلى الأشخاص عبر رقم الهاتف. في المقابل، تُعرّف Instagram وMessenger الأشخاص من خلال حساباتهم الاجتماعية، لذا يتم إنشاء جهات الاتصال هذه تلقائيًا عندما يرسل إليك شخص ما رسالة على تلك القناة.

هل يمكنني استيراد جهات الاتصال كـ “غير نشطة في البوت”؟ لا يوجد عمود لكل صف لذلك. قم باستيراد الدفعة أولاً، ثم استخدم إجراء إيقاف البوت المجمع على جهات الاتصال المستوردة — راجع استبعاد جهات الاتصال من بوت الذكاء الاصطناعي.


الخطوات التالية