Tham chiếu

Nhập danh sách khách

Nhập tới giới hạn số dòng username / số điện thoại, do một tài khoản tra cứu, vào một danh sách. Theo dõi tiến độ qua mục imports trong people.list.

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

Nhập tới giới hạn số dòng username / số điện thoại, do một tài khoản tra cứu, vào một danh sách. Theo dõi tiến độ qua mục imports trong people.list.

Thông tin

Tên	Giá trị
Mã	`imports.start`
Scope cần	`crm.write`
Mức	Ghi
Có thể cần xác nhận	Không
Kiểu chạy	Xếp việc cho máy chạy
Cần `Idempotency-Key`	Có
Vai trò thành viên được phép	`owner`, `manager`
Trong app	Khách hàng → Nhập

Trường vào

Trường	Kiểu	Bắt buộc
`fileName`	`chữ`	Có
`listId`	`uuid`	Có
`tags`	`chữ[]`	Không
`accountId`	`uuid`	Có
`rows`	`đối tượng[]`	Có

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/imports.start \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"fileName":"…","listId":"00000000-0000-0000-0000-000000000000","accountId":"00000000-0000-0000-0000-000000000000","rows":[]}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`importId`	`chữ`	Có
`counts`	`đối tượng`	Có
`ok`	`true`	Có

Ví dụ trả về

{
  "data": {
    "importId": "00000000-0000-4000-8000-000000000000",
    "counts": {
      "valid": 1,
      "error": 1,
      "pending": 1,
      "resolving": 1,
      "duplicate": 1,
      "not_found": 1,
      "suppressed": 1,
      "invalid": 1
    },
    "ok": 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: "imports.start". Tên tool khi được liệt kê: imports_start.

Nhập danh sách khách

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)