> For the complete documentation index, see [llms.txt](https://docs.chatalog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatalog.ai/booking/booking.md).

# Booking

The Booking feature allows your team to manage customer appointments directly within Chatalog. You can create booking items, collect booking information from customers, review booking records, and manage booking statuses from both the Booking page and the Messages Inbox.

{% hint style="info" %}
This is an add-on feature. Please contact your account manager if you would like to enable it for your organization.
{% endhint %}

Bookings can be created in two ways:

* Automatically through the AI Agent
* Manually by agents

## ⚙️ Configure Booking Items

Before creating bookings, you must first create a booking item.

Examples:

* Massage Service
* Consultation Session
* Event Registration
* Product Demo

### How to Create a Booking Item

<figure><img src="/files/xtqhng7levBXfAsBATOx" alt=""><figcaption></figcaption></figure>

1. Go to **Booking > Settings**
2. Click **Actions**
3. Select **Add New** to create a booking item

<figure><img src="/files/UrTaP9qL6RtYxrOrVEbZ" alt="" width="563"><figcaption></figcaption></figure>

1. Enter:
   * Name
   * Description
   * Required Fields
2. Click **OK**

### Required Field Types

You can define custom booking fields using the following field types:

| Type    | Description         | Examples           |
| ------- | ------------------- | ------------------ |
| String  | Text input          | Customer Name      |
| Number  | Numeric input       | Contact Number     |
| Date    | Date or date-time   | Appointment Date   |
| Boolean | True / False option | First-time Visitor |

***

## 🤖 Create Booking Automatically with AI Agent

The AI Agent can automatically collect booking information from customers and create bookings during conversations.

### Setup Steps

1. Open **Flow Builder**
2. Add an **AI Agent** block
3. Configure:
   * Role
   * Goal
   * Completion Criteria

<figure><img src="/files/j5rBSZHAlXAZWacjVbqO" alt="" width="563"><figcaption></figcaption></figure>

4. Under **Actions**, configure:

   1. Set Custom Field (optional)
   2. Set Label (optional)
   3. Select Knowledge Base (optional)
   4. Select a booking service

   <figure><img src="/files/pASCoxTIc1M8tpLtYiD5" alt="" width="563"><figcaption></figcaption></figure>
5. Connect with other flow blocks and save.

***

## 👤 Create Booking Manually

Agents can also manually create bookings directly from the Messages Inbox or the Booking management page.

### How to Create a Booking

1. Open a customer conversation
2. In the **Upcoming Bookings** section, click **Create**

<figure><img src="/files/fCeIlADHRV0VWciK4Plh" alt="" width="375"><figcaption></figcaption></figure>

3. Select a booking item

<figure><img src="/files/3wEmDhuZWObQx9iZUW03" alt="" width="375"><figcaption></figcaption></figure>

3. Fill in the booking information
4. Click **Save**

The booking will then appear in:

* Booking list
* Customer conversation sidebar

***

## 📅 Manage Bookings

Go to **Booking > Bookings** to review all booking records.

<figure><img src="/files/NeqeYBZe60e4GyGc1rmz" alt=""><figcaption></figcaption></figure>

You can:

* Filter bookings by item
* View upcoming bookings
* Review booking status
* Open booking details

***

## ✅ Confirm or Cancel Bookings

Booking statuses can be updated either manually by agents or automatically by the system.

**Supported statuses:**

* **Pending** – The booking has been created and is awaiting confirmation.
* **Confirmed** – The booking has been confirmed by an agent. This status must be updated manually.
* **Cancelled** – The booking has been cancelled by an agent. This status must be updated manually.
* **Completed** – The booking was previously **Confirmed**, and the scheduled booking time has passed. This status is updated automatically by the system.
* **Expired** – The booking was previously **Pending**, and the scheduled booking time has passed without being confirmed. This status is updated automatically by the system.

### How to Update Booking Status

1. Open the booking record
2. Update the booking status
3. Save changes

This helps teams track appointment progress and customer confirmations.

***

## 💬 Booking Information in Messages Inbox

When a customer has an upcoming booking, the booking card will appear in the conversation sidebar.

<figure><img src="/files/C7fEWRj50n51QmRCV9ZC" alt="" width="563"><figcaption></figcaption></figure>

Agents can:

* View booking details
* Review booking status
* Open the booking record
* Create additional bookings

This allows agents to manage conversations and appointments in one place.

***

## 📝 Additional Booking Information

Booking records support:

* Remarks
* Custom fields
* Additional booking metadata

<figure><img src="/files/RLI90TngrrGKw5HuT1oA" alt="" width="563"><figcaption></figcaption></figure>

This allows teams to store extra customer or appointment information when necessary.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatalog.ai/booking/booking.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.