GitHub
Xác minh tài khoản GitHub của một thành viên ngay trong ticket bằng bước Xác thực GitHub.
Bước Xác thực GitHub
Bước Xác thực GitHub kết nối một thành viên Discord với một tài khoản GitHub đã được xác minh — rất phù hợp cho các cộng đồng lập trình, dự án mã nguồn mở và bất kỳ ai bán hoặc hỗ trợ mã nguồn.
Loại bước này là một tính năng premium. Bạn không cần tự tạo GitHub App hay ứng dụng OAuth nào.
Ai Nên Sử Dụng
- Các dự án mã nguồn mở muốn đối chiếu báo cáo lỗi với một người dùng GitHub thực sự
- Các nhóm muốn dành mức hỗ trợ khác nhau cho nhà tài trợ hoặc cộng tác viên
- Người bán cung cấp quyền truy cập kho lưu trữ riêng sau khi mua hàng
- Các cộng đồng vận hành vai trò "nhà phát triển đã xác minh"
Dữ Liệu Được Lưu Lại
| Field | Example | Description |
|---|---|---|
github_id | 1234567 | ID người dùng GitHub dạng số, cố định |
github_username | octocat | Tên đăng nhập GitHub tại thời điểm xác minh |
> Xác minh GitHub: `octocat` (`1234567`)Tên người dùng GitHub có thể thay đổi và thậm chí bị người khác chiếm lại. ID dạng số không bao giờ thay đổi — hãy dùng nó bất cứ khi nào bạn lưu trữ thứ gì đó lâu dài.
Trải Nghiệm Của Thành Viên
Bước này hiển thị nút Login cùng logo GitHub.
Trang cấp quyền của GitHub mở ra và yêu cầu cấp cho TicketWave phạm vi read:user.
Sau khi thành viên cấp quyền, GitHub sẽ chuyển họ trở lại và TicketWave đọc hồ sơ công khai.
Trang xác nhận xuất hiện và ticket tiếp tục với bước tiếp theo.
read:user là phạm vi chỉ đọc đối với dữ liệu hồ sơ. TicketWave không thể đọc kho lưu trữ riêng, không thể đẩy mã và không thể hành động thay mặt thành viên.
Cấu Hình Bước Này
Mở module Ticket Steps
Server dashboard → Settings → Ticket Steps → Configure.
Tạo bước
| Field | Suggestion |
|---|---|
| Step Title | Connect your GitHub account |
| Step Description | We use your GitHub account to link this ticket to your issues and contributions. |
| Step Type | GitHub Authentication |
| Required Step | Tùy trường hợp — với báo cáo lỗi thì có, với câu hỏi chung thì không |
Đặt tùy chọn khi phù hợp
Tắt Required Step và TicketWave sẽ thêm nút ⏭️ Skip. Thành viên không có tài khoản GitHub vẫn có thể mở ticket, và phần tóm tắt sẽ hiển thị ⏭️ Skipped để nhân viên biết vì sao trường đó trống.
Kiểm tra thử
Mở một ticket và chạy qua luồng này một lần.
Khắc Phục Sự Cố
| Problem | Cause | Fix |
|---|---|---|
| Bước không xuất hiện | Premium chưa kích hoạt hoặc bước nằm trên giới hạn miễn phí | Kiểm tra trang Premium và thứ tự các bước của bạn |
| "Token invalid or expired" | Đã quá 10 phút | 🔁 Renew Token, rồi Login lại |
| GitHub hiển thị "already authorized" và bỏ qua màn hình | Thành viên đã cấp quyền cho TicketWave trước đó | Hoàn toàn bình thường — đăng nhập chỉ nhanh hơn thôi |
| Thành viên không muốn cấp quyền | Không có gì được lưu | Hãy đặt bước này là tùy chọn để họ có thể bỏ qua |
Các Bước Tiếp Theo
- Authentication Overview
- Button Steps (Hỏi phiên bản bị ảnh hưởng ngay sau khi đăng nhập)
- LunAI (Để AI tóm tắt các báo cáo lỗi dài)
How is this guide?