Coka - Ứng dụng đa chức năng dành cho CRM bất động sản

Showing 25 of 105 from the live probe.

• Coka Save Context

  Lưu context phiên làm việc — ghi nhớ organizationId và workspaceId mà người dùng đã chọn. Sau khi gọi coka_get_organizations và người dùng chọn tổ chức, gọi tool này để lưu organizationId. Tương tự với coka_get_workspaces/workspaceId. Context được giữ trong suốt phiên làm việc.

• Coka Load Context

  Đọc context phiên làm việc đã lưu — trả về organizationId và workspaceId mà người dùng đã chọn trước đó. Gọi tool này khi bạn KHÔNG CHẮC người dùng đang ở tổ chức/workspace nào, thay vì hỏi lại. Nếu context trống, hãy hỏi người dùng chọn tổ chức/workspace.

• Coka Get Token Instructions

  Nếu người dùng hoặc LLM phát hiện chưa có CokaToken, hãy gọi tool này để hiển thị hướng dẫn cấu hình token cho người dùng.

• Coka Get Profile

  Lấy thông tin cá nhân (fullName, phone, email, avatar, dob, gender) và quyền truy cập của tài khoản trên tổ chức này. Yêu cầu accessToken hợp lệ.

• Coka Get Organizations

  Lấy danh sách tổ chức. QUAN TRỌNG: Khi người dùng chọn tổ chức, gọi coka_save_context để ghi nhớ organizationId. Mọi thao tác sau ưu tiên dùng ID đã nhớ, KHÔNG hỏi lại.

• Coka Manage Organization Member

  Quản lý thành viên cấp Tổ chức (Organization Members). Hỗ trợ các action: - GET_ALL: Lấy toàn bộ danh sách thành viên. - GET_PERMISSIONS: Lấy danh sách thành viên kèm chi tiết phân quyền (OWNER/ADMIN/USER). - SEARCH: Tìm kiếm thành viên (Bắt buộc truyền searchText). - GET_INVITATIONS: Lấy danh sách các lời mời đã gửi (chưa phản hồi). - GET_REQUESTS: Lấy danh sách các yêu cầu xin gia nhập tổ chức. - INVITE: Mời tài khoản ĐÃ CÓ trên Coka tham gia tổ chức (Bắt buộc truyền profileId). - INVITE_EMAIL

• Coka Manage Permission Group

  Quản lý Nhóm quyền (Permission Groups) cấp độ Tổ chức. Hỗ trợ các action: - GET_ALL: Lấy danh sách các nhóm quyền. - GET_ROLES: Lấy chi tiết các quyền (roles) trong 1 nhóm quyền (Bắt buộc truyền groupId). - GET_MEMBERS: Lấy danh sách thành viên trong 1 nhóm quyền (Bắt buộc truyền groupId). - CREATE: Tạo nhóm quyền mới (Bắt buộc truyền name, có thể kèm description, scope). - UPDATE: Cập nhật thông tin (tên/mô tả) nhóm quyền (Bắt buộc truyền groupId, name). - DELETE: Xóa nhóm quyền (Bắt buộc truyề

• Coka Get Tags

  Lấy danh sách nhãn (tags) của tổ chức để phân loại Lead (ví dụ: mua bán, chuyển nhượng).

• Coka Get Leads

  Lấy danh sách Lead với bộ lọc nâng cao: theo thời gian (startDate/endDate), theo người phụ trách (assignees), theo kênh (channels). MẸO: Gọi coka_load_context trước để lấy organizationId đã lưu, tránh hỏi lại người dùng.

• Coka Get Lead Detail

  Lấy toàn bộ thông tin của một Lead: chi tiết (conversations, gender (0: Nam, 1: Nữ, 2: không xác định), maritalStatus...), lịch sử chăm sóc (journey), và hoạt động (schedules). Gọi 3 API song song.

• Coka Get Lead Journey

  Lấy lịch sử chăm sóc (journey) của một Lead. Trả về các sự kiện như LINK_CONVERSATION cùng jsonSummary.

• Coka Assign Lead

  Gán người phụ trách cho một Lead. Tool này sẽ TỰ ĐỘNG load danh sách thành viên tổ chức trước để kiểm tra profileId hợp lệ. - Gán cho **user**: truyền profileId (KHÔNG truyền teamId) - Gán cho **đội sale**: truyền teamId (KHÔNG truyền profileId, lấy teamId từ coka_get_teams) > **Lưu ý:** Chỉ được chọn 1 trong 2, KHÔNG được truyền cả profileId và teamId cùng lúc.

• Coka Set Lead Followers

  Đổi/gán người theo dõi cho một Lead. Tool này sẽ TỰ ĐỘNG load danh sách thành viên tổ chức trước để kiểm tra profileIds hợp lệ. - Gán **user** theo dõi: truyền profileIds (KHÔNG truyền teamIds) - Gán **đội sale** theo dõi: truyền teamIds (KHÔNG truyền profileIds, lấy teamIds từ coka_get_teams) > **Lưu ý:** Chỉ được chọn 1 trong 2, KHÔNG được truyền cả profileIds và teamIds cùng lúc.

• Coka Add Lead Tags

  Gán nhãn (tags) cho một Lead. Mặc định sẽ GIỮ LẠI nhãn cũ và THÊM nhãn mới (mode=add). Nếu người dùng muốn thay thế toàn bộ hoặc bỏ hết nhãn cũ, dùng mode=replace.

• Coka Update Lead Field

  Cập nhật một trường dữ liệu của Lead (ví dụ: gender, phone, email...). Cần truyền fieldName và value. (Lưu ý với gender: 0 là Nam, 1 là Nữ, 2 là không xác định)

• Coka Create Lead

  Tạo Lead (khách hàng tiềm năng) mới. TRƯỚC KHI GỌI TOOL NÀY, bạn PHẢI thực hiện theo quy trình: **BƯỚC 1 — Thông tin BẮT BUỘC:** 1. Hỏi: "Tên đầy đủ của Lead?" (fullName — BẮT BUỘC) **BƯỚC 2 — Hỏi có muốn điền thêm không:** 2. Hỏi: "Bạn có muốn điền thêm thông tin chi tiết không? (SĐT, email, nguồn, nhãn, người phụ trách...) Hay tạo ngay với thông tin tối giản?" → Nếu người dùng chọn "Tạo ngay" / "Không" → gọi tool ngay với chỉ fullName, các trường khác để mặc định. → Nếu người dùng chọn "Có"

• Coka Manage Schedule

  Quản lý hoạt động/lịch hẹn của một Lead trên Calendar. Lưu ý: API này dùng domain calendar.coka.ai. Hỗ trợ các action: - GET_ALL: Lấy danh sách lịch hẹn của Lead. Truyền contactId. - CREATE: Tạo lịch hẹn mới. Truyền các tham số bắt buộc. - UPDATE: Sửa lịch hẹn. Bắt buộc truyền scheduleId. - MARK_DONE: Đánh dấu hoàn thành/chưa hoàn thành. Bắt buộc truyền scheduleId và isDone.

• Coka Create Lead Note

  Thêm ghi chú chăm sóc mới vào lịch sử của một Lead. Dùng domain api.app2.coka.ai.

• Coka Update Lead Note

  Sửa nội dung ghi chú chăm sóc của một Lead. Dùng domain api.app2.coka.ai.

• Coka Delete Lead Note

  Xóa ghi chú chăm sóc của một Lead. Dùng domain api.app2.coka.ai.

• Coka Get Workspaces

  Lấy danh sách Workspace của tổ chức. Dùng khi cần chọn workspace cho Deal. Gọi coka_load_context trước để lấy organizationId đã lưu. QUAN TRỌNG: Khi người dùng chọn workspace, gọi coka_save_context để ghi nhớ workspaceId cho toàn bộ phiên.

• Coka Create Workspace

  Tạo Workspace mới. Gọi coka_load_context trước để lấy organizationId đã lưu. TRƯỚC KHI GỌI TOOL NÀY, bạn PHẢI thực hiện theo quy trình: **BƯỚC 1 — Lấy thông tin bắt buộc:** 1. Gọi coka_get_organizations → hiển thị danh sách tổ chức → hỏi người dùng chọn organizationId 2. Hỏi: "Tên Workspace muốn tạo là gì?" (name — BẮT BUỘC) **BƯỚC 2 — Xác nhận:** 3. Tóm tắt: "Sẽ tạo workspace tên 'X' trong tổ chức 'Y'. Xác nhận?" → Chỉ gọi tool khi người dùng xác nhận "Đồng ý". **BƯỚC 3 — Sau khi tạo thành c

• Coka Create Workspace With Stages

  Tạo Workspace mới và tự động khởi tạo pipeline giai đoạn (Stages). Gọi coka_load_context trước để lấy organizationId đã lưu. **Giai đoạn mặc định (áp dụng khi KHÔNG truyền customStages):** 1. "Đã tiếp nhận" 2. "Quan tâm" 3. "Không quan tâm" 4. "Giao dịch" **BƯỚC 1 — Lấy thông tin bắt buộc:** 1. Gọi coka_get_organizations → hiển thị danh sách tổ chức → hỏi người dùng chọn organizationId 2. Hỏi: "Tên Workspace muốn tạo là gì?" (name — BẮT BUỘC) 3. Hỏi: "Các giai đoạn mặc định muốn tạo?" (customS

• Coka Get Customers

  Tìm kiếm khách hàng (cá nhân hoặc doanh nghiệp) theo tên. Dùng khi cần: - Tìm khách hàng cá nhân: truyền isBusiness=false + searchText - Tìm doanh nghiệp: truyền isBusiness=true + searchText - Liệt kê tất cả: bỏ trống searchText

• Coka Create Customer

  Tạo khách hàng mới (cá nhân hoặc doanh nghiệp). Trả về customerId dùng để gắn vào Deal. Dùng khi: - Tìm kiếm bằng coka_get_customers không thấy khách hàng phù hợp - Cần tạo nhanh khách hàng mới để gắn vào Deal **TRƯỚC KHI GỌI:** 1. Hỏi tên khách hàng (fullName — BẮT BUỘC) 2. Hỏi: đây là cá nhân hay doanh nghiệp? (isBusiness) 3. Có thể bổ sung thêm: phone, email (không bắt buộc)