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

# Dashboard

> Your AI Agents home page. Two views: a get-started view when you have no agents, and an analytics view once your agents are running.

<Note>
  The dashboard is at `app.wittify.ai/dashboard` and is the page you land on after signing in. Wittify automatically picks one of two layouts based on whether you've built any agents yet. You can also force either view by adding `?view=new` (get-started layout) or `?view=active` (analytics layout) to the URL.
</Note>

## Which view will I see?

| What's true                                | What you see                                                      |
| ------------------------------------------ | ----------------------------------------------------------------- |
| First page load while we fetch your agents | A small centered loading spinner so we don't flash the wrong view |
| You have zero agents                       | The get-started view (covered next)                               |
| You have one or more agents                | The analytics view (covered after)                                |

You can switch back and forth with the URL helpers above without affecting your real agent count.

## Top bar (visible on both views)

The top bar runs across the top of the page and stays the same regardless of which view is active.

| Element                     | Behavior                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Page title                  | **Dashboard**. Replaced by a breadcrumb trail when you navigate into a specific agent or another product.                                                                                                                                                                                                                                                                                    |
| **+ Create Agent** dropdown | Brand-gradient button. Opens a 3-row dropdown with **Text Agent** (Web chat, WhatsApp, Social), **Voice Agent** (Phone, SIP, IVR, Contact Center), **Hybrid Agent (Text + Voice)**. Each row routes to that variant of [Choose Agent Type](/en/Systems/AI-Agents/Create-Agent/Choose-Agent-Type). On phones the button collapses to a compact **+** icon.                                    |
| Notifications bell          | Click to open the notifications dropdown. The empty state reads **No notifications. You're all caught up!**                                                                                                                                                                                                                                                                                  |
| Theme toggle                | A circular button with an animated sun / moon icon. Cycles through **Light**, **Dark**, and **System**.                                                                                                                                                                                                                                                                                      |
| Language switcher           | Globe icon. Click to open a dropdown with **English** and **العربية**. Switching language preserves the page you're on.                                                                                                                                                                                                                                                                      |
| Profile dropdown            | Click your avatar to open a dropdown with **Settings** (routes to [Profile Settings](/en/Account/Profile-Settings)), **User Activities** (routes to [User Activities](/en/Account/User-Activities)), **Plans & Subscription** (routes to [Plans and Subscriptions](/en/Account/Plans-and-Subscriptions)), and **Log Out** at the bottom. On phones, the language switcher also appears here. |

## Sidebar (visible on both views)

The dashboard sidebar runs down the start edge of the page. On screens narrower than `lg` it's hidden by default and slides in as an overlay when you tap the hamburger button in the top bar.

| Section             | Contents                                                                                                                                                                                                                                                                                                 |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wittify wordmark    | Tap to return to the dashboard home. The Saudi Tech logo sits next to it for visitors detected as being in Saudi Arabia.                                                                                                                                                                                 |
| Collapse toggle     | A small chevron button below the logo. Click to collapse the sidebar from 240 px wide to a 60 px icon-only rail. Click again to expand. Hidden on phones, where the sidebar is always full-width when open.                                                                                              |
| **System Switcher** | Drop-down listing all 5 Wittify products. The active product carries a brand-gradient highlight. Selecting another product routes to its home page.                                                                                                                                                      |
| **Dashboard**       | Highlighted in the active state when you're on this page.                                                                                                                                                                                                                                                |
| **Your AI Agents**  | A live list of your agents fetched from your account. While the list is loading, you'll see three pulsing skeleton rows. The empty state reads **You don't have agents yet**. Each row clicks through to that agent's [Manage Agent Overview](/en/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview). |
| **System** submenu  | A collapsible section with **Sub-users**, **Notification Settings** (routes to [Notification Settings](/en/Account/Notification-Settings)), and **Settings** (routes to [Profile Settings](/en/Account/Profile-Settings)).                                                                               |
| Plan card           | Card titled **Your Current Plan** with usage meters (Text, Voice, AI Responses, Voice AI Minutes), credits remaining, and an **Upgrade Plan** button. The button is hidden on Enterprise plans.                                                                                                          |
| Platform nav        | A short list of Wittify links: Documentation, Privacy Policy, Terms of Service, Prohibited Use Policy, About Us, Contact Us, Newsroom, Blog, Pricing Plans, Trust & Compliance.                                                                                                                          |
| Help                | **Frequently Asked Questions** plus social follow links.                                                                                                                                                                                                                                                 |

<Tip>
  The list under **Your AI Agents** always shows every agent you have, even if you have hundreds. There's no client-side pagination, you don't need to click "load more" anywhere.
</Tip>

## Get-started view (no agents yet)

A friendly onboarding layout. Six sections stack down the page, each with a soft entrance animation.

### 1. Hero greeting

| Element      | What you see                                                                                                                                                                                                                                                                                   |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eyebrow pill | **Welcome to Wittify · *YourPlanName* · Free** if you're on a free plan, or just **Welcome to Wittify · *YourPlanName*** otherwise.                                                                                                                                                            |
| Big greeting | **Good morning, *YourName*.** in the morning. **Good afternoon, *YourName*.** between noon and 5 pm. **Good evening, *YourName*.** after 5 pm. The time of day is your local time.                                                                                                             |
| Description  | *Your customers are calling, chatting, and messaging right now, and every unanswered query is a missed opportunity. Build your first AI agent in minutes and let Wittify handle conversations around the clock. Provide support, book meetings, create tickets, qualify leads, and much more.* |
| Hint         | *No-code builder · Setup in 10–15 minutes · No downtime*                                                                                                                                                                                                                                       |

### 2. How Wittify Works

A 5-card strip titled **How Wittify Works**. Each card shows a colored icon tile and a short title with a one-line description.

<Steps>
  <Step title="Create & Customize Agent">
    *Choose type, set identity, tone, language, and behavior. No code needed.*
  </Step>

  <Step title="Add Knowledge">
    *Upload FAQs, URLs, or documents as your agent's knowledge base.*
  </Step>

  <Step title="Integrate Tools">
    *Connect CRMs, calendars, ticketing systems, and custom APIs.*
  </Step>

  <Step title="Connect Channels">
    *Deploy to website, WhatsApp, phone, or your contact center.*
  </Step>

  <Step title="Go Live">
    *Your agent handles conversations automatically, 24/7.*
  </Step>
</Steps>

On phones the strip collapses to 2 columns (the 5th card spans two columns). On `lg+` it's a single 5-column row.

### 3. Build Your Agent Now

A section with a small kicker pill **No-code builder · Ready in 10–15 minutes**, then the heading **Create Your First AI Agent Now!** and the subheading *Transform your customer experience into something extraordinary with AI-powered assistants that work with voice, text, or both. All it takes is just a few simple steps to get started.*

Three large cards in a row (`grid-cols-3` on `md+`, single column on phones). Each card has its own brand color (indigo, purple, blue), a corner badge **No-Code Builder · \~10 min** or similar, an icon tile, channel chips, and a routing target.

<CardGroup cols={3}>
  <Card title="Text Agent" icon="message" href="/en/Systems/AI-Agents/Create-Agent/Text-Agent">
    *Engage customers through text with instant intelligence across all channels, delivering the right answer every time, day or night.*

    **Can be connected to:** Web Chat, WhatsApp, Social Channels.

    Setup time: about 10 minutes.
  </Card>

  <Card title="Voice Agent" icon="microphone" href="/en/Systems/AI-Agents/Create-Agent/Voice-Agent">
    *A voice assistant that speaks naturally to your customers, enabling hands-free communication 24/7, without hiring a single agent.*

    **Can be connected to:** Web Phone, SIP, Contact Center, IVR.

    Setup time: about 12 minutes.
  </Card>

  <Card title="Hybrid Agent (Text + Voice)" icon="bolt" href="/en/Systems/AI-Agents/Create-Agent/Hybrid-Agent">
    *The best of both worlds. One AI agent handling text and voice together, delivering a complete, highly interactive experience.*

    **Can be connected to:** Web Chat, WhatsApp, Social Channels, SIP / IVR.

    Setup time: about 15 minutes.
  </Card>
</CardGroup>

Clicking any card opens the wizard at [Choose Agent Type](/en/Systems/AI-Agents/Create-Agent/Choose-Agent-Type) with that variant pre-selected.

### 4. Connected channels strip

A horizontal card with seven brand-colored channel icons (Website, WhatsApp, Instagram, Phone / SIP, Messenger, Contact Center, X / Twitter) and a small **+more** chip at the end.

| Field    | Copy                                                                                                 |
| -------- | ---------------------------------------------------------------------------------------------------- |
| Title    | *Easily connect your AI agents to your website, WhatsApp, Instagram, telephony systems, and more...* |
| Subtitle | *Start serving your customers 24/7 with unmatched quality, across every channel they already use.*   |

### 5. Upgrade strip (plan-aware)

Hidden if you're on Enterprise. Otherwise the strip pushes the next tier up, with a few feature bullets and a CTA button.

| Your current plan | Strip pushes | CTA button        |
| ----------------- | ------------ | ----------------- |
| Sandbox           | Starter      | **Upgrade Now**   |
| Starter           | Scale        | **Upgrade Now**   |
| Scale             | Pro          | **Upgrade Now**   |
| Pro               | Enterprise   | **Contact Sales** |

Each strip carries a small footnote: *No downtime, cancel anytime*.

### 6. What You Can Build

A grid of 14 industry-icon cards titled **What You Can Build With Wittify**. The grid is 3 columns on phones, 5 on small tablets, 7 on `xl+`. Each card has an icon, a one-line industry name, and routes to a starter template (when available).

The 14 use cases:

Government & citizen services · Customer support & helpdesk · Banking & financial services · Healthcare & appointment booking · Telecom & ISP support · Real estate & lead capture · HR & employee self-service · Retail & e-commerce support · Education & certification · Outbound AI call campaigns · Logistics & delivery tracking · Travel & hospitality concierge · Insurance & claims processing · WhatsApp commerce & orders.

## Analytics view (one or more agents)

Shown when your account has at least one agent. The view aggregates numbers across **every** agent in your fleet. To see numbers for a single agent, click that agent's row in the **Your AI Agents** sidebar list.

### Hero

| Element                 | What you see                                                                                                                                               |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Eyebrow pill            | Same plan-aware welcome strip as the get-started view.                                                                                                     |
| Big title               | **All Agents Overview** with a brand-gradient icon tile next to it.                                                                                        |
| Subtitle                | *Aggregated performance across all your AI agents. Select a specific agent for detailed analytics.*                                                        |
| Period chips            | **7 days**, **30 days**, **90 days**, **Custom**. The active chip is highlighted. **Custom** opens a calendar popover where you pick a start and end date. |
| Export buttons          | **Export PDF** and **Export CSV**. Each downloads the current view's numbers and chart data.                                                               |
| **Report Period** label | A small chip on the upper end edge that shows the active period in plain English (e.g. *Last 7 days*).                                                     |

Changing the period updates every section below in lockstep.

### KPI strip

5 cards in a row. On phones the **first** card spans two columns and the next four sit in a 2×2 grid below it.

<CardGroup cols={3}>
  <Card title="Total AI Agents" icon="robot">
    A count of all agents in your account. Sub-line shows the **Active** vs **Draft** breakdown.
  </Card>

  <Card title="Total Conversations" icon="messages">
    Across all agents in the selected period. A small trend arrow shows the change **vs last month**.
  </Card>

  <Card title="Tickets & Leads Created" icon="ticket">
    Combined total, with a **Tickets** / **Leads** split underneath. Trend arrow next to the number.
  </Card>

  <Card title="Escalation Rate" icon="arrow-up-right">
    Share of conversations that escalated to a human. Lower is better.
  </Card>

  <Card title="User Satisfaction" icon="star">
    Average post-conversation rating. When the score is high the card carries an **Excellent rating** chip.
  </Card>
</CardGroup>

Each card has a small trend line at the bottom that aligns across cards regardless of label length.

### Conversation Volume charts

A card titled **Conversation Volume** with the subtitle *Daily conversations across all agents*. Three tabs at the top of the card switch the chart underneath:

| Tab         | What it shows                                               |
| ----------- | ----------------------------------------------------------- |
| **Daily**   | Number of conversations day by day for the selected period. |
| **By Day**  | Peak days of the week (Sunday through Saturday).            |
| **By Hour** | Peak hours of the day.                                      |

All three tabs are reactive to the date range chips above. An **Export** button on the upper end edge of the card downloads the current chart's numbers.

### Agent Performance

A card titled **Agent Performance** with a **View all** link on the upper end edge. Each row shows an agent's avatar, name, conversation count, deployment chips, and a small ratings indicator. The row is a clickable button that takes you to that agent's [Manage Agent Overview](/en/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview).

A **See more** button at the bottom paginates through additional rows. While loading, the button shows a spinner and the text **Loading...**. When all rows are visible, the button is replaced by **See less** which collapses the list back to its short form.

The *not deployed* badge appears next to agents that haven't been published to any channel yet.

### Analytics 2×2

Four cards in a 2×2 grid below the chart row.

<CardGroup cols={2}>
  <Card title="Sentiment Analysis" icon="face-smile">
    A donut chart with the **Positive** / **Neutral** / **Negative** split. Subtitle: *Based on N conversations this month* (number filled in live).
  </Card>

  <Card title="User Ratings" icon="star">
    A bar chart of post-conversation surveys grouped by star rating. Subtitle: *N post-conversation surveys* with **% of ratings** labels per bar.
  </Card>

  <Card title="Top User Intents" icon="tags">
    A horizontal bar chart of the most frequent topics this month. Subtitle: *Most frequent conversation topics this month*. Each bar shows a *N conversations* label at its end.
  </Card>

  <Card title="Response Time by Agent" icon="clock">
    A horizontal bar chart showing average reply time per agent in seconds. Subtitle: *Average seconds per message, last 7 days*. Each bar shows the value with an **s** suffix (for seconds).
  </Card>
</CardGroup>

### Tickets & Leads Created

A paginated table titled **Tickets & Leads Created** with these columns:

| Column      | Notes                                                                                                                                                     |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **#**       | Ticket or lead identifier                                                                                                                                 |
| **Type**    | **Ticket** or **Lead** badge                                                                                                                              |
| **Summary** | One-line description of the issue or lead                                                                                                                 |
| **Agent**   | The agent that created the record. Click the name to open that agent's [Manage Agent Overview](/en/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview). |
| **Status**  | One of **New**, **Open**, **In Progress**, **Resolved**, **Qualified**                                                                                    |
| **Created** | Creation timestamp in `dd-mm-yy HH:MM` format                                                                                                             |

Filter chips at the top of the table let you narrow by **All**, **Tickets**, or **Leads**. On phones each row collapses into a stacked card with the id and timestamp at the top, the type and status badges in the middle, and the summary in plain text below.

### Activity Feed

A card titled **Recent Activity** that lists system events in reverse chronological order: agent created, agent activated, conversation milestones, ticket events, lead events, and so on. A **See more** button at the bottom loads older events. Each event has a small icon and a sentence describing what happened.

### Upgrade strip

The same plan-aware strip as the get-started view, hidden on Enterprise.

## Mobile

A small mobile notice popup appears the first time you open the dashboard on a phone:

* Title: **Desktop Recommended**
* Body: *This page is designed to be accessed from a desktop browser. Some features may be limited on mobile devices.*
* A **Continue anyway** button dismisses the popup for the rest of your session.

The sidebar slides in from the start edge as an overlay when you tap the hamburger icon in the top bar. Tap the dark overlay (or tap the X inside the sidebar) to close it.

## Common questions

<AccordionGroup>
  <Accordion title="My dashboard greeting says Good evening but it's the morning where I am.">
    The greeting uses your computer's local clock, not your time zone setting in Wittify. If your laptop's clock is wrong, that's why. Update your operating system's time zone and refresh the page.
  </Accordion>

  <Accordion title="The KPI strip says zero conversations even though I had a busy week.">
    Check the date range chip at the top, you may be looking at **Last 7 days** while your traffic was last month. Try **30 days** or **90 days**. If the number is still zero, your conversation data may not have synced from the channel yet, give it a few minutes.
  </Accordion>

  <Accordion title="I clicked Export PDF but nothing downloaded.">
    Some browsers block automatic downloads. Look for a small bar at the top or bottom of the browser asking if you want to allow the download. Allow it and click **Export PDF** again. The export covers the current date range only.
  </Accordion>

  <Accordion title="The Agent Performance list is missing one of my agents.">
    Use the **See more** button at the bottom of the card. The first batch shows your top performers; agents with fewer conversations are paginated below. The **View all** link in the upper end-edge corner goes to a full list.
  </Accordion>

  <Accordion title="Why is my Upgrade strip hidden?">
    You're on the Enterprise plan. There's no higher tier to upgrade to. To discuss custom limits, use the **Contact Sales** option in the Pro upgrade strip on a Pro account, or reach out to your account manager directly.
  </Accordion>

  <Accordion title="Can I see numbers for just one agent?">
    Yes. Click that agent's row in the **Your AI Agents** sidebar list, that opens the per-agent [Manage Agent Overview](/en/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview) with the same KPI strip and charts but filtered to that agent only.
  </Accordion>

  <Accordion title="The page keeps showing me the get-started view but I have agents.">
    Add `?view=active` to the URL to force the analytics layout. If your agent list is loading slowly, you might be seeing a stale state, refresh the page.
  </Accordion>
</AccordionGroup>

## Next

<CardGroup cols={2}>
  <Card title="Choose Agent Type" icon="robot" href="/en/Systems/AI-Agents/Create-Agent/Choose-Agent-Type">
    Build your first agent in 10–15 minutes.
  </Card>

  <Card title="Manage Agent Overview" icon="chart-line" href="/en/Systems/AI-Agents/Manage-Agent/Manage-Agent-Overview">
    See per-agent analytics by clicking any row in the Agent Performance list.
  </Card>

  <Card title="Profile Settings" icon="gear" href="/en/Account/Profile-Settings">
    Update your name, time zone, and password.
  </Card>

  <Card title="Plans and Subscriptions" icon="credit-card" href="/en/Account/Plans-and-Subscriptions">
    Upgrade your plan or top up credits.
  </Card>
</CardGroup>
