Hướng dẫn AI Web

Dùng AI coding agent (Codex, Claude Code, Cursor…) để điều khiển site AI Web qua API — tạo landing, đăng bài, thêm sản phẩm bằng prompt một dòng, không cần vào admin từng thao tác.

Các tình huống dùng AI Agent

Copy prompt, thay tenmien.com và nội dung cụ thể:

Việc cần làm	Prompt mẫu (1 dòng)
Tạo landing page hàng loạt Nhiều trang bán hàng / giới thiệu cùng lúc	Tạo 5 landing page trên tenmien.com: trang-chu, gioi-thieu, dich-vu-a, dich-vu-b, lien-he — mỗi trang có hero, lợi ích, CTA Zalo
Tạo sản phẩm hàng loạt Đưa danh sách SP lên shop	Thêm 10 sản phẩm vào shop tenmien.com từ file products.csv — có tên, giá, mô tả ngắn, slug
Viết chuỗi bài SEO theo từ khóa Content cluster, internal link	Viết 8 bài blog SEO trên tenmien.com theo từ khóa: [kw1], [kw2], [kw3]… — bài pillar 2000 từ, bài phụ 1200 từ, link chéo
Migrate web cũ Chuyển landing/blog từ site cũ	Migrate landing và blog từ webcu.com sang tenmien.com — bắt đầu từ https://webcu.com
Video → bài blog Dùng skill aiweb-migrate	Chế bài blog từ video YouTube [URL] rồi đăng lên tenmien.com

Hướng dẫn theo việc thực tế người quản trị hay làm — không cần đọc hết menu admin.

Kích hoạt bản quyền phần mềm

Làm đầu tiên sau khi upload site lên hosting — nhiều tính năng (cập nhật, API Agent…) chỉ chạy khi license đã active trên đúng domain.

Bước	Thao tác
1	Đăng nhập admin /login
2	Vào menu Bản quyền hoặc truy cập /activate_license
3	Nhập license key (mua tại slim.vn) → Kích hoạt
4	Kiểm tra trạng thái Đã kích hoạt — 1 key gắn 1 domain tại một thời điểm

Lấy API key

Dùng để kết nối Codex / Claude Code / Cursor Agent với site (xem thêm Phần 1).

Bước	Thao tác
1	Đã kích hoạt bản quyền trên domain đang dùng
2	Cài đặt → API Agent → Tạo API key mới
3	Đặt tên (vd: Codex) → bấm tạo → copy key aiw_… ngay (chỉ hiện một lần)
4	Bấm Kiểm tra kết nối hoặc Test key này để chắc key hoạt động

Đổi mật khẩu admin

Bước	Thao tác
1	Đăng nhập /login
2	Vào Cài đặt → Tài khoản Admin
3	Nhập mật khẩu hiện tại (nếu đã đặt trước đó), mật khẩu mới ≥ 6 ký tự, xác nhận lại → Lưu

Thiết lập cần làm trước khi mở site

Làm theo thứ tự — mỗi mục tương ứng một tab trong Cài đặt:

Khi nào cần	Tab cài đặt	Làm gì
Luôn luôn	Cài đặt chung	Chọn trang chủ mặc định (landing publish) — để tenmien.com mở đúng trang, không vào admin
Luôn luôn	Thương hiệu	Đặt tên site, upload logo, favicon — hiện trên blog, shop, tab trình duyệt
Luôn luôn	SEO	Title + mô tả mặc định, ảnh OG — Google và mạng xã hội dùng khi trang chưa có SEO riêng
Có bán hàng	Thiết lập Shop + Thanh toán	Nhập ngân hàng, STK, chủ TK → bật VietQR — khách thấy mã QR sau khi đặt hàng. Cấu hình mức VAT nếu cần
Có bán hàng	Thông báo đơn hàng	Telegram Bot + Chat ID hoặc email admin — nhận tin khi có đơn mới
Có blog	Trang xem Blog	Tiêu đề hero, CTA cuối bài (Zalo, link shop…), số bài mỗi trang
Tùy chọn	Phong cách giao diện	Chọn theme màu cho blog, shop, trang công khai

Nạp dữ liệu từ backup

Source kèm hai file trong aiweb_core/data/backups/:

File	Khi nào dùng
empty-aiweb.db	Cài mới lần đầu — trống nội dung, giữ thương hiệu + SEO + theme. Import hoặc Chuyển DB.
demo-aiweb.db	Xem demo — đủ landing, blog, shop, sản phẩm số, affiliate. Mặc định trên localhost / DEMO_MODE.

Thao tác	Chi tiết
Chuyển DB	Cài đặt → Cơ sở dữ liệu → chọn file → Áp dụng
Demo admin	Mật khẩu: Demo@AIWeb2026 — sau đó chạy install_demo_images.php nếu ảnh chưa hiện

Thêm / sửa / xóa landing page

Việc cần làm	Cách làm
Thêm trang mới	Trang web → Tạo trang mới — nhập tên, slug tự sinh → vào editor
Sửa nội dung	Trong danh sách trang, bấm Sửa → dán HTML (tab Sửa) hoặc chỉnh trực quan (tab Xem & Sửa) → Lưu trang
Chèn blog / shop	Toolbar editor: nút Blog hoặc Shop → chọn danh mục → Chèn widget → Lưu
SEO riêng từng trang	Trong editor → ⚙ Cài đặt trang → tab SEO / Schema
Xuất bản / ẩn	Trang web → bật/tắt Publish. Trang publish: https://tenmien.com/{slug}
Xóa trang	Trang web → chọn trang → Xóa (không hoàn tác — nên backup DB trước)

Việc quản trị khác (tham khảo nhanh)

Các module tùy chọn — bật khi cần. Mỗi mục gồm mục đích, thiết lập nhanh và cách dùng cơ bản.

Kết nối Telegram

Mục đích: Nhận tin ngay trên điện thoại khi có đơn hàng mới (shop vật lý + sản phẩm số) và ticket Helpdesk mới.

Bước	Thao tác
1. Tạo Bot	Mở Telegram → tìm @BotFather → /newbot → lưu Bot Token
2. Lấy Chat ID	Nhắn tin cho bot (hoặc thêm bot vào nhóm) → dùng @userinfobot / @getidsbot để lấy Chat ID
3. Cấu hình đơn hàng	Cài đặt → Thông báo đơn hàng — dán Token + Chat ID → Gửi test → Lưu
4. Ticket Helpdesk (tùy chọn)	Cài đặt → Helpdesk — nhập Telegram Chat ID riêng cho hỗ trợ (dùng chung Bot Token ở bước 3)

Khi có đơn: Telegram gửi tin kèm link quản lý (/order-access?token=… hoặc admin Đơn hàng). Khi có ticket mới: gửi qua email admin + Telegram (nếu đã cấu hình).

Sản phẩm số

Mục đích: Bán file, khóa học, license key… — khách thanh toán xong nhận link tải / key tại /digital-access.

Bước	Thao tác
1. Bật module	Cài đặt → Sản phẩm số — tick Bật module sản phẩm số → Lưu
2. Thanh toán VietQR	Tab Thanh toán — cấu hình ngân hàng (giống shop vật lý)
3. PayPal (tùy chọn)	Cùng tab Sản phẩm số — nhập PayPal Client ID + Secret, bật sandbox nếu test, tỷ giá USD/VND
4. Thêm SP	Menu Sản phẩm số — tên, giá, upload file hoặc nhập license keys, slug
5. Bán hàng	Khách mua tại /digital hoặc /digital/{slug} → VietQR hoặc PayPal → nhận email + trang bàn giao

Quản lý đơn: menu Đơn SP số — duyệt thanh toán, gửi lại email, xác nhận bàn giao.

Affiliate

Mục đích: Đối tác giới thiệu khách mua sản phẩm số, nhận hoa hồng theo % — cần module Sản phẩm số đã bật.

Bước	Thao tác
1. Bật module	Cài đặt → Affiliate — tick bật module, đặt % hoa hồng mặc định, số tiền rút tối thiểu → Lưu
2. Google OAuth	Cùng tab — nhập Client ID + Secret từ Google Cloud Console (redirect URI hiện trong form) → Test OAuth
3. Đối tác đăng nhập	Đối tác vào /aff/login → Đăng nhập bằng Gmail → portal /aff
4. Link từng SP	Trong portal, đối tác copy link giới thiệu theo từng sản phẩm số (dạng ?ref=mã hoặc /aff/mã/slug)
5. Admin duyệt	Menu Affiliate — xem hoa hồng, duyệt rút tiền

Helpdesk

Mục đích: Khách đã mua sản phẩm số gửi ticket hỗ trợ — đăng nhập Gmail, admin nhận qua email + Telegram.

Bước	Thao tác
1. Bật Helpdesk	Cài đặt → Helpdesk — tick bật, nhập email admin, Chat ID Telegram (nếu cần)
2. Google OAuth khách	Nhập Client ID/Secret (có thể dùng chung OAuth Affiliate nếu tick tùy chọn trong form)
3. Bật trên SP số	Khi thêm/sửa sản phẩm số — tick Bật Helpdesk cho từng SP cần hỗ trợ
4. Khách dùng	Vào /support → đăng nhập Gmail → chọn SP đã mua → gửi ticket
5. Admin xử lý	Menu Helpdesk — trả lời ticket; khách nhận email phản hồi

Đa ngôn ngữ (blog)

Mục đích: Khách đọc blog bằng ngôn ngữ khác — widget tự dịch nội dung bài (Google Translate), không cần viết nhiều bản.

Bước	Thao tác
1. Ngôn ngữ UI site	Cài đặt → Cài đặt chung — chọn Ngôn ngữ UI (Tiếng Việt / English) cho giao diện blog, shop
2. Widget dịch blog	Cùng tab — tick Bật Google Translate trên bài viết → Lưu
3. Khách dùng	Trên trang chi tiết bài /blog/{slug} — chọn ngôn ngữ ở dropdown 🌐 (English, 日本語, 中文…)