Contacts: create, edit, merge and delete
A contact is one customer: a name, a phone number, the groups they belong to, and any custom fields you track.
- Who can use this
- Account owner, Manager, Agent
A contact is one customer: a name, a phone number, the groups they belong to, and any custom fields you track.
A contact is one customer: a name, a phone number, the groups they belong to, and any custom fields you track. Every conversation in the Team Inbox is linked to a contact. This page shows how to add a contact by hand, edit it, start a conversation with it, and delete it.
Sidebar → Contacts → All Contacts. The Contacts item appears for staff whose role has the Manage Contacts permission ("View and manage all contacts"). The Add Contact button appears only when the role also has Create Contact.
If a manager has limited you to certain contact groups, you see only the contacts in those groups (plus the contacts of conversations assigned to you). See Contact groups and saved filters.
The Add New Contact dialog opens on the Contact Info tab.
If your contacts are limited to your groups and you have more than one group, this field is required (Groups *).
You see "Contact created successfully".
The Update Contact dialog opens.
You see "Contact updated".
If the contact already has a conversation on that channel, the dialog says so and offers Open conversation; sending continues the existing conversation.
When the list is filtered (by a group, a custom field, a saved filter and so on), the panel can show which conditions each contact met.
The Explain Match switch next to the sort options stays grey until a filter is active.
The Match Explanation panel opens: "Why "…" matched your filter criteria".
Each condition shows the field it checked, a reason, and Matched or Not Matched. Groups of conditions (AND / OR) open to show their parts. Use Show All or Collapse All to open or close every group.
This cannot be undone.
The number of contacts you can store may depend on your plan. Check Billing → Current Plan.
Phone numbers must be digits only and at least 5 characters in the form.
The phone number cannot be changed. The edit dialog shows it, but only name, groups and custom fields are saved. To use a different number, create a new contact.
Contacts who have messaged you cannot be deleted. The platform keeps their conversation history, so the Delete item is hidden (or the delete is refused) once the contact has sent you any message.
Agents can edit, delete, star or change DND only for contacts they are allowed to see.
The list has columns for Name, Phone, Created, Updated, DND Enabled, Starred and Contact Groups. Use the column button next to the filters to show or hide them.
Click the copy icon next to a phone number to copy it. If the contact has a conversation, a link opens it in the Team Inbox.
Explain Match: when a filter is active, you can see why each contact matched it. See See why a contact matches a filter.
Starred contacts can be filtered and shown as a column.
Merging contacts: the panel has Merge Groups for contact groups, but no tool to merge two duplicate contacts.
Tip: to add many contacts at once, use Import contacts from a file instead of adding them one by one.
Do it with Copilot
(crm_get_contact)
Do it with Copilot
(crm_upsert_contact; updates the contact if that phone already exists)
Do it with Copilot
(crm_update_contact; the phone number cannot be changed)
Do it with Copilot
(crm_delete_contact) Deleting always needs your approval, and it is refused if the contact has messaged you.
| What you see | Why | What to do |
|---|---|---|
| "Name is required" / "Phone number is required" | A required field is empty. | Fill in the name and phone number. |
| "Phone number must contain only digits" | The number has spaces, + or dashes. | Pick the country, then type only digits. |
| "Choose one of your contact groups for this contact" | Your contacts are limited to groups and you have several. | Pick one of your groups in Groups *. |
| "You can only use your own contact groups" | You chose a group outside your scope. | Choose one of your own groups. |
| "This contact is outside your contact groups." | The contact is not in any of your groups. | Ask a manager to add the contact to one of your groups, or to change your limit. |
| No Delete item in the menu | The contact has messaged you, or your role cannot delete it. | Keep the contact; remove it from groups instead if needed. |
| No Add Contact button | Your role lacks Create Contact. | Ask an owner or manager. |
| Explain Match is greyed out, or no Explain in the row menu | No filter is applied, or the switch is off | Apply a filter, then switch on Explain Match |