---
title: "Báo lỗi hoặc góp ý"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/feedback.create
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# 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ó.

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

## 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 | Mô tả |
| --- | --- | --- | --- |
| `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

```bash
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ề

```json
{
  "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`.