Tài liệu

Tích hợp

Phản hồi từ AI — ticket hỗ trợ cho AI Agent

AI Agent báo lỗi, góp ý hoặc hỏi đội Telegram-Auto qua API/MCP; bạn đọc, trả lời và tắt được theo từng kết nối.

Xem Markdown

Khi một AI Agent (Claude, ChatGPT, Cursor, n8n…) dùng Telegram-Auto qua kết nối AI mà gặp lỗi, thấy thao tác rườm rà, thiếu chức năng hoặc có câu hỏi, nó gửi được một ticket hỗ trợ cho đội Telegram-Auto. Mỗi ticket có mã dạng TG-FB-XXXXXXXX.

Agent gửi khi nào

  • Một thao tác lỗi lặp lại, hoặc trả kết quả khác tài liệu.
  • Phải gọi nhiều bước cho một việc đáng lẽ đơn giản.
  • Thiếu một chức năng cần cho việc bạn giao.
  • Tài liệu thiếu hoặc sai; có câu hỏi về cách dùng.

Agent không phải gửi sau mỗi lệnh. Nó chỉ được nhắc khi gặp lỗi, khi tìm không thấy công cụ, hoặc ở lần gọi whoami đầu.

Không bao giờ gửi gì

Ứng dụng kiểm từng ticket trước khi lưu. Nếu thấy mật khẩu, mã đăng nhập, mã 2 lớp, khoá API (tga_…), khoá bot, phiên Telegram, cookie, thông tin proxy có mật khẩu hoặc số thẻ, cả ticket bị từ chối với mã feedback_secret_detected — không có gì được lưu. Số điện thoại, email, địa chỉ IP, @tên và phần sau dấu ? của link được che thành [phone], [email], [ip], [handle], [query].

Agent cũng không được chép tin nhắn của khách vào ticket nếu bạn chưa cho phép.

Ai thấy ticket

Ai Thấy gì
Kết nối AI đã gửi Ticket của chính nó, trả lời công khai, trạng thái
Chủ và Quản lý workspace Mọi ticket của workspace, trả lời công khai
Đội Telegram-Auto Mọi ticket, kèm ghi chú nội bộ

Nhân viên và Người xem không thấy tab này. Ghi chú nội bộ của đội Telegram-Auto không bao giờ hiện cho AI hay workspace.

Xem và trả lời

  1. Mở Cài đặt → Kết nối AI → Phản hồi từ AI.

  2. Lọc theo trạng thái (Đang mở, Chờ bạn, Đã xử lý, Đã đóng), loại hoặc kết nối; tìm theo mã hay tiêu đề.

    Tab Phản hồi từ AI với danh sách ticket, bộ lọc trạng thái, loại và kết nối
    Phản hồi từ AI

  3. Bấm một dòng để mở ticket. Chữ do AI viết hiện dạng chữ thuần — không có link hay định dạng tự tạo.

  4. Gõ ở ô Bổ sung thông tin rồi Gửi. AI thấy phần bổ sung ở lần gọi sau.

  5. Không cần nữa thì bấm Rút phản hồi: ticket đóng với kết quả "Đã rút".

Chi tiết một ticket: nội dung AI gửi, dòng thời gian có câu hỏi của đội hỗ trợ và ô bổ sung thông tin
Chi tiết ticket

"Chờ bạn" nghĩa là đội Telegram-Auto đang hỏi thêm. Bạn hoặc AI trả lời đều được; chuông báo khi đội trả lời hay hỏi thêm.

Bật / tắt theo từng kết nối

  • Kết nối mới: ô Cho AI gửi phản hồi và báo lỗi bật sẵn (ở hộp tạo kết nối và màn Đồng ý OAuth).
  • Kết nối có sẵn: bật sẵn một lần khi ra mắt kênh này.
  • Tắt bằng ô đó trong hộp sửa kết nối, hoặc công tắc Cho kết nối này gửi phản hồi trong ticket. Nút nhanh quyền không ghi đè ô này.

Khi tắt, AI nhận feedback_disabled nếu thử gửi; ticket cũ vẫn còn.

Vòng đời

Trạng thái Nghĩa
Mới Vừa nhận
Đã tiếp nhận / Đã lên kế hoạch / Đang làm Đội đang xử lý
Chờ bạn Đội hỏi thêm thông tin
Đã xử lý Có kết luận: đã sửa, đã trả lời, từ chối, trùng, không tái hiện được
Đã đóng Kết thúc
  • Đã xử lý 14 ngày mà không ai bổ sung → tự đóng.
  • Chờ bạn 30 ngày không ai trả lời → tự đóng với kết quả "Không phản hồi".
  • Đóng 90 ngày → ticket và dòng thời gian bị xoá; chỉ còn số đếm tuần ẩn danh.
  • AI đọc ticket đã đóng trong 30 ngày; sau đó chỉ người workspace còn thấy.

Hạn mức

Việc Giới hạn
Tạo ticket 10 / phút và 100 / ngày (mỗi kết nối và mỗi workspace)
Bổ sung 5 / phút và 30 / ngày mỗi kết nối, 100 / ngày mỗi workspace
Đọc 30 / phút mỗi kết nối

Cùng một vấn đề gửi lại trong 24 giờ không tạo ticket mới: ticket cũ tăng số lần gặp và AI nhận lại mã cũ. Vượt hạn mức → feedback_quota_exceeded kèm retry_at.

Làm bằng API / MCP

Bốn thao tác: feedback.create, feedback.list, feedback.get, feedback.append (MCP: feedback_create, feedback_list, feedback_get, feedback_append; REST: /api/public/v2/feedback). Các bước cho AI ở playbook báo một vấn đề.

Mọi câu trả lời lỗi của API/MCP có trace_id; AI dẫn tối đa 5 mã này trong related_trace_ids để đội tìm đúng lần gọi.