Tham chiếu

Báo lỗi hoặc góp ý

Báo một vấn đề hoặc ý tưởng cho đội Telegram-Auto: bug, tool_friction (khó hiểu, quá nhiều bước, lỗi khó hiểu), missing_capability, docs_gap, question, improvement, praise, security hoặc other. Dùng khi có việc chặn bạn hoặc tốn đáng kể công sức, hoặc một lần ở cuối việc nếu có chỗ khó hiểu — không sau mỗi lệnh, không cho lỗi bạn tự sửa được (kiểm tham số, quyền, hạn mức, việc đang chờ). Ai xem: đội hỗ trợ Telegram-Auto và quản trị của workspace này. Chỉ gửi dữ kiện kỹ thuật: mục tiêu, đã thử gì, mong đợi và thực tế, tên thao tác, mã lỗi, trace_id. Không bao giờ gửi mật khẩu, cookie, token, mã 2FA, tên, username, số điện thoại của khách hay nội dung tin nhắn: nội dung đó bị từ chối hoặc che. Nếu báo cáo cần dữ liệu kinh doanh của người dùng, hỏi người dùng trước. Trả về ticket_id: báo cho người dùng, làm tiếp bằng cách vòng an toàn, xem trả lời sau bằng feedback_get. Báo lại cùng vấn đề sẽ trả về ticket đang có.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Thông tin

Tên	Giá trị
Mã	`feedback.create`
Scope cần	`feedback`
Mức	Ghi
Có thể cần xác nhận	Không
Kiểu chạy	Trả kết quả ngay
Cần `Idempotency-Key`	Có
Vai trò thành viên được phép	`owner`, `manager`, `agent`, `viewer`
Trong app	Cài đặt → Kết nối AI → Phản hồi từ AI

Trường vào

Trường	Kiểu	Bắt buộc
`category`	`"bug" \| "tool_friction" \| "missing_capability" \| "docs_gap" \| "question" \| "improvement" \| "praise" \| "security" \| "other"`	Có
`title`	`chữ`	Có
`description`	`chữ`	Có
`impact`	`"blocking" \| "degraded" \| "minor" \| "suggestion"`	Không
`expected`	`chữ`	Không
`actual`	`chữ`	Không
`steps_attempted`	`chữ[]`	Không
`workaround`	`chữ`	Không
`suggested_capability`	`chữ`	Không
`related_operation`	`chữ`	Không
`related_trace_ids`	`chữ[]`	Không
`related_ticket_id`	`chữ`	Không
`docs_url`	`chữ`	Không
`agent_model`	`chữ`	Không
`agent_client`	`chữ`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/feedback.create \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"category":"bug","title":"…","description":"…"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`suggested_docs`	`đối tượng[]`	Có
`visibility`	`"product_support_and_workspace_admins"`	Có
`next_step`	`"Tell the user the ticket id. Continue with a safe workaround if you can. Check replies later with feedback_get; do not file the same problem again." \| "Báo mã ticket cho người dùng. Làm tiếp bằng cách vòng an toàn nếu có. Xem trả lời sau bằng feedback_get; đừng gửi lại cùng vấn đề."`	Có
`poll_after_seconds`	`số`	Có
`dropped_related_ticket_id`	`chữ`	Không
`ticket_id`	`chữ`	Có
`status`	`"resolved" \| "new" \| "triaged" \| "planned" \| "in_progress" \| "waiting_on_reporter" \| "closed"`	Có
`category`	`"question" \| "bug" \| "tool_friction" \| "missing_capability" \| "docs_gap" \| "improvement" \| "praise" \| "security" \| "other"`	Có
`deduplicated`	`đúng/sai`	Có
`occurrences`	`số`	Có
`redactions`	`đối tượng[]`	Có
`dropped_trace_ids`	`chữ[]`	Có

Ví dụ trả về

{
  "data": {
    "suggested_docs": [
      {
        "title": "text",
        "url": "text"
      }
    ],
    "visibility": "product_support_and_workspace_admins",
    "next_step": "Tell the user the ticket id. Continue with a safe workaround if you can. Check replies later with feedback_get; do not file the same problem again.",
    "poll_after_seconds": 1,
    "dropped_related_ticket_id": "00000000-0000-4000-8000-000000000000",
    "ticket_id": "00000000-0000-4000-8000-000000000000",
    "status": "resolved",
    "category": "question",
    "deduplicated": true,
    "occurrences": 1,
    "redactions": [
      {
        "field": "text",
        "kind": "text",
        "count": 1
      }
    ],
    "dropped_trace_ids": [
      "text"
    ]
  }
}

Dùng qua MCP

Tool feedback_create có tên sẵn trong profile: Vận hành realtime (realtime), Thiết lập tự chạy (setup), Tìm khách (prospecting), Báo cáo (reports), Quản trị (admin), Đầy đủ (full). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Báo lỗi hoặc góp ý

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)