nextX

Marketing

Chiến dịch email, mẫu email, tích hợp Google, báo cáo và hồ sơ người gửi.

6 endpoint · base /api/v1/marketing

GET/api/v1/marketing/email-campaignsThử ngay ▶

Liệt kê chiến dịch email.

Tool MCP: marketing_list_email_campaignsScope: marketing.email_campaigns.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
pageintquerykhông—
sizeintquerykhông—
statusstringquerykhông—
qstringquerykhông—

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/email-campaigns?page=1&size=20&status=...&q=... \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "name": "string",
      "subject": "string",
      "previewText": "string",
      "senderProfile": {
        "id": null,
        "fromName": null,
        "fromEmail": null
      },
      "templateId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "audienceFilter": {
        "logic": null,
        "conditions": null
      },
      "abTestEnabled": false,
      "abSubjectVariant": "string",
      "abSplitPct": 0,
      "status": "string",
      "recipientCount": 0,
      "scheduledAt": "2026-10-27T09:00:00+07:00",
      "sentAt": "2026-10-27T09:00:00+07:00",
      "createdAt": "2026-10-27T09:00:00+07:00",
      "updatedAt": "2026-10-27T09:00:00+07:00",
      "mergeTags": {},
      "optimizeSendTime": false,
      "sent": 0,
      "delivered": 0,
      "opensUnique": 0,
      "clicksUnique": 0,
      "excludeRecentDays": 0
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": false,
  "hasPreviousPage": false
}
GET/api/v1/marketing/email-campaigns/{id}Thử ngay ▶

Chi tiết 1 chiến dịch email.

Tool MCP: marketing_get_email_campaignScope: marketing.email_campaigns.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
idGUIDpathcó—

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/email-campaigns/<id> \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "name": "string",
  "subject": "string",
  "previewText": "string",
  "senderProfile": {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "fromName": "string",
    "fromEmail": "string"
  },
  "templateId": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "audienceFilter": {
    "logic": "string",
    "conditions": [
      {
        "field": null,
        "operator": null,
        "value": null
      }
    ]
  },
  "abTestEnabled": false,
  "abSubjectVariant": "string",
  "abSplitPct": 0,
  "status": "string",
  "recipientCount": 0,
  "scheduledAt": "2026-10-27T09:00:00+07:00",
  "sentAt": "2026-10-27T09:00:00+07:00",
  "createdAt": "2026-10-27T09:00:00+07:00",
  "updatedAt": "2026-10-27T09:00:00+07:00",
  "mergeTags": {},
  "optimizeSendTime": false,
  "sent": 0,
  "delivered": 0,
  "opensUnique": 0,
  "clicksUnique": 0,
  "excludeRecentDays": 0
}
GET/api/v1/marketing/email-templatesThử ngay ▶

Liệt kê mẫu email.

Tool MCP: marketing_list_email_templatesScope: marketing.email_templates.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
pageintquerykhông—
sizeintquerykhông—
categorystringquerykhông—
qstringquerykhông—

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/email-templates?page=1&size=20&category=...&q=... \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "items": [
    {
      "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "name": "string",
      "category": "string",
      "isSystem": false,
      "updatedAt": "2026-10-27T09:00:00+07:00",
      "editorMode": "string",
      "usedInCampaigns": 0
    }
  ],
  "totalCount": 0,
  "page": 0,
  "pageSize": 0,
  "totalPages": 0,
  "hasNextPage": false,
  "hasPreviousPage": false
}
GET/api/v1/marketing/google-integrationsThử ngay ▶

Liệt kê tích hợp Google (Analytics/Ads/Search Console).

Tool MCP: marketing_list_integrationsScope: marketing.integrations.viewOAuth người dùngAPI key / ứng dụng

Tham số

Không có tham số.

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/google-integrations \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

[
  {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "integrationType": "string",
    "status": "string",
    "googleAccountEmail": "string",
    "scopes": [
      "string"
    ],
    "connectedAt": "2026-10-27T09:00:00+07:00",
    "tokenExpiresAt": "2026-10-27T09:00:00+07:00",
    "lastRefreshedAt": "2026-10-27T09:00:00+07:00",
    "selectedResourceId": "string",
    "selectedResourceName": "string"
  }
]
GET/api/v1/marketing/reports/overviewThử ngay ▶

Tổng quan báo cáo marketing theo khoảng ngày.

Tool MCP: marketing_get_report_overviewScope: marketing.reports.viewOAuth người dùngAPI key / ứng dụng

Tham số

Tham sốKiểuVị tríBắt buộcMô tả
fromdatequerykhôngYYYY-MM-DD
todatequerykhôngYYYY-MM-DD

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/reports/overview?from=2026-06-01&to=2026-06-01 \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

{
  "period": {
    "from": "string",
    "to": "string"
  },
  "kpis": {
    "totalSent": 0,
    "deliveredRate": 0,
    "openRate": 0,
    "clickRate": 0,
    "conversionRate": 0,
    "revenue": 0
  },
  "byDay": [
    {
      "date": "string",
      "sent": 0,
      "opens": 0,
      "clicks": 0,
      "conversions": 0
    }
  ],
  "byChannel": [
    {
      "channel": "string",
      "sent": 0,
      "openRate": 0,
      "clickRate": 0,
      "conversionRate": 0,
      "delivered": 0,
      "failed": 0,
      "revenue": 0
    }
  ]
}
GET/api/v1/marketing/settings/sender-infoThử ngay ▶

Liệt kê hồ sơ người gửi (sender info).

Tool MCP: marketing_list_sender_profilesScope: marketing.sender_profiles.viewOAuth người dùngAPI key / ứng dụng

Tham số

Không có tham số.

Ví dụ

curl https://api.nextx.vn/api/v1/marketing/settings/sender-info \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

Ví dụ phản hồi

[
  {
    "id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
    "fromName": "string",
    "fromEmail": "string",
    "replyTo": "string",
    "isDefault": false,
    "isVerified": false,
    "verifiedAt": "2026-10-27T09:00:00+07:00",
    "dkimStatus": "string",
    "spfStatus": "string",
    "createdAt": "2026-10-27T09:00:00+07:00",
    "brevoSenderId": 0,
    "domain": "string",
    "isFreemailDomain": false,
    "dkimRecord": "string",
    "dkimRecordHost": "string",
    "spfRecord": "string"
  }
]