🤖 Demo: Agent-Native Custom Fields

Đây là tài liệu hướng dẫn demo khả năng tích hợp linh hoạt 100% của AI Agent vào hệ thống SaleHay CRM thông qua tính năng Agent-Native Custom Fields.

Với cơ chế này, tổ chức không cần IT can thiệp thiết kế Database hay tạo UI builder phức tạp. Doanh nghiệp chỉ cần gõ yêu cầu bằng Markdown, Agent tự phân tích và nhúng dữ liệu vào hệ thống qua giao thức JSONB.

1. Mục đích Demo

Bài toán: Spa A muốn quản lý "Tình trạng da" và "Tiền sử đi Spa". Trong khi Phòng Khám B lại muốn quản lý "Khoa khám" và "Mã bảo hiểm". Làm sao giải quyết bằng một CRM dùng chung?
Giải pháp: SaleHay sở hữu luồng Agent-Native. Agent tự động parse tin nhắn khách hàng qua kỹ xảo NLP, map theo yêu cầu của Doanh nghiệp và gọi API update động custom_fields.

2. Kịch bản dành cho OpenFang

Bạn hãy mở OpenFang (hoặc công cụ Agent khác như Claude Desktop, OpenClaw) với MCP Server của SaleHay đã bật.

Sao chép toàn bộ Prompt dưới đây và gửi cho Agent:

text

Bạn là AI Telesales cho "Mộc Spa". Vừa có một khách hàng nhắn tin tới như sau:

"Chào em, chị tên Hương, SĐT 0912345678. Chị dạo này da hay đổ dầu, nổi mụn bọc. Chị đang dùng BHA Obagi 2% thấy khô bong tróc da quá. Chị làm dân văn phòng ngồi máy lạnh suốt. Trước đây chị hay đi nặn mụn ở spa gần nhà nhưng giờ chuyển sang bên em."

Nhiệm vụ của bạn (tuân thủ nghiêm ngặt bằng MCP Tools):
1. **Tạo Lead** cho khách hàng Hương (dùng số điện thoại 0912345678).
2. **Trích xuất thông tin** chuyên môn từ lời khách thành đối tượng JSON `custom_fields` gồm các key sau: 
   - "Tình trạng da"
   - "Sản phẩm đang dùng"
   - "Môi trường"
   - "Tiền sử Spa"
3. Dùng công cụ **Cập nhật Lead** `crm_update_lead` (với lead_id vừa tạo) để truyền toàn bộ cấu trúc vừa trích vào trường `custom_fields` trên hệ thống. Trạng thái để là "new", mức độ "high".
4. Cuối cùng, **Log một cuộc trò chuyện** vào lịch sử báo cáo khách để lưu trữ quá trình làm việc.

3. Quá trình xử lý (Dự kiến)

OpenFang thấy nhiệm vụ 1 -> Gọi tool crm_create_lead(phone="0912345678", name="Hương"). SaleHay CRM báo tạo hệ thống thành công và trả về ID.

OpenFang dùng LLM NLP trích xuất dữ liệu của Hương ra thành:

json

{
   "Tình trạng da": "Đổ dầu, nổi mụn bọc, bong tróc",
   "Sản phẩm đang dùng": "BHA Obagi 2%",
   "Môi trường": "Văn phòng máy lạnh",
   "Tiền sử Spa": "Từng nặn mụn ở spa gần nhà"
}

OpenFang gọi tool crm_update_lead truyền JSON trên vào.
Hệ thống Admin của SaleHay tức thì xuất hiện thẻ thông tin tùy biến của khách hàng Hương được hiển thị đẹp đẽ bên trong Giao diện Quản lý không cần Reload!!

4. Video Quay Màn Hình Thực Tế

Vui lòng thêm Video Demo / File GIF của bạn vào đây để hoàn thiện tài liệu sau khi bạn đã thực hành trên máy.

Ý nghĩa kỹ thuật

Đội ngũ kỹ sư SaleHay sử dụng kiến trúc PostgreSQL JSONB kết hợp cùng Dynamic Render phía Frontend React. Việc gửi một payload JSON phức tạp từ Edge Model Context Protocol (MCP) về Core Backend được Rate-limit bảo vệ ở Worker Node. Dữ liệu sau đó nằm phẳng trên CSDL để dễ phân tích Cohort sau này.

🤖 Demo: Agent-Native Custom Fields ​

1. Mục đích Demo ​

2. Kịch bản dành cho OpenFang ​

3. Quá trình xử lý (Dự kiến) ​