> ## 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.

# Receptionist Avatar Onboarding

> Step-by-step guide to creating a Receptionist Avatar through the onboarding wizard

## Overview

The Receptionist Avatar onboarding wizard guides you through creating a kiosk-ready front desk experience in four steps. The process extracts your brand identity, lets you import contacts, and configures the kiosk appearance.

<Tip>
  The wizard is designed to get you up and running quickly. You can always refine contacts, styling, and settings after the initial setup.
</Tip>

## Starting the Wizard

1. Navigate to **Agents → Create New Agent**
2. Select **Receptionist Avatar** as the channel
3. The onboarding wizard opens with a 4-step flow

## The 4-Step Process

<Steps>
  <Step title="Name & Domain">
    Name your Receptionist Avatar and enter your company domain for brand extraction.
  </Step>

  <Step title="Import Contacts">
    Add employee contacts that visitors can search and call from the kiosk.
  </Step>

  <Step title="Customize Appearance">
    Select an avatar, theme, and brand colors for the kiosk.
  </Step>

  <Step title="Review & Create">
    Review your configuration and create the agent.
  </Step>
</Steps>

***

## Step 1: Name & Domain

### Agent Name

Give your Receptionist Avatar a descriptive name. This appears in the dashboard to identify it among your agents.

<Note>
  If you leave the name blank, it defaults to "Receptionist Avatar" with the current date and time.
</Note>

### Company Domain

Enter your company website URL (e.g., `https://humanizing.com`). The platform uses this to:

* **Extract brand colors** via Brandfetch integration
* **Detect your logo** for kiosk branding
* **Set context** for the Receptionist Avatar's identity

You can click **Example** to pre-fill with `humanizing.com` and see how extraction works.

### Brand Extraction

After entering a domain, click **Extract** to fetch brand colors and logo. The extracted colors appear as swatches you can select as your primary brand color.

<Tip>
  If extraction doesn't find your exact colors, you can manually enter a hex code or use the color picker. Click "Skip" to proceed without brand extraction.
</Tip>

***

## Step 2: Import Contacts

Add the employees that visitors will be able to find and contact through the kiosk.

### Adding Contacts

There are three ways to add contacts:

| Method                   | Description                                        |
| ------------------------ | -------------------------------------------------- |
| **Manual entry**         | Fill in name, phone, and email for each contact    |
| **CSV import**           | Upload a CSV file with columns: name, phone, email |
| **Paste from clipboard** | Paste comma-separated contact data directly        |

### Example Contacts

Click **Add 3 Example Contacts** to populate the list with sample data. This helps you see how the contact list will look and test the kiosk flow.

### Contact Fields

Each contact has three fields:

| Field     | Required | Description                           |
| --------- | -------- | ------------------------------------- |
| **Name**  | Yes      | Full name displayed in search results |
| **Phone** | No       | Phone number for calling              |
| **Email** | No       | Email address for search              |

<Note>
  This step is optional. Click **Skip for now** to proceed without contacts and add them later from the Contacts page.
</Note>

***

## Step 3: Customize Appearance

Configure how the kiosk looks to visitors.

### Avatar Selection

Choose a 3D avatar from the gallery. The avatar appears on the kiosk attract screen and throughout the visitor flow.

### Theme

Select between **Light** and **Dark** mode for the kiosk interface.

| Theme     | Best For                                             |
| --------- | ---------------------------------------------------- |
| **Light** | Bright lobbies, corporate offices, reception desks   |
| **Dark**  | Dimmer environments, modern aesthetics, tech offices |

### Brand Colors

Select or customize your primary brand color. You can:

* Click an extracted color swatch from Step 1
* Use the color picker
* Enter a hex code manually

### Preview

The right side of the screen shows a live preview of the kiosk with your current settings. Toggle between **Portrait** and **Landscape** orientations to see how it looks on different devices.

***

## Step 4: Review & Create

Review all your settings before creating the agent:

* **Agent name** and domain
* **Contacts** count
* **Avatar**, theme, and brand color

Click **Create Receptionist Avatar** to finalize. The agent is created and you're redirected to the Playground where you can:

* Preview the kiosk
* Copy the deployment URL
* Test the visitor flow

***

## After Onboarding

<CardGroup cols={2}>
  <Card title="Preview in Playground" icon="flask" href="/receptionist/deployment">
    Test the full kiosk flow and copy the deployment URL.
  </Card>

  <Card title="Manage Contacts" icon="address-book" href="/receptionist/contacts">
    Add, edit, or import more contacts for the kiosk directory.
  </Card>

  <Card title="Customize Styling" icon="palette" href="/receptionist/styling">
    Adjust avatar, theme, colors, and logo from the Styling page.
  </Card>

  <Card title="Deploy to Device" icon="rocket" href="/receptionist/deployment">
    Open the kiosk URL on a tablet or touchscreen to go live.
  </Card>
</CardGroup>