Công cụ AI — Marketing

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

Bật luồng tự động hoá

Write proposalScope: marketing:write

marketing_activate_workflow

Bật một luồng tự động hoá Marketing để bắt đầu chạy và gửi tin cho khách; kiểm như nút Bật trên mà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ả
`workflowName`	string	không	Tên luồng (bỏ trống nếu đang mở luồng trên màn)

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": "marketing_activate_workflow",
  "arguments": {
    "args": {
      "workflowName": "Chăm sóc khách mới"
    }
  }
}

Danh mục khối tự động hoá

ĐọcScope: marketing:read

marketing_automation_catalog

Danh mục khối dựng luồng tự động hoá Marketing: loại sự kiện kích hoạt, loại hành động (gửi ZNS, email, gắn thẻ…) kèm trường cấu hình, và các bước chờ, rẽ nhánh.

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/marketing/marketing_automation_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": "marketing_automation_catalog",
  "arguments": {
    "args": {}
  }
}

Kiểm đồ thị luồng

ĐọcScope: marketing:read

marketing_check_graph

Kiểm một đồ thị luồng Marketing chưa lưu bằng đúng bộ kiểm của nút Bật: bước mồ côi, vòng lặp, ô cấu hình thiếu, kênh chưa sẵn sàng. Không ghi gì.

Tham số	Kiểu	Bắt buộc	Mô tả
`graph`	object	không	Đồ thị gọn của luồng

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/marketing/marketing_check_graph/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"graph":{"trigger":"contact_created","steps":[{"ref":"S1","kind":"action","actionType":"send_email"},{"ref":"S2","kind":"wait","wait":{"wait_type":"duration_hours","duration_hours":24}},{"ref":"S3","kind":"action","actionType":"send_zns"}]}}'

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": "marketing_check_graph",
  "arguments": {
    "args": {
      "graph": {
        "trigger": "contact_created",
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "send_email"
          },
          {
            "ref": "S2",
            "kind": "wait",
            "wait": {
              "wait_type": "duration_hours",
              "duration_hours": 24
            }
          },
          {
            "ref": "S3",
            "kind": "action",
            "actionType": "send_zns"
          }
        ]
      }
    }
  }
}

Tạo biểu mẫu web

Write proposalScope: marketing:write

marketing_create_web_form

Tạo biểu mẫu web thu khách tiềm năng (nhúng vào website) từ mô tả: tên, loại, các trường, giao diện, hành động sau khi gửi. 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 biểu mẫu
`formType`	string	không	LeadCapture (mặc định), Survey, Registration…
`fields`	object[]	có	Các trường theo thứ tự hiển thị
`theme`	object	không	Giao diện
`submitAction`	object	không	Hành động sau khi gửi
`publish`	boolean	không	true = xuất bản ngay

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": "marketing_create_web_form",
  "arguments": {
    "args": {
      "name": "Đăng ký học thử yoga",
      "fields": [
        {
          "label": "Họ tên",
          "fieldType": "Text",
          "isRequired": true
        },
        {
          "label": "Số điện thoại",
          "fieldType": "Phone",
          "isRequired": true
        }
      ],
      "publish": false
    }
  }
}

Tạo luồng tự động hoá

Write proposalScope: marketing:write

marketing_create_workflow_from_graph

Tạo một luồng tự động hoá Marketing mới (gửi ZNS/email, chờ, rẽ nhánh…) từ đồ thị gọ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ả
`name`	string	có	Tên luồng
`goalType`	string	không	Mục tiêu luồng, mặc định Lead
`graph`	object	không	Đồ thị gọn của luồng

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": "marketing_create_workflow_from_graph",
  "arguments": {
    "args": {
      "name": "Chào mừng khách mới",
      "goalType": "Lead",
      "graph": {
        "trigger": "contact_created",
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "send_email"
          },
          {
            "ref": "S2",
            "kind": "wait",
            "wait": {
              "wait_type": "duration_hours",
              "duration_hours": 24
            }
          },
          {
            "ref": "S3",
            "kind": "action",
            "actionType": "send_zns"
          }
        ]
      }
    }
  }
}

Xoá trang landing

Write proposalScope: marketing:write

marketing_delete_landing

Xoá một trang landing. 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ả
`pageId`	string	có	Mã trang cần xoá

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": "marketing_delete_landing",
  "arguments": {
    "args": {
      "pageId": "00000000-0000-0000-0000-000000000000"
    }
  }
}

Chi tiết chiến dịch email

ĐọcScope: marketing:read

marketing_email_campaigns_get

Chi tiết một chiến dịch email.

Tham số	Kiểu	Bắt buộc	Mô tả
`id`	string	có	Id chiến dịch (lấy từ marketing_email_campaigns_search)

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

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

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": "marketing_email_campaigns_get",
  "arguments": {
    "args": {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b"
    }
  }
}

Chiến dịch email

ĐọcScope: marketing:read

marketing_email_campaigns_search

Danh sách chiến dịch email: tiêu đề, trạng thái, số gửi, mở, bấm; lọc theo trạng thái, từ khoá và số ngày gần nhất; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`status`	string	không	Trạng thái chiến dịch
`q`	string	không	Từ khoá
`days`	integer	không	Số ngày gần nhất
`page`	integer	không	Trang, bắt đầu từ 1
`size`	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/marketing/marketing_email_campaigns_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"days":30}'

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": "marketing_email_campaigns_search",
  "arguments": {
    "args": {
      "days": 30
    }
  }
}

Mẫu email

ĐọcScope: marketing:read

marketing_email_templates_search

Danh sách mẫu email, lọc theo nhóm và từ khoá; có phân trang.

Tham số	Kiểu	Bắt buộc	Mô tả
`category`	string	không	Nhóm mẫu
`q`	string	không	Từ khoá
`page`	integer	không	Trang, bắt đầu từ 1
`size`	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/marketing/marketing_email_templates_search/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"q":"khuyến mãi"}'

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": "marketing_email_templates_search",
  "arguments": {
    "args": {
      "q": "khuyến mãi"
    }
  }
}

Số liệu luồng tự động hoá

ĐọcScope: marketing:read

marketing_get_workflow_stats

Số liệu chạy của một luồng tự động hoá trong N ngày gần nhất so với N ngày trước: khách vào luồng, đang trong luồng, tin gửi được, bị bỏ qua, lỗi, chuyển đổi, doanh thu.

Tham số	Kiểu	Bắt buộc	Mô tả
`workflowName`	string	không	Tên luồng (bỏ trống nếu đang mở luồng trên màn)
`days`	integer	không	Số ngày gần nhất, mặc định 30

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/marketing/marketing_get_workflow_stats/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"workflowName":"Chăm sóc khách mới","days":30}'

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": "marketing_get_workflow_stats",
  "arguments": {
    "args": {
      "workflowName": "Chăm sóc khách mới",
      "days": 30
    }
  }
}

Tích hợp Google

ĐọcScope: marketing:read

marketing_integrations_list

Các tích hợp Google đã kết nối: loại, trạng thái, tài khoản, hạn token. Không trả token.

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/marketing/marketing_integrations_list/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": "marketing_integrations_list",
  "arguments": {
    "args": {}
  }
}

Trang landing

ĐọcScope: marketing:read

marketing_list_landing_pages

Danh sách trang landing của workspace: tên, đường dẫn, còn là nháp hay đã xuất bản. Không nhận tham số, không ghi gì.

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/marketing/marketing_list_landing_pages/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": "marketing_list_landing_pages",
  "arguments": {
    "args": {}
  }
}

Biểu mẫu web

ĐọcScope: marketing:read

marketing_list_web_forms

Danh sách biểu mẫu web thu khách tiềm năng: tên, trạng thái, số trường, lượt xem, lượt gửi và các trường.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Một phần tên biểu mẫu

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

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

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

Luồng tự động hoá

ĐọcScope: marketing:read

marketing_list_workflows

Danh sách luồng tự động hoá Marketing: tên, trạng thái (nháp, đang chạy, tạm dừng), loại sự kiện kích hoạt, số bước.

Tham số	Kiểu	Bắt buộc	Mô tả
`search`	string	không	Một phần tên luồng
`status`	string	không	Draft, Active hoặc Paused
`includeGraph`	boolean	không	true = kèm đồ thị khi chỉ còn một kết quả

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/marketing/marketing_list_workflows/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": "marketing_list_workflows",
  "arguments": {
    "args": {
      "status": "Active"
    }
  }
}

Tạm dừng luồng tự động hoá

Write proposalScope: marketing:write

marketing_pause_workflow

Tạm dừng một luồng tự động hoá đang chạy: ngừng đưa khách mới vào và ngừng gửi. 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ả
`workflowName`	string	không	Tên luồng (bỏ trống nếu đang mở luồng trên màn)

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": "marketing_pause_workflow",
  "arguments": {
    "args": {
      "workflowName": "Chăm sóc khách mới"
    }
  }
}

Xuất bản trang landing

Write proposalScope: marketing:write

marketing_publish_landing

Xuất bản một trang landing nháp để khách bên ngoài truy cập qua link. 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ả
`pageId`	string	có	Mã trang cần xuất bản

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": "marketing_publish_landing",
  "arguments": {
    "args": {
      "pageId": "00000000-0000-0000-0000-000000000000"
    }
  }
}

Tổng quan marketing

ĐọcScope: marketing:read

marketing_reports_overview

Tổng quan hiệu quả marketing (gửi, mở, bấm, chuyển đổi theo kênh) trong một khoảng ngày.

Tham số	Kiểu	Bắt buộc	Mô tả
`from`	string	không	Từ ngày (yyyy-MM-dd)
`to`	string	không	Đến ngày (yyyy-MM-dd)

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

curl -X POST https://api.nextx.vn/api/v1/ai/tools/marketing/marketing_reports_overview/read \
  -H "X-Api-Key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"from":"2026-10-01","to":"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": "marketing_reports_overview",
  "arguments": {
    "args": {
      "from": "2026-10-01",
      "to": "2026-10-27"
    }
  }
}

Lưu nháp trang landing

Write proposalScope: marketing:write

marketing_save_landing_draft

Lưu nháp một trang landing (khối hero, văn bản, bảng giá, biểu mẫu); không xuất bả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ả
`pageId`	string	không	Mã trang (bỏ trống để tạo trang mới)
`name`	string	có	Tên trang
`slug`	string	không	Đường dẫn trang
`title`	string	có	Tiêu đề khách nhìn thấy
`blocksJson`	string	có	Mảng khối của trang, dạng JSON

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": "marketing_save_landing_draft",
  "arguments": {
    "args": {
      "name": "Khuyến mãi tháng 11",
      "title": "Ưu đãi tháng 11",
      "blocksJson": "[]"
    }
  }
}

Người gửi email

ĐọcScope: marketing:read

marketing_sender_profiles_list

Danh sách người gửi email: tên, địa chỉ và trạng thái xác minh.

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/marketing/marketing_sender_profiles_list/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": "marketing_sender_profiles_list",
  "arguments": {
    "args": {}
  }
}

Gỡ xuất bản trang landing

Write proposalScope: marketing:write

marketing_unpublish_landing

Gỡ xuất bản một trang landing; link không còn hiển thị nội dung. 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ả
`pageId`	string	có	Mã trang cần 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": "marketing_unpublish_landing",
  "arguments": {
    "args": {
      "pageId": "00000000-0000-0000-0000-000000000000"
    }
  }
}

Sửa biểu mẫu web

Write proposalScope: marketing:write

marketing_update_web_form

Sửa một biểu mẫu web: thêm, bớt, sửa trường, đổi tên, giao diện, lời cảm ơn — gộp mọi thay đổi trong một 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ả
`formName`	string	có	Tên biểu mẫu cần sửa
`name`	string	không	Tên mới (nếu đổi)
`addFields`	object[]	không	Trường cần thêm
`removeFields`	string[]	không	Trường cần xoá
`updateFields`	object[]	không	Trường cần sửa
`theme`	object	không	Giao diện
`submitAction`	object	không	Hành động sau khi gửi

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": "marketing_update_web_form",
  "arguments": {
    "args": {
      "formName": "Đăng ký học thử yoga",
      "name": "Đăng ký học thử"
    }
  }
}

Sửa luồng tự động hoá

Write proposalScope: marketing:write

marketing_update_workflow_graph

Sửa một luồng tự động hoá đã có bằng cách gửi toàn bộ đồ thị sau khi sửa, kèm phiên bản đồ thị đã đọc; luồng đang chạy phải tạm dừng trước. 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ả
`workflowName`	string	không	Tên luồng (bỏ trống nếu đang mở luồng trên màn)
`baseVersion`	integer	không	Phiên bản đồ thị đã đọc
`graph`	object	không	Đồ thị gọn sau khi sửa

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": "marketing_update_workflow_graph",
  "arguments": {
    "args": {
      "workflowName": "Chào mừng khách mới",
      "baseVersion": 1834512907,
      "graph": {
        "trigger": "contact_created",
        "steps": [
          {
            "ref": "S1",
            "kind": "action",
            "actionType": "send_email"
          },
          {
            "ref": "S2",
            "kind": "wait",
            "wait": {
              "wait_type": "duration_hours",
              "duration_hours": 48
            }
          },
          {
            "ref": "S3",
            "kind": "action",
            "actionType": "send_zns"
          }
        ]
      }
    }
  }
}