Excel یا CSV سے رابطے امپورٹ کرنا (رضامندی کے ساتھ)

رابطے → امپورٹ کریں (/app/contacts/import) فائل سے صارفین کی پوری فہرست لاتا ہے۔ رابطوں کے صفحے پر رابطہ شامل کریں ایک شخص کو ہاتھ سے شامل کرتا ہے۔ جب تک آپ فائل چیک کر کے امپورٹ کا بٹن نہ دبائیں، کچھ محفوظ نہیں ہوتا۔

شروع کرنے سے پہلے

• امپورٹ کے لیے رابطے امپورٹ کریں کا اختیار درکار ہے (پہلے سے مالک اور ایڈمن کے پاس؛ مالک یا ایڈمن اسے سیٹنگز → ارکان پر رسائی میں تبدیلی سے کسی کو بھی دے سکتا ہے، دیکھیں کردار اور اختیارات)۔ اس کے بغیر امپورٹ کریں بٹن چھپا رہتا ہے اور صفحہ کہتا ہے رابطے امپورٹ کرنے کے لیے "رابطے امپورٹ کریں" کا اختیار درکار ہے۔ کسی مالک یا ایڈمن سے کہیں۔
• رابطہ شامل کریں کے لیے رابطوں کا انتظام کا اختیار درکار ہے (پہلے سے مالک، ایڈمن اور ایڈیٹر کے پاس)۔
• فائل: CSV (UTF-8، UTF-16 یا Windows عربی؛ کوما، سیمی کولن یا ٹیب) یا Excel .xlsx (پہلی شیٹ)۔ زیادہ سے زیادہ 20 MB اور 100,000 قطاریں۔ پرانی Excel .xls فائل قبول نہیں ہوتی: Excel میں File > Save As > Excel Workbook (.xlsx) یا CSV UTF-8 منتخب کریں۔
• پہلی قطار میں کالمز کے نام ہونے چاہئیں، مثلاً Name, Phone, Email یا الاسم، الجوال، البريد الإلكتروني۔ ہر شخص کا فون نمبر یا ای میل ہونا ضروری ہے۔
• حسب ضرورت تفصیلات (رکنیت کا درجہ، سالگرہ...) امپورٹ کرنے کے لیے پہلے حسب ضرورت رابطہ فیلڈز میں فیلڈز بنائیں۔

مرحلہ وار: فائل امپورٹ کریں

1. رابطے پر امپورٹ کریں دبائیں۔ 2. فائل: فائل منتخب کریں دبائیں، اسے چنیں، اپ لوڈ کریں دبائیں۔ آپ کو فائل پڑھی جا رہی ہے… دکھائی دیتا ہے، پھر کالمز۔ 3. کالمز: کالمز کو ملائیں کے نیچے آپ کی فائل کے ہر کالم کا ایک بطور امپورٹ کریں خانہ ہے۔ ہم انگریزی اور عربی ہیڈرز سے اندازہ لگاتے ہیں (الجوال → فون (WhatsApp)، الاسم → نام، کسی حسب ضرورت فیلڈ سے ملتا ہیڈر → وہ فیلڈ)۔ جن کالمز کی ضرورت نہیں انہیں امپورٹ نہ کریں پر سیٹ کریں۔ مثال فائل کی ایک قدر دکھاتی ہے۔ 4. اختیارات کے نیچے: - مقامی نمبروں کا ملک: ملکی کوڈ کے بغیر لکھے نمبر (0501234567، یا 501234567 جب Excel نے صفر ہٹا دیا ہو) اس ملک کے نمبر سمجھے جاتے ہیں۔ عربی ہندسے (٠٥٠...) بھی ٹھیک ہیں۔ فائل میں ملک کالم اپنی قطار کے لیے غالب رہتا ہے۔ شروع میں یہ آپ کی کمپنی کا ملک ہوتا ہے۔ - وہ لوگ جو پہلے سے رابطوں میں ہیں (وہی فون یا ای میل): انہیں فائل کی قدروں سے اپ ڈیٹ کریں (بھرے ہوئے خانے رابطے کی پرانی قدر بدل دیتے ہیں، خالی خانے کبھی کچھ صاف نہیں کرتے، ٹیگز شامل کیے جاتے ہیں، فون یا ای میل صرف تب شامل ہوتا ہے جب رابطے کے پاس نہ ہو) یا انہیں چھوڑ دیں۔ - تمام امپورٹ شدہ لوگوں کے لیے اضافی ٹیگز (کوما سے الگ)۔ 5. جاری رکھیں دبائیں۔ 6. رضامندی: نہیں - انہوں نے رضامندی نہیں دی، یا مجھے معلوم نہیں یا ہاں - انہوں نے رضامندی دی، اور میں بتا سکتا ہوں کیسے منتخب کریں۔ ہاں کے لیے وہ چینلز جن پر انہوں نے رضامندی دی (WhatsApp، SMS، ای میل) پر نشان لگائیں، انہوں نے رضامندی کہاں دی؟ منتخب کریں، ان لوگوں نے رضامندی کیسے دی؟ لکھیں (کم از کم 10 حروف، مثلاً "انہوں نے ہمارے لائلٹی پروگرام میں شامل ہوتے وقت WhatsApp پر مجھے آفرز بھیجیں پر نشان لگایا")، معلوم ہو تو انہوں نے رضامندی کب دی (اختیاری) بھریں، اور میں تصدیق کرتا ہوں کہ ان لوگوں نے یہ رضامندی دی ہے اور پوچھے جانے پر میں ثبوت دکھا سکتا ہوں۔ پر نشان لگائیں۔ 7. فائل چیک کریں دبائیں۔ چیک ہر قطار پڑھتا ہے اور کچھ محفوظ نہیں کرتا (N میں سے n قطاریں چیک ہو رہی ہیں…)۔ 8. چیک کا نتیجہ دکھاتا ہے امپورٹ کے لیے تیار، مسائل والے، نئے رابطے، پہلے سے رابطوں میں اور فائل میں دہرائے گئے، اور وجہ کے ساتھ مسائل والی پہلی قطاریں۔ سیٹنگز تبدیل کریں آپ کو واپس لے جاتا ہے؛ errors.csv ڈاؤن لوڈ کریں مسئلے والی ہر قطار دیتا ہے۔ 9. n رابطے امپورٹ کریں دبائیں۔ N میں سے n امپورٹ ہو رہے ہیں… پیش رفت دکھاتا ہے۔ آپ صفحہ چھوڑ سکتے ہیں: امپورٹ جاری رہتا ہے، اور رابطے → امپورٹ کریں → حالیہ امپورٹس اسے دوبارہ کھولتا ہے (کھولیں)۔ 10. جب امپورٹ مکمل ہو گیا۔ دکھائی دے تو فہرست دیکھنے کے لیے امپورٹ شدہ رابطے دیکھیں دبائیں، یا errors.csv ڈاؤن لوڈ کریں۔ کل تعداد کے نیچے اس امپورٹ نے جتنے لوگ بنائے یا اپ ڈیٹ کیے وہ سب فہرست "Import – customers.csv – 2026-09-24" میں ہیں (n لوگ)۔ امپورٹ کی بنائی فہرست کا نام بتاتا ہے؛ فہرست کھولیں اسے رابطے → سامعین پر کھولتا ہے (اگلا حصہ دیکھیں)۔

امپورٹ کی فہرست

جب امپورٹ مکمل ہوتا ہے تو اس کے بنائے یا اپ ڈیٹ کیے ہوئے سب لوگ ایک نئی فہرست (جامد سامعین) میں ڈالے جاتے ہیں جس کا نام Import – <file name> – <date> ہوتا ہے، مثلاً Import – customers.csv – 2026-09-24۔ اسے کسی بھی فہرست کی طرح استعمال کریں: اسے WhatsApp نشریہ کے سامعین کے طور پر چنیں، رابطے → سامعین پر کھولیں، لوگ شامل کریں یا ہٹائیں (سامعین)۔

• چھوڑے گئے لوگ (پہلے سے رابطوں میں، انہیں چھوڑ دیں کے ساتھ)، مسائل والی قطاریں اور وہ قطاریں جو محفوظ نہ ہو سکیں اس میں شامل نہیں۔
• تاریخ وہ دن ہے جب امپورٹ مکمل ہوا۔ اسی دن وہی فائل دوبارہ امپورٹ کریں تو اس کے لوگ اسی فہرست میں شامل ہوتے ہیں؛ کسی اور دن آپ کو نئی فہرست ملتی ہے۔
• منسوخ شدہ امپورٹ کی کوئی فہرست نہیں بنتی۔ جو لوگ وہ پہلے ہی امپورٹ کر چکا تھا ان پر امپورٹ کا ٹیگ رہتا ہے، اس لیے آپ انہیں پھر بھی ڈھونڈ سکتے ہیں۔
• ایک ورک اسپیس زیادہ سے زیادہ 500 سامعین رکھتا ہے۔ جب پہلے ہی 500 ہوں تو امپورٹ فہرست کے بغیر مکمل ہوتا ہے اور کہتا ہے اس امپورٹ کے لیے کوئی فہرست نہیں بنی: ورک اسپیس میں پہلے ہی 500 سامعین موجود ہیں۔ جن فہرستوں کی اب ضرورت نہیں انہیں رابطے → سامعین پر آرکائیو کریں؛ ٹیگ پھر بھی فائل کے ہر شخص کو نشان زد کرتا ہے۔

لوگوں کو کیسے ملایا جاتا ہے (کوئی نقل نہیں)

• کوئی قطار کسی رابطے والا ہی شخص ہے جب اس کا فون نمبر (+ملکی کوڈ اور نمبر کی شکل میں لکھے جانے کے بعد) یا اس کا ای میل اس ورک اسپیس میں کسی بھی چینل پر پہلے سے موجود ہو۔ ضم شدہ رابطہ ایک شخص کے طور پر اپ ڈیٹ ہوتا ہے۔
• ایک فائل میں ایک ہی نمبر یا ای میل والی دو قطاریں ایک رابطہ بنتی ہیں: پہلی اسے بناتی ہے، بعد والی اسے اپ ڈیٹ کرتی ہیں (یا چھوڑ دی جاتی ہیں جب آپ نے انہیں چھوڑ دیں منتخب کیا ہو)۔
• فون نمبر والا نیا رابطہ اس شخص کے WhatsApp رابطے کے طور پر بنایا جاتا ہے، تاکہ جب وہ آپ کو لکھیں تو ان کے پیغامات اسی کارڈ پر آئیں۔ اس کا ذریعہ امپورٹ ہوتا ہے۔
• ہر امپورٹ شدہ رابطے کو امپورٹ کا اپنا ٹیگ ملتا ہے، import: کے ساتھ تاریخ اور فائل کا نام (مثلاً import:2026-09-24-customers-3f9a)، تاکہ آپ انہیں رابطوں کے صفحے پر دوبارہ ڈھونڈ سکیں (ٹیگ سے فلٹر کر کے)، اوپر والی امپورٹ کی فہرست کے علاوہ۔

رضامندی: کیا درج ہوتا ہے

• جی ہاں کے ساتھ ہر شخص کو ہر نشان زد چینل کے لیے رضامندی کا ریکارڈ ملتا ہے، ذریعہ امپورٹ اور ثبوت کے طور پر آپ کا بیان، جگہ، تاریخ اور فائل کا نام، اور یہ کہ امپورٹ کس نے شروع کیا۔ یہ رابطے پر رضامندی کا تاریخچہ کے نیچے دکھائی دیتا ہے (رضامندی اور آپٹ آؤٹ)۔
• صرف وہ چینلز جن کا پتا قطار میں ہو: WhatsApp اور SMS کے لیے فون نمبر، ای میل کے لیے ای میل درکار ہے۔
• فائل میں مارکیٹنگ رضامندی (ہاں / نہیں) کالم: صرف وہ قطاریں جن میں ہاں ہو (yes، y، 1، نعم، موافق) رضامندی پاتی ہیں؛ جن میں نہیں ہو یا خالی ہوں انہیں کچھ نہیں ملتا۔ ایسے کالم کے لیے اعلان (جی ہاں) درکار ہے یا اسے امپورٹ نہ کریں پر سیٹ کرنا ہوگا۔
• جن لوگوں نے رضامندی واپس لی یا STOP کا جواب دیا ان کا انتخاب برقرار رہتا ہے (ان کا پہلا انکار برقرار رکھا میں شمار)۔ امپورٹ کبھی اسے نہیں بدلتا؛ صرف وہ شخص خود، یا ٹیم کا کوئی رکن رضامندی درج کریں سے ان کی نئی رضامندی درج کر کے، بدل سکتا ہے۔
• نہیں کے ساتھ کسی کو مارکیٹنگ رضامندی نہیں ملتی۔ وہ پھر بھی 24 گھنٹے کی ونڈو میں جوابات اور یوٹیلیٹی پیغامات وصول کر سکتے ہیں۔

اگر کچھ غلط ہو جائے

• یہ پرانی Excel فائل (.xls) ہے... → اسے .xlsx یا CSV UTF-8 کے طور پر محفوظ کریں اور دوبارہ اپ لوڈ کریں۔
• پہلی قطار میں کالمز کے نام ہونے چاہئیں → ہیڈر والی قطار شامل کریں۔
• فائل میں 100,000 سے زیادہ قطاریں ہیں یا فائل 20 MB سے بڑی ہے → اسے تقسیم کریں۔
• فون یا ای میل کا کالم میپ کریں۔ → ایک کالم کو فون (WhatsApp) یا ای میل پر سیٹ کریں۔
• دو کالمز "…" پر سیٹ ہیں → ان میں سے ایک کو امپورٹ نہ کریں پر سیٹ کریں۔
• errors.csv میں قطاریں، وجہ کے ساتھ: درست فون نمبر نہیں (ملکی کوڈ چیک کریں) (مقامی نمبروں کا ملک چیک کریں)، کوئی فون نمبر یا ای میل نہیں، درست ای میل ایڈریس نہیں، نامعلوم ملک، نامعلوم زبان، نامعلوم ٹائم زون، حسب ضرورت فیلڈ کی قدر فیلڈ کے مطابق نہیں (فیلڈ کا نام تفصیل میں ہوتا ہے: انتخاب اس کے آپشنز میں سے ایک ہونا چاہیے، تاریخ YYYY-MM-DD یا دن/مہینہ/سال، نمبر صرف ہندسے)، رضامندی کے کالم میں ہاں یا نہیں ہونا چاہیے، پہلے سے رابطہ ہے - چھوڑ دیا گیا، محفوظ نہیں ہو سکا (وہ قطار دوبارہ امپورٹ کرنے کی کوشش کریں)۔ errors.csv میں فائل کے اپنے کالمز ہوتے ہیں، اس لیے آپ قطاریں درست کر کے انہیں نئی فائل کے طور پر امپورٹ کر سکتے ہیں۔
• امپورٹ منسوخ کریں اگلی 1,000 قطاروں سے پہلے روک دیتا ہے؛ پہلے سے امپورٹ شدہ رابطے رہتے ہیں۔
• قطاریں اور فائل کی محفوظ کاپی اپ لوڈ کے 30 دن بعد حذف ہو جاتی ہیں؛ اس کے بعد errors.csv دستیاب نہیں رہتی (اس فائل کی قطاریں اپ لوڈ کے 30 دن بعد حذف کر دی گئیں۔)۔ امپورٹ کی کل تعداد اور رضامندی کا اعلان محفوظ رہتے ہیں۔

ایک رابطہ شامل کریں

1. رابطے پر رابطہ شامل کریں دبائیں۔
2. نام بھریں اور کم از کم ان میں سے ایک: فون (WhatsApp) (ملکی کوڈ کے ساتھ، یا آپ کے منتخب کردہ ملک کا مقامی نمبر)، ای میل، یا کسی دوسرے پلیٹ فارم پر ہینڈل اس کے پلیٹ فارم کے ساتھ۔
3. اختیاری: ٹیگز (کوما سے الگ)، نوٹس، اور مارکیٹنگ رضامندی (اختیاری) کے نیچے وہ چینلز جن پر اس شخص نے رضامندی دی، نیز انہوں نے رضامندی کیسے دی؟
4. رابطہ شامل کریں دبائیں۔ آپ کو {name} شامل کر دیا گیا۔ دکھائی دیتا ہے اور رابطہ کھل جاتا ہے۔
5. یہ شخص پہلے سے رابطوں میں ہے۔ → نمبر یا ای میل کسی کا ہے؛ رابطہ کھولیں دبائیں۔

صرف ہینڈل سے شامل کیے گئے رابطے کا اپنا الگ کارڈ بنتا ہے؛ جب وہ شخص اس پلیٹ فارم سے آپ کو لکھے تو دونوں کو ضم کریں… سے ملا دیں (رابطے)۔

ڈیولپرز (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) واپس کرتا ہے — اوپر والی فہرست۔

متعلقہ

• رابطے
• فہرستیں اور سیگمنٹس (سامعین)
• رضامندی اور آپٹ آؤٹ
• حسب ضرورت رابطہ فیلڈز
• واٹس ایپ نشریات