Tham chiếu
friend.added — Lưu vào danh bạ
Tài khoản lưu một người vào danh bạ Telegram (từ app hoặc điện thoại).
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Tài khoản lưu một người vào danh bạ Telegram (từ app hoặc điện thoại).
Từ bản web 1.7.0, máy chạy —.
| Tên | Giá trị |
|---|---|
| Mã | friend.added |
| Nhóm | Danh bạ Telegram |
| 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 | conversation_ids |
Trường bị bỏ ở chế độ nội dung thin |
peer.name, peer.username |
| Trường do người ngoài viết (không tin cậy) | peer.name |
JSON Schema
https://tlg.builera.app/schemas/events/friend.added/2.json
Payload mẫu (đúng như webhooks.test gửi)
{
"specversion": "1.0",
"id": "evt_01JDOCSSAMPLE",
"source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
"type": "friend.added",
"time": "2026-10-21T13:45:00.123Z",
"datacontenttype": "application/json",
"dataschema": "https://tlg.builera.app/schemas/events/friend.added/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": {
"account": {
"id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
"label": "Sale 1",
"username": "sale_demo_1",
"tg_user_id": "100200300"
},
"peer": {
"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
},
"conversation_id": "9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
"by": {
"kind": "human",
"id": null
},
"links": {
"app": "https://tlg.builera.app/w/07c2e5e1-c42f-4212-851b-c55b6dd7989d/inbox?c=9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b"
},
"untrusted_fields": [
"peer.name"
]
}
}