Tiện ích trình duyệt CaptchaSonic là cách đơn giản nhất để giải CAPTCHA khi duyệt web thủ công hoặc trong các framework tự động hóa như Selenium. Hướng dẫn này bao gồm cách cài đặt và cấu hình cho tất cả các trình duyệt được hỗ trợ.

---

## 🚀 Tính năng chính

*   **Giải không cần click**: Tự động phát hiện và bắt đầu giải hầu hết các loại CAPTCHA phổ biến.
*   **Chế độ ẩn**: Hoạt động ở nền mà không che khuất màn hình của bạn.
*   **Tương thích rộng**: Hỗ trợ reCAPTCHA (v2/v3/Invisible), hCaptcha, GeeTest và nhiều loại khác.
*   **Danh sách chặn**: Xác định các domain cụ thể mà bạn muốn tắt tính năng giải tự động.

---

## 1. Điều kiện cần

Trước khi cài đặt, bạn cần có:
1.  Một [tài khoản CaptchaSonic](https://captchasonic.com).
2.  Một **API Key** từ [Bảng điều khiển](https://captchasonic.com/app) của bạn.

> [!IMPORTANT]
> API key của bạn là riêng tư. Không bao giờ chia sẻ hoặc đưa nó lên kho lưu trữ công khai.

---

## 2. Cài đặt

### Đối với Google Chrome

Vì tiện ích của chúng tôi thường xuyên được cập nhật với các mô hình AI mới, chúng tôi khuyến nghị cài đặt phiên bản "unpacked" để có các tính năng mới nhất.

1.  **Cài từ Store**: Cách dễ nhất — thêm trực tiếp từ [Chrome Web Store](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh).

Hoặc để dùng bản build mới nhất chưa phát hành:

1.  **Tải về**: Lấy tệp ZIP tiện ích mới nhất từ [GitHub Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) của chúng tôi.
2.  **Giải nén**: Giải nén thư mục đã tải vào một vị trí cố định trên ổ đĩa.
3.  **Quản lý tiện ích**: Mở Chrome và vào `chrome://extensions/`.
4.  **Developer Mode**: Bật công tắc **Developer Mode** ở góc trên bên phải.
5.  **Load Unpacked**: Nhấp nút **Load unpacked** và chọn thư mục đã giải nén.

![Các bước cài đặt tiện ích Chrome](/guides/BE/guide.7.png)

### Đối với Mozilla Firefox

1.  **Cài từ Store**: Thêm trực tiếp từ [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/).

Hoặc cài thủ công từ tệp `.xpi`:

1.  **Tải về**: Lấy tệp `.xpi` từ [GitHub Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) của chúng tôi.
2.  **Menu Add-ons**: Mở Firefox, nhấp nút menu (ba gạch), và chọn **Add-ons and Themes**.
3.  **Cài từ tệp**: Nhấp biểu tượng bánh răng phía trên danh sách tiện ích và chọn **Install Add-on From File...**.
4.  **Xác nhận**: Chọn tệp `.xpi` và nhấp **Add**.

---

## 3. Cấu hình

Sau khi cài đặt, nhấp biểu tượng CaptchaSonic trên thanh công cụ trình duyệt để mở popup cài đặt.

1.  **Xác thực**: Dán **API Key** của bạn vào ô đầu tiên và nhấp **Save**.
2.  **Bật module**: Bật các loại CAPTCHA bạn muốn giải tự động.
3.  **Tùy chọn nâng cao**:
    *   **Solving Delay**: Đặt độ trễ nếu bạn muốn hành vi giống người hơn.
    *   **Auto-Submit**: Tự động nhấp "Verify" sau khi thử thách được giải.

![Giao diện cài đặt tiện ích](/guides/BE/guide.17.png)

---

## 4. Sử dụng

Tiện ích được thiết kế theo kiểu "cài một lần, dùng mãi".

*   **Phát hiện**: Khi bạn truy cập trang có CAPTCHA, biểu tượng tiện ích sẽ đổi trạng thái để báo đã tìm thấy thử thách.
*   **Trạng thái**: Một huy hiệu trạng thái nhỏ có thể xuất hiện gần widget CAPTCHA để hiển thị tiến trình giải.
*   **Hoàn thành**: Khi đã giải xong, tiện ích sẽ điền token kết quả và, nếu được cấu hình, gửi form.

---

## 5. Khắc phục sự cố (FAQ)

**Q: Tiện ích không giải được CAPTCHA.**
*   A: Kiểm tra [Bảng điều khiển](https://captchasonic.com/app) để đảm bảo bạn còn đủ credit. Xác nhận API key đã được dán đúng trong cài đặt.

**Q: Tôi gặp lỗi "Low Score" với reCAPTCHA v3.**
*   A: reCAPTCHA v3 phụ thuộc vào lịch sử trình duyệt và uy tín IP của bạn. Hãy thử dùng proxy chất lượng cao hoặc xóa bộ nhớ đệm trình duyệt.

**Q: Chrome báo tiện ích bị "corrupted".**
*   A: Thường xảy ra khi bạn di chuyển thư mục tiện ích sau khi đã tải vào. Chỉ cần gỡ bỏ tiện ích khỏi `chrome://extensions/` và nhấp "Load unpacked" lại.

---

## 6. Hỗ trợ

Nếu gặp sự cố kéo dài, hãy liên hệ đội ngũ kỹ thuật qua live chat trên [Bảng điều khiển chính thức](https://captchasonic.com/app).

---

> [!TIP]
> **Lưu ý cho nhà phát triển**: Thu thập dữ liệu với khối lượng lớn? Hãy cân nhắc dùng [REST API](/docs/api) của chúng tôi thay cho tiện ích trình duyệt để có thông lượng cao hơn đáng kể.
