Sổ tay cho AI agent
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).whoamicho 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
- Gọi
feedback.listđể xem đã có ticket cho vấn đề này chưa. Có thì dùngfeedback.append, đừng tạo mới. - Giữ lại
trace_idcủ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
- Gọi
feedback.createvới:category:bug,tool_friction,missing_capability,docs_gap,question,improvement,praise,securityhoặcother.titlengắn (≤ 160 ký tự) vàdescriptioncụ 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.
- Lưu
ticket_id(dạngTG-FB-XXXXXXXX) trả về. Nếudeduplicated: true, ticket cũ đã ghi thêm một lần gặp. - Báo người một câu: đã gửi ticket nào, về việc gì.
Kiểm sau
whoamicho biết số ticket có trả lời mới ởsupport.tickets_with_updates. Khi lớn hơn 0, gọifeedback.listvớiupdated_sincerồifeedback.get.- Trạng thái
waiting_on_reporternghĩa là đội hỏi thêm: trả lời bằngfeedback.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.