> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cosmo.humanizing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Contacts

> Import and manage the employee contact directory for your Receptionist Avatar kiosk

## Overview

The Contacts page manages the employee directory that visitors can search through on the kiosk. Visitors use the contact search screen to find people by name, phone, or email, and then initiate a call or notification.

## Accessing Contacts

Navigate to your Receptionist Avatar in the sidebar. **Contacts** is listed as the second item under the Receptionist Avatar section, after Playground & Setup. The page has two tabs:

| Tab             | Purpose                                          |
| --------------- | ------------------------------------------------ |
| **My Contacts** | View, search, edit, and delete existing contacts |
| **Add New**     | Add contacts manually or import via CSV          |

***

## Viewing Contacts

The **My Contacts** tab displays all contacts in a data table with:

* **Name** — Full name of the employee
* **Phone** — Phone number
* **Email** — Email address
* **Actions** — Edit and delete buttons

### Searching

Use the search bar above the table to filter contacts by name, phone, or email. Search is instant and case-insensitive.

### Bulk Actions

Select multiple contacts using checkboxes (shift-click for range selection) to perform bulk actions:

* **Delete selected** — Remove multiple contacts at once

***

## Adding Contacts

Switch to the **Add New** tab to add contacts. Three methods are available:

### Manual Entry

Fill in the contact form:

1. Enter the **Name** (required)
2. Enter the **Phone** number (optional)
3. Enter the **Email** address (optional)
4. Click **Add Contact**

### CSV Import

Import contacts from a CSV file:

1. Click **Import CSV**
2. Upload a CSV file or paste CSV data into the text area
3. The expected format is: `name,phone,email` (one contact per line)
4. Review the parsed contacts
5. Click **Import** to add them

<Note>
  The CSV parser handles quoted fields correctly (e.g., `"Smith, John","+1234567890","john@example.com"`), so names with commas work as expected.
</Note>

### Example Contacts

Click **Add 3 Example Contacts** to quickly populate the directory with sample data for testing.

***

## Editing Contacts

Click the **edit icon** (pencil) in the Actions column to edit a contact. Update any field and save changes.

## Deleting Contacts

Click the **delete icon** (trash) in the Actions column to remove a single contact. For bulk deletion, use checkboxes and the bulk actions bar.

***

## Best Practices

<AccordionGroup>
  <Accordion icon="file-csv" title="Keep contact data clean">
    Regularly review and update contacts. Remove employees who have left and add new ones promptly. Visitors rely on this directory to find the right person.
  </Accordion>

  <Accordion icon="phone" title="Include phone numbers">
    While phone and email are optional, including at least a phone number for each contact enables the full calling flow on the kiosk.
  </Accordion>

  <Accordion icon="magnifying-glass" title="Use full names">
    Enter full names (first and last) to make search results more accurate. Avoid abbreviations or nicknames that visitors might not recognize.
  </Accordion>

  <Accordion icon="upload" title="Use CSV for bulk imports">
    If you have more than a few contacts, export them from your HR system or directory as CSV and import them. This is much faster than manual entry.
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Customize Kiosk Styling" icon="palette" href="/receptionist/styling">
    Configure the visual appearance of your kiosk.
  </Card>

  <Card title="Deploy Your Kiosk" icon="rocket" href="/receptionist/deployment">
    Get the deployment URL and set up your physical kiosk device.
  </Card>
</CardGroup>