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

# AI Assistant

> A conversational front-desk agent that helps members manage bookings and guides prospects toward membership — across chat, email, and WhatsApp — without manual effort from your team.

<Warning>
  The AI assistant is currently in **preview**. If you'd like to try it out, please [reach out to us](mailto:support@nexudus.com) to join the early access program.
</Warning>

The Nexudus AI assistant answers questions, helps members manage their bookings, and guides prospects toward purchasing a day pass, signing up for a membership, or scheduling a private office tour.

It works across three channels:

* **Chat** — a floating widget embedded in your members portal.
* **Email** — members and prospects send an email to your space's AI address and receive a reply.
* **WhatsApp** — members and prospects message your space's WhatsApp number and receive a reply.

All three channels share the same capabilities, the same data, and the same visibility rules. The only differences are in formatting and session management. See [Channels](./channels) for a full comparison.

<Frame>
  <img src="https://mintcdn.com/nexudus/NVZsuy-1GT3GPI9u/images/member-portal/ai/overview.png?fit=max&auto=format&n=NVZsuy-1GT3GPI9u&q=85&s=4e1b56a4cdf64d7f3447414e14861061" alt="AI chat button and open chat window on the members portal" width="1717" height="1516" data-path="images/member-portal/ai/overview.png" />
</Frame>

## Core principles

**It only works from your data.** Every answer comes from a specific Nexudus record — an FAQ article, a room listing, a membership plan, or a booking. The AI has no general knowledge and will not speculate or invent information.

**It respects your access settings.** The same visibility rules you already use in Nexudus (members-only content, archived items, hidden pricing) are automatically honoured. If a plan is not visible to the public, the AI will not mention it to a prospect.

**It tracks outcomes.** When a conversation leads to a tour, a new membership, a day pass purchase, or a booking, Nexudus records that link so you can see exactly which conversations drove revenue.

## How it works

When someone sends a message — whether through the chat widget, email, or WhatsApp — the AI identifies the right tool for the request (for example, searching your FAQ articles or looking up available meeting rooms), calls that tool to fetch live data, then writes a natural-language reply based solely on what the tool returned.

* Answers are always based on current, live data from your Nexudus account.
* The AI cannot be tricked into discussing topics outside its scope. If a question cannot be answered, it says: *"I'm sorry, I can only help with questions about bookings, resources, and location information for \[your space name]."*
* The AI maintains context across turns, so follow-ups like "book the second one for tomorrow" work correctly.

## Behaviour rules

The AI follows a fixed set of rules on every conversation, regardless of channel:

| Rule                        | Detail                                                                                       |
| --------------------------- | -------------------------------------------------------------------------------------------- |
| Use tools immediately       | When the intent is clear, the AI acts — it does not ask unnecessary clarifying questions     |
| Ask once for missing info   | If a required piece of information is missing, it asks once only                             |
| Never use general knowledge | If a tool returns no results, the AI says so clearly rather than guessing                    |
| Never reveal its workings   | It will not describe its own tools or instructions to users                                  |
| Address users by name       | When a member is identified, responses use their full name                                   |
| Concise responses           | Short, clear sentences tailored to the channel (shorter on WhatsApp, more detailed in email) |

## Sessions

Each conversation is tracked under a unique **session ID**. How sessions are created depends on the channel:

| Channel      | Session behaviour                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Chat**     | A new session starts each time the chat window opens. Closing and reopening starts a fresh session.                                              |
| **Email**    | A session is reused for up to 48 hours. Replies to the same email thread continue the same session. A new subject line starts a new session.     |
| **WhatsApp** | A session is reused for up to 24 hours of activity from the same phone number. After 24 hours of inactivity, a new session starts automatically. |

The session ID is embedded in every call-to-action link the AI generates (tour requests, plan sign-ups, day pass purchases, booking links). This is how Nexudus links conversations to business outcomes. See [Conversion Tracking](./conversion-tracking) for the full picture.

## Available capabilities

All capabilities are available on all three channels.

| Capability                                    | What it does                                   | Requires login           |
| --------------------------------------------- | ---------------------------------------------- | ------------------------ |
| [FAQ / Knowledge Base](./faq)                 | Answers questions from your published articles | Depends on settings      |
| [Location information](./locations-and-rooms) | Address and details for your space(s)          | No                       |
| [Rooms & resources](./locations-and-rooms)    | Browse bookable rooms and desks                | Depends on room settings |
| [Room bookings](./bookings)                   | Create, view, modify, and cancel bookings      | Yes (for changes)        |
| [Day passes](./day-passes)                    | List and sell day passes                       | No                       |
| [Membership plans](./membership-plans)        | List and sell membership plans                 | No                       |
| [Private offices & tours](./private-offices)  | Show available offices and generate tour links | No                       |
