[{"data":1,"prerenderedAt":584},["ShallowReactive",2],{"help-article-contacts-importing-contacts":3,"help-siblings-contacts":543},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"body":17,"_type":537,"_id":538,"_source":539,"_file":540,"_stem":541,"_extension":542},"\u002Fhelp\u002Fcontacts\u002Fimporting-contacts","contacts",false,"","Importing contacts from CSV","How to bulk import contacts into AIsoule from a CSV file with column mapping and duplicate handling.",2,"beginner","3 minutes",[14,15,16],"\u002Fhelp\u002Fcontacts\u002Fadding-contacts","\u002Fhelp\u002Fcontacts\u002Fusing-tags","\u002Fhelp\u002Fcontacts\u002Fcreating-segments",{"type":18,"children":19,"toc":525},"root",[20,28,34,41,46,221,228,240,246,343,349,354,377,383,426,432,455,461,466,489,495,505,515],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"importing-contacts-from-csv",[26],{"type":27,"value":8},"text",{"type":21,"tag":29,"props":30,"children":31},"p",{},[32],{"type":27,"value":33},"Bulk import hundreds or thousands of contacts from a spreadsheet.",{"type":21,"tag":35,"props":36,"children":38},"h2",{"id":37},"csv-format-requirements",[39],{"type":27,"value":40},"CSV format requirements",{"type":21,"tag":29,"props":42,"children":43},{},[44],{"type":27,"value":45},"Your CSV file should have these columns:",{"type":21,"tag":47,"props":48,"children":49},"table",{},[50,74],{"type":21,"tag":51,"props":52,"children":53},"thead",{},[54],{"type":21,"tag":55,"props":56,"children":57},"tr",{},[58,64,69],{"type":21,"tag":59,"props":60,"children":61},"th",{},[62],{"type":27,"value":63},"Column",{"type":21,"tag":59,"props":65,"children":66},{},[67],{"type":27,"value":68},"Required",{"type":21,"tag":59,"props":70,"children":71},{},[72],{"type":27,"value":73},"Example",{"type":21,"tag":75,"props":76,"children":77},"tbody",{},[78,120,157,183,204],{"type":21,"tag":55,"props":79,"children":80},{},[81,110,115],{"type":21,"tag":82,"props":83,"children":84},"td",{},[85,92,94,100,102,108],{"type":21,"tag":86,"props":87,"children":89},"code",{"className":88},[],[90],{"type":27,"value":91},"phone_number",{"type":27,"value":93}," (or ",{"type":21,"tag":86,"props":95,"children":97},{"className":96},[],[98],{"type":27,"value":99},"phone",{"type":27,"value":101},", ",{"type":21,"tag":86,"props":103,"children":105},{"className":104},[],[106],{"type":27,"value":107},"mobile",{"type":27,"value":109},")",{"type":21,"tag":82,"props":111,"children":112},{},[113],{"type":27,"value":114},"✅ Yes",{"type":21,"tag":82,"props":116,"children":117},{},[118],{"type":27,"value":119},"+919876543210",{"type":21,"tag":55,"props":121,"children":122},{},[123,147,152],{"type":21,"tag":82,"props":124,"children":125},{},[126,132,133,139,140,146],{"type":21,"tag":86,"props":127,"children":129},{"className":128},[],[130],{"type":27,"value":131},"name",{"type":27,"value":93},{"type":21,"tag":86,"props":134,"children":136},{"className":135},[],[137],{"type":27,"value":138},"full_name",{"type":27,"value":101},{"type":21,"tag":86,"props":141,"children":143},{"className":142},[],[144],{"type":27,"value":145},"recipient_name",{"type":27,"value":109},{"type":21,"tag":82,"props":148,"children":149},{},[150],{"type":27,"value":151},"Optional",{"type":21,"tag":82,"props":153,"children":154},{},[155],{"type":27,"value":156},"John Doe",{"type":21,"tag":55,"props":158,"children":159},{},[160,169,173],{"type":21,"tag":82,"props":161,"children":162},{},[163],{"type":21,"tag":86,"props":164,"children":166},{"className":165},[],[167],{"type":27,"value":168},"email",{"type":21,"tag":82,"props":170,"children":171},{},[172],{"type":27,"value":151},{"type":21,"tag":82,"props":174,"children":175},{},[176],{"type":21,"tag":177,"props":178,"children":180},"a",{"href":179},"mailto:john@example.com",[181],{"type":27,"value":182},"john@example.com",{"type":21,"tag":55,"props":184,"children":185},{},[186,195,199],{"type":21,"tag":82,"props":187,"children":188},{},[189],{"type":21,"tag":86,"props":190,"children":192},{"className":191},[],[193],{"type":27,"value":194},"tags",{"type":21,"tag":82,"props":196,"children":197},{},[198],{"type":27,"value":151},{"type":21,"tag":82,"props":200,"children":201},{},[202],{"type":27,"value":203},"customer, vip",{"type":21,"tag":55,"props":205,"children":206},{},[207,212,216],{"type":21,"tag":82,"props":208,"children":209},{},[210],{"type":27,"value":211},"Any custom field name",{"type":21,"tag":82,"props":213,"children":214},{},[215],{"type":27,"value":151},{"type":21,"tag":82,"props":217,"children":218},{},[219],{"type":27,"value":220},"city, company",{"type":21,"tag":222,"props":223,"children":225},"h3",{"id":224},"example-csv",[226],{"type":27,"value":227},"Example CSV",{"type":21,"tag":229,"props":230,"children":235},"pre",{"className":231,"code":233,"language":234,"meta":7},[232],"language-csv","phone_number,name,email,tags\n+919876543210,John Doe,john@example.com,customer\n+919876543211,Jane Smith,jane@example.com,\"customer,vip\"\n+919876543212,Bob Wilson,,new-lead\n","csv",[236],{"type":21,"tag":86,"props":237,"children":238},{"__ignoreMap":7},[239],{"type":27,"value":233},{"type":21,"tag":35,"props":241,"children":243},{"id":242},"how-to-import",[244],{"type":27,"value":245},"How to import",{"type":21,"tag":247,"props":248,"children":249},"ol",{},[250,264,276,288,300,305,334],{"type":21,"tag":251,"props":252,"children":253},"li",{},[254,256,262],{"type":27,"value":255},"Go to ",{"type":21,"tag":257,"props":258,"children":259},"strong",{},[260],{"type":27,"value":261},"Contacts",{"type":27,"value":263}," in the sidebar",{"type":21,"tag":251,"props":265,"children":266},{},[267,269,274],{"type":27,"value":268},"Click the ",{"type":21,"tag":257,"props":270,"children":271},{},[272],{"type":27,"value":273},"Import",{"type":27,"value":275}," button (or use the menu → Import\u002FExport)",{"type":21,"tag":251,"props":277,"children":278},{},[279,281,286],{"type":27,"value":280},"Click ",{"type":21,"tag":257,"props":282,"children":283},{},[284],{"type":27,"value":285},"\"Choose File\"",{"type":27,"value":287}," and select your CSV",{"type":21,"tag":251,"props":289,"children":290},{},[291,293,298],{"type":27,"value":292},"AIsoule will auto-detect columns and show a ",{"type":21,"tag":257,"props":294,"children":295},{},[296],{"type":27,"value":297},"column mapping",{"type":27,"value":299}," preview",{"type":21,"tag":251,"props":301,"children":302},{},[303],{"type":27,"value":304},"Verify the mapping is correct (phone → phone_number, etc.)",{"type":21,"tag":251,"props":306,"children":307},{},[308,310],{"type":27,"value":309},"Choose what to do with duplicates:\n",{"type":21,"tag":311,"props":312,"children":313},"ul",{},[314,324],{"type":21,"tag":251,"props":315,"children":316},{},[317,322],{"type":21,"tag":257,"props":318,"children":319},{},[320],{"type":27,"value":321},"Skip",{"type":27,"value":323}," — Don't update existing contacts",{"type":21,"tag":251,"props":325,"children":326},{},[327,332],{"type":21,"tag":257,"props":328,"children":329},{},[330],{"type":27,"value":331},"Update",{"type":27,"value":333}," — Overwrite existing contact data with new values",{"type":21,"tag":251,"props":335,"children":336},{},[337,338],{"type":27,"value":280},{"type":21,"tag":257,"props":339,"children":340},{},[341],{"type":27,"value":342},"\"Import\"",{"type":21,"tag":35,"props":344,"children":346},{"id":345},"handling-duplicates",[347],{"type":27,"value":348},"Handling duplicates",{"type":21,"tag":29,"props":350,"children":351},{},[352],{"type":27,"value":353},"AIsoule detects duplicates by phone number. If a contact with the same phone number already exists:",{"type":21,"tag":311,"props":355,"children":356},{},[357,367],{"type":21,"tag":251,"props":358,"children":359},{},[360,365],{"type":21,"tag":257,"props":361,"children":362},{},[363],{"type":27,"value":364},"Skip mode",{"type":27,"value":366}," — The existing contact is left unchanged",{"type":21,"tag":251,"props":368,"children":369},{},[370,375],{"type":21,"tag":257,"props":371,"children":372},{},[373],{"type":27,"value":374},"Update mode",{"type":27,"value":376}," — Name, email, tags, and custom fields are updated with the new values",{"type":21,"tag":35,"props":378,"children":380},{"id":379},"import-limits",[381],{"type":27,"value":382},"Import limits",{"type":21,"tag":311,"props":384,"children":385},{},[386,398,408],{"type":21,"tag":251,"props":387,"children":388},{},[389,391,396],{"type":27,"value":390},"Maximum ",{"type":21,"tag":257,"props":392,"children":393},{},[394],{"type":27,"value":395},"10,000 contacts",{"type":27,"value":397}," per import",{"type":21,"tag":251,"props":399,"children":400},{},[401,403],{"type":27,"value":402},"File size limit: ",{"type":21,"tag":257,"props":404,"children":405},{},[406],{"type":27,"value":407},"5MB",{"type":21,"tag":251,"props":409,"children":410},{},[411,413,419,420],{"type":27,"value":412},"Supported formats: ",{"type":21,"tag":86,"props":414,"children":416},{"className":415},[],[417],{"type":27,"value":418},".csv",{"type":27,"value":101},{"type":21,"tag":86,"props":421,"children":423},{"className":422},[],[424],{"type":27,"value":425},".xlsx",{"type":21,"tag":35,"props":427,"children":429},{"id":428},"tips",[430],{"type":27,"value":431},"Tips",{"type":21,"tag":311,"props":433,"children":434},{},[435,440,445,450],{"type":21,"tag":251,"props":436,"children":437},{},[438],{"type":27,"value":439},"Always include the country code in phone numbers (e.g., +91 for India)",{"type":21,"tag":251,"props":441,"children":442},{},[443],{"type":27,"value":444},"Remove any formatting from phone numbers (no spaces, dashes, or parentheses)",{"type":21,"tag":251,"props":446,"children":447},{},[448],{"type":27,"value":449},"Use UTF-8 encoding for special characters",{"type":21,"tag":251,"props":451,"children":452},{},[453],{"type":27,"value":454},"Test with a small file (10-20 contacts) first",{"type":21,"tag":35,"props":456,"children":458},{"id":457},"after-importing",[459],{"type":27,"value":460},"After importing",{"type":21,"tag":29,"props":462,"children":463},{},[464],{"type":27,"value":465},"Once imported, you can:",{"type":21,"tag":311,"props":467,"children":468},{},[469,474,479,484],{"type":21,"tag":251,"props":470,"children":471},{},[472],{"type":27,"value":473},"View contacts in the Contacts list",{"type":21,"tag":251,"props":475,"children":476},{},[477],{"type":27,"value":478},"Create segments to group them",{"type":21,"tag":251,"props":480,"children":481},{},[482],{"type":27,"value":483},"Add them to broadcast campaigns",{"type":21,"tag":251,"props":485,"children":486},{},[487],{"type":27,"value":488},"Start conversations with template messages",{"type":21,"tag":35,"props":490,"children":492},{"id":491},"troubleshooting",[493],{"type":27,"value":494},"Troubleshooting",{"type":21,"tag":29,"props":496,"children":497},{},[498,503],{"type":21,"tag":257,"props":499,"children":500},{},[501],{"type":27,"value":502},"\"Invalid phone number on row X\"",{"type":27,"value":504}," — Check that the number includes a country code and has no special characters.",{"type":21,"tag":29,"props":506,"children":507},{},[508,513],{"type":21,"tag":257,"props":509,"children":510},{},[511],{"type":27,"value":512},"\"File too large\"",{"type":27,"value":514}," — Split your file into multiple CSVs of 10,000 contacts each.",{"type":21,"tag":29,"props":516,"children":517},{},[518,523],{"type":21,"tag":257,"props":519,"children":520},{},[521],{"type":27,"value":522},"\"Column not detected\"",{"type":27,"value":524}," — Make sure your CSV header row uses one of the recognized column names (phone_number, phone, mobile, name, email).",{"title":7,"searchDepth":10,"depth":10,"links":526},[527,531,532,533,534,535,536],{"id":37,"depth":10,"text":40,"children":528},[529],{"id":224,"depth":530,"text":227},3,{"id":242,"depth":10,"text":245},{"id":345,"depth":10,"text":348},{"id":379,"depth":10,"text":382},{"id":428,"depth":10,"text":431},{"id":457,"depth":10,"text":460},{"id":491,"depth":10,"text":494},"markdown","content:help:contacts:importing-contacts.md","content","help\u002Fcontacts\u002Fimporting-contacts.md","help\u002Fcontacts\u002Fimporting-contacts","md",[544,547,549,552,555,558,561,563,566,569,570,573,576,579,582],{"_path":545,"title":546},"\u002Fhelp\u002Fcontacts\u002Factivity-timeline","Contact activity timeline explained",{"_path":14,"title":548},"Adding and managing contacts",{"_path":550,"title":551},"\u002Fhelp\u002Fcontacts\u002Fbulk-operations","Bulk operations (assign, tag, delete)",{"_path":553,"title":554},"\u002Fhelp\u002Fcontacts\u002Fcontact-assignment","Contact assignment (to user)",{"_path":556,"title":557},"\u002Fhelp\u002Fcontacts\u002Fcontact-merging","Merging duplicate contacts",{"_path":559,"title":560},"\u002Fhelp\u002Fcontacts\u002Fcontact-pinning","Contact pinning and favorites",{"_path":16,"title":562},"Creating custom segments with filters",{"_path":564,"title":565},"\u002Fhelp\u002Fcontacts\u002Fcustom-fields","Creating custom fields for contacts",{"_path":567,"title":568},"\u002Fhelp\u002Fcontacts\u002Fexporting-contacts","Exporting contacts to CSV",{"_path":4,"title":8},{"_path":571,"title":572},"\u002Fhelp\u002Fcontacts\u002Flifecycle-stages","Contact lifecycle stages (lead to customer)",{"_path":574,"title":575},"\u002Fhelp\u002Fcontacts\u002Fqr-scanner","Using the QR code scanner to add contacts",{"_path":577,"title":578},"\u002Fhelp\u002Fcontacts\u002Fservice-window","Understanding the 24-hour service window",{"_path":580,"title":581},"\u002Fhelp\u002Fcontacts\u002Fsource-tracking","Contact source tracking",{"_path":15,"title":583},"Using tags to organize contacts",1780423183853]