---
title: "Người trong chiến dịch"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/campaigns.people
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Người trong chiến dịch

Người nhận của một chiến dịch kèm bước và kết quả của họ (lật trang theo offset).

Người nhận của một chiến dịch kèm bước và kết quả của họ (lật trang theo offset).

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `campaigns.people` |
| 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 | Chiến dịch → Người nhận |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `id` | `uuid` | Có |   |
| `status` | `chữ` | Không |   |
| `limit` | `số nguyên` | Không |   |
| `offset` | `số nguyên` | Không |   |

## Ví dụ gọi

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

## Trường ra (`data`)

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `page` | `null \| chữ \| số \| đối tượng \| any[] \| đúng/sai` | Có |
| `untrusted` | `true` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "page": "text",
    "untrusted": true
  }
}
```

## Dùng qua MCP

Không có tên sẵn trong profile nào: gọi `tools_describe` rồi `tools_run` với `code: "campaigns.people"`. Tên tool khi được liệt kê: `campaigns_people`.