API Reference
Tổng quan
Các route API của ACAP Platform được xây dựng toàn bộ thông qua tRPC. Nghĩa là không có chuẩn REST method truyền thống. Mọi lời gọi đều được định tuyến qua trpc/[router].[action].
1. Quick Reference
Hệ thống cung cấp các khối Router chính:
auth: Quản lý session.channel: Kênh kết nối (Zalo, Web).conversation: Cuộc trò chuyện.message: Nhắn tin (AI & Khách).
2. Danh sách Endpoints quan trọng
Message Router
Xử lý các tin nhắn từ người dùng.
| TrPC Path | Input Schema | Purpose |
|---|---|---|
message.send | { conversationId: number, content: string, role?: string } | Gửi tin nhắn từ agent vào hội thoại. |
message.aiReply | { conversationId: number, customerMessage: string } | Kích hoạt AI tạo ra phản hồi cho khách. Đầu vào là user message mới nhất. |
Mã nguồn (Client Side - React)
tsx
const mutation = trpc.message.aiReply.useMutation({
onSuccess: (data) => {
console.log("Tokens used:", data.tokensUsed);
}
});
// Gọi khi khách hàng gửi
mutation.mutate({ conversationId: 101, customerMessage: "Chào shop" });Analytics & Alerts Router
Dùng cho trang giao diện tổng quan quản trị.
| TrPC Path | Mục đích |
|---|---|
analytics.dashboard | Trả về tổng số lượng tin nhắn, độ hài lòng trung bình (CSAT/Sentiment) và chất lượng. |
alert.list | Liệt kê các cảnh báo đỏ. Ví dụ cạn kiệt token, bất thường trong đoạn hội thoại (Anomaly). |
alert.resolve | Đánh dấu sự cố đã được admin giải quyết. |
Links nội bộ liên quan: