Tham chiếu
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.
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
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 |
Khách nhắn tới | Đăng ký được | messages.read |
message.mentioned |
Bị tag | Đăng ký được | messages.read |
message.reply_to_me |
Được trả lời tin | Đăng ký được | messages.read |
message.sent |
Tin đã gửi đi | Đăng ký được | messages.read |
message.status_changed |
Tin ra đổi trạng thái | Đăng ký được | messages.read |
message.edited |
Tin được sửa | Đăng ký được | messages.read |
message.deleted |
Tin bị xoá | Đăng ký được | messages.read |
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 |
Hội thoại mới | Đăng ký được | messages.read |
conversation.updated |
Hội thoại thay đổi | Đăng ký được | messages.read |
conversation.assigned |
Đổi người xử lý | Đăng ký được | messages.read |
conversation.lock_changed |
Đổi người giữ hội thoại | Đăng ký được | messages.read |
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 |
Đã vào nhóm | Đăng ký được | accounts.read |
group.left |
Đã rời nhóm | Đăng ký được | accounts.read |
group.member_joined |
Có người vào nhóm | Đăng ký được | messages.read |
group.member_left |
Có người rời nhóm | Đăng ký được | messages.read |
group.join_request |
Có yêu cầu vào nhóm | Đăng ký được | messages.read |
group.updated |
Nhóm thay đổi | Đăng ký được | messages.read |
group.admin_changed |
Đổi quản trị nhóm | Dự kiến | messages.read |
discovery.scan_done |
Quét nhóm xong | Đăng ký được | accounts.read |
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 |
Lưu vào danh bạ | Đăng ký được | messages.read |
friend.removed |
Xoá khỏi danh bạ | Đăng ký được | messages.read |
friend.blocked |
Chặn | Đăng ký được | messages.read |
friend.unblocked |
Bỏ chặn | Đăng ký được | messages.read |
friend.request_received |
Lời mời kết bạn | Không áp dụng cho Telegram | messages.read |
friend.accepted |
Đồng ý kết bạn | Không áp dụng cho Telegram | messages.read |
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 |
Khách mới | Đăng ký được | crm.read |
contact.updated |
Khách thay đổi | Đăng ký được | crm.read |
contact.stage_changed |
Khách đổi giai đoạn | Đăng ký được | crm.read |
contact.dnc_changed |
Đổi "không liên hệ" | Đăng ký được | crm.read |
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 |
Chiến dịch chạy | Đăng ký được | crm.read |
campaign.paused |
Chiến dịch tạm dừng | Đăng ký được | crm.read |
campaign.resumed |
Chiến dịch chạy lại | Đăng ký được | crm.read |
campaign.completed |
Chiến dịch kết thúc | Đăng ký được | crm.read |
campaign.step_sent |
Bước chiến dịch đã gửi | Đăng ký được | crm.read |
campaign.replied |
Khách trả lời chiến dịch | Đăng ký được | crm.read |
campaign.enrollment_completed |
Khách đi hết chiến dịch | Đăng ký được | crm.read |
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 |
Lệnh đã xếp việc | Đăng ký được | accounts.read |
operation.started |
Lệnh bắt đầu chạy | Đăng ký được | accounts.read |
operation.completed |
Lệnh xong | Đăng ký được | accounts.read |
operation.failed |
Lệnh lỗi | Đăng ký được | accounts.read |
operation.waiting |
Lệnh đang chờ | Đăng ký được | accounts.read |
operation.blocked |
Lệnh bị từ chối | Đăng ký được | accounts.read |
operation.unverified |
Lệnh không xác nhận được | Đăng ký được | accounts.read |
operation.cancelled |
Lệnh bị huỷ | Đăng ký được | accounts.read |
confirmation.requested |
Agent xin xác nhận | Đăng ký được | accounts.read |
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 |
Tài khoản đổi trạng thái | Đăng ký được | accounts.read |
account.session_changed |
Phiên đăng nhập đổi | Đăng ký được | accounts.read |
account.safety_changed |
Mức an toàn đổi | Đăng ký được | accounts.read |
account.connection_changed |
Kết nối Telegram đổi | Đăng ký được | accounts.read |
account.policy_changed |
Cài đặt chạy đổi | Đăng ký được | accounts.read |
account.login_needs_code |
Đăng nhập chờ mã | Đăng ký được | accounts.manage |
account.login_needs_password |
Đăng nhập chờ mật khẩu 2 lớp | Đăng ký được | accounts.manage |
account.login_completed |
Đăng nhập xong | Đăng ký được | accounts.read |
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 |
Máy chạy online | Đăng ký được | accounts.read |
node.offline |
Máy chạy mất liên lạc | Đăng ký được | accounts.read |
proxy.failed |
Proxy lỗi | Đăng ký được | accounts.read |
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 |
Cảnh báo mới | Đăng ký được | audit.read |
config.changed |
Cấu hình được áp | Đăng ký được | accounts.read |
routine.run_completed |
Lịch việc chạy xong | Đăng ký được | accounts.read |
rule.fired |
Luật tự động chạy | Đăng ký được | accounts.read |
webhook.disabled |
Webhook tự tắt | Đăng ký được | webhooks.read |
webhook.suspended |
Webhook mất quyền | Đăng ký được | webhooks.read |
webhook.test |
Ping thử | Nội bộ | webhooks.read |
webhook.verify |
Thử thách xác minh | Nội bộ | webhooks.read |