Tài liệu

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.

Xem Markdown

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ì.

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.