Hướng dẫn dùng Siz với trợ lý AI

Dành cho người muốn nhờ trợ lý AI (Claude, ChatGPT…) tìm và đặt vé xem phim, vé máy bay qua Siz. Trợ lý lo phần tìm kiếm và giữ chỗ; bạn luôn là người quyết định và tự thanh toán.

Bạn là lập trình viên của một cửa hàng bán vé? Xem hướng dẫn tích hợp cho cửa hàng.

1. Siz là gì?

Siz (AI Gateway) là cổng kết nối giữa trợ lý AI của bạn và các cửa hàng bán vé như rạp chiếu phim hay hãng bay. Trợ lý kết nối với Siz theo chuẩn MCP; Siz thay trợ lý gọi tới cửa hàng, trong đúng phạm vi bạn cho phép.

Qua Siz, trợ lý có thể:

  • tìm suất chiếu, chuyến bay và xem giá;
  • xem ghế còn trống;
  • giữ chỗ tạm thời cho bạn (tạo đơn giữ chỗ);
  • hiện thẻ thanh toán để bạn chọn cách trả tiền;
  • hiện vé của bạn sau khi cửa hàng xác nhận đã nhận tiền.

Những việc trợ lý và Siz không làm:

  • không thanh toán thay bạn và không giữ tiền của bạn;
  • không biết mật khẩu tài khoản cửa hàng của bạn;
  • không nhận ngày sinh hay số hộ chiếu của hành khách: những thông tin này bạn chỉ nhập trên trang của hãng bay.

2. Kết nối Siz với trợ lý AI

Mọi trợ lý AI đều kết nối tới Siz bằng cùng một địa chỉ, luôn kết thúc bằng /mcp:

Địa chỉ kết nối
https://app.sicenz.com/mcp

claude.ai

  1. Mở claude.ai, vào Settings → Connectors.
  2. Chọn Add custom connector.
  3. Đặt tên, ví dụ Siz, và dán địa chỉ https://app.sicenz.com/mcp, rồi lưu.
  4. Bấm Connect. Trình duyệt mở trang đăng nhập Siz.
  5. Nhập email của bạn, mở hộp thư lấy mã OTP 6 số rồi nhập mã.
  6. Trang cho phép hiện tên ứng dụng, các quyền ứng dụng xin và danh sách cửa hàng. Bấm Liên kết tài khoản cạnh cửa hàng bạn muốn dùng (xem mục 4), chọn quyền rồi bấm Đồng ý.
  7. Quay lại claude.ai: connector đã sẵn sàng. Hãy thử nhờ trợ lý tìm một suất chiếu.

Claude Code

Thêm Siz làm máy chủ MCP rồi đăng nhập:

Terminal
claude mcp add --transport http aig https://app.sicenz.com/mcp
claude mcp login aig

Thay cho claude mcp login aig, bạn cũng có thể gõ /mcp trong Claude Code rồi chọn máy chủ aig. Trình duyệt mở trang Siz: đăng nhập bằng mã gửi qua email, liên kết cửa hàng và đồng ý như trên claude.ai.

Nếu Siz được khai báo trong tệp .mcp.json của một dự án, Claude Code sẽ hỏi bạn có tin các máy chủ MCP của dự án đó không. Hãy đồng ý lời hỏi này trước; chưa đồng ý thì máy chủ chưa hiện ra để đăng nhập.

Đăng nhập lại sau này vẫn an toàn: kết nối cũ được dùng lại, các chỗ bạn đang giữ vẫn còn trong danh sách.

ChatGPT

ChatGPT chỉ cho thêm connector tuỳ chỉnh ở gói trả phí và khi bật chế độ nhà phát triển (developer mode). Cách làm tương tự claude.ai: thêm connector với địa chỉ https://app.sicenz.com/mcp, rồi đăng nhập và đồng ý trên trang Siz.

Siz chưa được kiểm thử với ChatGPT, nên các bước và giao diện có thể khác.

3. Quyền của ứng dụng

Trên trang cho phép, bạn chọn quyền cho từng ứng dụng AI:

Xem thông tin read
Tìm kiếm, xem giá, ghế trống, xem đơn và vé của bạn.
Xem giá và báo giá quote
Hiện được dành sẵn cho sau này: chưa có chức năng nào cần riêng quyền này, và nó không cho phép giữ chỗ hay tạo đơn.
Giữ chỗ và tạo đơn thanh toán transact
Giữ chỗ tạm thời, đổi hoặc trả chỗ đang giữ, và chọn cách thanh toán cho đơn. Bạn quyết định: đánh dấu Cho phép giữ ghế và tạo đơn đặt vé trên trang cho phép. Ô này chỉ được đánh dấu sẵn cho ứng dụng đăng nhập qua một nền tảng AI quen thuộc (như claude.ai hay chatgpt.com) hoặc được Siz duyệt; với ứng dụng khác, hãy xem dòng “Ứng dụng này đăng nhập qua” và chỉ đánh dấu nếu bạn tin tưởng ứng dụng tại địa chỉ đó.

Kể cả khi có quyền transact, AI không bao giờ thanh toán thay bạn. Bạn tự chuyển khoản trong ứng dụng ngân hàng hoặc trả trên trang thanh toán.

Tên ứng dụng hiện trên trang cho phép là do chính ứng dụng tự khai. Địa chỉ ở dòng “Ứng dụng này đăng nhập qua” là nơi Siz gửi kết quả đồng ý của bạn và không thể giả mạo. Nhãn “được Siz duyệt” chỉ nói Siz đã xem xét ứng dụng cho việc giữ chỗ và tạo đơn.

4. Liên kết tài khoản cửa hàng

Để đơn giữ chỗ và vé đứng đúng tên bạn, Siz cần biết tài khoản của bạn ở cửa hàng. Bạn liên kết một lần cho mỗi cửa hàng, ngay trên trang cho phép:

  1. Bấm Liên kết tài khoản cạnh tên cửa hàng.
  2. Trình duyệt mở trang /agent-link trên website của cửa hàng. Đăng nhập bằng tài khoản cửa hàng của bạn nếu được hỏi.
  3. Trang hỏi bạn có đồng ý cho Siz liên kết với tài khoản đó không. Bấm Đồng ý.
  4. Bạn được đưa về trang cho phép của Siz, cửa hàng hiện “đã liên kết”.

Mật khẩu cửa hàng chỉ nhập trên website của cửa hàng; Siz không nhìn thấy. Trợ lý chỉ dùng được những cửa hàng bạn đã liên kết và đã chọn khi đồng ý.

5. Đặt vé và thanh toán

Nhờ trợ lý tìm và giữ chỗ

Cứ nói bằng tiếng Việt như khi nhắn cho người thật, ví dụ:

  • “Tối nay có suất Mưa Đỏ nào ở CGV Vincom Đồng Khởi không? Tôi cần 2 ghế giữa, gần cuối rạp.”
  • “Tìm chuyến bay Sài Gòn đi Hà Nội sáng thứ Bảy cho 1 người, so giá đã gồm thuế phí.”
  • “Giữ giúp tôi ghế F7 và F8 suất 19:30.”
  • “Tôi muốn chuyển khoản VietQR.”

Trợ lý đọc sơ đồ ghế, rồi giữ chỗ khi bạn đồng ý. Giữ chỗ chưa phải là mua: chưa ai bị trừ tiền.

Thẻ thanh toán trong khung chat

Sau khi giữ chỗ, khung chat hiện một thẻ gồm: tên phim hoặc chuyến bay, ghế, tổng tiền, thời gian giữ chỗ còn lại và các nút chọn phương thức thanh toán. Bạn bấm trên thẻ, hoặc nhắn trợ lý phương thức muốn dùng. Nếu cửa hàng chỉ có một phương thức, thẻ tự chọn phương thức đó.

Chuyển khoản VietQR

  1. Mở ứng dụng ngân hàng của bạn và quét mã QR trên thẻ.
  2. Giữ nguyên số tiền và nội dung chuyển khoản mà ứng dụng ngân hàng điền sẵn. Cửa hàng dựa vào nội dung chuyển khoản để biết khoản tiền thuộc đơn nào; nếu nhập tay, hãy gõ chính xác từng ký tự.
  3. Trước khi xác nhận, kiểm tra tên người nhận khớp với tên cửa hàng hiện trên thẻ.
  4. Chuyển tiền. Thẻ tự cập nhật khi cửa hàng xác nhận đã nhận tiền.

Liên kết thanh toán

Với phương thức như thẻ quốc tế hay ví điện tử, thẻ hiện nút Mở trang thanh toán và một mã QR để mở trang đó trên điện thoại. Bạn trả tiền trên trang của nhà cung cấp thanh toán. Siz chỉ hiện liên kết tới những địa chỉ cửa hàng đã đăng ký trước với Siz.

Thời gian giữ chỗ

Chỗ chỉ được giữ trong thời gian ngắn, tuỳ cửa hàng (thường khoảng 10 phút với vé phim, 15 phút với vé máy bay). Lần đầu chọn phương thức thanh toán, cửa hàng có thể gia hạn thêm tối đa 5 phút, nhưng không quá 20 phút kể từ lúc giữ chỗ. Thẻ hiện đồng hồ đếm ngược “Giữ chỗ còn …”. Hết giờ mà chưa trả, chỗ được trả lại và thẻ báo “Hết thời gian giữ chỗ”; hãy nhờ trợ lý đặt lại. Nếu bạn vừa trả tiền sát giờ, bấm Kiểm tra lại trên thẻ trước khi đặt lại.

Bạn có thể bấm Đổi phương thức cho tới khi trả tiền. Khi đổi, hướng dẫn cũ (mã QR, nội dung chuyển khoản, liên kết cũ) hết hiệu lực: đừng trả theo hướng dẫn cũ.

Vé máy bay: nhập hành khách trước

Với vé máy bay, thẻ hiện “Cần nhập thông tin hành khách” và nút Nhập thông tin hành khách. Nút này mở trang của hãng bay: đăng nhập, nhập thông tin từng hành khách và lưu. Sau đó thẻ hiện các cách thanh toán với tổng tiền cuối cùng. Thông tin hành khách chỉ nằm ở hãng bay; trợ lý và Siz không nhận.

Ứng dụng không hiện thẻ

Một số ứng dụng (ví dụ Claude Code) không hiện được thẻ. Khi đó trợ lý ghi các thông tin như trên bằng chữ: ngân hàng, số tài khoản, tên người nhận, số tiền chính xác và nội dung chuyển khoản, hoặc tên nhà cung cấp và liên kết thanh toán; đôi khi kèm ảnh mã QR. Bạn làm theo giống hệt như với thẻ.

6. Nhận và dùng vé

Khi cửa hàng xác nhận đã nhận tiền, thẻ chuyển sang Đã thanh toán rồi hiện vé: mã đặt chỗ, mã QR vào cửa, thời gian, rạp, phòng và ghế (vé phim) hoặc chuyến bay, hành trình, hành khách và hạng vé (vé máy bay).

  • Vé đã được quét ở cổng mang dấu ĐÃ SỬ DỤNG; vé bị huỷ mang dấu ĐÃ HUỶ.
  • Muốn xem lại vé, chỉ cần hỏi trợ lý: “Vé của tôi đâu?”
  • Nút Xem vé trên trang nhà cung cấp mở trang vé trên website của cửa hàng (cần đăng nhập tài khoản cửa hàng).
  • Mã QR vào cửa chỉ dùng được một lần: ai quét trước thì người đó vào. Đừng gửi mã hay ảnh chụp mã cho người khác. Trợ lý cũng không đọc hay chép lại mã này.

7. Mẹo khi dùng claude.ai

claude.ai hỏi bạn trước mỗi lần connector dùng một công cụ. Thẻ thanh toán tự kiểm tra trạng thái đơn vài giây một lần (công cụ get_checkout) và tự tải vé (get_ticket), nên nếu lần nào cũng phải bấm cho phép thì thẻ khó tự cập nhật.

Hãy chọn Always allow cho các công cụ chỉ đọc: get_checkout, get_ticket, search_offers, get_seatmap, list_checkouts. Các công cụ thay đổi đơn (create_checkout, update_checkout, select_payment_method, cancel_checkout) bạn có thể để claude.ai hỏi mỗi lần.

8. Quản lý kết nối

Trang Kết nối của tôi liệt kê các ứng dụng AI đã kết nối, quyền và cửa hàng của từng ứng dụng.

  • Bấm Thu hồi để ngắt một ứng dụng: ứng dụng không dùng được tài khoản của bạn nữa, ngay lập tức.
  • Các chỗ ứng dụng đã giữ trước đó không bị huỷ; chúng tự hết hạn sau thời gian giữ chỗ.
  • Muốn dùng lại, chỉ cần kết nối lại từ trợ lý AI.
  • Bấm Tắt quyền đặt vé để chỉ lấy lại quyền giữ ghế và tạo đơn: ứng dụng vẫn giữ các quyền khác. Quyền truy cập ứng dụng đang có có thể còn dùng được tối đa một giờ. Muốn cho phép đặt vé lại, hãy kết nối lại từ trợ lý AI và đánh dấu ô đó.

9. An toàn

  • Không bao giờ gõ số thẻ, mã CVV, mật khẩu hay mã OTP ngân hàng vào khung chat. Siz không bao giờ hỏi những thông tin này.
  • Chỉ coi là đã thanh toán khi thẻ hoặc trợ lý báo cửa hàng đã xác nhận, không phải khi trợ lý đoán là xong.
  • Luôn kiểm tra tên người nhận trong ứng dụng ngân hàng trước khi chuyển tiền, và kiểm tra địa chỉ trang thanh toán trước khi nhập thẻ.
  • Nếu thấy hướng dẫn thanh toán lạ, không khớp với cửa hàng, hãy dừng lại và hỏi cửa hàng.

10. Hỏi đáp

AI có tự trừ tiền của tôi không?

Không. Siz và trợ lý không thanh toán thay bạn. Mọi khoản tiền đều do bạn tự chuyển hoặc tự trả.

Tôi đã chuyển khoản mà thẻ vẫn chưa báo đã thanh toán?

Thẻ chỉ đổi khi cửa hàng xác nhận đã nhận tiền. Đợi thêm một lúc rồi bấm Kiểm tra lại hoặc nhờ trợ lý kiểm tra. Đừng chuyển thêm lần nữa. Nếu vẫn không được, liên hệ cửa hàng kèm biên lai chuyển khoản.

Tôi trả tiền sau khi đã hết thời gian giữ chỗ thì sao?

Chỗ có thể đã được trả lại cho người khác. Hãy liên hệ cửa hàng: khoản trả muộn được xử lý theo quy trình hoàn tiền của cửa hàng.

Vì sao trợ lý của tôi không giữ chỗ được?

Có thể bạn chưa đánh dấu “Cho phép giữ ghế và tạo đơn đặt vé” khi đồng ý (hoặc đã tắt sau đó), Siz đã tắt quyền đặt vé của ứng dụng đó, hoặc bạn chưa liên kết tài khoản với cửa hàng. Xem lại mục 3 và mục 4.

Tôi có phải đưa số hộ chiếu cho AI không?

Không. Thông tin hành khách chỉ nhập trên trang của hãng bay.

Tôi đổi ý sau khi đã chọn chuyển khoản được không?

Được, cho tới khi trả tiền: bấm Đổi phương thức hoặc nhắn trợ lý. Hướng dẫn cũ hết hiệu lực.

Làm sao huỷ vé đã mua?

Trợ lý chỉ trả lại được chỗ đang giữ chưa thanh toán. Vé đã mua được huỷ và hoàn tiền theo chính sách của cửa hàng, trên website của cửa hàng.