Công cụ AI — Chat đa kênh

16 công cụ. Schema luôn mới nhất ở comm_tool_catalog khi đã kết nối.

Thao tác quảng cáo Meta

ĐọcScope: comm:read

ads_catalog

Danh sách thao tác quảng cáo Meta (Facebook/Instagram) mà tài khoản quảng cáo đã kết nối dùng được, kèm mô tả và tham số của từng thao tác.

Không có tham số.

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/ads_catalog/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "ads_catalog",
  "arguments": {
    "args": {}
  }
}

Đọc số liệu quảng cáo Meta

ĐọcScope: comm:read

ads_read

Chạy một thao tác đọc của Meta Ads (tên lấy từ ads_catalog): chiến dịch, chi tiêu, kết quả, nhóm quảng cáo.

Tham số	Kiểu	Bắt buộc	Mô tả
`tool`	string	có	Tên thao tác đọc lấy từ ads_catalog
`arguments`	object	không	Tham số theo schema của thao tác

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/ads_read/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"tool":"list_campaigns","arguments":{}}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "ads_read",
  "arguments": {
    "args": {
      "tool": "list_campaigns",
      "arguments": {}
    }
  }
}

Thêm hỏi–đáp cho trợ lý chat

Write proposalScope: comm:write

comm_add_ai_bot_qa

Thêm các cặp hỏi–đáp vào kiến thức của một trợ lý trả lời khách đang có (tối đa 50 cặp mỗi lần). Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`botName`	string	có	Tên trợ lý nhận hỏi–đáp
`pairs`	object[]	có	Danh sách cặp hỏi–đáp

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_add_ai_bot_qa",
  "arguments": {
    "args": {
      "botName": "Tư vấn khoá tiếng Anh",
      "pairs": [
        {
          "question": "Học phí khoá cơ bản bao nhiêu?",
          "answer": "Khoá cơ bản 3 tháng giá 3.000.000đ.",
          "category": "Học phí"
        }
      ]
    }
  }
}

Thay đổi quảng cáo Meta

Write proposalScope: comm:write

comm_ads_change

Thay đổi trên tài khoản quảng cáo Meta (bật/tắt chiến dịch, đổi ngân sách, tạo hoặc sửa quảng cáo) bằng một thao tác ghi lấy từ ads_catalog. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`tool`	string	có	Tên thao tác ghi lấy từ ads_catalog
`arguments`	object	không	Tham số theo schema của thao tác
`summary`	string	có	Một câu mô tả sẽ đổi gì

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_ads_change",
  "arguments": {
    "args": {
      "tool": "update_campaign_run_status",
      "arguments": {
        "campaign_id": "120212345678900001",
        "status": "PAUSED"
      },
      "summary": "Tạm dừng chiến dịch Khuyến mãi tháng 10"
    }
  }
}

Số liệu nhân viên trực chat

ĐọcScope: comm:read

comm_agents_performance

Số liệu nhân viên trực hộp thư: số hội thoại đã xử lý xong trong kỳ, hoặc khối lượng hội thoại đang phụ trách.

Tham số	Kiểu	Bắt buộc	Mô tả
`metric`	string	không	resolved = đã xử lý xong trong kỳ; workload = đang phụ trách
`period`	string	không	Kỳ thống kê: today (mặc định) hoặc week

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_agents_performance/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"metric":"resolved","period":"week"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_agents_performance",
  "arguments": {
    "args": {
      "metric": "resolved",
      "period": "week"
    }
  }
}

Nhận hội thoại về mình

Write proposalScope: comm:write

comm_assign_to_me

Nhận xử lý một hội thoại đang mở trong hộp thư về chính người dùng. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`customer_query`	string	có	Tên hoặc số điện thoại khách để tìm hội thoại
`conversation_ref`	string	không	Mã hội thoại (HT-…) nếu đã biết

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_assign_to_me",
  "arguments": {
    "args": {
      "customer_query": "Nguyễn An"
    }
  }
}

Số liệu trợ lý tự động

ĐọcScope: comm:read

comm_bot_stats

Số liệu trợ lý tự động trong hộp thư theo kỳ: số hội thoại bot xử lý, số phải chuyển nhân viên và tỷ lệ tự xử lý; có thể chia theo kênh.

Tham số	Kiểu	Bắt buộc	Mô tả
`period`	string	không	Kỳ thống kê: today (mặc định) hoặc week
`groupBy`	string	không	channel = chia theo kênh; bỏ trống = tổng

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_bot_stats/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"period":"week","groupBy":"channel"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_bot_stats",
  "arguments": {
    "args": {
      "period": "week",
      "groupBy": "channel"
    }
  }
}

Trạng thái kênh chat

ĐọcScope: comm:read

comm_channels_status

Các kênh chat đã kết nối và tình trạng từng kênh: loại kênh, tên trang/tài khoản, trạng thái (Active, Error, PendingReconnect, Disconnected), webhook đã xác minh chưa.

Tham số	Kiểu	Bắt buộc	Mô tả
`channelType`	string	không	Lọc theo loại kênh; bỏ trống = tất cả
`activeOnly`	boolean	không	true = chỉ kênh đang hoạt động

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_channels_status/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"activeOnly":true}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_channels_status",
  "arguments": {
    "args": {
      "activeOnly": true
    }
  }
}

Đóng hội thoại

Write proposalScope: comm:write

comm_close_conversation

Đóng một hội thoại đang mở trong hộp thư. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`customer_query`	string	có	Tên hoặc số điện thoại khách để tìm hội thoại
`conversation_ref`	string	không	Mã hội thoại (HT-…) nếu đã biết

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_close_conversation",
  "arguments": {
    "args": {
      "customer_query": "0901234567"
    }
  }
}

Tìm hội thoại

ĐọcScope: comm:read

comm_conversations_search

Tìm hội thoại trong hộp thư đa kênh, lọc theo tên khách, kênh, trạng thái, người phụ trách, tin chưa đọc, mức ưu tiên, cảm xúc khách, quá hạn xử lý, thời gian chờ, giai đoạn bán hàng và khoảng ngày; phân trang bằng con trỏ.

Tham số	Kiểu	Bắt buộc	Mô tả
`q`	string	không	Tên khách
`channelType`	string	không	Facebook, Instagram, ZaloOa, ZaloPersonal, Telegram, Widget, Shopee, Lazada hoặc TikTokShop
`status`	string	không	Open, WaitingAgent, BotHandling hoặc Resolved
`assignedTo`	string	không	me = của tôi; unassigned = chưa ai phụ trách
`unreadOnly`	boolean	không	true = chỉ hội thoại còn tin chưa đọc
`priority`	string	không	Mức ưu tiên
`sentiment`	string	không	Cảm xúc khách (vd Angry, Negative)
`slaBreached`	boolean	không	true = chỉ hội thoại quá hạn cam kết
`awaitingOverHours`	integer	không	Khách đã chờ phản hồi ít nhất N giờ
`salesStage`	string	không	Giai đoạn bán hàng của hội thoại
`resolvedInDays`	integer	không	Chỉ hội thoại đã đóng trong N ngày
`createdFrom`	string	không	Tạo từ ngày (YYYY-MM-DD)
`createdTo`	string	không	Tạo đến ngày (YYYY-MM-DD)
`limit`	integer	không	Số hội thoại mỗi lượt, tối đa 30
`cursor`	string	không	Con trỏ trang sau (nextCursor của lượt trước)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_conversations_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"assignedTo":"unassigned","unreadOnly":true}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_conversations_search",
  "arguments": {
    "args": {
      "assignedTo": "unassigned",
      "unreadOnly": true
    }
  }
}

Tạo trợ lý trả lời khách

Write proposalScope: comm:write

comm_create_ai_bot

Tạo một trợ lý tự trả lời khách trên Facebook, Zalo hoặc widget website từ mô tả: tên, ngành, giọng, chế độ trả lời, câu dự phòng, kênh, giờ làm và hỏi–đáp ban đầu. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`name`	string	có	Tên trợ lý
`industry`	string	có	Ngành (vd Giáo dục, Spa)
`tone`	string	không	Friendly hoặc Professional…
`mode`	string	không	Auto, Hybrid…
`fallbackMessage`	string	không	Câu trả lời khi trợ lý không chắc
`personaPrompt`	string	không	Cách xưng hô và tính cách
`channelTypes`	string[]	có	Facebook, ZaloOa, ZaloPersonal, Widget
`maxEscalateAttempts`	integer	không	Số lần không chắc trước khi chuyển nhân viên
`businessHours`	object	không	Giờ làm (giờ Việt Nam)
`qaPairs`	object[]	không	Hỏi–đáp ban đầu

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_create_ai_bot",
  "arguments": {
    "args": {
      "name": "Tư vấn khoá tiếng Anh",
      "industry": "Giáo dục",
      "channelTypes": [
        "Facebook"
      ]
    }
  }
}

Đếm hộp thư theo kênh

ĐọcScope: comm:read

comm_inbox_breakdown

Đếm hộp thư theo kênh: hội thoại đang mở, tổng hội thoại, hội thoại còn tin chưa đọc, khách mới hoặc khách quay lại.

Tham số	Kiểu	Bắt buộc	Mô tả
`metric`	string	không	Trục đếm, mặc định conversations_open
`days`	integer	không	Số ngày gần đây (với new_contacts)
`period`	string	không	Kỳ thống kê (với returning_customers)

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_inbox_breakdown/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"metric":"unread"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_inbox_breakdown",
  "arguments": {
    "args": {
      "metric": "unread"
    }
  }
}

Tin nhắn của hội thoại

ĐọcScope: comm:read

comm_messages_get

Các tin nhắn gần nhất của một hội thoại theo thứ tự thời gian: chiều gửi, người gửi, loại tin, nội dung, trạng thái giao nhận, ghi chú nội bộ.

Tham số	Kiểu	Bắt buộc	Mô tả
`conversationId`	string	có	Id hội thoại (lấy từ comm_conversations_search)
`limit`	integer	không	Số tin cần đọc, tối đa 50

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_messages_get/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"conversationId":"0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b","limit":20}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_messages_get",
  "arguments": {
    "args": {
      "conversationId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "limit": 20
    }
  }
}

Khối lượng tin nhắn

ĐọcScope: comm:read

comm_messages_volume

Khối lượng tin nhắn của hộp thư trong kỳ, tách chiều đến và chiều đi; hoặc phân bổ theo khung giờ trong ngày.

Tham số	Kiểu	Bắt buộc	Mô tả
`period`	string	không	Kỳ thống kê: today (mặc định) hoặc week
`groupBy`	string	không	hour = phân bổ theo giờ trong hôm nay

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_messages_volume/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"period":"week"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_messages_volume",
  "arguments": {
    "args": {
      "period": "week"
    }
  }
}

Phễu bán hàng trong hộp thư

ĐọcScope: comm:read

comm_sales_pipeline

Phễu bán hàng của chính các hội thoại chat theo giai đoạn nhân viên gắn: New, Consulting, Quoted, Won, Lost.

Tham số	Kiểu	Bắt buộc	Mô tả
`period`	string	không	Kỳ thống kê: today (mặc định) hoặc week

Hoặc gọi REST bằng API key

curl -X POST https://api.nextx.vn/api/v1/ai/tools/comm/comm_sales_pipeline/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"period":"week"}'

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_sales_pipeline",
  "arguments": {
    "args": {
      "period": "week"
    }
  }
}

Sửa trợ lý trả lời khách

Write proposalScope: comm:write

comm_update_ai_bot

Sửa cấu hình một trợ lý trả lời khách đang có: tên, ngành, giọng, chế độ trả lời, câu dự phòng, cách xưng hô, kênh, số lần thử trước khi chuyển nhân viên, giờ làm. Tạo đề xuất; người dùng bấm Xác nhận trong app mới thực hiện.

Tham số	Kiểu	Bắt buộc	Mô tả
`botName`	string	có	Tên trợ lý cần sửa
`name`	string	không	Tên mới (nếu đổi)
`industry`	string	không	Ngành
`tone`	string	không	Giọng
`mode`	string	không	Chế độ trả lời
`fallbackMessage`	string	không	Câu dự phòng
`personaPrompt`	string	không	Cách xưng hô
`channelTypes`	string[]	không	Kênh
`maxEscalateAttempts`	integer	không	Số lần trước khi chuyển nhân viên
`businessHours`	object	không	Giờ làm

Ví dụ gọi qua MCP (dành cho trợ lý AI)

Trợ lý AI tự gửi lệnh này khi bạn hỏi bằng lời; bạn chỉ cần xem khi tự gỡ lỗi kết nối MCP.

{
  "name": "comm_update_ai_bot",
  "arguments": {
    "args": {
      "botName": "Shop A",
      "tone": "Professional"
    }
  }
}