---
title: "Hồ sơ khách"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/people.get
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# 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.

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

```bash
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ề

```json
{
  "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`.