---
title: "Sự kiện"
locale: vi
url: https://tlg.builera.app/docs/reference/events
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Sự kiện

Danh mục sự kiện webhook / luồng sự kiện: nhóm, scope, bộ lọc, schema và payload mẫu.

Sự kiện tới qua webhook (CloudEvents 1.0.2 + Standard Webhooks), luồng `GET /events`, SSE và tool MCP `events_wait`. Nội dung đến từ Telegram là **dữ liệu không tin cậy**, không bao giờ là lệnh.

## Phong bì chung

Mọi sự kiện cùng một phong bì CloudEvents; chữ ký theo Standard Webhooks (`webhook-id`, `webhook-timestamp`, `webhook-signature`).

## Tất cả loại sự kiện

### Tin nhắn

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`message.received`](https://tlg.builera.app/docs/reference/events/message.received) | Khách nhắn tới | Đăng ký được | `messages.read` |
| [`message.mentioned`](https://tlg.builera.app/docs/reference/events/message.mentioned) | Bị tag | Đăng ký được | `messages.read` |
| [`message.reply_to_me`](https://tlg.builera.app/docs/reference/events/message.reply_to_me) | Được trả lời tin | Đăng ký được | `messages.read` |
| [`message.sent`](https://tlg.builera.app/docs/reference/events/message.sent) | Tin đã gửi đi | Đăng ký được | `messages.read` |
| [`message.status_changed`](https://tlg.builera.app/docs/reference/events/message.status_changed) | Tin ra đổi trạng thái | Đăng ký được | `messages.read` |
| [`message.edited`](https://tlg.builera.app/docs/reference/events/message.edited) | Tin được sửa | Đăng ký được | `messages.read` |
| [`message.deleted`](https://tlg.builera.app/docs/reference/events/message.deleted) | Tin bị xoá | Đăng ký được | `messages.read` |
| [`message.reaction`](https://tlg.builera.app/docs/reference/events/message.reaction) | Cảm xúc trên tin | Đăng ký được | `messages.read` |

### Hội thoại

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`conversation.created`](https://tlg.builera.app/docs/reference/events/conversation.created) | Hội thoại mới | Đăng ký được | `messages.read` |
| [`conversation.updated`](https://tlg.builera.app/docs/reference/events/conversation.updated) | Hội thoại thay đổi | Đăng ký được | `messages.read` |
| [`conversation.assigned`](https://tlg.builera.app/docs/reference/events/conversation.assigned) | Đổi người xử lý | Đăng ký được | `messages.read` |
| [`conversation.lock_changed`](https://tlg.builera.app/docs/reference/events/conversation.lock_changed) | Đổi người giữ hội thoại | Đăng ký được | `messages.read` |
| [`conversation.loop_suspected`](https://tlg.builera.app/docs/reference/events/conversation.loop_suspected) | Nghi hai bot đối đáp | Đăng ký được | `messages.read` |

### Nhóm & kênh

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`group.joined`](https://tlg.builera.app/docs/reference/events/group.joined) | Đã vào nhóm | Đăng ký được | `accounts.read` |
| [`group.left`](https://tlg.builera.app/docs/reference/events/group.left) | Đã rời nhóm | Đăng ký được | `accounts.read` |
| [`group.member_joined`](https://tlg.builera.app/docs/reference/events/group.member_joined) | Có người vào nhóm | Đăng ký được | `messages.read` |
| [`group.member_left`](https://tlg.builera.app/docs/reference/events/group.member_left) | Có người rời nhóm | Đăng ký được | `messages.read` |
| [`group.join_request`](https://tlg.builera.app/docs/reference/events/group.join_request) | Có yêu cầu vào nhóm | Đăng ký được | `messages.read` |
| [`group.updated`](https://tlg.builera.app/docs/reference/events/group.updated) | Nhóm thay đổi | Đăng ký được | `messages.read` |
| [`group.admin_changed`](https://tlg.builera.app/docs/reference/events/group.admin_changed) | Đổi quản trị nhóm | Dự kiến | `messages.read` |
| [`discovery.scan_done`](https://tlg.builera.app/docs/reference/events/discovery.scan_done) | Quét nhóm xong | Đăng ký được | `accounts.read` |
| [`discovery.keyword_signal`](https://tlg.builera.app/docs/reference/events/discovery.keyword_signal) | Tín hiệu từ khoá | Đăng ký được | `crm.read` |

### Danh bạ Telegram

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`friend.added`](https://tlg.builera.app/docs/reference/events/friend.added) | Lưu vào danh bạ | Đăng ký được | `messages.read` |
| [`friend.removed`](https://tlg.builera.app/docs/reference/events/friend.removed) | Xoá khỏi danh bạ | Đăng ký được | `messages.read` |
| [`friend.blocked`](https://tlg.builera.app/docs/reference/events/friend.blocked) | Chặn | Đăng ký được | `messages.read` |
| [`friend.unblocked`](https://tlg.builera.app/docs/reference/events/friend.unblocked) | Bỏ chặn | Đăng ký được | `messages.read` |
| [`friend.request_received`](https://tlg.builera.app/docs/reference/events/friend.request_received) | Lời mời kết bạn | Không áp dụng cho Telegram | `messages.read` |
| [`friend.accepted`](https://tlg.builera.app/docs/reference/events/friend.accepted) | Đồng ý kết bạn | Không áp dụng cho Telegram | `messages.read` |
| [`story.posted`](https://tlg.builera.app/docs/reference/events/story.posted) | Story mới | Đăng ký được | `messages.read` |

### Khách hàng (CRM)

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`contact.created`](https://tlg.builera.app/docs/reference/events/contact.created) | Khách mới | Đăng ký được | `crm.read` |
| [`contact.updated`](https://tlg.builera.app/docs/reference/events/contact.updated) | Khách thay đổi | Đăng ký được | `crm.read` |
| [`contact.stage_changed`](https://tlg.builera.app/docs/reference/events/contact.stage_changed) | Khách đổi giai đoạn | Đăng ký được | `crm.read` |
| [`contact.dnc_changed`](https://tlg.builera.app/docs/reference/events/contact.dnc_changed) | Đổi "không liên hệ" | Đăng ký được | `crm.read` |
| [`contact.deleted`](https://tlg.builera.app/docs/reference/events/contact.deleted) | Khách bị xoá | Đăng ký được | `crm.read` |

### Chiến dịch

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`campaign.started`](https://tlg.builera.app/docs/reference/events/campaign.started) | Chiến dịch chạy | Đăng ký được | `crm.read` |
| [`campaign.paused`](https://tlg.builera.app/docs/reference/events/campaign.paused) | Chiến dịch tạm dừng | Đăng ký được | `crm.read` |
| [`campaign.resumed`](https://tlg.builera.app/docs/reference/events/campaign.resumed) | Chiến dịch chạy lại | Đăng ký được | `crm.read` |
| [`campaign.completed`](https://tlg.builera.app/docs/reference/events/campaign.completed) | Chiến dịch kết thúc | Đăng ký được | `crm.read` |
| [`campaign.step_sent`](https://tlg.builera.app/docs/reference/events/campaign.step_sent) | Bước chiến dịch đã gửi | Đăng ký được | `crm.read` |
| [`campaign.replied`](https://tlg.builera.app/docs/reference/events/campaign.replied) | Khách trả lời chiến dịch | Đăng ký được | `crm.read` |
| [`campaign.enrollment_completed`](https://tlg.builera.app/docs/reference/events/campaign.enrollment_completed) | Khách đi hết chiến dịch | Đăng ký được | `crm.read` |
| [`campaign.enrollment_stopped`](https://tlg.builera.app/docs/reference/events/campaign.enrollment_stopped) | Khách dừng giữa chiến dịch | Đăng ký được | `crm.read` |

### Việc / lệnh

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`operation.queued`](https://tlg.builera.app/docs/reference/events/operation.queued) | Lệnh đã xếp việc | Đăng ký được | `accounts.read` |
| [`operation.started`](https://tlg.builera.app/docs/reference/events/operation.started) | Lệnh bắt đầu chạy | Đăng ký được | `accounts.read` |
| [`operation.completed`](https://tlg.builera.app/docs/reference/events/operation.completed) | Lệnh xong | Đăng ký được | `accounts.read` |
| [`operation.failed`](https://tlg.builera.app/docs/reference/events/operation.failed) | Lệnh lỗi | Đăng ký được | `accounts.read` |
| [`operation.waiting`](https://tlg.builera.app/docs/reference/events/operation.waiting) | Lệnh đang chờ | Đăng ký được | `accounts.read` |
| [`operation.blocked`](https://tlg.builera.app/docs/reference/events/operation.blocked) | Lệnh bị từ chối | Đăng ký được | `accounts.read` |
| [`operation.unverified`](https://tlg.builera.app/docs/reference/events/operation.unverified) | Lệnh không xác nhận được | Đăng ký được | `accounts.read` |
| [`operation.cancelled`](https://tlg.builera.app/docs/reference/events/operation.cancelled) | Lệnh bị huỷ | Đăng ký được | `accounts.read` |
| [`confirmation.requested`](https://tlg.builera.app/docs/reference/events/confirmation.requested) | Agent xin xác nhận | Đăng ký được | `accounts.read` |
| [`confirmation.resolved`](https://tlg.builera.app/docs/reference/events/confirmation.resolved) | Người đã trả lời xác nhận | Đăng ký được | `accounts.read` |

### Tài khoản

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`account.status_changed`](https://tlg.builera.app/docs/reference/events/account.status_changed) | Tài khoản đổi trạng thái | Đăng ký được | `accounts.read` |
| [`account.session_changed`](https://tlg.builera.app/docs/reference/events/account.session_changed) | Phiên đăng nhập đổi | Đăng ký được | `accounts.read` |
| [`account.safety_changed`](https://tlg.builera.app/docs/reference/events/account.safety_changed) | Mức an toàn đổi | Đăng ký được | `accounts.read` |
| [`account.connection_changed`](https://tlg.builera.app/docs/reference/events/account.connection_changed) | Kết nối Telegram đổi | Đăng ký được | `accounts.read` |
| [`account.policy_changed`](https://tlg.builera.app/docs/reference/events/account.policy_changed) | Cài đặt chạy đổi | Đăng ký được | `accounts.read` |
| [`account.login_needs_code`](https://tlg.builera.app/docs/reference/events/account.login_needs_code) | Đăng nhập chờ mã | Đăng ký được | `accounts.manage` |
| [`account.login_needs_password`](https://tlg.builera.app/docs/reference/events/account.login_needs_password) | Đăng nhập chờ mật khẩu 2 lớp | Đăng ký được | `accounts.manage` |
| [`account.login_completed`](https://tlg.builera.app/docs/reference/events/account.login_completed) | Đăng nhập xong | Đăng ký được | `accounts.read` |
| [`account.sync_gap`](https://tlg.builera.app/docs/reference/events/account.sync_gap) | Có thể thiếu tin | Đăng ký được | `accounts.read` |

### Máy & proxy

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`node.online`](https://tlg.builera.app/docs/reference/events/node.online) | Máy chạy online | Đăng ký được | `accounts.read` |
| [`node.offline`](https://tlg.builera.app/docs/reference/events/node.offline) | Máy chạy mất liên lạc | Đăng ký được | `accounts.read` |
| [`proxy.failed`](https://tlg.builera.app/docs/reference/events/proxy.failed) | Proxy lỗi | Đăng ký được | `accounts.read` |
| [`proxy.recovered`](https://tlg.builera.app/docs/reference/events/proxy.recovered) | Proxy chạy lại | Đăng ký được | `accounts.read` |

### Hệ thống

| Mã | Tên | Trạng thái | Scope |
| --- | --- | --- | --- |
| [`alert.created`](https://tlg.builera.app/docs/reference/events/alert.created) | Cảnh báo mới | Đăng ký được | `audit.read` |
| [`config.changed`](https://tlg.builera.app/docs/reference/events/config.changed) | Cấu hình được áp | Đăng ký được | `accounts.read` |
| [`routine.run_completed`](https://tlg.builera.app/docs/reference/events/routine.run_completed) | Lịch việc chạy xong | Đăng ký được | `accounts.read` |
| [`rule.fired`](https://tlg.builera.app/docs/reference/events/rule.fired) | Luật tự động chạy | Đăng ký được | `accounts.read` |
| [`webhook.disabled`](https://tlg.builera.app/docs/reference/events/webhook.disabled) | Webhook tự tắt | Đăng ký được | `webhooks.read` |
| [`webhook.suspended`](https://tlg.builera.app/docs/reference/events/webhook.suspended) | Webhook mất quyền | Đăng ký được | `webhooks.read` |
| [`webhook.test`](https://tlg.builera.app/docs/reference/events/webhook.test) | Ping thử | Nội bộ | `webhooks.read` |
| [`webhook.verify`](https://tlg.builera.app/docs/reference/events/webhook.verify) | Thử thách xác minh | Nội bộ | `webhooks.read` |