Bảng điều khiển

Tổng quan vận hành AIECOS Social CRM

Tổng đối tác
——
Khách duy nhất
Đang hoạt động
——
≤ 7 ngày tương tác
Cần chú ý
——
7–30 ngày im
Ngưng tương tác
——
> 30 ngày im
Tổng tin nhắn
——
Trong 30 ngày

Xu hướng tin nhắn — 14 ngày qua

Khách vs Nhân viên

Theo kênh

Phân bố trạng thái đối tác

Đang tải...

Bản đồ hoạt động theo giờ

Đang tải...

Sức khỏe Hộp thư

Đang tải...

Thời gian phản hồi

Đang tải...

Đối tác mới (14 ngày)

Giờ cao điểm

Tỉ lệ phản hồi theo kênh

Đang tải...

Tín hiệu cảm xúc

Đang tải...

Top 5 đối tác (tuần này)

Đang tải...

Hoạt động gần đây

Đang tải...

Đối tác cần chăm sóc

Auto-alert partners chuyển At-Risk hoặc Dormant

KHẨN — At-Risk (cần liên hệ trong 1-3 ngày)

Đang tải...

CẦN GỌI LẠI — Dormant + Churned

Đang tải...

Inbox

3 cột: Trang · Hội thoại · Tin nhắn + Thông tin khách

Trang
Đang tải...
Hội thoại
Đang tải...
Chọn 1 hội thoại để xem tin nhắn
Tin nhắn
Thông tin khách

Pipeline

Phân nhóm đối tác theo mức độ hoạt động (last contact)

Partner 360

Quản lý đối tác B2B — click 1 dòng để xem chi tiết

PartnerPageStageDays silentLast seen
Đang tải...

Phân tích hiệu suất

Phân tích chuyên sâu — tin nhắn, hoạt động partner, channel mix

Tổng tin nhắn
—
Trong khoảng thời gian
Đối tác active
—
≤ 7 ngày tương tác
Đối tác im
—
At-Risk + Dormant
Tỉ lệ phản hồi
—
Agent / Tổng tin
Avg tin/đối tác
—
Trong khoảng
Avg im (ngày)
—
Trung bình/đối tác

Tin nhắn theo ngày — Khách vs Nhân viên

Tỉ lệ Khách vs Nhân viên

Top đối tác theo số tin

Đang tải...

Bản đồ hoạt động theo giờ (30 ngày qua)

Đang tải...

Phân bố theo giờ

Top sender (theo tên)

Đang tải...

Phân bố theo ngày trong tuần

Báo cáo

Xuất báo cáo + CSV từ data tin nhắn

Khoảng thời gian
last 30d
Tin nhắn trong khoảng
—
Đối tác active
—
Cần chú ý
—

Tuỳ chọn xuất

Xem trước báo cáo

Đang tải...

Hướng dẫn & MCP setup

Bắt đầu nhanh + hướng dẫn kết nối MCP cho Claude

Quick start
MCP setup
Chrome extension
API reference

5-minute setup

  1. Clone repo: git clone https://github.com/aiecosvietnam/aiecos-social-crm
  2. Boot Docker stack: cp .env.example .env && docker compose up -d
  3. Seed demo data: bash examples/seed-demo-data.sh
  4. Open this UI → Settings → enter Supabase URL http://localhost:3000
  5. Install Chrome extension → chrome://extensions/ → Load unpacked → chọn chrome-extension/ folder
  6. Configure extension: enter server URL + API token từ .env

5-stage partner classification

● Active≤ 3 ngày tương tácHealthy
● Sleeping3-7 ngày imĐáng theo dõi
● At-Risk7-30 ngày imCần outreach
● Dormant30-90 ngày imRevival campaign
● Churned> 90 ngày imCó thể lost

1. Install MCP server

cd mcp-server && npm install

2. Add to ~/.claude.json

Edit Claude config — append vào mcpServers object:

{
  "mcpServers": {
    "aiecos-social-crm": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/aiecos-social-crm/mcp-server/index.js"],
      "env": {
        "AIECOS_SUPABASE_URL": "https://your-project.supabase.co",
        "AIECOS_SUPABASE_KEY": "eyJhbGc...your-service-role-key",
        "AIECOS_SCHEMA": "aiecos_social"
      }
    }
  }
}

3. Restart Claude Code → 8 tools available

  • summary — tổng quan
  • list_partners(stage?) — list theo stage
  • get_partner_messages(conv_id) — lịch sử 1 partner
  • search_messages(query) — tìm tin nhắn
  • get_at_risk_partners(min_days?, max_days?)
  • pipeline_stats — phân bố 5 stages
  • top_partners_by_volume(limit?, days?)
  • recent_activity(limit?)

Example prompts

Use MCP aiecos-social-crm: show me summary + top 5 partners by msg volume this week
aiecos-social-crm: list dormant partners and suggest re-engagement messages for each
aiecos-social-crm: search messages with "pricing" or "discount" in the last 30 days

Install AIECOS Pancake Connector

  1. Mở chrome://extensions/
  2. Bật Developer mode (góc phải trên)
  3. Click Load unpacked
  4. Chọn folder chrome-extension/
  5. Pin icon AIECOS lên toolbar
  6. Click icon → nhập Server URL (sync receiver) + API Token
  7. Mở app.pancake.vn → extension tự sync mỗi phút
  8. Bấm SYNC ALL để walk hết history

Sync receiver endpoints

MethodPathDescription
GET/api/statusHealth check (public)
POST/api/syncPush messages (batch or single)
POST/api/channel/registerRegister a new page
GET/api/channelsList registered pages
POST/api/admin/refresh-aggregatesRecompute page counts

Auth: X-AIECOS-Token: <your-token> header on all protected endpoints.

Test with curl

curl -X POST http://localhost:3500/api/sync \
  -H "X-AIECOS-Token: $API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @examples/sample-batch-payload.json

Cài đặt

Cấu hình kết nối Supabase

Config lưu trong localStorage. Bỏ trống = chạy demo mode với sample data.