---
title: "message.mentioned — Bị tag"
locale: vi
url: https://tlg.builera.app/docs/reference/events/message.mentioned
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# message.mentioned — Bị tag

Tin đến có @tag đúng tài khoản (tag theo username hoặc tag tên). Cần máy chạy ≥ 1.0.30.

Tin đến có @tag đúng tài khoản (tag theo username hoặc tag tên). Cần máy chạy ≥ 1.0.30.

Từ bản web 1.7.0, máy chạy 1.0.30.

| Tên | Giá trị |
| --- | --- |
| Mã | `message.mentioned` |
| Nhóm | Tin nhắn |
| Trạng thái | Đăng ký được |
| Scope cần để nhận | `messages.read` |
| Gắn với một tài khoản | Có |
| Chỉ kết nối gây ra sự kiện mới nhận | Không |
| Bộ lọc áp dụng | `chat_types`, `exclude_self`, `include_backfill`, `conversation_ids`, `conversation_tags`, `keywords`, `has_media`, `person_stage_ids`, `campaign_ids` |
| Trường bị bỏ ở chế độ nội dung `thin` | `message.text`, `message.reply_to.text`, `message.reply_to.sender_name`, `message.quote_text`, `message.attachments[].name`, `message.forwarded_from`, `conversation.title`, `conversation.topic.title`, `sender.name`, `sender.username` |
| Trường do người ngoài viết (không tin cậy) | `message.text`, `message.reply_to.text`, `message.quote_text`, `message.attachments[].name`, `message.forwarded_from.name`, `sender.name`, `conversation.title`, `conversation.topic.title` |

## JSON Schema

[https://tlg.builera.app/schemas/events/message.mentioned/2.json](https://tlg.builera.app/schemas/events/message.mentioned/2.json)

## Payload mẫu (đúng như `webhooks.test` gửi)

```json
{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "message.mentioned",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/message.mentioned/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "message": {
      "id": "6b1c3d5e-7f9a-4b2c-8d4e-6f8a0b2c4d6e",
      "tg_message_id": 8812,
      "direction": "in",
      "type": "text",
      "text": "@sale_demo_1 báo giá giúp em",
      "attachments": [],
      "reply_to": null,
      "quote_text": null,
      "mentions": [
        {
          "kind": "username",
          "username": "sale_demo_1",
          "tg_user_id": "100200300",
          "is_me": true
        }
      ],
      "is_mention": true,
      "is_reply_to_me": false,
      "is_self": false,
      "is_backfill": false,
      "topic_id": 12,
      "grouped_id": null,
      "forwarded_from": null,
      "service_action": null,
      "sent_at": "2026-10-21T13:45:00.123Z"
    },
    "conversation": {
      "id": "5b7c9d1e-2f3a-4b5c-8d9e-0f1a2b3c4d5e",
      "chat_type": "supergroup",
      "title": "Nhóm Khách VIP",
      "peer_tg_id": "-1001234567890",
      "topic": {
        "id": 12,
        "title": "Hỏi giá"
      },
      "assignee_id": null,
      "tags": [],
      "campaign_id": null,
      "lock": null
    },
    "sender": {
      "tg_user_id": "456789",
      "name": "Nguyễn Văn A",
      "username": "nva",
      "person_id": "c41b7e2a-9d3c-4b1f-8e2a-7c5d3b1f9e08",
      "stage_id": "3e5f7a9b-1c3d-4e5f-9a1b-2c3d4e5f6a7b",
      "is_contact": true,
      "internal": false
    },
    "account": {
      "id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "label": "Sale 1",
      "username": "sale_demo_1",
      "tg_user_id": "100200300"
    },
    "links": {
      "app": "https://tlg.builera.app/w/07c2e5e1-c42f-4212-851b-c55b6dd7989d/inbox?c=5b7c9d1e-2f3a-4b5c-8d9e-0f1a2b3c4d5e",
      "reply": {
        "operation": "messages.send",
        "rest": "POST /api/public/v2/ops/messages.send",
        "mcp_tool": "messages_send",
        "input": {
          "conversationId": "5b7c9d1e-2f3a-4b5c-8d9e-0f1a2b3c4d5e",
          "replyToMessageId": 8812,
          "inReplyToEventId": "evt_01JDOCSSAMPLE"
        }
      }
    },
    "untrusted_fields": [
      "message.text",
      "sender.name",
      "conversation.title",
      "conversation.topic.title"
    ]
  }
}
```