---
title: "Tài khoản gửi phù hợp"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/campaigns.senders
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Tài khoản gửi phù hợp

Các tài khoản gửi được cho một mục tiêu chiến dịch, kèm sức chứa hôm nay.

Các tài khoản gửi được cho một mục tiêu chiến dịch, kèm sức chứa hôm nay.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `campaigns.senders` |
| Scope cần | `campaigns.write` |
| 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` |
| Trong app | Chiến dịch → Cài đặt → Tài khoản gửi |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `goal` | `"outreach" \| "nurture"` | Có |   |

## Ví dụ gọi

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

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

| Trường | Kiểu | Bắt buộc |
| --- | --- | --- |
| `ok` | `true` | Có |
| `senders` | `đối tượng[]` | Có |

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "senders": [
      {
        "id": "00000000-0000-4000-8000-000000000000",
        "label": "text",
        "ok": true,
        "reason": "text",
        "perDay": 1,
        "week": 1,
        "free": 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.senders"`. Tên tool khi được liệt kê: `campaigns_senders`.