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

# QR Code Generator

> Hướng dẫn tạo và quản lý mã QR Code trong ChatbotX để dẫn khách hàng trực tiếp vào kịch bản chatbot từ sản phẩm in ấn và cửa hàng.

**QR Code Generator** là công cụ giúp bạn tự động khởi tạo mã QR Code và đường liên kết truy cập nhanh (Short URL). Khi khách hàng quét mã QR bằng ứng dụng camera trên điện thoại hoặc nhấp vào link, hệ thống ChatbotX sẽ ngay lập tức kích hoạt kịch bản (Flow) tư vấn hoặc chăm sóc được cài đặt sẵn.

Đây là giải pháp tuyệt vời khi triển khai marketing offline hoặc bán hàng thực tế: in mã QR lên bao bì sản phẩm, danh thiếp, tờ rơi, bảng hiệu tại cửa hàng (standee) hay tài liệu sự kiện để thu hút khách hàng tham gia vào luồng chăm sóc tự động.

## Cách truy cập tính năng QR Code Generator

Từ thanh điều hướng bên trái của ChatbotX, chọn **Tools** và nhấn vào thẻ **QR Code Generator**.

<Frame>
  <img src="https://mintcdn.com/chatbotx/QSxjtsGeDWPApX1M/images/tools_qr_code_generator_card.png?fit=max&auto=format&n=QSxjtsGeDWPApX1M&q=85&s=88bf9e79e57191947b31b9d922094ed9" alt="Tools QR Code Generator Card" width="2370" height="1458" data-path="images/tools_qr_code_generator_card.png" />
</Frame>

## Hướng dẫn tạo mã QR Code mới

<Steps>
  <Step title="Mở cửa sổ tạo mới QR Code">
    Tại trang quản lý **QR Codes**, nhấn nút **+ Create QR Code** ở góc trên bên phải.
  </Step>

  <Step title="Điền thông tin cấu hình QR Code">
    Trong màn hình khởi tạo, bạn thiết lập các thông tin sau:

    * **Name**: Đặt tên nhận diện cho mã QR Code (ví dụ: `demo`, `qr-menu-cua-hang`, `qr-xac-nhan-don-hang`).
    * **Bot Response**: Chọn Flow (kịch bản chatbot) sẽ tự động kích hoạt khi khách hàng quét mã QR Code.
    * **Size (optional)**: Tùy chỉnh kích thước ảnh mã QR tính theo pixel (ví dụ: nhập `600` để xuất ảnh nét phục vụ in ấn chất lượng cao).
  </Step>

  <Step title="Hoàn tất khởi tạo">
    Nhấn nút **Create** để hệ thống tạo mã QR Code.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/chatbotx/QSxjtsGeDWPApX1M/images/create_qr_code_form.png?fit=max&auto=format&n=QSxjtsGeDWPApX1M&q=85&s=2f44054180f028dc318c9f64c50c4d60" alt="Create QR Code Form" width="2638" height="1232" data-path="images/create_qr_code_form.png" />
</Frame>

## Xem trước, Chỉnh sửa và Tải xuống QR Code

Sau khi khởi tạo thành công, giao diện quản lý chi tiết QR Code sẽ hiển thị gồm 2 khu vực chính:

### Chỉnh sửa thông tin

Bạn có thể điều chỉnh lại **Name**, chọn kịch bản **Bot Response** khác hoặc thay đổi **Size** ảnh bất kỳ lúc nào, sau đó nhấn **Save** để lưu cập nhật.

### Xem trước và Tải ảnh mã QR

Khu vực xem trước cung cấp đầy đủ các tiện ích:

* **Ảnh mã QR Code**: Hiển thị mã QR trực quan kèm thông điệp "Scan me with your camera".
* **Đường liên kết truy cập nhanh (Short URL)**: Cung cấp liên kết rút gọn (dạng `https://app.chatbotx.io/l/...`) đi kèm nút **Copy** (Biểu tượng sao chép) để bạn dán vào các kênh truyền thông trực tuyến.
* **Nút Download**: Tải file ảnh mã QR Code sắc nét về máy tính để gửi cho bộ phận thiết kế in ấn.

<Frame>
  <img src="https://mintcdn.com/chatbotx/QSxjtsGeDWPApX1M/images/edit_qr_code_preview.png?fit=max&auto=format&n=QSxjtsGeDWPApX1M&q=85&s=5256c5f7aece5811260be30d6dd37a5a" alt="Edit QR Code Preview" width="2639" height="1233" data-path="images/edit_qr_code_preview.png" />
</Frame>

## Quản lý danh sách QR Codes

Toàn bộ các mã QR Code đã tạo sẽ được thống kê tập trung tại trang danh sách **QR Codes**:

* **Tìm kiếm nhanh**: Sử dụng ô **Search name...** để tra cứu mã QR theo tên.
* **Thông tin chi tiết**: Bảng hiển thị rõ **Name** (Tên mã), **Bot Response** (Kịch bản phản hồi gắn kèm) và **Size** (Kích thước ảnh).
* **Thao tác nhanh**: Nhấn vào biểu tượng **...** ở cuối mỗi dòng để mở tùy chọn Chỉnh sửa (Edit) hoặc Xóa (Delete) mã QR Code.

<Frame>
  <img src="https://mintcdn.com/chatbotx/PzfG3HWuxUyRGX6t/images/qr_codes_management_list.png?fit=max&auto=format&n=PzfG3HWuxUyRGX6t&q=85&s=9f50610b9d47481755f58ed363dd3766" alt="QR Codes Management List" width="2410" height="762" data-path="images/qr_codes_management_list.png" />
</Frame>

## Trải nghiệm quét mã của khách hàng

Khi khách hàng quét mã QR Code trên sản phẩm hoặc nhấp vào đường link rút gọn, hệ thống ChatbotX sẽ hiển thị trang chuyển tiếp giao diện đa kênh (Landing Page chọn kênh):

<Frame>
  <img src="https://mintcdn.com/chatbotx/QSxjtsGeDWPApX1M/images/qr_code_channel_selection_landing.png?fit=max&auto=format&n=QSxjtsGeDWPApX1M&q=85&s=c4cc96eea3350d40989e4124ccf58e95" alt="QR Code Channel Selection Landing" width="1892" height="1445" data-path="images/qr_code_channel_selection_landing.png" />
</Frame>

1. Trang landing sẽ hiển thị danh sách các kênh nhắn tin mà doanh nghiệp hỗ trợ (như Telegram, Webchat, Facebook Messenger, WhatsApp, TikTok...).
2. Khách hàng lựa chọn ứng dụng nhắn tin quen thuộc và nhấn nút **Continue**.
3. Ứng dụng chat sẽ mở ra và Bot tự động gửi tin nhắn phản hồi theo kịch bản Flow đã được thiết lập.

## Mẹo thực tiễn và Lưu ý

<Note>
  Mã QR Code trong ChatbotX là mã QR động. Bạn có thể thay đổi kịch bản **Bot Response** khác trong phần chỉnh sửa bất kỳ lúc nào mà không làm thay đổi hình ảnh mã QR Code hay làm hỏng đường link đã in trên ấn phẩm.
</Note>

<Note>
  Khi cần in ấn trên các vật phẩm kích thước lớn như standee cửa hàng, poster hay bảng hiệu, bạn nên thiết lập **Size (optional)** từ 600px trở lên để đảm bảo hình ảnh mã QR Code không bị vỡ nét khi phóng to.
</Note>