Projects
Manage real estate developments, link properties to projects, and publish public project pages.
Projects
Projects represent real estate developments such as condominiums, gated communities, apartment towers, or commercial plazas. They allow you to group multiple properties (units) under a single project and manage shared information like condominium amenities and location.
Difference between property and project
| Aspect | Property | Project |
|---|---|---|
| Represents | An individual unit (apartment, house, lot) | A complete development (condo, residential community) |
| Price | Fixed unit price | Not applicable (each unit has its own price) |
| Bedrooms/bathrooms | Yes, per unit | Not applicable |
| Amenities | Unit-specific | Shared development amenities |
| Units | Is a unit | Can have multiple linked properties |
| Public page | /p/[slug] | /pr/[slug] |
A project is like a "container" for properties. Individual properties (units) are linked to the project and inherit the project's location and amenities for bot search purposes.
Projects overview
The projects page shows a grid of cards with all projects in your organization. Each card displays:
- Photo of the project (or a pin icon if no photos are available)
- Badge with construction status (or "Archived" if applicable)
- Name and location
- Actions menu (edit, change status, archive)
From this page you can:
- Search projects by name, description, city, or neighborhood
- Show/hide archived projects
- Change construction status directly from the card's action menu
- Archive or unarchive projects
- Create new projects
Creating a project
Navigate to Projects in the sidebar menu.
Click the Add project button.
Fill in the form with the project information.
Click Create project to save.
Form sections
Basic information
| Field | Required | Description |
|---|---|---|
| Name | Yes | Project name (e.g., "Torres del Valle", "Condominio Vista Real"). |
| Slug | No | Identifier for the public URL. Auto-generated if left empty. |
| Website | No | URL of the project or developer's website. |
Location
| Field | Required | Description |
|---|---|---|
| State / Province | No | Project province or state. |
| City | No | Project city or canton. |
| Neighborhood | No | Project neighborhood or district. |
| Landmarks | No | Nearby landmarks. |
| Map | No | Click the map to mark the project's exact location. You can also search for an address using the search field. The marker can be dragged to adjust the position. |
Description and FAQ
| Field | Required | Description |
|---|---|---|
| Description | No | Free text describing the project. Displayed on the public page. |
| Q&A | No | Text with frequently asked questions about the project. The bot uses this information to answer contact inquiries. |
Amenities
Projects share the same amenity picker as properties. Project amenities represent shared development services (pool, gym, security).
Media
Projects support photos, videos, and 3D tours with the same rules as properties. See Photos & media.
Linking properties to a project
When creating a property, you can link it to an existing project using the project dropdown in the Project section of the form.
When you link a property to a project:
- The project's location is automatically inherited and the location fields are locked (they cannot be edited independently).
- The project's amenities are shown as read-only. You can add extra amenities specific to the unit.
- The property appears as an available unit on the project's public page.
- The project's amenities are automatically included in the property's embedding for bot searches.
Public project pages
Each active project generates a public page at:
https://yourorganization.trochai.com/pr/[slug]The project's public page shows:
- Photo gallery of the project
- Name and location
- Description of the project
- Shared amenities
- 3D virtual tour (if URL is configured)
- Map with the project's exact location (if coordinates are set)
- Available units --- Grid of properties linked to the project with active status, showing photo, price, category, bedrooms, and bathrooms. Each card links to the individual property's public page.
- Contact buttons --- WhatsApp to chat and schedule a visit
SEO
Project pages also generate Open Graph meta tags, Twitter Cards, and structured data (JSON-LD type Place) to optimize visibility in search engines and social media.
How the bot uses projects
The WhatsApp bot supports project searches through the search_project intent:
- "What projects do you have?" --- The bot lists available projects
- "I'm looking for a condo in Escazu" --- Searches projects by location
- "I'm looking for something in Torres del Valle" --- Searches by project name
Additionally, when the bot searches for individual properties, it includes the project context (shared amenities, Q&A) in the results, enabling more complete responses.
Project amenities are merged with property amenities in embeddings. If the project has pool and gym, all linked properties will be found when a client searches for "with pool and gym".
Project statuses
Projects have two status dimensions: the construction status and the archive option.
Construction status
| Status | Description |
|---|---|
| Pre-sale | Project in pre-sale phase, construction has not started yet |
| Under construction | Project currently being built |
| Ready | Construction finished, ready for delivery |
| Delivered | Project fully delivered to owners |
You can change the construction status directly from the card's action menu, without opening the edit form.
Archiving projects
An archived project is hidden from the main view (unless you enable the "Show archived" filter). Archiving is independent of construction status --- you can archive a project at any phase.
To archive or unarchive a project, use the corresponding option in the card's action menu.