Tham chiếu

Hồ sơ khách

Một người kèm ghi chú, cuộc trò chuyện (trên các tài khoản được phép) và danh sách.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Một người kèm ghi chú, cuộc trò chuyện (trên các tài khoản được phép) và danh sách.

Thông tin

Tên	Giá trị
Mã	`people.get`
Scope cần	`crm.read`
Mức	Chỉ đọc
Có thể cần xác nhận	Không
Kiểu chạy	Trả kết quả ngay
Cần `Idempotency-Key`	Không
Vai trò thành viên được phép	`owner`, `manager`, `agent`, `viewer`
Trong app	Khách hàng → hồ sơ

Trường vào

Trường	Kiểu	Bắt buộc	Mô tả
`personId`	`uuid`	Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/people.get \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personId":"00000000-0000-0000-0000-000000000000"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`person`	`đối tượng`	Có
`notes`	`đối tượng[]`	Có
`conversations`	`đối tượng[]`	Có
`listIds`	`chữ[]`	Có

Ví dụ trả về

{
  "data": {
    "person": {
      "untrusted": true,
      "id": "00000000-0000-4000-8000-000000000000",
      "tg_user_id": 1,
      "username": "text",
      "first_name": "text",
      "last_name": "text",
      "bio": "text",
      "is_bot": true,
      "is_premium": true,
      "is_contact": true,
      "stage_id": "00000000-0000-4000-8000-000000000000",
      "tags": [
        "text"
      ],
      "temperature": "text",
      "temperature_reason": "text",
      "owner_account_id": "00000000-0000-4000-8000-000000000000",
      "source": "text",
      "listed": true,
      "last_interaction_at": "2026-10-22T12:00:00.000Z",
      "created_at": "2026-10-22T12:00:00.000Z"
    },
    "notes": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "body": "text",
        "author_id": "00000000-0000-4000-8000-000000000000",
        "created_at": "2026-10-22T12:00:00.000Z"
      }
    ],
    "conversations": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "account_id": "00000000-0000-4000-8000-000000000000",
        "status": "open",
        "last_message_at": "2026-10-22T12:00:00.000Z",
        "unread_count": 1
      }
    ],
    "listIds": [
      "text"
    ]
  }
}

Dùng qua MCP

Tool people_get có tên sẵn trong profile: Tìm khách (prospecting). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Hồ sơ khách

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)