---
title: "Áp kịch bản nuôi cho tài khoản"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/nurture.apply
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Áp kịch bản nuôi cho tài khoản

Áp một kịch bản (mã có sẵn hoặc id đã lưu) cho tối đa 200 tài khoản.

Áp một kịch bản (mã có sẵn hoặc id đã lưu) cho tối đa 200 tài khoản.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `nurture.apply` |
| Mã mới (v2) | `nurture_plans.apply` |
| Scope cần | `nurture.write` |
| Mức | Ghi |
| Có thể cần xác nhận | Có |
| 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` |
| Trong app | Nuôi tài khoản → Áp kịch bản |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `ref` | `chữ` | Có |   |
| `accountIds` | `uuid[]` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/nurture.apply \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ref":"…","accountIds":[]}'
```

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

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `applied` | `số` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "applied": 1
  }
}
```

## 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: "nurture.apply"`. Tên tool khi được liệt kê: `nurture_apply`.