Công cụ AI — Tổng đài

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

Tổng đài viên

ĐọcScope: call:read

call_agents_search

Danh sách tổng đài viên: máy nhánh, trạng thái (Available, OnCall, Paused, Acw, Offline) và hàng đợi phụ trách.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Lọc theo trạng thái tổng đài viên
`search`	string	không	Tên hoặc máy nhánh
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

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

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": "call_agents_search",
  "arguments": {
    "args": {
      "status": "Available"
    }
  }
}

Luồng cuộc gọi

ĐọcScope: call:read

call_call_flows_search

Danh sách luồng cuộc gọi tự động, lọc theo trạng thái và tên.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái luồng
`search`	string	không	Tên luồng
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

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

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": "call_call_flows_search",
  "arguments": {
    "args": {
      "search": "CSKH"
    }
  }
}

Lịch sử cuộc gọi

ĐọcScope: call:read

call_calls_search

Lịch sử cuộc gọi trong phạm vi người dùng được xem: lọc theo chiều gọi (Inbound, Outbound), trạng thái, tổng đài viên, khoảng ngày và số điện thoại.

Tham số	Kiểu	Bắt buộc	Mô tả
`direction`	string	không	Inbound hoặc Outbound
`status`	string	không	Ringing, Answered, Completed, Missed, Abandoned, Voicemail hoặc Failed
`agentId`	string	không	Id tổng đài viên
`dateFrom`	string	không	Từ ngày (yyyy-MM-dd)
`dateTo`	string	không	Đến ngày (yyyy-MM-dd)
`search`	string	không	Số điện thoại
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/call/call_calls_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"direction":"Inbound","status":"Missed","dateFrom":"2026-10-27","dateTo":"2026-10-27"}'

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": "call_calls_search",
  "arguments": {
    "args": {
      "direction": "Inbound",
      "status": "Missed",
      "dateFrom": "2026-10-27",
      "dateTo": "2026-10-27"
    }
  }
}

Chiến dịch gọi

ĐọcScope: call:read

call_campaigns_search

Danh sách chiến dịch gọi (Draft, Active, Paused, Completed, Cancelled), tìm theo tên.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái chiến dịch
`search`	string	không	Tên chiến dịch
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

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

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": "call_campaigns_search",
  "arguments": {
    "args": {
      "status": "Active"
    }
  }
}

Kịch bản IVR

ĐọcScope: call:read

call_ivr_flows_search

Danh sách kịch bản trả lời tự động (IVR), lọc theo trạng thái và tên.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái kịch bản
`search`	string	không	Tên kịch bản
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/call/call_ivr_flows_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"search":"Tổng đài chính"}'

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": "call_ivr_flows_search",
  "arguments": {
    "args": {
      "search": "Tổng đài chính"
    }
  }
}

Đầu số tổng đài

ĐọcScope: call:read

call_phone_numbers_search

Danh sách đầu số của tổng đài, đang dùng hoặc đã tắt, có tìm kiếm.

Tham số	Kiểu	Bắt buộc	Mô tả
`isActive`	boolean	không	true = chỉ đầu số đang dùng
`search`	string	không	Số điện thoại
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/call/call_phone_numbers_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"isActive":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": "call_phone_numbers_search",
  "arguments": {
    "args": {
      "isActive": true
    }
  }
}

Hàng đợi cuộc gọi

ĐọcScope: call:read

call_queues_search

Danh sách hàng đợi cuộc gọi, đang dùng hoặc đã tắt, có tìm kiếm.

Tham số	Kiểu	Bắt buộc	Mô tả
`isActive`	boolean	không	true = chỉ hàng đợi đang dùng
`search`	string	không	Tên hàng đợi
`page`	integer	không	Trang, bắt đầu từ 1
`pageSize`	integer	không	Số dòng mỗi trang, tối đa 50

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/call/call_queues_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"isActive":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": "call_queues_search",
  "arguments": {
    "args": {
      "isActive": true
    }
  }
}