AI Chat
The AI Chat module provides a conversational interface to the VIVIN AI Assistant. Use it to ask questions about your portfolio, occupancy, revenue, upcoming move-ins, and coliving overview — and get instant, data-backed answers without leaving the platform.
User Roles and Access
In the management frontend, the AI Chat route (/ai-chat) is wrapped with VivinOnlyGuard: only users whose email satisfies the internal Vivin check (isVivinUserEmail, typically @vivin.app accounts) can open the page. Other signed-in users see the standard permission-denied state. The AI Chat item in the sidebar is also marked vivinOnly, so it is hidden for non-internal users. Access to sensitive data is still enforced by the API for each request.
| Role | Practical access |
|---|---|
Vivin internal (e.g. @vivin.app) | Can open AI Chat from the sidebar and /ai-chat; use like other management tools with API-enforced data access |
| Property Manager / Admin / Viewer (other) | Route and nav entry are not available; same pattern as other Vivin-only tools in the shell |
If product policy changes to broaden AI Chat access, update VivinOnlyGuard on /ai-chat, the sidebar vivinOnly flag for AI Chat, and this documentation together.
Prerequisites
- An active Vivin account with at least one property and listing
- Access to the management frontend (hub.vivin.app)
Open the AI Chat module at hub.vivin.app/ai-chat. See Deep Links for all management frontend routes.
Key Workflows
Starting a New Conversation
- Navigate to Tools > AI Chat in the sidebar (or go to
/ai-chat) - Click New chat in the left sidebar
- Type your question in the message input at the bottom
- Press Enter or click the send button
Asking About Your Portfolio
The AI Assistant has access to your account data and can answer questions such as:
| Question Type | Example |
|---|---|
| Occupancy | "How is my occupancy for next month?" |
| Revenue | "What is my expected revenue this month?" |
| Move-ins | "Who is moving in this month?" |
| Coliving overview | "Give me an overview of all my coliving properties" |
Responses include real data from your bookings, properties, and financial records — with breakdowns by property, unit, and tenant where relevant.
Using Example Conversations
The sidebar includes Example conversations you can click to see sample questions and answers. These demonstrate the kinds of queries the AI can handle. Click Start a real conversation to begin your own chat.
Managing Conversations
- Rename — Hover over a conversation in the sidebar and click the pencil icon to rename it
- Archive — Click the trash icon to archive a conversation (it is removed from the list)
- Switch — Click any conversation in the sidebar to switch between chats
Interface Overview
The AI Chat screen has two main areas:
Left sidebar
- New chat button — creates a new conversation
- List of your conversations (click to switch)
- Examples section — sample questions you can try
Main chat area
- Message history (your messages on the right, AI responses on the left)
- Message input at the bottom
- Loading indicator while the AI is responding
Important Notes
VIVIN AI can make mistakes. Verify important information before taking action.
The AI Assistant provides helpful summaries and insights based on your data, but critical decisions (e.g., payment reminders, contract changes) should be confirmed in the relevant modules (Finance, Bookings, etc.).
Related
- Automation & AI — Platform-wide AI capabilities, including tenant-facing chatbot
- Dashboard — Real-time KPIs and overview
- Finance — Revenue and payment details
- Bookings — Booking and move-in details