Nhóm Node Zalo Personal - Module

Tổng Quan

Nhóm node Zalo Personal cho phép người dùng tự động hóa các thao tác trên tài khoản Zalo cá nhân thông qua Agent. Các thao tác này bao gồm trích xuất tập khách hàng (bạn bè, nhóm), truy vấn chiến dịch Zalo, và thu thập thông tin nhóm Zalo một cách hiệu quả để hỗ trợ kịch bản seeding & marketing.

---

Chi tiết các Node Zalo Personal

1. Thu Thập Dữ Liệu Khách Hàng (Crawling)

Zalo - Crawl danh sách bạn bè (Crawl Friends)

• Chức năng: Tạo tiến trình (job) ngầm để tự động quét và crawl danh sách bạn bè từ một tài khoản Zalo Personal cụ thể.
• Cấu hình Input:
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Dropdown lựa chọn tài khoản Zalo cá nhân đích đã được ủy quyền kết nối vào hệ thống.

Zalo - Crawl nhóm (Crawl Groups)

• Chức năng: Crawl và thu thập dữ liệu danh sách nhóm Zalo dựa trên ID hoặc tham số Link. Hỗ trợ tùy chọn tự động tham gia luôn vào các nhóm chưa gia nhập nếu được yêu cầu.
• Cấu hình Input:
  • Chế độ chọn kết nối (Connection Mode): Select from list hoặc phương thức thủ công.
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Lựa chọn danh tính Zalo chịu trách nhiệm chạy lệnh.

Zalo - Crawl nhóm theo ID chi tiết (Crawl Groups By IDs)

• Chức năng: Thực hiện truy vấn trực tiếp vào một ID nhóm mở để lấy danh sách thông tin sâu (nâng cao hơn) thay vì URL lộn xộn.
• Cấu hình Input:
  • Chế độ nhập liệu (Input Mode): Chọn Single Group ID (ID đơ) hoặc Multiple IDs (Danh sách ID).
  • ID Nhóm Zalo (Zalo Group ID): Khai báo chuỗi/số định danh của Nhóm (Ví dụ: 182736455243).

---

2. Quản Lý Chiến Dịch Zalo & Tài Khoản (Campaigns & Accounts)

Zalo - Danh sách chiến dịch Zalo Personal (List Campaigns)

• Chức năng: Lấy danh sách các chiến dịch (Campaign) truyền thông tương tác trên Zalo Personal. Hỗ trợ phân trang và tìm kiếm theo trạng thái/thể loại.
• Cấu hình Input:
  • Trang (Page): Số trang hiện tại (1).
  • Giới hạn (Limit): Số bản ghi trả về tối đa (10).
  • Tìm kiếm (Search): Bắt từ khóa campaign (Ví dụ: Campaign khuyến mãi).
  • Chế độ chọn kết nối (Connection Mode): Tương tự các node trên, thường là Select from list.
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Gắn tài khoản xử lý.
  • Trạng thái (Status): Lọc theo trạng thái campaign (Chờ chạy, Đang chạy, Tạm Dừng, Đã Xong).
  • Loại chiến dịch (Campaign Type): Lọc theo hình thức seeding/viral...

Zalo - Danh sách tài khoản cá nhân (List Zalo Personal Accounts)

• Chức năng: Hiển thị tổng quan list toàn bộ các Zalo Personal Account đang được mapping và quản lý dưới danh nghĩa của một đặc vụ Agent nhất định.
• Cấu hình Input:
  • Agent: Đối tượng hệ thống (Drop selection).
  • Trang (Page) / Giới hạn (Limit): Cấu hình phân trang cơ bản.
  • Tìm kiếm (Search): Khung search tên tài khoản.

---

3. Chiến Dịch Zalo Personal (Zalo Personal Campaign)

Zalo - Gỡ Zalo Personal Account (Remove Zalo Personal Accounts)

• Chức năng: Gỡ Zalo Personal Account khỏi agent.
• Cấu hình Input:
  • Agent: Cấu hình hệ thống Agent để gỡ tài khoản, bao gồm các chế độ con:
    • Chế độ chọn Agent (Agent Selection Mode): Lựa chọn phương thức xác định Agent (Select from list hoặc Enter ID manually).
    • Tùy thuộc vào chế độ đã chọn, hiển thị Dropdown để chọn Agent hoặc ô nhập chuẩn UUID để điền ID thủ công.
  • ID Zalo Personal Account: Mảng chứa các ID Zalo Personal Account đích cần gỡ.

Zalo - Hủy chiến dịch (Cancel Campaign)

• Chức năng: Hủy chiến dịch Zalo Personal đang chạy hoặc đã lên lịch.
• Cấu hình Input:
  • Chế độ chọn chiến dịch (Campaign Selection Mode): Chọn phương thức để xác định chiến dịch cần hủy (Select from list hoặc Enter ID manually).
  • Chiến dịch (Campaign): Tùy thuộc chế độ đã chọn, hiển thị Dropdown các chiến dịch hoặc ô nhập mã ID số chiến dịch.

Zalo - Lấy chi tiết chiến dịch (Get Campaign)

• Chức năng: Lấy thông tin chi tiết của chiến dịch Zalo Personal.
• Cấu hình Input:
  • Chế độ chọn chiến dịch (Campaign Selection Mode): Chọn phương thức xác định chiến dịch (Select from list hoặc Enter ID manually).
  • Chiến dịch (Campaign): Tùy thuộc chế độ đã chọn, hiển thị Dropdown các chiến dịch hoặc ô nhập mã ID số chiến dịch.

Zalo - Lấy danh sách thành viên nhóm (Get Group Members)

• Chức năng: Lấy danh sách thành viên trong nhóm Zalo với tính năng phân trang.
• Cấu hình Input:
  • Chế độ chọn kết nối (Connection Mode): Phương thức xác định kết nối Zalo cá nhân (Select from list hoặc Enter ID manually).
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Dropdown danh sách kết nối cá nhân hiện tại hoặc nhập mã nhận diện UUID thủ công.
  • Chế độ chọn nhóm (Group Selection Mode): Phương thức xác định nhóm Zalo (Select from list hoặc Enter ID manually).
  • Nhóm Zalo (Zalo Group): Dropdown nhóm Zalo quản lý của tài khoản liên kết hoặc tự khởi tạo ID nhóm thủ công.
  • Trang (Page): Số trang hiển thị (bắt đầu từ 1).
  • Giới hạn (Limit): Số lượng thành viên lớn nhất mỗi trang.

Zalo - Lấy logs chiến dịch (Get Campaign Logs)

• Chức năng: Lấy logs thực thi của chiến dịch Zalo Personal với bộ lọc.
• Cấu hình Input:
  • Chế độ chọn chiến dịch (Campaign Selection Mode): Cách định danh chiến dịch (Select from list hoặc Enter ID manually).
  • Chiến dịch (Campaign): Dropdown danh sách chiến dịch hoặc nhập riêng biệt bằng mã ID số.
  • Trang (Page): Nhập vào số trang cần lấy.
  • Giới hạn (Limit): Số lượng bản ghi cho một khoảng dữ liệu (1-200).
  • Tìm kiếm (Search): Bắt từ khóa tìm kiếm trong logs.
  • Chế độ chọn kết nối (Connection Mode): Lựa chọn nguồn cung cấp kết nối API (Select from list hoặc Enter ID manually).
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Trình đơn chọn kết nối Zalo đã xác thực hoặc mã nhập Integration ID thủ công.
  • Trạng thái (Status): Tùy chọn lọc logs trên trạng thái sự kiện duy nhất trong menu xổ xuống (Pending, Processing, Success, Failed, Retry).

Zalo OA - Quản lý nhóm (Zalo OA - Group)

• Chức năng: Quản lý nhóm Zalo OA, bao gồm lấy thông tin, xem thành viên và gửi tin nhắn.
• Cấu hình Input:
  • Kết nối (Connection): Chọn tài khoản Zalo OA đã liên kết.
  • Hành động (Action): Chọn thao tác cần thực hiện:
    • Lấy thông tin nhóm (Get Group Info).
    • Lấy danh sách thành viên (Get Group Members).
    • Gửi tin nhắn (Send Message).
  • ID Nhóm (Group ID): Nhập ID của nhóm cần thao tác.
  • Loại tin nhắn (Message Type): (Chỉ hiển thị khi chọn Gửi tin nhắn) Chọn định dạng Text hoặc Image.
  • Nội dung tin nhắn (Message Content): (Chỉ hiển thị khi chọn loại Text) Nhập văn bản cần gửi.
  • URL Hình ảnh (Image URL): (Chỉ hiển thị khi chọn loại Image) Nhập URL trực tiếp của ảnh (yêu cầu HTTPS).

Zalo - Lấy thông tin từ link nhóm (Get Group Link Info)

• Chức năng: Lấy thông tin chi tiết của nhóm Zalo thông qua link mời (invite link).
• Cấu hình Input:
  • Chế độ chọn kết nối (Connection Mode): Lựa chọn Select from list hoặc Enter ID manually.
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Chọn tài khoản hoặc nhập UUID tích hợp.
  • Link Nhóm (Group Link): Nhập URL mời của nhóm (Ví dụ: https://zalo.me/g/abc123).

Zalo - Mời vào nhóm (Invite To Groups)

• Chức năng: Tự động mời danh sách nhiều người dùng vào một nhóm Zalo cụ thể.
• Cấu hình Input:
  • Chế độ chọn kết nối (Connection Mode): Lựa chọn Select from list hoặc Enter ID manually.
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Chọn tài khoản thực hiện lời mời.
  • Chế độ chọn nhóm (Group Selection Mode): Lựa chọn Select from list hoặc Enter ID manually.
  • Nhóm Zalo (Zalo Group): Chọn nhóm đích trong danh sách hoặc nhập ID nhóm trực tiếp.
  • Chế độ chọn thành viên (Member Selection Mode): Cách thức xác định danh sách mời (Select from list hoặc Enter as comma-separated string).
  • Chọn thành viên / Danh sách ID (Chuỗi): Lựa chọn các người dùng từ danh sách (tự động loại trừ người đã có trong nhóm) hoặc nhập chuỗi ID phân cách bằng dấu phẩy.

Zalo - Lọc audiences từ segment (Filter Audiences From Segment)

• Chức năng: Lấy danh sách các đối tượng (audiences) Zalo thỏa mãn các điều kiện lọc từ các phân đoạn (segments) có sẵn.
• Cấu hình Input:
  • Trang (Page) / Giới hạn (Limit): Cấu hình phân trang dữ liệu trả về.
  • Tìm kiếm (Search): Tìm kiếm theo tên, email hoặc số điện thoại.
  • Tiêu chí Segment (Segment Criteria): Cấu hình logic lọc phức tạp (AND/OR) theo các thuộc tính khách hàng.
  • Chế độ Segment IDs: Chọn cách nhập segment (Array format hoặc Comma-separated string).
  • Segment IDs: Danh sách mã UUID của các segment cần lọc.
  • Có SĐT / Có Email: Lọc nhanh theo trạng thái có/không có thông tin liên lạc.
  • Nền tảng (Platform): Lọc theo nguồn nguồn gốc (Web, Facebook, Zalo OA, Zalo Personal...).
  • ID Tích hợp (Integration ID): Lọc theo mã định danh của kênh tích hợp.
  • ID Tag / Tag IDs: Lọc theo nhãn hoặc danh sách nhãn (UUID) được gắn cho khách hàng.
  • Là người theo dõi Zalo (Is Zalo Follower): Lọc theo trạng thái đã nhấn quan tâm/theo dõi OA hay chưa.

Zalo - Lấy thông tin chi tiết nhóm (Get Group Info)

• Chức năng: Truy vấn thông tin chi tiết của một nhóm Zalo cụ thể dựa trên quyền của tài khoản cá nhân.
• Cấu hình Input:
  • Chế độ chọn kết nối (Connection Mode): Lựa chọn Select from list hoặc Enter ID manually.
  • Tài khoản Zalo cá nhân (Zalo Personal Account): Tài khoản thực hiện truy vấn.
  • Chế độ chọn nhóm (Group Selection Mode): Lựa chọn Select from list hoặc Enter ID manually.
  • Nhóm Zalo (Zalo Group): Chọn nhóm từ danh sách hoặc nhập mã ID nhóm thủ công.