---
title: "Báo một vấn đề cho đội Telegram-Auto"
locale: vi
url: https://tlg.builera.app/docs/agent-playbooks/report-a-problem
verified: 2026-10-27
app_version: "2.3"
---

# Báo một vấn đề cho đội Telegram-Auto

Khi gặp lỗi, thao tác rườm rà, thiếu chức năng hay có câu hỏi, gửi một ticket hỗ trợ ngắn, không chứa bí mật, rồi theo dõi trả lời.


## Mục tiêu

Bạn báo cho đội Telegram-Auto một lỗi, một chỗ rườm rà, một chức năng còn thiếu, một lỗ hổng tài liệu hoặc một câu hỏi — để đội sửa ứng dụng, không phải để làm thay việc của người dùng.

## Quyền cần

- Scope `feedback` (bật sẵn cho kết nối mới; người dùng tắt được). `whoami` cho biết ở `support.feedback_enabled`.
- Mọi vai trò kết nối đều dùng được, kể cả Chỉ xem.

## Hỏi người trước khi

Hỏi người trước khi đưa vào ticket bất kỳ dữ liệu nghiệp vụ nào của họ (tên khách, nội dung tin, tên nhóm). Không cần hỏi để báo lỗi kỹ thuật của chính bạn.

## Kiểm trước

1. Gọi `feedback.list` để xem đã có ticket cho vấn đề này chưa. Có thì dùng `feedback.append`, đừng tạo mới.
2. Giữ lại `trace_id` của các câu trả lời lỗi (tối đa 5, trong 7 ngày, cùng kết nối).

## Các bước

1. Gọi `feedback.create` với:
   - `category`: `bug`, `tool_friction`, `missing_capability`, `docs_gap`, `question`, `improvement`, `praise`, `security` hoặc `other`.
   - `title` ngắn (≤ 160 ký tự) và `description` cụ thể: đã làm gì, mong gì, thấy gì.
   - Nếu có: `related_operation` (mã thao tác), `related_trace_ids`, `expected`, `actual`, `steps_attempted`, `workaround`, `impact`.
2. Lưu `ticket_id` (dạng `TG-FB-XXXXXXXX`) trả về. Nếu `deduplicated: true`, ticket cũ đã ghi thêm một lần gặp.
3. Báo người một câu: đã gửi ticket nào, về việc gì.

> [!IMPORTANT]
> Không bao giờ đưa vào ticket: mật khẩu, mã đăng nhập, mã 2 lớp, khoá API hay khoá bot, phiên Telegram, cookie, proxy có mật khẩu, số thẻ. Ticket có những thứ đó bị từ chối cả (`feedback_secret_detected`), không lưu gì.

## Kiểm sau

- `whoami` cho biết số ticket có trả lời mới ở `support.tickets_with_updates`. Khi lớn hơn 0, gọi `feedback.list` với `updated_since` rồi `feedback.get`.
- Trạng thái `waiting_on_reporter` nghĩa là đội hỏi thêm: trả lời bằng `feedback.append`.
- Không hỏi vòng liên tục; đọc lại tối thiểu 60 giây một lần.

## Khi lỗi

| Mã | Ý nghĩa | Làm gì |
|---|---|---|
| `feedback_disabled` | Người dùng đã tắt kênh cho kết nối này | Dừng, nói với người |
| `feedback_secret_detected` | Ticket có thứ giống bí mật | Bỏ phần đó (xem `details.rejected`) rồi gửi lại |
| `feedback_quota_exceeded` | Vượt hạn mức | Chờ tới `retry_at` |
| `feedback_intake_paused` | Đội tạm dừng nhận ticket | Thử lại sau, không mất gì |
| `feedback_closed` | Ticket đã đóng | Tạo ticket mới nếu vấn đề còn |

## Điều kiện dừng

Dừng khi đã có `ticket_id` và đã báo người, khi người không muốn gửi, hoặc khi kênh bị tắt.