استيراد جهات الاتصال من Excel أو CSV (مع الموافقة)
أضف قائمة عملاء من ملف CSV أو Excel: طابق الأعمدة (بعناوين بأي لغة من لغات التطبيق)، واختر الدولة للأرقام المحلية وما يحدث لمن هو موجود مسبقًا، وأقرّ بالموافقة التسويقية التي أعطوها، وافحص الملف، ثم استورده ونزّل errors.csv. وأيضًا: إضافة جهة اتصال لشخص واحد.
تضيف جهات الاتصال ← استيراد (/app/contacts/import) قائمة عملاء كاملة من ملف. ويضيف زر إضافة جهة اتصال في صفحة جهات الاتصال شخصًا واحدًا يدويًا. لا يُحفظ شيء حتى تفحص الملف وتضغط زر الاستيراد.
قبل أن تبدأ
- يحتاج الاستيراد مهمة استيراد جهات الاتصال (للمالك والمسؤول افتراضيًا، ويمكن للمالك أو المسؤول منحها لأي شخص عبر تعديل الصلاحيات في الإعدادات ← الأعضاء، راجع الأدوار والمهام). بدونها يختفي زر استيراد وتقول الصفحة يتطلب استيراد جهات الاتصال مهمة استيراد جهات الاتصال. اطلبها من المالك أو المسؤول.
- تحتاج إضافة جهة اتصال مهمة إدارة جهات الاتصال (للمالك والمسؤول والمحرر افتراضيًا).
- الملف: CSV (بترميز UTF-8 أو UTF-16 أو ترميز ويندوز العربي؛ بفواصل أو فواصل منقوطة أو علامات جدولة) أو Excel بصيغة .xlsx (الورقة الأولى). حتى 20 ميغابايت و100,000 صف و200 عمود. ويُرفض ملف Excel القديم .xls: في Excel اختر ملف > حفظ باسم > مصنف Excel (.xlsx) أو CSV UTF-8.
- يجب أن يسمّي الصف الأول الأعمدة، مثل
الاسم، الجوال، البريد الإلكترونيأوName, Phone, Email. ويحتاج كل شخص رقم جوال أو بريدًا إلكترونيًا. - لاستيراد بيانات مخصصة (فئة العضوية، تاريخ الميلاد...) أنشئ الحقول أولًا في حقول جهات الاتصال المخصصة.
خطوة بخطوة: استيراد ملف
- في جهات الاتصال اضغط استيراد.
- الملف: اضغط اختر ملفًا واختره ثم اضغط رفع. ترى جارٍ قراءة الملف… ثم الأعمدة.
- الأعمدة: تحت طابق الأعمدة لكل عمود في ملفك مربع استيراد كـ. نخمّن من العناوين بلغات التطبيق العشر، بعلامات التشكيل أو بدونها (
الجوالأوTéléphoneأوHandyأوCep telefonu← الجوال (واتساب)، والاسمأوNom completأوNama← الاسم، والعنوان الذي يطابق حقلًا مخصصًا ← ذلك الحقل). وبجانب عمود للاسم الأول يُعدNomأوNameوحده اسم العائلة، وبجانب عمود لاسم العائلة يُعدNomeأوNombreالاسم الأول. اضبط الأعمدة التي لا تحتاجها على لا تستورد. ويعرض مثال قيمة من الملف. وإن بدا أن عمودًا مضبوطًا على لا تستورد فيه أرقام هواتف أو عناوين بريد (ولم يُضبط عمود آخر عليها) يقول ذلك سطر أصفر تحته، مثل يبدو أن هذا العمود فيه أرقام هواتف، لكنه مضبوط على «لا تستورد»، فلن تُستورد. اختر «الجوال (واتساب)» لاستيرادها. - تحت الخيارات:
- الدولة للأرقام المحلية: تُقرأ الأرقام المكتوبة بلا رمز دولة (
07400 123456أو7400 123456إذا حذف Excel الصفر) كأرقام لهذه الدولة. والأرقام العربية (٠٥٠...) مقبولة. وعمود الدولة في الملف هو المعتمد لصفه. وتبدأ بدولة شركتك (وإن لم تُحدَّد تظهر اختر الدولة، ولا تُقرأ إلا الأرقام المكتوبة مع رمز دولتها)؛ وفي القائمة كل الدول بأسمائها بلغتك وبالترتيب الأبجدي تحت كل الدول (وتأتي أولًا تحت مقترحة الدولة التي يذكر متصفحك أنك فيها، إن ذكرها). - الأشخاص الموجودون مسبقًا (نفس الجوال أو البريد): حدّثهم بقيم الملف (الخلايا الممتلئة تحل محل ما كان لدى جهة الاتصال، والخلايا الفارغة لا تمسح شيئًا، وتُضاف الوسوم، ولا يُضاف جوال أو بريد إلا إذا لم يكن لديها) أو تخطَّهم.
- وسوم إضافية لكل من يُستورد (افصل بينها بفواصل): حتى 10 وسوم، كل منها حتى 50 حرفًا (وتُتجاهل # في البداية). والأكثر يُظهر تحت المربع أضف 10 وسوم إضافية على الأكثر. احذف بعضها، أو أضفها لاحقًا من «إضافة وسوم».، والوسم الأطول يمكن أن يكون الوسم 50 حرفًا على الأكثر. اختصره أو قسّمه بفاصلة.؛ وينتظر متابعة حتى يصح المربع.
- اضغط متابعة.
- الموافقة: اختر لا - لم يوافقوا، أو لا أعلم أو نعم - وافقوا، وأستطيع أن أوضح كيف. عند نعم حدد القنوات التي وافقوا عليها (واتساب ورسائل SMS والبريد الإلكتروني)، واختر أين وافقوا؟، واكتب كيف وافق هؤلاء الأشخاص؟ (10 أحرف على الأقل، مثل "اختاروا أرسلوا لي العروض عبر واتساب عند الانضمام إلى برنامج الولاء")، ومتى وافقوا (اختياري) إن أردت، وحدد أؤكد أن هؤلاء الأشخاص أعطوا هذه الموافقة وأستطيع تقديم الدليل عند الطلب.
- اضغط افحص الملف. يقرأ الفحص كل الصفوف ولا يحفظ شيئًا (جارٍ فحص n من N صف…).
- تعرض نتيجة الفحص جاهزة للاستيراد وفيها مشاكل وجهات اتصال جديدة وموجودة مسبقًا ومكررة في الملف، وأول الصفوف التي فيها مشاكل مع السبب. يعيدك تغيير الإعدادات إلى الخطوات السابقة، ويعطيك تنزيل errors.csv كل الصفوف التي فيها مشاكل. ولجهة الاتصال 20 وسمًا على الأكثر: فإن كان بعض الأشخاص سيتجاوزونها يقول الفحص مثلًا ستتجاوز 3 جهات اتصال حدّ 20 وسمًا. تحتفظ بوسومها وتحصل على وسم هذا الاستيراد، وتُضاف الوسوم الجديدة الأخرى ما دام هناك متسع. والملف المصنوع بـ تصدير CSV يُستورد كما هو: تُزال الفاصلة العليا قبل رقم مثل '+447400123456.
- اضغط استيراد n جهة اتصال. يعرض جارٍ استيراد n من N… التقدم. يمكنك مغادرة الصفحة: يستمر الاستيراد، وتعيد فتحه من جهات الاتصال ← استيراد ← آخر عمليات الاستيراد (فتح). والملف الذي رفعته وتركته قبل الاستيراد (عند الأعمدة أو الموافقة أو بعد افحص الملف) يظهر في آخر عمليات الاستيراد بحالة لم يكتمل، ومعه متابعة (للعودة إلى حيث توقفت) وتجاهل. يسأل تجاهل: "هل تريد تجاهل الملف المرفوع "(الملف)"؟ لم يُستورد منه شيء. ستُحذف صفوفه والملف المحفوظ." ثم يزيله من القائمة. ويُتجاهَل تلقائيًا كل ملف مرفوع يبقى غير مكتمل 7 أيام، ولا يتغير شيء في جهات الاتصال في الحالتين.
- عندما ترى اكتمل الاستيراد. اضغط عرض جهات الاتصال المستوردة لرؤية القائمة، أو تنزيل errors.csv (يظهر مع سطر الصفوف التي لم تُستورد مع السبب، بأعمدة ملفك نفسها. فقط عندما توجد صفوف لم تُستورد). وتحت الأرقام تذكر عبارة كل من أنشأه هذا الاستيراد أو حدّثه موجود في القائمة "Import – customers.csv – 2026-09-24" (n شخص). القائمة التي أنشأها الاستيراد، ويفتحها فتح القائمة في جهات الاتصال ← الجماهير (راجع القسم التالي).
قائمة الاستيراد
عند اكتمال الاستيراد يوضع كل من أنشأه أو حدّثه في قائمة جديدة (جمهور ثابت) باسم Import – <اسم الملف> – <التاريخ>، مثل Import – customers.csv – 2026-09-24. استخدمها كأي قائمة: اخترها جمهورًا لـ بث واتساب، أو افتحها في جهات الاتصال ← الجماهير، أو أضف إليها أشخاصًا وأزلهم (الجماهير).
- لا يدخلها من تُخطّي (الموجودون مسبقًا مع تخطَّهم)، ولا الصفوف التي فيها مشاكل، ولا الصفوف التي تعذّر حفظها.
- التاريخ هو يوم اكتمال الاستيراد. إن استوردت الملف نفسه مرة أخرى في اليوم نفسه ينضم أشخاصه إلى القائمة نفسها؛ وفي يوم آخر تحصل على قائمة جديدة.
- الاستيراد الملغى لا تُنشأ له قائمة. ويبقى وسم الاستيراد على من استُورد قبل الإلغاء، فتجدهم به.
- تحتفظ مساحة العمل بـ 500 جمهور على الأكثر. إن كان لديها 500 بالفعل يكتمل الاستيراد بلا قائمة ويقول لم تُنشأ قائمة لهذا الاستيراد: مساحة العمل تحتفظ بالفعل بـ 500 جمهور. أرشف القوائم التي لم تعد تحتاجها في جهات الاتصال ← الجماهير؛ ويبقى الوسم على كل من جاء من الملف.
كيف يُطابَق الأشخاص (بلا تكرار)
- يكون الصف هو الشخص نفسه إذا كان رقم جواله (بعد كتابته برمز الدولة ثم الرقم) أو بريده موجودًا في مساحة العمل هذه على أي قناة. وتُحدَّث جهة الاتصال المدموجة كشخص واحد.
- الصفان اللذان لهما الرقم أو البريد نفسه في ملف واحد يصبحان جهة اتصال واحدة: الأول ينشئها والتالي يحدّثها (أو يُتخطى إذا اخترت تخطَّهم).
- تُنشأ جهة الاتصال الجديدة ذات رقم الجوال كجهة اتصال واتساب لذلك الشخص، فحين يراسلك تصل رسائله إلى البطاقة نفسها. ويكون المصدر استيراد.
- تحصل كل جهة اتصال مستوردة على وسم الاستيراد الخاص،
import:متبوعًا بالتاريخ واسم الملف (مثلimport:2026-09-24-customers-3f9a)، فتجدهم لاحقًا في صفحة جهات الاتصال (بالتصفية حسب الوسم)، إلى جانب قائمة الاستيراد أعلاه.
الموافقة: ما الذي يُسجَّل
- عند نعم يحصل كل شخص على سجل موافقة لكل قناة محددة، بالمصدر استيراد ودليل هو إقرارك والمكان والتاريخ واسم الملف، ومن بدأ الاستيراد. ويظهر تحت سجل الموافقات في جهة الاتصال (الموافقة وإلغاء الاشتراك).
- فقط القنوات التي للصف عنوان عليها: واتساب وSMS يحتاجان رقم جوال، والبريد يحتاج بريدًا إلكترونيًا.
- عمود الموافقة التسويقية (نعم / لا) في الملف: لا تُسجّل الموافقة إلا للصفوف التي تقول نعم (yes أو y أو 1 أو نعم أو موافق)، والصفوف التي تقول لا أو الفارغة لا تحصل على شيء. ويحتاج هذا العمود الإقرار (نعم) أو ضبطه على لا تستورد.
- من سحب موافقته أو أرسل STOP يبقى على اختياره (يُعد ضمن بقيت على رفضها السابق). لا يغيّره الاستيراد أبدًا؛ لا يغيّره إلا الشخص نفسه، أو زميل يسجل موافقته الجديدة عبر تسجيل موافقة.
- عند لا لا يحصل أحد على موافقة تسويقية. ويمكن مع ذلك الرد عليهم خلال نافذة الـ 24 ساعة وإرسال رسائل المعاملات.
إذا حدث خطأ
- هذا ملف Excel قديم (.xls)... ← احفظه بصيغة .xlsx أو CSV UTF-8 وارفعه مجددًا.
- يجب أن يسمّي الصف الأول الأعمدة ← أضف صفًا للعناوين. ويحتوي الملف على أسماء الأعمدة، لكن لا توجد تحته صفوف لأشخاص. ← في الملف صف العناوين ولا شيء تحته (أو صفوف فارغة فقط)؛ أضف صفًا لكل شخص تحت أسماء الأعمدة وارفعه مجددًا. أما الملف فارغ. فيعني أنه لم يوجد في الملف شيء على الإطلاق.
- يحتوي الملف على أكثر من 100,000 صف أو حجم الملف أكبر من 20 ميغابايت ← قسّمه. وتظهر الرسالة الثانية أيضًا لملف صغير يحتوي على ملايين الخلايا المملوءة عند فتحه.
- يحتوي الملف على أكثر من 200 عمود. ← احذف الأعمدة التي لا تحتاجها. القيمة المكتوبة في عمود بعيد تُحتسب حتى لو كان العمود فارغًا فيما عداها، أما الخلايا الفارغة فلا تُحتسب.
- اختر عمودًا للجوال أو للبريد الإلكتروني. ← اضبط عمودًا على الجوال (واتساب) أو البريد الإلكتروني.
- عمودان مضبوطان على "…" ← اضبط أحدهما على لا تستورد.
- الصفوف في errors.csv مع السبب: رقم جوال غير صالح (تحقق من رمز الدولة) (راجع الدولة للأرقام المحلية)، لا يوجد رقم جوال أو بريد إلكتروني، عنوان بريد إلكتروني غير صالح، دولة غير معروفة، لغة غير معروفة، منطقة زمنية غير معروفة، قيمة حقل مخصص لا تناسب نوع الحقل (اسم الحقل في التفاصيل: الاختيار يجب أن يكون من خياراته، والتاريخ YYYY-MM-DD أو يوم/شهر/سنة، والرقم أرقام فقط)، يجب أن يكون عمود الموافقة نعم أو لا، موجود مسبقًا في جهات الاتصال - تم تخطيه، تعذر الحفظ (جرّب استيراد ذلك الصف مرة أخرى). ويحتوي errors.csv على أعمدة ملفك نفسها، فتصحح الصفوف وتستوردها كملف جديد. ويأتي بلغة التطبيق التي تستخدمها: أعمدته الأربعة الأولى (الصف، الحالة، السبب، التفاصيل) وحالة كل صف والسبب بتلك اللغة.
- يوقف إلغاء الاستيراد العملية قبل الـ 1,000 صف التالية؛ وتبقى جهات الاتصال التي استُوردت.
- تُحذف الصفوف والنسخة المحفوظة من الملف بعد 30 يومًا من الرفع، وعندها لا يعود errors.csv متاحًا (حُذفت صفوف هذا الملف بعد 30 يومًا من رفعه.). وتبقى أرقام الاستيراد وإقرار الموافقة.
إضافة جهة اتصال واحدة
- في جهات الاتصال اضغط إضافة جهة اتصال.
- املأ الاسم (حتى 120 حرفًا) وواحدًا على الأقل من الجوال (واتساب) (مع رمز الدولة، أو رقمًا محليًا لـ الدولة التي تختارها)، أو البريد الإلكتروني، أو اسم الحساب على منصة أخرى مع المنصة. وتبدأ الدولة بدولة شركتك (الإعدادات ← الشركة) وفيها كل الدول بأسمائها بلغتك؛ وإن لم تُضبط دولة للشركة تقول اختر الدولة. والأرقام التي تكتبها بلوحة مفاتيح عربية (٠٥٥…) تتحول إلى 0-9 في الجوال (واتساب) أثناء الكتابة، فيُقرأ الرقم من اليسار إلى اليمين بترتيبه المعتاد.
- اختياري: الوسوم (افصل بينها بفواصل) وملاحظات، وتحت الموافقة التسويقية (اختياري) القنوات التي وافق عليها الشخص مع كيف وافق؟
- اضغط إضافة جهة الاتصال. ترى تمت إضافة [name]. وتُفتح جهة الاتصال.
- هذا الشخص موجود مسبقًا في جهات الاتصال. ← الرقم أو البريد يخص شخصًا موجودًا؛ اضغط فتح جهة الاتصال. وعندما تكون المشكلة في حقل واحد يظهر السبب بالأحمر تحت ذلك الحقل، ويصبح الحقل أحمر وينتقل المؤشر إليه. مثلًا هذا ليس رقم جوال صحيحًا للدولة المختارة. أدخل رقمًا محليًا لتلك الدولة، أو الرقم كاملًا يبدأ بـ + ورمز الدولة. تحت الجوال (واتساب) (وإن لم تُختر الدولة: هذا ليس رقم جوال صحيحًا. تحقّق من الأرقام بعد + ورمز الدولة، أو اختر الدولة في الأسفل وأدخل رقمًا محليًا.)، أو اختر منصة اسم الحساب. تحت المنصة (كلما كُتب اسم حساب، حتى مع رقم جوال أو بريد)، أو تحتاج موافقة واتساب أو الرسائل النصية إلى رقم جوال. أدخل الرقم، أو ألغِ تحديد واتساب وSMS. تحت الجوال (واتساب)، أو تحتاج موافقة البريد الإلكتروني إلى عنوان بريد. أدخل العنوان، أو ألغِ تحديد البريد الإلكتروني. أو أدخل بريدًا إلكترونيًا مثل name@example.com. تحت البريد الإلكتروني، أو اكتب كيف وافق الشخص (3 أحرف على الأقل). تحت كيف وافق؟ وكل سبب يظهر بلغتك. صحّحه واضغط إضافة جهة الاتصال مجددًا. أما الرسالة التي تخص النموذج كله (أدخل رقم جوال أو بريدًا إلكترونيًا أو اسم حساب.) فتظهر في الأسفل.
جهة الاتصال المضافة باسم حساب فقط تحصل على بطاقة خاصة بها؛ وحين يراسلك الشخص من تلك المنصة ادمج البطاقتين عبر دمج مع… (جهات الاتصال).
للمطورين (API)
يضيف POST /workspaces/{workspaceId}/contacts جهة اتصال واحدة (name وphone وemail وhandle مع platform وcountry وtags وnotes وattributes وconsent: {channels, evidence})؛ ويعيد الرمز 409 معرّف جهة الاتصال الموجودة contactId. والاستيراد: POST .../contacts/imports (ملف متعدد الأجزاء file)، وGET .../contacts/imports/{id}، وPATCH مع {mapping, options}، وPOST .../validate، وPOST .../run، وPOST .../cancel، وGET .../errors.csv?lang=ar (lang: en أو ar أو fr أو es أو pt أو de أو tr أو id أو hi أو ur). ويعيد GET للاستيراد المكتمل audience (id وname وmemberCount) — القائمة أعلاه.