Importing contacts
1
Upload your file
From Customers, click Import Contacts, then Add Import, and upload a CSV or XLSX file (up to 30 MB).Not sure how your file should look? Click Download sample CSV on this step to get a ready-made example.Your file needs a header row as the first row, and phone numbers must include the country code (for example
+9198******). If a phone number already belongs to a customer, you choose what happens on the last step.2
Map your columns
ChatFlows reads your file’s headers and suggests a mapping to contact fields automatically. Review and adjust the mapping — including your own customer fields — before continuing.
3
Set Default Values and start the import
First, choose what happens when a phone number already belongs to a customer:
- Skip the row — the existing customer stays as it is. The row is listed as skipped. This is the default.
- Update the existing contact — the customer is updated with the columns from your file and the default values below. Groups and labels are added, never removed.
Some defaults are required — the WhatsApp channel, type, status, and source must be set before you can start the import.
Tracking an import
Each import you run is listed with its status and progress. Open one to:- See how many rows were imported, updated, skipped, and failed.
- Download Failed Rows CSV — a file listing the rows that failed and why.
- Download Original File — the file you uploaded.
- Delete a single import record, or bulk-delete several at once. This only removes the import history entry — contacts already created by that import are not deleted.
Exporting contacts
From the Customers page, apply the filters you want — type, status, source, active, assignee, or channel — or type in the search box, then click Export to download exactly that filtered list as a file. You can also select specific contacts in the list. When contacts are selected, Export downloads only those rows.What’s next
Managing customers
Browse, create, and edit contacts individually.
Bulk Actions & Merge
Clean up and organize contacts after a large import.

