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

# Lịch sự kiện

> Lên lịch sự kiện trong XanhCard để tự động kích hoạt thông báo, cập nhật thẻ và các hành động khác vào thời điểm chính xác bạn cấu hình.

## Sự kiện là gì?

Sự kiện cho phép bạn lên lịch các hành động tự động cho thẻ — ví dụ: gửi thông báo vào ngày sinh nhật hoặc kích hoạt cập nhật vào một thời điểm cụ thể.

Khi thời gian sự kiện đến, hệ thống sẽ tự động:

* Gửi thông báo đẩy đến người dùng (nếu bật)
* Cập nhật dữ liệu trên thẻ (nếu cấu hình)

## Truy cập lịch sự kiện

Vào **Calendar Events** từ thanh điều hướng bên trái.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/01-calendar-events-empty.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=3e26d0d00fd1c4a20556dd94ebd5b445" alt="Lịch sự kiện" width="2804" height="1642" data-path="images/events/01-calendar-events-empty.png" />

## Điều hướng lịch

Sử dụng các nút điều hướng để chuyển tháng và năm:

* **Previous month**: Tháng trước
* **Next month**: Tháng sau
* **today**: Quay về ngày hiện tại

## Tạo sự kiện mới

<Steps>
  <Step title="Vào Calendar Events">
    Chọn **Calendar Events** từ thanh điều hướng.
  </Step>

  <Step title="Nhấn Create">
    Nhấn nút **Create** ở góc trên bên phải.
  </Step>

  <Step title="Cấu hình sự kiện">
    Điền thông tin trong hộp thoại **Create new event**.

    <img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/02-create-event-dialog.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=ce1a8aa3acb4725d283ef148f28d6537" alt="Hộp thoại tạo sự kiện" width="2588" height="1720" data-path="images/events/02-create-event-dialog.png" />
  </Step>

  <Step title="Nhấn Save">
    Nhấn **Save** để lưu sự kiện.
  </Step>
</Steps>

## Cấu hình sự kiện

### Event Time

* **Select Date**: Chọn ngày diễn ra sự kiện
* **Select Time**: Chọn giờ phút
* **Timezone**: Chọn múi giờ (UTC, +07:00, v.v.)

### Notification

Bật **Enable notification** để gửi thông báo đẩy đến người sở hữu thẻ.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/03-event-with-notification.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=4fe987c5a148ff584eecdb8d2d891ce4" alt="Sự kiện với thông báo" width="902" height="728" data-path="images/events/03-event-with-notification.png" />

* **Message**: Nội dung thông báo (tối đa 200 ký tự)
* **Translations**: Thêm bản dịch cho nhiều ngôn ngữ
  * **EN**: Tiếng Anh
  * **VI**: Tiếng Việt
  * Bạn có thể thêm ngôn ngữ khác bằng cách nhập mã ngôn ngữ (ví dụ: `fr`, `de`)

<Info>
  Thông báo sẽ hiển thị trên màn hình khóa của điện thoại người dùng khi đến thời gian sự kiện.
</Info>

### Event Details

* **Name**: Tên sự kiện (bắt buộc)
* **Description**: Mô tả sự kiện (tùy chọn)

### Audience

* **All passes**: Áp dụng cho tất cả thẻ được tạo trước thời gian sự kiện
* **Conditions**: (Sắp ra mắt) Áp dụng cho thẻ thỏa mãn điều kiện nhất định

### Actions

Cấu hình hành động sẽ thực hiện khi sự kiện diễn ra.

#### Tab Data

Chọn trường dữ liệu để cập nhật trên thẻ.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/05-event-data-tab.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=600d8aaa964c8ed2603824a7c9a6a5f5" alt="Tab Data" width="2624" height="1772" data-path="images/events/05-event-data-tab.png" />

* Chọn **Field Name** từ danh sách các trường có sẵn:
  * `firstName`, `lastName`, `mainEmail`, `mainPhone`
  * `organizationName`, `positionTitle`, `title`
  * `address`, `website`, `notes`
  * `avatar`, `logo`, `qr_code`
* Nhập **Value**: Giá trị mới cho trường đó
* Nhấn **Add field** để thêm nhiều trường

#### Tab Code

Nhập JSON object tùy chỉnh để cập nhật dữ liệu.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/04-event-code-tab.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=3cb2e926683caaa4176ff10b03c6035c" alt="Tab Code" width="2625" height="1772" data-path="images/events/04-event-code-tab.png" />

```json theme={null}
{
  "status": "active",
  "tier": "gold"
}
```

## Chỉnh sửa sự kiện

Nhấn vào sự kiện trên lịch để mở hộp thoại chỉnh sửa.

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/07-edit-event-dialog.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=09bd43e8908bff82a9c5c116e83529dd" alt="Chỉnh sửa sự kiện" width="2577" height="1720" data-path="images/events/07-edit-event-dialog.png" />

Trong chế độ chỉnh sửa, bạn có thể:

* Thay đổi thời gian, nội dung, thông báo
* Thêm hoặc xóa hành động
* Nhấn **Save** để lưu thay đổi
* Nhấn **Delete** để xóa sự kiện

<Warning>
  Xóa sự kiện sẽ hủy bỏ tất cả hành động và thông báo đã lên lịch.
</Warning>

## Xem sự kiện trên lịch

Sau khi tạo, sự kiện sẽ hiển thị trên lịch với định dạng:

```
[HH:MM] Tên sự kiện
```

Ví dụ: `[04:28] Chiến dịch khuyến mãi hè`

<img src="https://mintcdn.com/xanhcard/oMUUuAnumaWwVH74/images/events/06-calendar-with-event.png?fit=max&auto=format&n=oMUUuAnumaWwVH74&q=85&s=e598192955a0bef0c444d70567a50f80" alt="Lịch có sự kiện" width="3360" height="1974" data-path="images/events/06-calendar-with-event.png" />

## Ví dụ sử dụng

### Gửi thông báo khuyến mãi

<Steps>
  <Step title="Tạo sự kiện">
    Đặt tên "Chiến dịch khuyến mãi hè"
  </Step>

  <Step title="Chọn thời gian">
    Chọn ngày và giờ bắt đầu khuyến mãi
  </Step>

  <Step title="Bật thông báo">
    Nhập: "Khuyến mãi hè đã bắt đầu! Giảm 50% tất cả sản phẩm."
  </Step>

  <Step title="Chọn đối tượng">
    Chọn "All passes" để gửi đến tất cả người dùng
  </Step>

  <Step title="Lưu">
    Nhấn **Save**
  </Step>
</Steps>

### Cập nhật trạng thái thẻ

<Steps>
  <Step title="Tạo sự kiện">
    Đặt tên "Nâng cấp lên hạng Vàng"
  </Step>

  <Step title="Chọn thời gian">
    Chọn ngày nâng cấp
  </Step>

  <Step title="Thêm hành động">
    Trong tab **Data**, chọn trường `title` và nhập giá trị "Hội viên Vàng"
  </Step>

  <Step title="Lưu">
    Nhấn **Save**
  </Step>
</Steps>

<Tip>
  Bạn có thể tạo nhiều sự kiện trong cùng một ngày. Các sự kiện sẽ thực hiện theo thời gian đã lên lịch.
</Tip>