# Contacts

> See the people who talk to your agent on every channel, and import or export their names, emails, and phone numbers.

Contacts is your agent's address book. It lists the people who have talked to your agent, the channels they used, and any name, email address, or phone number Hourzero knows about them. You can also import a list of customers or export everyone to a spreadsheet.

**Where to find it:** open your agent and select **Contacts** in the sidebar.

![The Contacts table with customers from Chat Bubble, WhatsApp, Slack, Instagram, and Messenger](https://hourzero.dev/marketing/app/contacts-light.webp "Each row is one person. Lena Fischer wrote on Instagram and the Chat Bubble, so both appear on her row.")

## What a contact is

A contact is a customer or visitor: someone on the other side of the chat. Contacts are not the same as your teammates. Your teammates are workspace members who sign in to Hourzero, and you manage them in [Members](https://hourzero.dev/docs/workspace-management/members).

Hourzero adds a contact when someone starts talking to your agent. What it knows depends on the channel:

- On WhatsApp, it usually knows the phone number.
- On Slack or Messenger, it often knows the person's name.
- On your website, a visitor stays anonymous until they share details, for example in a lead form, or until your website signs them in with [identity verification](https://hourzero.dev/docs/integrations/identity-verification). A signed-in customer is one contact on every device.

That's why some fields are empty. The page reminds you: "Profile fields may be empty when a channel does not provide them."

## Read the contacts table

The table shows these columns by default:

- **External ID**: the ID the channel uses for this person, such as a WhatsApp number or a website visitor ID. A small icon shows the channel. For a customer signed in with identity verification, it's your website's own user ID, marked **Verified**.
- **Name**, **Phone Number**, and **Email**: what Hourzero knows about the person.
- **Channel**: every channel this person has used.
- **Last Active**: when they last took part in a chat.
- **Conversations**: how many chats they've had with this agent.
- **Actions**: **See details** opens the contact's page.

Two more columns are hidden: **Contact ID** (Hourzero's own ID for the person) and **First Seen**. Select **Columns** to show or hide any column.

One person can appear with more than one identity. In the screenshot above, Lena Fischer has an Instagram ID and a Chat Bubble ID on the same row.

## Open a contact

Select **See details**, the contact's name, or anywhere on their row to open their page. Hold Cmd (Mac) or Ctrl (Windows) to open it in a new tab.

The top of the page shows their name, email, phone, and channels, with **Verified** for a customer signed in with identity verification. Below are four figures:

- **Conversations**: how many chats they've had with this agent, and when they were last active.
- **Messages sent**: how many messages they've written, and when they were first seen.
- **Tickets**: how many [Helpdesk](https://hourzero.dev/docs/ai-agent-management/helpdesk) tickets they've requested, and how many are still open.
- **Satisfaction**: the share of their ticket ratings that were Great or Amazing, with their average rating.

The tabs list everything tied to them:

- **Conversations**: their chats on every channel, newest first. Select one to read it in **Activity → Conversations**. The filter button narrows them by date, channel, last reply, or attachments, the same filters as the Conversations page, and **Rows per page** sets how many show at once.
- **Tickets**: tickets where they're the requester, with status, owner, team, and rating. Select one to open it in the Helpdesk. While the Helpdesk is on, **Create ticket** starts a ticket with them as the requester.
- **Satisfaction**: how they rated their resolved tickets, with the same breakdown as [Feedback](https://hourzero.dev/docs/ai-agent-management/helpdesk/feedback). Select a face to show only those ratings.
- **Leads & data**: the [lead and data forms](https://hourzero.dev/docs/ai-agent-management/submissions) they submitted. Select a row to see every field.
- **Files**: files they uploaded in chats, with the same search, download, and delete as **Activity → File storage**.

The **Details** panel has their contact ID, your website's user ID if they're verified, their channel identities, and any custom attributes your website sent with [identity verification](https://hourzero.dev/docs/integrations/identity-verification).

## Find a contact

- Type in **Search contacts…** to search by name, email, phone, ID, or channel.
- Use the channel menu (**All channels**) to show people from one channel.
- Use the details menu (**All profile details**) to show **Complete details** (name, email, and phone), **Partial details**, or **No profile details**.
- Select a column header to sort by it.
- Select **Clear** to remove your filters.

Use **Rows per page** at the bottom to show 10, 25, or 50 contacts at a time.

> [!TIP]
> Filter by **No profile details** to see how many people chat without leaving any contact info. If the number is high and you want to follow up with them, add a [Collect leads](https://hourzero.dev/docs/ai-agent-management/actions/collect-leads) action so the agent can ask for an email address.

## Import contacts

Importing adds people you already know, like customers from your online store, to the list.

1. Select **Download template** and choose **CSV template** or **Excel template (.xlsx)**.
2. Fill in the template. Keep the three columns **Name**, **Email**, and **Phone**, and don't add others.
3. Give every person at least an email address or a phone number. Name is optional.
4. Select **Import** and choose your file, or drag it onto the upload area.
5. Select **Import contacts**.
6. Review the result: **Imported** (new contacts added), **Duplicates** (skipped), and **Invalid** (rows with a problem). Any problems are listed under **Rows to review**, with the row number and what to fix.

Here's what a small import file looks like:

```text
Name,Email,Phone
Maya Chen,maya@acme.com,
Jordan Lee,jordan@northwind.co,+1 415 555 0187
Sam Ortiz,,+1 646 555 0123
```

> [!IMPORTANT]
> The file must have exactly the columns **Name**, **Email**, and **Phone**. If it has extra columns, like "Company" or "Notes", the whole import is rejected. Copy your data into the template instead of uploading a full export from another tool.

### Import rules

- Files can be CSV or Excel (.xlsx), with up to 100,000 rows and up to 20 MB.
- For Excel files, Hourzero only reads the first sheet.
- If an email or phone number matches someone who's already a contact, or appears twice in the file, that row is skipped as a duplicate. Hourzero doesn't create a second copy of the person.
- Rows with problems, like an email address without an @, don't stop the rest of the file. Fix them and import only those rows again.

To import another file, select **Import another file** in the result screen.

Importing only adds people to the list. It doesn't send them messages, and it doesn't give the agent access to any other customer information.

## Export contacts

1. Select **Export**.
2. Choose **CSV file** or **Excel file (.xlsx)**. The download starts right away.

The export includes every contact for this agent, not only the ones on your screen. Filters and search don't change what's exported. The file has three columns: **Name**, **Email**, and **Phone**.

> [!NOTE]
> Exports contain personal information. Store the file safely and only share it with people who need it.

## Common questions

### Where do I see a contact's conversations?

Open the contact and stay on the **Conversations** tab. Select a chat to read it in **Activity → Conversations**. See [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations).

### What's the difference between Contacts and Leads?

A lead is a form someone filled in during a chat, like "Talk to our team". Contacts is the list of people. One person can submit several leads. See [Leads and collected data](https://hourzero.dev/docs/ai-agent-management/submissions).

### Does adding a contact give them access to Hourzero?

No. Contacts are customers. To let a teammate sign in, invite them under [Members](https://hourzero.dev/docs/workspace-management/members).

## Next steps

- [Conversations](https://hourzero.dev/docs/ai-agent-management/conversations): Read the chats behind each contact.
- [Leads and collected data](https://hourzero.dev/docs/ai-agent-management/submissions): See the details customers shared in forms.
- [Collect leads](https://hourzero.dev/docs/ai-agent-management/actions/collect-leads): Let the agent ask visitors for their contact details.
