Tài liệu

Hướng dẫn

Nhập danh sách khách từ tệp

Nhập CSV hoặc XLSX, ghép cột và theo dõi kết quả tra khách trên Telegram.

Xem Markdown

Bạn nhập danh sách username từ CSV hoặc XLSX để tạo một lượt tra khách, có kết quả cho từng dòng. Tệp được nhận chưa có nghĩa mọi người trong tệp đã vào Khách.

Ai làm được

Chủ và Quản lý.

Cần chuẩn bị

Tệp cần một cột username, dạng @username hoặc link hồ sơ t.me. Có thể thêm cột tên, ghi chú và thẻ. Luồng này không tra người theo số điện thoại.

Mỗi lượt nhận tối đa 10.000 dòng. Cần ít nhất một tài khoản Telegram đang chạy để tra hồ sơ.

Bắt đầu ở đâu

Mở Khách → Lượt nhập, rồi chọn Nhập file. Nút Nhập file cũng có trên tab Bảng.

Các bước

  1. Chọn hoặc kéo tệp vào hộp nhập. Ứng dụng đọc tệp trước khi cho bạn xác nhận. Tệp vượt giới hạn dòng cần chia nhỏ.

  2. Ghép cột username. Kiểm tra cột ứng dụng nhận ra, không chỉ dựa vào tên cột. Thiếu cột username thì chưa tiếp tục được.

  3. Ghép các cột bổ sung. Chọn cột tên, ghi chú, thẻ nếu có. Cột không dùng thì chọn — Không dùng —.

  4. Xem phần Kiểm tra. Phân biệt dòng sẽ tra, dòng lỗi và dòng trống bị bỏ qua. Sửa tệp gốc nếu cột bị lệch hoặc nhiều username sai.

    Hộp nhập khách đang ghép cột và kiểm tra dữ liệu
    Kiểm tra trước khi nhập

  5. Chọn danh sách đích. Ở Thêm vào danh sách, chọn danh sách có sẵn, tạo mới hoặc không thêm.

  6. Đặt thẻ chung nếu cần. Gắn thẻ cho tất cả giúp nhận biết nguồn nhập. Thẻ không thay thế yêu cầu không liên hệ.

  7. Chọn tài khoản tra. Mỗi lần tra đi qua hàng việc và hạn mức mở hồ sơ của tài khoản đó, nên lượt nhập có thể cần thời gian.

  8. Xác nhận nhập. Đọc thông báo số dòng đang tra, đã có và bị loại. Dòng trùng hoặc người đã có không tạo hồ sơ mới; người đã có vẫn được thêm danh sách và thẻ của lượt nhập.

  9. Theo dõi tại Lượt nhập. Mở kết quả để xem từng dòng. Dùng Tải file lỗi để sửa phần lỗi thay vì nhập lại cả tệp.

Kết quả

Mỗi lượt nhập giữ tiến độ và kết quả riêng: hợp lệ, đã có, không tìm thấy, bị loại trừ, không hợp lệ hoặc lỗi.

Kiểm tra

Đối chiếu số dòng đã kiểm với tổng số dòng. Tìm một người hợp lệ trong Khách và kiểm tra danh sách, thẻ vừa chọn. Dòng đang chờ tra chưa phải lỗi.

Khi có lỗi

Kiểm tra định dạng tệp, cột username và trạng thái tài khoản tra. Người bị loại trừ không phải dữ liệu cần nhập lại.

Dừng ngăn lượt nhập xử lý tiếp; nó không hoàn tác những hồ sơ đã xử lý.

Làm bằng API hoặc MCP

Dùng imports.start và imports.cancel — MCP imports_start, imports_cancel.