Thiết lập tích hợp Jira và Confluence
Role: Project Manager 📋
Kết nối AIPD với Jira và Confluence để đồng bộ ticket, đẩy artifact AI sinh ra vào đúng dự án Jira, và kéo trang Confluence vào Knowledge Base làm ngữ cảnh cho AI Agent.
Hướng dẫn thao tác
Trong sidebar, chọn Integration Hub thuộc nhóm Project Management.
Trang hiển thị hai tab: JIRA và CONFLUENCE. Mỗi tab có cấu trúc giống nhau — bên trái là panel cấu hình kết nối, bên phải là danh sách dữ liệu đã đồng bộ.
Tích hợp Jira
Chọn tab JIRA.
Bước 1: Chọn project
Nhấn dropdown "Project" ở góc trên để chọn project cần cấu hình tích hợp.
Bước 2: Điền thông tin kết nối
Panel Configuration bên trái hiển thị form với các trường:
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Friendly Name | Có | Tên hiển thị cho integration này (ví dụ: Product Engineering) |
| Project Key | Có | Mã project Jira đích (ví dụ: WEB, PROJ) |
| Jira Version | Có | Chọn: Jira 9 (REST API v2) hoặc Jira 10+ (REST API v3) |
| Jira Domain | Có | Domain Atlassian Cloud (ví dụ: company.atlassian.net) — không cần https:// |
| Epic Field Name | Không | Tên field custom Epic trong Jira nếu có cấu hình riêng |
| Cron Schedule | Không | Lịch tự động đồng bộ, dạng cron (ví dụ: 0 * * * * — mỗi giờ) |
| API Token | Có | Token lấy từ Atlassian Account → Security → API tokens |
Toggle "Scan Credentials" cho phép hệ thống tự dò credentials từ kho lưu trữ an toàn — bật nếu đã cấu hình Credentials trước đó.
Bước 3: Kiểm tra kết nối
Nhấn "Test Connection". Thanh trạng thái phía dưới panel sẽ hiển thị:
Verifying...— đang kiểm traVerified(xanh) — kết nối thành côngConnection Failed(đỏ, có tooltip lỗi) — sai credentials hoặc domain
Bước 4: Lưu cấu hình
Khi kết nối thành công, nhấn "Create Connection" (lần đầu tạo) hoặc "Save Changes" (cập nhật lại). Danh sách Jira ticket tải lên ở panel bên phải.
Bảng ticket Jira hiển thị các cột: Issue Key, Issue Type, Summary, Status, Assignee. Nhấn "Sync Tickets" để kéo dữ liệu mới nhất từ Jira về.
Tích hợp Confluence
Chọn tab CONFLUENCE và thực hiện tương tự với form kết nối:
| Trường | Bắt buộc | Ghi chú |
|---|---|---|
| Friendly Name | Có | Tên hiển thị (ví dụ: Documentation) |
| Confluence Domain | Có | Domain Atlassian Cloud (ví dụ: company.atlassian.net) |
| Space Key | Có | Mã Space Confluence làm nguồn knowledge base (ví dụ: DOC, PROJ) |
| Confluence Version | Không | Chọn: Confluence 8 (v1), Confluence 8.5, hoặc Confluence 9+ (v2) |
| User Email | Có | Email tài khoản Atlassian dùng để xác thực |
| API Token | Có | Token Atlassian (cùng nguồn với Jira) |
Sau khi lưu thành công, panel bên phải hiển thị cây phân cấp trang Confluence. Nhấn "Sync Pages" để đồng bộ nội dung mới nhất vào Knowledge Base. Dùng ô "Filter pages..." và nút Expand All / Collapse All để điều hướng cây.
Cập nhật hoặc kiểm tra lại kết nối
Chỉnh sửa bất kỳ trường nào → nhấn "Test Connection" để xác minh lại → nhấn "Save Changes". Nút sẽ đổi label thành "Retest" sau khi đã xác minh thành công, hoặc "Retry" nếu kết nối thất bại.
Không chia sẻ API Token qua chat hoặc commit vào Git. Token được AIPD lưu mã hoá; chỉ tài khoản có quyền Update trên màn hình Integration Hub mới thao tác được.
Sau khi tích hợp xong, chuyển sang bước 02 — Thiết lập quyền truy cập project để phân quyền thành viên vào project.