Before creating contacts, connect at least one WhatsApp or Messenger channel. Without a connected channel, you can’t create contacts or send messages. See WhatsApp Setup to set up.
Creating a contact
1
Open Customers
Click Customers in the sidebar menu.
2
Click Add Contact
The button sits at the top right of the page. A form opens on the right side of the screen.Fields marked with a red
* are required: First Name, Phone, Type, Status, Source, and Link to WhatsApp Channel. The rest are optional.3
Enter the name
Fill in First Name. Add the Last Name if you know it.
4
Enter the phone number
Fill in Phone. Pick the correct country code from the dropdown next to the number.
5
Enter the email
Fill in Email if you have it.
6
Choose the type
Pick Lead, Customer, or Guest in the Type field.
7
Assign a team member
Pick a team member in Assigned To. Leave it as Unassigned if nobody is handling this contact yet.
8
Choose a status
Pick the contact’s current stage in the Status field. Click the
+ icon to create a new status without leaving the form.9
Choose a source
Pick where the contact came from in the Source field. Click the
+ icon to create a new source without leaving the form.10
Link a WhatsApp channel
Pick your WhatsApp account in Link to WhatsApp Channel.
11
Add a display name
Fill in Display Name if you want a specific name shown across ChatFlows. Leave it empty and ChatFlows will fill it in for you.
12
Add groups and labels
Pick one or more Groups and Labels. Click the
+ icon to create a new customer group or customer tag without leaving the form.13
Fill in custom fields
If you created customer fields, open the Custom Fields tab at the top of the form and fill them in. A red
* on the tab means a required field is still empty.14
Save
Click Save. The contact is added and appears in your list right away.
Contacts aren’t only created by hand. When a new person messages you first, ChatFlows saves them as a contact automatically, with a default status, source, and more. Customers from your connected Shopify store are added the same way, matched by phone number, and their Shopify tags become customer tags. You can choose those defaults in Settings → Customers.
Fields worth knowing more about
Assigned To The team member responsible for this contact. Use it so your team knows who follows up. Link to WhatsApp Channel The WhatsApp account used to message this contact. Required when creating a contact. A contact can be linked to more than one WhatsApp channel. Every time you edit the contact and pick a channel here, that channel is added to the contact. The channels already linked stay as they are. This is useful when the same customer reaches you on two different WhatsApp numbers of your business. Custom Fields Extra details you decide to store, such as a company name or an order number. See Customer Fields to create your own.Editing a contact
Click the menu icon at the end of a contact’s row and click Edit. The same form opens with the details already filled in. Change what you need and click Save.Viewing contact details
Click a contact’s name to open their details panel. You can view details here but not change them — except notes, which you can add and edit from the Notes tab. The panel has up to three tabs:- Contact Details — type, labels, source, assigned team member, groups, message channels, and the last message and created times.
- Custom Fields — the values saved in your custom fields. Shown only when the contact has custom-field values.
- Notes — internal notes about this contact.
Using notes
Notes are for your team only. The contact never sees them. Use notes to record follow-up reminders, customer preferences, or what was discussed on a call. Open the Notes tab and click Add Note to write one. You can edit or delete a note at any time.Actions on a single contact
Click the menu icon at the end of a contact row to see these actions:- View — open the contact details panel.
- Edit — open the contact form to change details.
- Open chat — go to the existing conversation with this contact. Shown only when the contact has already chatted with you.
- Initiate chat — start a new WhatsApp conversation by sending an approved template message. Shown only when the contact has a phone number and a linked WhatsApp channel. See Inbox to understand the 24-hour messaging window.
- Send flow — send one of your WhatsApp Forms to this contact. Shown only when the contact has a phone number and a linked WhatsApp channel.
- Merge with… — join this contact with a duplicate record. See Bulk Actions & Merge.
- Delete — remove the contact. This also permanently deletes their conversations and chat media, and cannot be undone.
Finding contacts
As your list grows, use these to find the right people quickly:- Search — type a name, phone number, or email in the search box.
- Type tabs — click All, Leads, Customers, or Guests at the top to show only that type.
- Filters — click Filters to narrow the list by:
- Type — Lead, Customer, or Guest.
- Status — the current stage of the contact.
- Source — where the contact came from.
- Active — show only active or only inactive contacts.
- Assignee — the team member handling the contact.
- Channel — the WhatsApp or Messenger account the contact is linked to.
What’s next
Import & Export
Add many contacts at once from a CSV or Excel file.
Bulk Actions & Merge
Update many contacts together, or join duplicates.
Customer Fields
Store extra details on every contact.
Campaigns
Send a message to a group of contacts.

