استيراد جهات الاتصال من Excel أو CSV (مع الموافقة)

أضف قائمة عملاء من ملف CSV أو Excel: طابق الأعمدة (بما فيها العناوين العربية)، واختر الدولة للأرقام المحلية وما يحدث لمن هو موجود مسبقًا، وأقرّ بالموافقة التسويقية التي أعطوها، وافحص الملف، ثم استورده ونزّل errors.csv. وأيضًا: إضافة جهة اتصال لشخص واحد.

تضيف جهات الاتصال ← استيراد (/app/contacts/import) قائمة عملاء كاملة من ملف. ويضيف زر إضافة جهة اتصال في صفحة جهات الاتصال شخصًا واحدًا يدويًا. لا يُحفظ شيء حتى تفحص الملف وتضغط زر الاستيراد.

قبل أن تبدأ

يحتاج الاستيراد مهمة استيراد جهات الاتصال (للمالك والمسؤول افتراضيًا، ويمكن للمالك أو المسؤول منحها لأي شخص عبر تعديل الصلاحيات في الإعدادات ← الأعضاء، راجع الأدوار والمهام). بدونها يختفي زر استيراد وتقول الصفحة يتطلب استيراد جهات الاتصال مهمة استيراد جهات الاتصال. اطلبها من المالك أو المسؤول.
تحتاج إضافة جهة اتصال مهمة إدارة جهات الاتصال (للمالك والمسؤول والمحرر افتراضيًا).
الملف: CSV (بترميز UTF-8 أو UTF-16 أو ترميز ويندوز العربي؛ بفواصل أو فواصل منقوطة أو علامات جدولة) أو Excel بصيغة ‎.xlsx (الورقة الأولى). حتى 20 ميغابايت و100,000 صف. ويُرفض ملف Excel القديم ‎.xls: في Excel اختر ملف > حفظ باسم > مصنف Excel ‏(‎.xlsx) أو CSV UTF-8.
يجب أن يسمّي الصف الأول الأعمدة، مثل الاسم، الجوال، البريد الإلكتروني أو Name, Phone, Email. ويحتاج كل شخص رقم جوال أو بريدًا إلكترونيًا.
لاستيراد بيانات مخصصة (فئة العضوية، تاريخ الميلاد...) أنشئ الحقول أولًا في حقول جهات الاتصال المخصصة.

خطوة بخطوة: استيراد ملف

1. في جهات الاتصال اضغط استيراد. 2. الملف: اضغط اختر ملفًا واختره ثم اضغط رفع. ترى جارٍ قراءة الملف… ثم الأعمدة. 3. الأعمدة: تحت طابق الأعمدة لكل عمود في ملفك مربع استيراد كـ. نخمّن من العناوين بالعربية والإنجليزية (الجوال ← الجوال (واتساب)، الاسم ← الاسم، والعنوان الذي يطابق حقلًا مخصصًا ← ذلك الحقل). اضبط الأعمدة التي لا تحتاجها على لا تستورد. ويعرض مثال قيمة من الملف. 4. تحت الخيارات: - الدولة للأرقام المحلية: تُقرأ الأرقام المكتوبة بلا رمز دولة (0501234567 أو 501234567 إذا حذف Excel الصفر) كأرقام لهذه الدولة. والأرقام العربية (٠٥٠...) مقبولة. وعمود الدولة في الملف هو المعتمد لصفه. وتبدأ بدولة شركتك. - الأشخاص الموجودون مسبقًا (نفس الجوال أو البريد): حدّثهم بقيم الملف (الخلايا الممتلئة تحل محل ما كان لدى جهة الاتصال، والخلايا الفارغة لا تمسح شيئًا، وتُضاف الوسوم، ولا يُضاف جوال أو بريد إلا إذا لم يكن لديها) أو تخطَّهم. - وسوم إضافية لكل من يُستورد (افصل بينها بفواصل). 5. اضغط متابعة. 6. الموافقة: اختر لا - لم يوافقوا، أو لا أعلم أو نعم - وافقوا، وأستطيع أن أوضح كيف. عند نعم حدد القنوات التي وافقوا عليها (واتساب ورسائل SMS والبريد الإلكتروني)، واختر أين وافقوا؟، واكتب كيف وافق هؤلاء الأشخاص؟ (10 أحرف على الأقل، مثل "اختاروا أرسلوا لي العروض عبر واتساب عند الانضمام إلى برنامج الولاء")، ومتى وافقوا (اختياري) إن أردت، وحدد أؤكد أن هؤلاء الأشخاص أعطوا هذه الموافقة وأستطيع تقديم الدليل عند الطلب. 7. اضغط افحص الملف. يقرأ الفحص كل الصفوف ولا يحفظ شيئًا (جارٍ فحص n من N صف…). 8. تعرض نتيجة الفحص جاهزة للاستيراد وفيها مشاكل وجهات اتصال جديدة وموجودة مسبقًا ومكررة في الملف، وأول الصفوف التي فيها مشاكل مع السبب. يعيدك تغيير الإعدادات إلى الخطوات السابقة، ويعطيك تنزيل errors.csv كل الصفوف التي فيها مشاكل. 9. اضغط استيراد n جهة اتصال. يعرض جارٍ استيراد n من N… التقدم. يمكنك مغادرة الصفحة: يستمر الاستيراد، وتعيد فتحه من جهات الاتصال ← استيراد ← آخر عمليات الاستيراد (فتح). 10. عندما ترى اكتمل الاستيراد. اضغط عرض جهات الاتصال المستوردة لرؤية القائمة، أو تنزيل 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 ميغابايت ← قسّمه.
اختر عمودًا للجوال أو للبريد الإلكتروني. ← اضبط عمودًا على الجوال (واتساب) أو البريد الإلكتروني.
عمودان مضبوطان على "…" ← اضبط أحدهما على لا تستورد.
الصفوف في errors.csv مع السبب: رقم جوال غير صالح (تحقق من رمز الدولة) (راجع الدولة للأرقام المحلية)، لا يوجد رقم جوال أو بريد إلكتروني، عنوان بريد إلكتروني غير صالح، دولة غير معروفة، لغة غير معروفة، منطقة زمنية غير معروفة، قيمة حقل مخصص لا تناسب نوع الحقل (اسم الحقل في التفاصيل: الاختيار يجب أن يكون من خياراته، والتاريخ YYYY-MM-DD أو يوم/شهر/سنة، والرقم أرقام فقط)، يجب أن يكون عمود الموافقة نعم أو لا، موجود مسبقًا في جهات الاتصال - تم تخطيه، تعذر الحفظ (جرّب استيراد ذلك الصف مرة أخرى). ويحتوي errors.csv على أعمدة ملفك نفسها، فتصحح الصفوف وتستوردها كملف جديد.
يوقف إلغاء الاستيراد العملية قبل الـ 1,000 صف التالية؛ وتبقى جهات الاتصال التي استُوردت.
تُحذف الصفوف والنسخة المحفوظة من الملف بعد 30 يومًا من الرفع، وعندها لا يعود errors.csv متاحًا (حُذفت صفوف هذا الملف بعد 30 يومًا من رفعه.). وتبقى أرقام الاستيراد وإقرار الموافقة.

إضافة جهة اتصال واحدة

في جهات الاتصال اضغط إضافة جهة اتصال.
املأ الاسم وواحدًا على الأقل من الجوال (واتساب) (مع رمز الدولة، أو رقمًا محليًا لـ الدولة التي تختارها)، أو البريد الإلكتروني، أو اسم الحساب على منصة أخرى مع المنصة.
اختياري: الوسوم (افصل بينها بفواصل) وملاحظات، وتحت الموافقة التسويقية (اختياري) القنوات التي وافق عليها الشخص مع كيف وافق؟
اضغط إضافة جهة الاتصال. ترى تمت إضافة {name}. وتُفتح جهة الاتصال.
هذا الشخص موجود مسبقًا في جهات الاتصال. ← الرقم أو البريد يخص شخصًا موجودًا؛ اضغط فتح جهة الاتصال.

جهة الاتصال المضافة باسم حساب فقط تحصل على بطاقة خاصة بها؛ وحين يراسلك الشخص من تلك المنصة ادمج البطاقتين عبر دمج مع… (جهات الاتصال).

للمطورين (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. ويعيد GET للاستيراد المكتمل audience (id وname وmemberCount) — القائمة أعلاه.

في هذا القسم: التفاعل

كل المقالات