Hướng dẫn cài đặt extension & thiết lập

0. Cài đặt extension

Extension chưa có trên Chrome Web Store nên cần cài thủ công (an toàn, chỉ mất khoảng 1 phút):

1. Bấm Tải extension ở đầu trang để tải file .zip, rồi giải nén ra 1 thư mục.
2. Mở Chrome, vào chrome://extensions.
3. Bật công tắc Developer mode (góc trên bên phải).
4. Bấm Load unpacked, chọn đúng thư mục vừa giải nén.

Extension sẽ tự cập nhật khi bạn tải lại + "Load unpacked" lại phiên bản mới — không cần gỡ cài đặt.

1. Etsy API key (bắt buộc)

Extension gọi thẳng Etsy API bằng key của chính bạn (mô hình BYOK) — key chỉ lưu trên máy bạn, không gửi về server của chúng tôi.

1. Vào etsy.com/developers/register (cần đăng nhập tài khoản Etsy có sẵn, dùng tài khoản mua hàng hoặc tài khoản shop đều được).
2. Bấm Create a New App. Điền App name bất kỳ (chỉ bạn nhìn thấy), mô tả mục đích là dùng cá nhân để theo dõi sản phẩm, đồng ý điều khoản API rồi bấm Create App.
3. Vào trang Your Apps, bấm vào app vừa tạo — bạn sẽ thấy 2 giá trị: Keystring (chính là API key) và Shared Secret.
4. Mở popup extension → tab Keys → dán Keystring vào ô "Keystring", dán Shared Secret vào ô "Shared secret" → bấm Save.

Etsy cấp key miễn phí, giới hạn mặc định khoảng 10 request/giây và 10.000 request/ngày — đủ dùng thoải mái cho theo dõi cá nhân. Nếu popup báo "API key is invalid or has expired", kiểm tra lại đã copy đúng cả 2 giá trị chưa (không dính khoảng trắng thừa).

2. Telegram alerts (tùy chọn)

Nếu bật, extension sẽ gửi cảnh báo qua Telegram ngay khi 1 listing đang theo dõi vừa bán hết & renew — nhận được kể cả khi Chrome đang tắt. Bước này cần 2 giá trị: Bot token và Chat ID, cả hai đều tự tạo qua Telegram, không cần đăng ký gì với chúng tôi.

Bước 1 — Tạo bot, lấy Bot token

1. Mở Telegram, tìm kiếm @BotFather (tài khoản có tick xanh chính chủ Telegram).
2. Gửi lệnh /newbot.
3. BotFather hỏi tên hiển thị cho bot — nhập gì cũng được (ví dụ "Etsy Tracker Alerts").
4. BotFather hỏi tiếp username cho bot — phải kết thúc bằng chữ "bot" (ví dụ "etsy_tracker_alerts_bot"), và phải chưa ai dùng.
5. BotFather trả về 1 dòng token dạng 123456789:ABCdefGhIJKlmNoPQRstuVwxYZ — đây chính là Bot token, copy lại.

Bước 2 — Lấy Chat ID

1. Mở đúng bot vừa tạo, bấm Start để bắt đầu chat với bot (bắt buộc — bot chỉ "nhìn thấy" chat sau khi bạn nhắn trước).
2. Mở trình duyệt, truy cập https://api.telegram.org/bot<BOT_TOKEN>/getUpdates (thay <BOT_TOKEN> bằng token ở Bước 1, giữ nguyên phần "bot" phía trước).
3. Trang trả về đoạn JSON, tìm "chat":{"id":123456789,...} — con số đó chính là Chat ID của bạn. Nếu trang trả về rỗng, quay lại gửi thử 1 tin nhắn cho bot rồi tải lại trang.

Bước 3 — Nhập vào extension

1. Mở popup extension → tab Keys → bật công tắc Telegram alerts.
2. Dán Bot token và Chat ID vào 2 ô tương ứng → bấm Save.
3. Chrome sẽ hỏi xin quyền truy cập api.telegram.org — bấm Allow (quyền này chỉ được xin đúng lúc bạn bật tính năng).