Sequenzy MCP

Máy chủ Sequenzy MCP

Máy chủ MCP chính thức cho Sequenzy, nền tảng tiếp thị email hỗ trợ AI.

Kết nối Sequenzy với Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw và các máy khách MCP khác để trợ lý AI của bạn có thể quản lý các hoạt động email bằng các công cụ có cấu trúc thay vì các lệnh gọi API viết tay.

Những Gì Bạn Có Thể Làm

• Quản lý người đăng ký, thẻ, danh sách và phân khúc động, bao gồm đối chiếu thẻ hàng loạt và kiểm thử sự kiện tổng hợp.
• Đồng bộ phân khúc sang đối tượng tùy chỉnh Meta cho tiếp thị lại trên Facebook và Instagram.
• Quản lý sản phẩm và đính kèm tệp giao hàng kỹ thuật số cho tự động hóa mua hàng.
• Tải lên hình ảnh email được lưu trữ với văn bản thay thế và cài đặt cắt xén đáp ứng tái sử dụng.
• Soạn thảo, cập nhật, lên lịch và kiểm tra chiến dịch, bao gồm xem trước đối tượng đã phân giải, mục tiêu chuyển đổi được lưu trữ và danh tính Người gửi, Trả lời, CC và BCC.
• Kết xuất chiến dịch, bước chuỗi và mẫu sang HTML an toàn email chính xác mà không cần gửi.
• Thêm khối khảo sát Poll và NPS một cú nhấp chuột vào email và kiểm tra tóm tắt phản hồi chiến dịch.
• Tạo và chỉnh sửa chuỗi email, bao gồm trình kích hoạt nhiều danh sách/thẻ, điều kiện dừng theo bộ lọc đối tượng và thuộc tính, ghi đè danh tính gửi, cấu trúc lại biểu đồ hiện có và gửi thử trực tiếp từng bước cho người đánh giá nội bộ.
• Hủy, tạm dừng, tiếp tục, nhân bản hoặc xóa chiến dịch và ghi danh liên hệ vào chuỗi.
• Quản lý mẫu email giao dịch và gửi email giao dịch đến danh sách người nhận To, Cc và Bcc dùng chung.
• Cung cấp biến thể mẫu đã bản địa hóa hoặc xếp hàng dịch AI cho các ngôn ngữ đã bật.
• Tạo, xem trước, chỉnh sửa, xuất bản, hủy xuất bản và xóa trang đích.
• Tạo biểu mẫu đăng ký đã lưu theo phạm vi danh sách với các nhóm khối xếp chồng, hàng, lưới và lớp phủ hình ảnh đơn đáp ứng (bao gồm điều khiển khoảng cách nền trước), sau đó trả về nhúng trang tĩnh an toàn cho máy khách.
• Tạo, nhắm mục tiêu, xuất bản, nhân bản và triển khai cửa sổ bật lên đăng ký đã lưu với cùng bố cục khối đệ quy.
• Kết nối và xác minh miền tùy chỉnh cho trang đích đã xuất bản.
• Quản lý lời mời nhóm, cuộc trò chuyện hộp thư đến và điểm cuối webhook gửi đi.
• Tạo nội dung email, dòng tiêu đề và chuỗi nhiều bước.
• Kiểm tra phân tích, hoạt động người đăng ký, tình trạng gửi, tạm dừng gửi cấp công ty, tích hợp, lược đồ tải trọng sự kiện đã xuất bản, danh tính gửi, cài đặt theo dõi và URL bảng điều khiển.
• Kiểm tra xem "Được gửi bằng Sequenzy" có hiển thị cho không gian làm việc hay không, lý do đăng ký của chủ sở hữu có xóa nó hay không và mở trang đăng ký chuẩn để nâng cấp hoặc gia hạn. Thay đổi quyền áp dụng cho các lần gửi trong tương lai từ các chuỗi trực tiếp hiện có mà không cần chỉnh sửa khối của chúng.
• Chẩn đoán lý do gửi bị tạm dừng và khôi phục các lần tạm dừng do trả lại cứng đủ điều kiện sau khi xác nhận dọn dẹp danh sách.
• Kiểm tra chính xác việc loại trừ trả lại, khiếu nại và vệ sinh email của người nhận, đồng thời dọn dẹp các lần trả lại cũ đủ điều kiện mà không tiết lộ danh sách loại trừ SES dùng chung.
• Cấu hình thông tin sản phẩm công ty, mặc định danh tính gửi toàn tài khoản, đổi tên hồ sơ người gửi và trả lời riêng lẻ, quản lý miền người gửi và kiểm tra ví dụ tích hợp cho các khung phổ biến.

Mọi công cụ MCP đã xuất bản bao gồm chú thích rõ ràng readOnlyHint, destructiveHint và openWorldHint để các máy khách tương thích có thể hiển thị khả năng sử dụng công cụ chính xác. Công cụ cũng xuất bản định nghĩa outputSchema và trả về structuredContent, cung cấp cho máy khách và mô hình hình dạng kết quả có thể đọc bằng máy cho các lệnh gọi tiếp theo.

Thiết Lập Nhanh

Đường dẫn thiết lập dễ nhất là trình hướng dẫn Sequenzy:

npx @sequenzy/setup

Trình hướng dẫn mở luồng đăng nhập trình duyệt, tạo khóa API cá nhân, phát hiện máy khách AI được hỗ trợ và cấu hình chúng tự động khi có thể.

MCP Từ Xa Được Lưu Trữ

Đối với máy khách hỗ trợ MCP HTTP Streamable, hãy sử dụng điểm cuối được lưu trữ của Sequenzy thay vì chạy quy trình stdio cục bộ:

https://api.sequenzy.com/v1/mcp

ChatGPT và thư mục plugin OpenAI sử dụng bề mặt được lưu trữ đã đánh giá:

https://api.sequenzy.com/v1/mcp/openai

Bề mặt đó chia sẻ cùng triển khai và giữ bộ công cụ tiêu chuẩn ngoại trừ sáu thao tác: connect_integration, create_api_key, create_webhook, list_webhook_deliveries, replay_webhook_delivery và rotate_sequence_inbound_webhook_secret. Phản hồi vẫn khả dụng với lược đồ rút gọn cho phản hồi sản phẩm tổng quát, được yêu cầu rõ ràng.

Máy khách từ xa nên xác thực bằng luồng OAuth Sequenzy khi được hỗ trợ. Máy khách cục bộ và tự động hóa vẫn có thể sử dụng gói stdio bên dưới với SEQUENZY_API_KEY.

Điểm cuối được lưu trữ và gói stdio hỗ trợ đặc tả MCP 2026-07-28 trong khi vẫn tương thích với máy khách thời đại 2025. Máy khách HTTP hiện đại sử dụng khám phá theo yêu cầu và tiêu đề phương thức; máy khách hiện có tiếp tục hoạt động qua cùng điểm cuối và lệnh gói.

Tệp khám phá có thể đọc bằng máy:

• Tệp kê khai máy chủ MCP: server.json
• Thẻ tác nhân: .well-known/agent-card.json
• Tệp kê khai khả năng tác nhân: agent-capability.json
• Siêu dữ liệu kỹ năng OpenClaw: openclaw/skill.json

Dữ liệu và quyền riêng tư

Sequenzy chỉ gửi cho máy khách MCP dữ liệu cần thiết cho công cụ người dùng yêu cầu chạy, trong không gian làm việc đã chọn và phạm vi khóa hoặc OAuth được cấp cho máy khách đó. Tùy thuộc vào công cụ được yêu cầu, điều này có thể bao gồm tên và ID không gian làm việc; dữ liệu liên hệ, đồng ý, đối tượng, thuộc tính, sự kiện, tương tác, trả lời, khảo sát và thương mại của người đăng ký; nội dung chiến dịch và tự động hóa; phân tích gửi; và trạng thái tích hợp hoặc webhook. Xem Chính sách quyền riêng tư Sequenzy để biết đầy đủ danh mục, mục đích, người nhận, thời gian lưu giữ và kiểm soát của người dùng.

Không sử dụng thuộc tính tùy chỉnh, sự kiện, ghi chú, biểu mẫu, mẫu webhook, biến email hoặc phản hồi mở để gửi dữ liệu thẻ thanh toán, dữ liệu sức khỏe hoặc y tế, mã định danh chính phủ, dữ liệu sinh trắc học hoặc di truyền, thông tin xác thực, dữ liệu nhân khẩu học nhạy cảm hoặc vị trí địa lý chính xác.

Tuyến được OpenAI đánh giá nêu rõ và thực thi các hạn chế đó trên các đầu vào mở có liên quan, bao gồm đường dẫn thuộc tính lồng nhau như profile.ssn, cặp tọa độ như lat/lng và văn xuôi có nhãn như Religion: ... hoặc GPS coordinates: .... Tuyến này từ chối URL mang thông tin xác thực trong bất kỳ đối số nào, dù thông tin xác thực nằm trong userinfo, đường dẫn, truy vấn hay phân đoạn, chẳng hạn như biểu mẫu hoặc cửa sổ bật lên redirectUrl có mã truy cập hoặc chữ ký URL. Bộ chọn thuộc tính bị hạn chế bên trong thẻ hợp nhất bị từ chối mà không chặn nội dung tác giả thông thường về cùng chủ đề. Trên bề mặt này, render_email chấp nhận dữ liệu mẫu hoặc subscriber nội tuyến đã được kiểm tra chính sách, nhưng không phải subscriberId, vì vậy nó không thể phân giải thuộc tính tùy chỉnh được lưu trữ chưa kiểm tra. Kết quả của nó loại bỏ các trường bị hạn chế, lỗi API thô, tải trọng gỡ lỗi, mã định danh yêu cầu/theo dõi/phiên nội bộ, mã định danh tài khoản hoặc thông tin xác thực không cần thiết, URL mang thông tin xác thực được lưu trữ và URL webhook gửi đến. MCP từ xa tiêu chuẩn và gói stdio cục bộ giữ hợp đồng đầy đủ cho máy khách đáng tin cậy, bao gồm thiết lập tích hợp dựa trên thông tin xác thực, khóa API một lần và bí mật webhook, URL webhook gửi đến và lỗi API chi tiết. Ưu tiên bảng điều khiển hoặc CLI cục bộ khi bí mật nên nằm ngoài cuộc trò chuyện AI. submit_feedback chỉ chạy khi người dùng yêu cầu rõ ràng; lược đồ OpenAI của nó bị giới hạn ở thông điệp tổng quát, danh mục và ngữ cảnh quy trình làm việc tùy chọn, và tuyến từ chối văn bản phản hồi chứa địa chỉ email hoặc ID tài nguyên.

Những gì bề mặt được đánh giá đảm bảo là có giới hạn. Nó nhận dạng dữ liệu bị hạn chế theo hình dạng: từ tên trường tiếng Anh như passport_id, user.ssn hoặc api_secret ở bất kỳ độ sâu lồng nào, văn xuôi có nhãn như Diagnosis: ..., hình dạng thông tin xác thực đã biết, cặp tọa độ thập phân và URL mang thông tin xác thực bên trong bất kỳ chuỗi nào, bao gồm HTML. Nó không diễn giải văn xuôi không nhãn, tên trường không phải tiếng Anh hoặc giá trị máy khách cố tình che giấu; những giá trị đó vẫn được bao phủ bởi hạn chế sử dụng ở trên thay vì bộ lọc.

Thiết Lập Thủ Công

Tất cả máy khách MCP stdio sử dụng cùng lệnh:

• Lệnh: npx
• Đối số: -y @sequenzy/mcp
• Biến môi trường bắt buộc: SEQUENZY_API_KEY=seq_user_your_key_here

Biến môi trường tùy chọn:

• SEQUENZY_API_URL - URL API cơ sở Sequenzy. Mặc định là https://api.sequenzy.com.
• SEQUENZY_APP_URL - URL bảng điều khiển cơ sở Sequenzy được sử dụng bởi trình trợ giúp URL ứng dụng. Mặc định là https://sequenzy.com.

Claude Desktop

Thêm vào cấu hình Claude Desktop của bạn:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Khởi động lại Claude Desktop sau khi chỉnh sửa cấu hình.

Claude Code

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- npx -y @sequenzy/mcp

Trên Windows gốc, bọc npx bằng cmd /c:

claude mcp add --scope user --env=SEQUENZY_API_KEY=seq_user_your_key_here sequenzy -- cmd /c npx -y @sequenzy/mcp

Đối với cấu hình dự án dùng chung, sử dụng .mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Codex

codex mcp add sequenzy --env SEQUENZY_API_KEY=seq_user_your_key_here -- npx -y @sequenzy/mcp
codex mcp list

Cấu hình Codex thủ công trong ~/.codex/config.toml:

[mcp_servers.sequenzy]
command = "npx"
args = ["-y", "@sequenzy/mcp"]

[mcp_servers.sequenzy.env]
SEQUENZY_API_KEY = "seq_user_your_key_here"

Cursor

Cài đặt Sequenzy từ Cursor Marketplace để có kết nối được lưu trữ với Sequenzy OAuth. Plugin kết nối đến:

https://api.sequenzy.com/v1/mcp

Sau khi cài đặt, hoàn tất luồng đăng nhập trình duyệt. Tác nhân của Cursor sau đó có thể sử dụng công cụ Sequenzy từ trò chuyện, bao gồm khi Grok là mô hình được chọn.

Để thiết lập stdio cục bộ thủ công, thêm vào ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sequenzy": {
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Windsurf

Sử dụng cùng hình dạng JSON như Cursor.

• macOS: ~/Library/Application Support/Windsurf/mcp.json
• Windows: %APPDATA%\Windsurf\mcp.json

VS Code Copilot

VS Code sử dụng đối tượng servers:

{
  "servers": {
    "sequenzy": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@sequenzy/mcp"],
      "env": {
        "SEQUENZY_API_KEY": "seq_user_your_key_here"
      }
    }
  }
}

Máy Khách MCP Khác

Đối với OpenClaw, Hermes và các máy khách tương thích MCP khác, trỏ máy khách đến npx -y @sequenzy/mcp và đặt SEQUENZY_API_KEY.

Lấy Khóa API

1. Mở bảng điều khiển Sequenzy.
2. Sử dụng luồng thiết lập MCP để tạo khóa cá nhân hoặc mở Cài đặt -> Khóa API để tạo khóa công ty.
3. Chọn cài đặt trước quyền hoặc phạm vi tùy chỉnh chính xác mà tích hợp cần.
4. Thêm khóa vào cấu hình máy khách MCP của bạn.

Khóa cá nhân bắt đầu bằng seq_user_. Bạn có thể thu hồi chúng bất kỳ lúc nào trong bảng điều khiển.

Khóa công ty cũng có thể được dọn dẹp mà không tiết lộ bí mật. Gọi list_api_keys để so sánh ID khóa, tên, tiền tố không bí mật, quyền, dấu thời gian sử dụng cuối và dấu isCurrent, sau đó chuyển ID chính xác đến revoke_api_key. delete_api_key là bí danh tương thích cho cùng thao tác vĩnh viễn. Phản hồi danh sách và thu hồi không bao giờ chứa khóa thô hoặc băm khóa được lưu trữ.

Khôi phục từ thiếu quyền khóa API

Nếu công cụ báo cáo thiếu phạm vi như campaigns:read hoặc templates:write, hãy gọi get_account. Trường apiKeyPermissions của nó liệt kê danh tính và loại khóa hiện tại, phạm vi, phạm vi đọc tiếp thị bị thiếu phổ biến và manageUrl trực tiếp. Tuyến được OpenAI đánh giá trả về cùng quyền mà không có ID tài khoản của người dùng hoặc danh tính khóa đang hoạt động. Khóa cá nhân mở Khóa API Tài khoản; khóa công ty mở cài đặt Khóa API của không gian làm việc đã chọn. Nếu khóa không bao gồm account:read, hãy mở bảng điều khiển Sequenzy trực tiếp và chọn trang Khóa API phù hợp.

Quyền có thể chỉnh sửa tại chỗ, vì vậy hãy mở manageUrl. Đối với khóa công ty, sử dụng list_api_keys và cờ isCurrent của nó để xác định khóa đang hoạt động trước khi chỉnh sửa, sau đó thử lại công cụ bị lỗi mà không thay thế thông tin xác thực hoặc khởi động lại máy khách. Tác nhân sử dụng khóa công ty với api_keys:manage có thể thay vào đó gọi update_api_key; khóa cá nhân phải được chỉnh sửa trên trang cấp tài khoản vì công cụ đó chỉ quản lý khóa công ty. Đầu vào scopes và preset của nó thay thế toàn bộ lựa chọn quyền thay vì hợp nhất, vì vậy hãy giữ mọi phạm vi hiện có vẫn cần thiết. Kết nối OAuth được lưu trữ có thể thay vào đó ngắt kết nối và cấp quyền lại với quyền rộng hơn. Khi khóa đang hoạt động thiếu api_keys:manage, hãy gọi request_api_key_handoff thay vì thử lại update_api_key. Thao tác này yêu cầu account:read và trả về URL đánh giá của chủ sở hữu với tên khóa, quyền hạn và tiền nhiệm tùy chọn được điền sẵn theo yêu cầu. Thao tác này không bao giờ tạo hoặc trả về khóa; chủ sở hữu không gian làm việc xem xét biểu mẫu, tạo khóa thay thế trong trình duyệt và sao chép khóa vào máy khách. Truyền replaceApiKeyId: "current" để đề nghị thu hồi khóa đang hoạt động sau khi khóa thay thế được tạo. Nếu khóa đang hoạt động cũng thiếu account:read, hãy sử dụng trực tiếp bảng điều khiển.

Cài đặt trước Safer agent access mặc định bao gồm lists:write và tags:write, để tác nhân có thể tạo và cập nhật định nghĩa danh sách và thẻ, đồng thời bao gồm subscribers:tag để áp dụng thẻ cho các liên hệ hiện có. Cài đặt này cũng bao gồm ab_tests:read, ab_tests:write và sequences:write, để tác nhân có thể kiểm tra và chỉnh sửa nội dung biến thể A/B của chuỗi, bao gồm cả thông báo bỏ giỏ hàng và bỏ duyệt. Cài đặt này không bao gồm subscribers:write, vì vậy không thể thêm liên hệ vào danh sách hoặc xóa chúng khỏi danh sách. Xóa danh sách hoặc thẻ vẫn yêu cầu quyền lists:delete hoặc tags:delete tương ứng.

Cài đặt trước AI drafting bao gồm subscribers:write, để tác nhân soạn thảo có thể xây dựng danh sách cũng như tạo danh sách. Việc nhập áp dụng listIds cũng cần lists:write; đăng ký chuỗi hoặc gửi double-opt-in bổ sung cần automations:trigger.

Công cụ

Bề mặt tiêu chuẩn hiện hiển thị 243 công cụ MCP. Bề mặt được OpenAI xem xét hiển thị 237; chỉ sáu thao tác được liệt kê ở trên bị bỏ qua.

Các công cụ từ chối các đối số mà chúng không khai báo thay vì âm thầm bỏ qua chúng. Lỗi nêu tên các trường không được hỗ trợ, liệt kê các đối số được hỗ trợ và cung cấp hướng dẫn tập trung cho các lỗi phổ biến như bộ lọc người đăng ký hoặc tùy chọn sắp xếp được phát minh.

Tài khoản, Công ty, Thiết lập

Công cụ	Mô tả
get_account	Lấy thông tin tài khoản, các công ty khả dụng, quyền hạn khóa hiện tại và URL quản lý API Keys.
select_company	Đặt công ty đang hoạt động cho các lệnh gọi công cụ trong tương lai.
get_app_urls	Xây dựng URL bảng điều khiển cho chiến dịch, trang đích, chuỗi email, email, cài đặt, quản lý đăng ký, tên miền và chi tiết email đã gửi. settingsTab: "billing" phân giải đến Account -> Subscription.
create_company	Tạo công ty hoặc thương hiệu mới.
get_company	Đọc chi tiết công ty, thông tin sản phẩm, bối cảnh thương hiệu, bản địa hóa, cài đặt theo dõi trả lời, giá trị mặc định hiện tại của From/Reply-To và quyền emailBranding chỉ đọc hiệu lực kèm lý do gói/trạng thái và URL đăng ký; STO được xác định rõ ràng là chỉ dành cho chiến dịch.
update_company	Chỉnh sửa thông tin sản phẩm, bối cảnh thương hiệu, chủ đề email, theo dõi trả lời và giá trị mặc định hoặc tên hồ sơ From/Reply-To trên toàn tài khoản.
get_sync_rules	Đọc các quy tắc ánh xạ sự kiện sang thẻ của công ty và liệu công ty có sử dụng bộ cài đặt sẵn nền tảng kế thừa hay không.
update_sync_rules	Thay thế tất cả quy tắc đồng bộ; truyền [] để vô hiệu hóa chúng hoặc null để chọn bộ cài đặt sẵn nền tảng SaaS/thương mại điện tử.
get_shopify_automation_settings	Đọc cài đặt bỏ qua duyệt web, bỏ giỏ hàng và giảm giá cho cửa hàng Shopify đã kết nối.
update_shopify_automation_settings	Cập nhật một phần cài đặt tự động hóa Shopify hoặc đặt lại một phần riêng lẻ về giá trị mặc định của nền tảng.
create_api_key	Tạo khóa API công ty và trả về bí mật dùng một lần trên MCP tiêu chuẩn; bỏ qua trên tuyến đã được OpenAI xem xét.
request_api_key_handoff	Chuẩn bị URL tạo/xoay khóa có xem xét của chủ sở hữu khi khóa đang hoạt động không thể tự quản lý khóa API.
list_api_keys	Liệt kê khóa API công ty dưới dạng siêu dữ liệu không bí mật để nhận dạng và dọn dẹp an toàn.
update_api_key	Đổi tên khóa API công ty hoặc thay thế bộ quyền hoặc phạm vi của khóa mà không thay đổi giá trị khóa.
revoke_api_key	Thu hồi vĩnh viễn một khóa API công ty chính xác theo ID sau khi kiểm tra bằng list_api_keys.
delete_api_key	Bí danh tương thích cho revoke_api_key.
list_websites	Liệt kê tên miền gửi với trạng thái tổng hợp, SPF, DKIM và MAIL FROM đã lưu.
add_sending_domain	Thêm tên miền gửi và trả về bản ghi thiết lập DNS theo nhóm cụ thể.
add_website	Bí danh tương thích cho add_sending_domain.
check_website	Đọc chi tiết xác minh SPF, DKIM, MAIL FROM và tổng hợp đã lưu của tên miền gửi.
verify_sending_domain	Chạy xác minh DNS/nhà cung cấp mới cho tên miền gửi và trả về trạng thái cũng như chẩn đoán hiện tại.
list_integrations	Liệt kê các tích hợp đã kết nối với tình trạng kết nối và đồng bộ, không trả về thông tin xác thực.
get_sending_status	Chẩn đoán trạng thái gửi đang hoạt động, tạm dừng hoặc bị đình chỉ, bao gồm mẫu số thực thi, cổng xem xét và các bước khắc phục.
resume_sending	Khôi phục trạng thái tạm dừng do hard-bounce đủ điều kiện sau khi xác nhận rõ ràng danh sách đã được làm sạch.
get_tracking_settings	Đọc cài đặt mở/nhấp mặc định trên toàn tài khoản và Transactional API, hủy đăng ký, phân bổ, UTM, tên miền nhấp, theo dõi trả lời và double-opt-in.
update_tracking_settings	Cập nhật mặc định theo dõi trên toàn tài khoản và Transactional API, phân bổ, UTM và double opt-in trên toàn tài khoản.
get_integration_guide	Lấy ví dụ tích hợp theo khung cụ thể.
get_integration	Kiểm tra một tích hợp đã kết nối, cấu trúc sự kiện, nhắm mục tiêu danh sách, hoạt động gần đây và đề xuất.
list_integration_capabilities	So sánh khả năng của nhà cung cấp dù đã kết nối hay chưa.
connect_integration	Kết nối các nhà cung cấp API-key hoặc webhook-secret được hỗ trợ trên MCP tiêu chuẩn, bao gồm webhook Lemon Squeezy được quản lý, Attio chỉ gửi đi và tùy chọn nhập lịch sử PostHog/Segment; bỏ qua trên tuyến đã được OpenAI xem xét.
get_event_schema	Kiểm tra ví dụ payload sự kiện đã xuất bản, đường dẫn thuộc tính, loại và thẻ gộp theo nhà cung cấp.
list_integration_activity	Đọc nhật ký hoạt động webhook và đồng bộ cụ thể theo tích hợp đã lưu.
set_integration_sync_enabled	Bật hoặc tắt nhập hàng loạt và backfill trong khi vẫn giữ webhook trực tiếp được kết nối.
set_integration_list_targeting	Chọn danh sách mà danh bạ được tạo bởi tích hợp được hỗ trợ sẽ tham gia khi nhà cung cấp ghi dữ liệu trong tương lai.
sync_integration	Xếp hàng đợi doanh thu thanh toán, người dùng Supabase hoặc nhập lịch sử sự kiện PostHog/Segment bằng cấu hình tích hợp đã lưu.
get_integration_pixel	Đọc trạng thái pixel/cấu hình trực tiếp của Shopify và phân biệt sự kiện tối đã xác nhận với lần đọc không xác định.
activate_integration_pixel	Cài đặt hoặc trỏ lại pixel storefront của Shopify; có tính chất idempotent khi nó đã ở trạng thái hiện tại.
list_web_tracking_keys	Liệt kê các khóa theo dõi website có thể xuất bản, giới hạn nguồn gốc, trạng thái sử dụng và đoạn mã cài đặt.
get_web_tracking_key	Lấy một khóa theo dõi website kèm đoạn mã cài đặt chính xác và điểm cuối tiếp nhận.
create_web_tracking_key	Tạo khóa theo dõi có thể xuất bản cho storefront hoặc website không phải Shopify.
update_web_tracking_key	Đổi tên, giới hạn, thu hồi hoặc kích hoạt lại khóa theo dõi website.
delete_web_tracking_key	Xóa vĩnh viễn khóa theo dõi website sau khi đoạn mã của nó đã được gỡ bỏ.
list_sender_profiles	Liệt kê hồ sơ người gửi và địa chỉ trả lời, mặc định và mức sẵn sàng của miền gửi.
update_sender_profile	Đổi tên một hồ sơ người gửi hoặc địa chỉ trả lời mà không thay đổi mặc định của tài khoản.
delete_sender_profile	Xóa vĩnh viễn hồ sơ người gửi không sử dụng, có kiểm tra đối với các bề mặt gửi đang hoạt động và người gửi cuối cùng còn lại.
get_notification_preferences	Đọc cài đặt thông báo tài khoản theo công ty của người dùng hiện tại và các chế độ được hỗ trợ, bao gồm báo cáo hàng tuần vào thứ Hai.
update_notification_preferences	Cập nhật chế độ phân phối thông báo tài khoản của người dùng hiện tại, bao gồm chọn không nhận báo cáo hàng tuần, mà không ảnh hưởng đến đồng nghiệp.
render_email	Hiển thị HTML email an toàn cuối cùng và chẩn đoán các thẻ merge chưa được giải quyết, bao gồm lỗi chính tả bị ẩn bởi giá trị mặc định. Quy trình được đánh giá bởi OpenAI chấp nhận dữ liệu mẫu hoặc người đăng ký nội tuyến đã được kiểm tra chính sách, không phải ID người đăng ký đã lưu.
get_sending_status giữ trạng thái tạm dừng dựa trên Postgres, các cổng đánh giá và khả năng khắc phục sẵn sàng khi phân tích sức khỏe người gửi tạm thời không khả dụng; trong trường hợp suy giảm đó, senderHealth là null.

render_email trả về unresolvedMergeTags để người gọi có thể phân biệt tên không xác định với thẻ được nhận dạng chỉ đơn thuần trống cho liên hệ đang xem trước. Các tên không xác định được báo cáo ngay cả khi bộ lọc default cung cấp văn bản: ví dụ: {{ subscriber.frstName | default: "there" }} hiển thị lời chào hợp lý cho mọi liên hệ trong khi bỏ qua tên đã lưu. Một tên được nhận dạng trống cho một liên hệ không được báo cáo khi giá trị mặc định của nó được sử dụng. Tuyến được đánh giá bởi OpenAI từ chối các bộ chọn thuộc tính tùy chỉnh bị hạn chế bên trong các thẻ hợp nhất. Nó cũng bỏ qua đối số subscriberId; sử dụng subscriber nội tuyến đã được kiểm tra chính sách hoặc bỏ qua dữ liệu người đăng ký để xem trước mẫu.

Để hiển thị một bước trình tự có nodeType là action_ab_test, hãy truyền sequenceId và nodeId của bước cùng với variantId từ get_sequence.sequence.emails[].abTest.variants. Các bước này không có email riêng, vì vậy biến thể là bắt buộc; việc đọc và hiển thị bản sao cạnh tranh của chúng cũng yêu cầu phạm vi ab_tests:read.

Đối với Supabase, sync_integration tái sử dụng các ánh xạ dự án, lược đồ, bảng, lựa chọn danh sách và sự đồng ý đã lưu trong bảng điều khiển. Nó không thể nhắm mục tiêu một bảng tùy ý. Chạy nó sau khi cài đặt trình kích hoạt cơ sở dữ liệu trực tiếp để nhập người dùng tồn tại trước khi trình kích hoạt được cài đặt, sau đó thăm dò get_integration và list_integration_activity để theo dõi tiến trình và kết quả cấp hàng.

set_integration_sync_enabled chỉ kiểm soát nhập hàng loạt và backfill; nó không ngăn webhook trực tiếp của nhà cung cấp tạo liên hệ. Sử dụng set_integration_list_targeting để chọn tư cách thành viên danh sách trong tương lai của họ: null tuân theo mặc định của không gian làm việc, [] không tham gia danh sách nào và một mảng được điền nhắm mục tiêu các danh sách đó. Thay đổi không có hiệu lực hồi tố và không bao giờ xóa tư cách thành viên hiện có. Nó cũng không dừng các trình tự any_contact mặc định, đăng ký các liên hệ không có danh sách; các trình tự any_list rõ ràng và danh sách cụ thể yêu cầu tư cách thành viên khớp. Kết hợp nhắm mục tiêu danh sách với pause_sequence_enrollments khi các đăng ký mặc định đó cũng phải dừng. Supabase, Stripe, Shopify, Wix và Webflow hỗ trợ kiểm soát này.

Đối với PostHog, sync_integration khởi động lại quá trình nhập lịch sử sự kiện từ đầu bằng khóa API cá nhân đã lưu. Các sự kiện đã nhập được khử trùng lặp, vì vậy việc thử lại một lần nhập thất bại không tạo ra bản sao.

Đối với Segment, connect_integration trên MCP tiêu chuẩn có thể tùy chọn nhập lịch sử sự kiện gần đây từ Unify sau khi webhook trực tiếp được kết nối. Quá trình nhập duyệt qua các liên hệ hiện có thông qua Profile API, bao gồm 14 ngày gần nhất của API, bỏ qua các liên hệ không có hồ sơ khớp và khử trùng lặp an toàn các lần thử lại và chồng chéo webhook trực tiếp. Các kết nối mới bỏ qua các cuộc gọi trang/màn hình tự động trừ khi các tên đó được đưa vào danh sách cho phép rõ ràng. Bí mật webhook Segment phải dài 16-153 byte UTF-8. Trên tuyến được đánh giá bởi OpenAI, tuyến bỏ qua connect_integration, hãy kết nối Segment trong bảng điều khiển hoặc CLI cục bộ. Sử dụng sync_integration để thử lại với thông tin đăng nhập đã lưu.

Đối với Lemon Squeezy, hãy truyền provider: "lemon_squeezy", khóa API và ID cửa hàng dạng số làm providerAccountId. Bỏ qua webhookSecret cho thiết lập được quản lý mặc định; phản hồi báo cáo webhookProvisioning và testMode. Chỉ cung cấp bí mật ký 16-40 ký tự cho thiết lập webhook thủ công, sử dụng webhookUrl được trả về. Thông tin đăng nhập không bao giờ được trả về.

Đối với Attio, connect_integration trên MCP tiêu chuẩn chấp nhận mã thông báo truy cập không gian làm việc mà không có bí mật webhook, với settings.listMap tùy chọn làm bản đồ ID danh sách Sequenzy sang UUID danh sách người Attio hoặc slug API, cộng với syncCompanyFromDomain để kiểm soát khớp công ty từ các miền email không miễn phí. Trên tuyến được đánh giá bởi OpenAI, hãy kết nối Attio trong bảng điều khiển hoặc CLI cục bộ, sau đó sử dụng update_attio_settings cho cùng cài đặt. Tích hợp chỉ gửi đi: các tham gia mới vào danh sách Sequenzy được ánh xạ sẽ upsert người và thêm họ vào danh sách Attio; việc xóa danh sách không xóa bản ghi khỏi Attio.

Gọi get_event_schema trước khi viết thẻ hợp nhất {{event.*}} hoặc bộ lọc thuộc tính sự kiện. Bỏ qua eventName để liệt kê các sự kiện tích hợp được ghi lại; cung cấp tên sự kiện để nhận tải trọng ví dụ và đường dẫn thuộc tính cụ thể của nhà cung cấp, và tùy chọn lọc theo provider. Tên sự kiện tùy chỉnh vẫn hợp lệ ngay cả khi kết quả báo cáo documented: false; điều đó chỉ có nghĩa là không có mẫu tham chiếu nào được xuất bản. Sử dụng hoạt động tích hợp hoặc đăng ký trình tự để có dữ liệu gửi thực tế vì công cụ này trả về dữ liệu tham chiếu tĩnh.

Đối với một miền gửi mới, hãy gọi add_sending_domain, xuất bản các bản ghi DNS trong website.dnsRecords được trả về, đợi DNS lan truyền, sau đó gọi verify_sending_domain. Xuất bản mọi bản ghi được trả về thay vì giả định một nhà cung cấp hoặc số lượng bản ghi cố định: các miền hợp nhất bao gồm DMARC bắt buộc, trong khi các miền kế thừa có thể trả về bản ghi Amazon SES MAIL FROM và trả lời thư đến. Nếu xác minh được thử trước khi tạo, lỗi sẽ trỏ lại add_sending_domain với miền được yêu cầu.

Đối với Shopify, hãy gọi get_integration_pixel trước khi dựa vào lượt xem sản phẩm, hoạt động giỏ hàng hoặc trình kích hoạt bỏ qua duyệt. Kết quả được đọc trực tiếp từ Shopify vì người bán có thể xóa pixel độc lập. Nếu pixel.healthy là false, dependentEvents đặt tên các trình kích hoạt không thể đến; gọi activate_integration_pixel để cài đặt hoặc trỏ lại pixel. Kích hoạt là idempotent và các sự kiện bắt đầu ở lần truy cập cửa hàng tiếp theo thay vì được backfill.

Đối với các trang web tùy chỉnh, headless, bán vé hoặc SaaS, hãy sử dụng list_web_tracking_keys trước khi dựa vào trình kích hoạt xem sản phẩm hoặc giỏ hàng. Tạo khóa với danh sách cho phép nguồn gốc rõ ràng, cài đặt installSnippet được trả về, sau đó yêu cầu backend đã xác thực của khách hàng tạo bằng chứng ngắn hạn thông qua POST /api/v1/web-tracking-identities và gọi sequenzy.identify(email, identityToken) khi đăng nhập hoặc thanh toán. Chỉ riêng khóa có thể xuất bản chỉ ghi lại hoạt động ẩn danh và không thể kích hoạt tự động hóa người đăng ký. Đoạn mã được trả về cài đặt các stub phương thức đồng bộ trước trình tải không đồng bộ của nó, vì vậy các cuộc gọi danh tính và sự kiện được thực hiện trong quá trình khởi động trang được xếp hàng đợi cho đến khi SDK sẵn sàng. Ưu tiên thu hồi khóa bằng update_web_tracking_key trước khi xóa vĩnh viễn.

Các công ty mới bắt đầu không có quy tắc đồng bộ hóa. Cài đặt trước kế thừa vẫn khả dụng cho các công ty SaaS/thương mại điện tử bằng cách truyền null cho update_sync_rules; các công ty dịch vụ và tư vấn thường nên giữ [] hoặc xác định quy tắc rõ ràng.

Sử dụng list_sender_profiles để tìm ID hồ sơ, sau đó gọi update_sender_profile để chỉ thay đổi tên hiển thị của nó. Truyền type: "reply" cho hồ sơ trả lời; người gửi là mặc định. Địa chỉ, miền gửi và lựa chọn From/Reply-To mặc định trên toàn tài khoản vẫn không thay đổi. Đổi tên yêu cầu phạm vi companies:manage.

Sử dụng delete_sender_profile để xóa vĩnh viễn danh tính From lỗi thời. Nó từ chối người gửi cuối cùng và bất kỳ hồ sơ nào được sử dụng bởi chiến dịch trực tiếp, trình tự hoạt động (bao gồm ghi đè bước) hoặc email giao dịch. Các bản nháp đủ điều kiện và mặc định tài khoản chuyển sang fallbackSenderProfileId được trả về; xem lại trước khi gửi. Hồ sơ trả lời không được hỗ trợ bởi công cụ xóa này.

Bỏ qua giỏ hàng Shopify được bật theo mặc định. Nó kích hoạt ecommerce.cart_abandoned sau một giờ không hoạt động giỏ hàng, với thời gian chờ 24 giờ cho mỗi người đăng ký. Sử dụng update_shopify_automation_settings để thay đổi các trường cartAbandonment.enabled, delayHours hoặc cooldownHours; truyền cartAbandonment: null để khôi phục các mặc định đó mà không thay đổi cài đặt bỏ qua duyệt hoặc giảm giá. Giá trị thời gian phải dương; delayHours bị giới hạn ở 168 và cooldownHours ở 720.

Người đăng ký

Công cụ	Mô tả
add_subscriber	Thêm một người đăng ký; trạng thái chỉ tạo, vì vậy hãy sử dụng update_subscriber cho một liên hệ hiện có.
create_subscriber_import	Xếp hàng đợi tối đa 5.000 bản ghi CRM đầy đủ với idempotencyKey an toàn thử lại tùy chọn; các kiểm tra vệ sinh email được bật tiếp tục riêng sau khi nhập.
get_subscriber_import	Đọc tiến trình, số lượng kết quả hàng và tóm tắt lỗi cho một lần nhập đã xếp hàng đợi.
update_subscriber	Cập nhật các trường hồ sơ gốc và điện thoại, đồng ý SMS, thuộc tính, thẻ hoặc trạng thái toàn cầu.
remove_subscriber	Hủy đăng ký trong khi bảo toàn lịch sử chặn, hoặc xóa vĩnh viễn chỉ với hardDelete: true.
get_subscriber	Tìm nạp chi tiết người đăng ký theo email hoặc ID bên ngoài.
search_subscribers	Tìm kiếm theo truy vấn, thẻ, danh sách, trạng thái, phân khúc hoặc một thuộc tính tùy chỉnh, với phân trang tự động hoặc có thể tiếp tục.
trigger_subscriber_event	Phát ra một sự kiện tùy chỉnh chính xác như một tích hợp sẽ làm, áp dụng quy tắc đồng bộ hóa và khớp trình kích hoạt trình tự.
trigger_subscriber_events	Phát ra một số sự kiện tùy chỉnh có thứ tự cho một người đăng ký.
import_subscriber_events	Nhập tối đa 25 sự kiện có nguồn gốc được xác định trên các liên hệ; lịch sử im lặng yêu cầu mọi hàng cho một liên hệ phải hơn một giờ tuổi.
bulk_add_subscriber_tags	Thêm thẻ vào tối đa 500 người đăng ký hiện có; yêu cầu subscribers:tag và cũng có thể yêu cầu tags:write.
bulk_remove_subscriber_tags	Xóa thẻ khỏi tối đa 500 người đăng ký hiện có; yêu cầu subscribers:tag hoặc subscribers:write.

Sử dụng create_subscriber_import để nhập CRM thay vì lặp qua add_subscriber. Một cuộc gọi chấp nhận 5.000 bản ghi đầy đủ và trả về ID nhập không đồng bộ; thăm dò nó bằng get_subscriber_import. Một lần nhập completed vẫn có thể chứa lỗi hàng, vì vậy hãy kiểm tra failedCount và failedReasons. Mọi hàng bị loại trừ đều được tính: skippedReasons tổng bằng skippedCount, và failedReasons tổng bằng failedCount. Báo cáo bất kỳ thiếu hụt nào với ID nhập thay vì đoán hàng nào bị bỏ qua. Khi vệ sinh email được bật, các kiểm tra khả năng gửi tiếp tục riêng sau khi nhập và kết quả xuất hiện trong tình trạng Danh sách; trạng thái nhập không chờ hoặc bao gồm các phán quyết đó. Các phán quyết không hợp lệ bị chặn khỏi các lần gửi sau. Sử dụng optInMode: "confirmed" chỉ khi sự đồng ý đã được xác minh.

Đối với import_subscriber_events, email là bắt buộc khi một hàng có thể tạo liên hệ mới; externalId có thể đứng một mình chỉ cho một liên hệ hiện có. Cung cấp eventId ổn định trên mọi hàng. Thử lại tái sử dụng biên nhận ban đầu và idempotently thử lại khôi phục xuôi dòng. Phân loại lịch sử là theo liên hệ: nếu bất kỳ hàng nào cho một liên hệ là gần đây, toàn bộ nhóm của liên hệ đó sử dụng đường dẫn tác dụng phụ trực tiếp.

Để chặn tuân thủ, hãy gọi update_subscriber với status: "unsubscribed" (hoặc sử dụng remove_subscriber mà không có hardDelete). Không thử lại add_subscriber với trạng thái khác: trạng thái trên công cụ đó chỉ áp dụng khi liên hệ được tạo lần đầu và kết quả bỏ qua không khớp được báo cáo là lỗi. Khi add_subscriber bỏ qua listIds, một contact được tạo bởi lệnh gọi sẽ tuân theo các danh sách mặc định của workspace trong khi một contact hiện có giữ nguyên các danh sách thành viên hiện tại của nó. Hãy truyền ID danh sách một cách tường minh khi một contact hiện có cần tham gia các danh sách cụ thể; truyền [] để nhắm đến không danh sách nào.

update_subscriber.phone ghi vào trường điện thoại gốc hiển thị trên contact, không phải một thuộc tính tùy chỉnh. Chỉ truyền smsConsent: true sau khi đã xác minh sự đồng ý bằng văn bản rõ ràng, hoặc false để chọn không tham gia cho contact. Thay đổi số điện thoại mà không có smsConsent sẽ đặt lại sự đồng ý SMS vì sự đồng ý thuộc về số cũ.

add_subscriber, update_subscriber, và create_subscriber_import chấp nhận một múi giờ IANA timezone như America/New_York. Giá trị được lưu trên hồ sơ contact gốc và cho phép phân phối chiến dịch theo khu vực của người nhận. Truyền một múi giờ trống cho update_subscriber để xóa nó; các giá trị không hợp lệ trong hàng nhập khẩu bị bỏ qua mà không từ chối phần còn lại của quá trình nhập khẩu.

Sản phẩm & Phân phối Kỹ thuật số

Công cụ	Mô tả
list_products	Liệt kê các sản phẩm đã đồng bộ từ dữ liệu Stripe, Shopify, WooCommerce, thủ công hoặc Commerce API.
upsert_products	Tạo hoặc cập nhật tối đa 100 sản phẩm Commerce API theo ID sản phẩm của bạn.
delete_product	Xóa một sản phẩm đã được đẩy trước đó qua Commerce API.
attach_product_file	Đính kèm một tệp phân phối được lưu trữ hoặc tải lên cục bộ vào một sản phẩm.
remove_product_file	Gỡ bỏ một tệp phân phối sản phẩm đã đính kèm.
sync_products	Xếp hàng đợi đồng bộ danh mục sản phẩm Stripe, tùy chọn chọn một tích hợp theo ID.

Sau khi một tệp phân phối sản phẩm được đính kèm, các sự kiện mua hàng khớp bao gồm download.url và download.name, vì vậy các email kích hoạt bởi giao dịch mua có thể sử dụng các thẻ gộp như {{event.download.url}}.

Đối với sản phẩm Stripe, list_products trả về mọi giá hoạt động như một biến thể, với ID giá Stripe trong variantId. Sử dụng ID đó để nhắm đến một mức giá chính xác trong chuỗi mua hàng ngay cả khi đó không phải là giá mặc định của sản phẩm.

Tài nguyên Hình ảnh

Công cụ	Mô tả
upload_image_asset	Tải lên một hình ảnh email và trả về bản ghi phương tiện được lưu trữ cùng khối hình ảnh sẵn sàng chèn.

Công cụ chấp nhận hình ảnh PNG, JPEG, GIF và WebP lên đến 5MB. Các máy khách stdio cục bộ có thể truyền filePath. Các máy khách lưu trữ/từ xa có thể truy cập byte tệp đính kèm có thể truyền imageBase64 với filename. Cung cấp altText cho khả năng truy cập, sau đó sử dụng displayWidthPercent, cropHeight, objectFit (cover hoặc contain), và align để chuẩn hóa cách trình bày ảnh chụp màn hình. imageBlock được trả về có thể được sao chép trực tiếp vào mảng khối được chấp nhận bởi các công cụ chiến dịch, chuỗi, mẫu và email giao dịch.

Các byte hình ảnh đã xác thực luôn được tải lên nguồn gốc được cấu hình bởi SEQUENZY_API_URL, ngay cả khi một proxy ngược trả về một URL tải lên tương đương dưới một máy chủ khác. Thông tin xác thực API không bao giờ được chuyển tiếp đến nguồn gốc thay thế đó.

{
  "filePath": "/Users/me/Desktop/product-results.png",
  "altText": "Product results dashboard",
  "displayWidthPercent": 100,
  "cropHeight": 320,
  "objectFit": "cover",
  "align": "center"
}

Danh sách, Thẻ, Phân đoạn

Công cụ	Mô tả
list_tags	Liệt kê tất cả các thẻ.
create_tag	Tạo một định nghĩa thẻ với màu tùy chọn.
update_tag	Cập nhật màu của một thẻ.
delete_tag	Xóa một thẻ và gỡ nó khỏi người đăng ký.
list_lists	Liệt kê các danh sách người đăng ký.
create_list	Tạo một danh sách người đăng ký.
update_list	Đổi tên hoặc mô tả một danh sách người đăng ký.
delete_list	Xóa một danh sách người đăng ký.
add_subscribers_to_list	Thêm tối đa 500 người đăng ký vào một danh sách từ một mảng email.
remove_subscribers_from_list	Gỡ tối đa 500 người đăng ký khỏi một danh sách.
list_segments	Liệt kê các phân đoạn đã lưu và số lượng.
create_segment	Tạo các phân đoạn lọc mảng lồng nhau hoặc cùng phần tử.
update_segment	Cập nhật tên phân đoạn, bộ lọc, nhóm gốc hoặc toán tử nối.
delete_segment	Xóa một phân đoạn (yêu cầu segments:delete).
get_segment_count	Xem trước số lượng người đăng ký hoạt động cho một phân đoạn.

Đối với xuất người đăng ký, search_subscribers chấp nhận listId, chính xác listName, hoặc list (ID trước, sau đó là tên chính xác). Nó cũng chấp nhận attribute cộng attributeValue, với attributeOperator cho contains, so sánh số, hoặc is_not_empty; dạng kết hợp "attributeName:value" vẫn được hỗ trợ. Các bộ lọc kết hợp với AND; sử dụng một phân đoạn đã lưu cho logic OR, nhóm lồng nhau, loại trừ, mức độ tương tác hoặc điều kiện sự kiện. Nếu limit bị bỏ qua, công cụ tự động tìm nạp mọi trang khớp. Đối với đọc theo khối, truyền limit và làm theo pagination.nextCursor (hoặc pagination.nextOffset) trong khi hasMore là true. offset và page được hỗ trợ dưới 1.000.000 kết quả bỏ qua; sử dụng con trỏ cho các đối tượng sâu hơn.

Để điền danh sách hàng loạt, sử dụng add_subscribers_to_list; điểm cuối API hỗ trợ là POST /api/v1/lists/{listId}/subscribers không có hậu tố /bulk:

{
  "emails": ["ada@example.com", "grace@example.com"],
  "duplicateStrategy": "skip",
  "enrollInSequences": false,
  "optInMode": "default"
}

Gửi tối đa 500 email mỗi yêu cầu. Giới hạn tốc độ API tiêu chuẩn vẫn được áp dụng: 100 yêu cầu mỗi phút cho mỗi khóa API và 20 yêu cầu mỗi giây ở chế độ bùng nổ. Đối với nhập CLI theo CSV, các tiêu đề email được chấp nhận bao gồm email, e-mail, email address và mail; nếu không có tiêu đề được nhận diện, CLI đọc cột đầu tiên.

Bộ lọc phân đoạn hỗ trợ thuộc tính, sự kiện, thành viên phân đoạn đã lưu, sự kiện tương tác, quy tắc mua sản phẩm Stripe và quy tắc mua sản phẩm thương mại. Sử dụng filterJoinOperator: "or" cho phân đoạn khớp-bất-kỳ, hoặc truyền một nhóm root v2 cho logic lồng nhau.

Đối với thuộc tính mảng-đối-tượng, sử dụng đường dẫn ký tự đại diện như history_events[].eventvenue_id:2103. Khi một nhóm AND cũng lọc history_events[].showing_date, cả hai điều kiện phải khớp một phần tử history_events[] dùng chung; các giá trị từ các mục lịch sử không liên quan không được kết hợp. Xóa một phân đoạn yêu cầu segments:delete; segments:write là không đủ.

Mỗi trường bộ lọc phân đoạn xác thực các toán tử riêng của nó:

• status, segment: is, is_not
• tag: contains, not_contains, is_empty, is_not_empty
• email: contains, not_contains
• emailProvider, list: is, is_not, is_empty, is_not_empty
• firstName, lastName: contains, not_contains, is_empty, is_not_empty
• added: less_than, more_than
• attribute: is, is_not, is_empty, is_not_empty, gte, lte, gt, lt, contains, not_contains
• event, các trường tương tác email: is, is_not, at_least, less_than_count
• emailBounced: cũng hỗ trợ is_temporary_bounce, is_permanent_bounce
• stripeProduct: is, is_not, at_least, less_than_count
• stripeCurrentProduct, stripeTrialProduct: is, is_not, gte, lte, gt, lt
• commerceProduct: is, is_not, at_least, less_than_count

Ví dụ về bộ lọc sản phẩm Stripe:

{ "field": "stripeProduct", "operator": "is", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "is_not", "value": "prod_pro" }
{ "field": "stripeProduct", "operator": "at_least", "value": "prod_pro:3" }
{ "field": "stripeProduct", "operator": "less_than_count", "value": "prod_pro:3" }

Bộ lọc sản phẩm thương mại khớp với các sản phẩm được mua qua đơn hàng thương mại. Giá trị có thể là provider:productId cho ID theo phạm vi nhà cung cấp (shopify, woocommerce hoặc api), một ID sản phẩm trần để khớp với bất kỳ nhà cung cấp nào, hoặc provider:productId:count cho các toán tử ngưỡng:

{ "field": "commerceProduct", "operator": "is", "value": "api:starter-kit" }
{ "field": "commerceProduct", "operator": "at_least", "value": "shopify:42:2" }

Các trường tương tác như emailSent, emailDelivered, emailOpened, emailClicked, emailBounced và emailComplained chấp nhận các cửa sổ trượt như 7d, 30d, 90d, 180d hoặc all. Các toán tử hiện diện có thể giới hạn theo chính sách phân phối với marketing:<timeRange> (lưu lượng chiến dịch chính sách tiếp thị, tự động hóa và Send API) hoặc transactional:<timeRange> (gửi chính sách giao dịch); phạm vi chính sách yêu cầu một ảnh chụp chính sách tại thời điểm gửi, vì vậy các sự kiện tự động hóa cũ và Send API mơ hồ chỉ khả dụng qua các bộ lọc không giới hạn. emailBounced cũng hỗ trợ các giá trị có phạm vi với is_temporary_bounce và is_permanent_bounce. Với at_least và less_than_count, sử dụng count:timeRange, chẳng hạn như 10:30d hoặc 10:all. Các toán tử hiện diện có thể thay vào đó sử dụng phạm vi chiến dịch như campaign:cmp_123; phạm vi chiến dịch và loại email không thể kết hợp với các toán tử đếm.

Đồng bộ Đối tượng (Meta Ads)

Công cụ	Mô tả
list_audience_syncs	Liệt kê các đồng bộ phân đoạn-đến-đối tượng với lịch trình và trạng thái đồng bộ cuối.
list_ad_accounts	Liệt kê các tài khoản quảng cáo Meta khả dụng để đồng bộ.
create_audience_sync	Đẩy một phân đoạn đến một đối tượng tùy chỉnh Meta theo lịch trình.
update_audience_sync	Thay đổi tần suất đồng bộ (hourly, daily, weekly) hoặc tạm dừng/tiếp tục.
delete_audience_sync	Gỡ một ánh xạ đồng bộ; đối tượng Meta được giữ lại.
sync_audience_now	Kích hoạt tải lên ngay lập tức ngoài lịch trình thông thường.

Yêu cầu tích hợp Meta Ads được kết nối trong bảng điều khiển Sequenzy (Cài đặt -> Tích hợp). create_audience_sync chấp nhận một phân đoạn hiện có (segmentId) hoặc một mẫu có sẵn (predefinedSegmentId, ví dụ zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) - phân đoạn mẫu được tạo tự động khi sử dụng lần đầu và lần tải lên đầu tiên chạy ngay lập tức.

Đối tượng chỉ thêm: người đăng ký rời khỏi phân đoạn sau đó vẫn ở trong đối tượng Meta. Meta yêu cầu 100+ người khớp trước khi một đối tượng có thể được sử dụng để phân phối quảng cáo.

Mẫu

Công cụ	Mô tả
list_templates	Liệt kê các mẫu với trạng thái bản địa hóa, nhãn và bộ lọc isTemplate, cùng phân trang.
get_template	Đọc chi tiết mẫu, nội dung và các biến thể bản địa hóa.
create_template	Tạo mẫu từ lời nhắc, HTML hoặc khối Sequenzy; sử dụng isTemplate: true để lưu thiết kế chính có thể tái sử dụng.
update_template	Cập nhật siêu dữ liệu mẫu, văn bản xem trước hộp thư đến, nhãn, HTML hoặc khối; đánh dấu hoặc bỏ đánh dấu mẫu chính bằng isTemplate.
set_template_localization	Tạo hoặc thay thế một biến thể bản địa hóa do người gọi cung cấp.
sync_template_localizations	Xếp hàng đợi dịch AI cho các ngôn ngữ không phải ngôn ngữ chính đã chọn hoặc tất cả các ngôn ngữ được bật.
delete_template	Xóa một mẫu.

list_templates trả về 50 nội dung email mới nhất trước tiên theo mặc định và chấp nhận limit lên đến 100. Tiến offset bằng pagination.count trong khi pagination.hasMore là đúng; pagination.total báo cáo tổng số khớp đầy đủ, bao gồm cả chiến dịch và nội dung email giao dịch.

Đặt isTemplate: true trên list_templates để chỉ trả về các thiết kế chính đã lưu, hoặc false để trả về các nội dung email thông thường. Các mẫu chính được đánh dấu được cung cấp làm điểm khởi đầu cho các bước chuỗi và chiến dịch trên bảng điều khiển; bắt đầu từ một mẫu chính sẽ tạo một bản sao độc lập để các chỉnh sửa không ảnh hưởng đến mẫu chính.

Việc sao chép thiết kế nguồn độc lập/chuỗi và viết lại AI trong một bố cục đã chọn hiện chỉ có trên bảng điều khiển. Bản phát hành này cố ý giữ các quy trình làm việc đó trong chế độ tác giả tương tác, nơi người dùng có thể xem lại nguồn, bản dịch và bất kỳ bản sao dự phòng nào trước khi lưu một bước chuỗi. REST, CLI và MCP không cung cấp thao tác sao chép thiết kế nguồn độc lập/chuỗi tương đương. create_template với prompt tạo nội dung mới mà không bảo toàn bố cục hiện có; HTML hoặc khối được cung cấp tạo nội dung mới mà không tự động sao chép các biến thể bản địa hóa. Xem tài liệu về tính khả dụng của giao diện.

Bản sao chiến dịch đã hoạt động thông qua REST POST /api/v1/campaigns và MCP create_campaign với templateId; không thể kết hợp với prompt để viết lại AI.

Đối với nội dung hoàn toàn mới được yêu cầu bằng ngôn ngữ tự nhiên, hãy truyền prompt để Sequenzy tạo các khối gốc có thương hiệu ở phía máy chủ. Chỉ sử dụng blocks cho nội dung Sequenzy đã hoàn thiện do người gọi cung cấp và chỉ sử dụng html khi bảo toàn đánh dấu được cung cấp hoặc được yêu cầu rõ ràng. prompt, blocks và html loại trừ lẫn nhau; style và tone chỉ hợp lệ với prompt.

Sử dụng set_template_localization khi bản sao đã dịch đến từ quy trình làm việc bản địa hóa của riêng bạn. Nó yêu cầu một locale không phải ngôn ngữ chính được bật, một subject đã bản địa hóa và chính xác một trong html hoặc blocks. Sử dụng sync_template_localizations để yêu cầu Sequenzy dịch các ngôn ngữ đã chọn; bỏ qua locales để đồng bộ mọi ngôn ngữ không phải ngôn ngữ chính được bật. Đồng bộ rõ ràng hoạt động ngay cả khi tính năng bản địa hóa tự động khi lưu bị tắt.

Thành phần Email Tái sử dụng

Công cụ	Mô tả
list_email_components	Liệt kê các phần và chân trang đã lưu, tùy chọn giới hạn ở các mặc định được ghim.
get_email_component	Đọc khối, siêu dữ liệu, phiên bản và trạng thái vị trí mặc định của một thành phần.
get_default_email_component	Đọc thành phần hiện được ghim vào vị trí mặc định như footer.
set_default_email_component	Tạo hoặc thay thế chân trang mặc định của công ty được sử dụng bởi các email khối mới xây dựng.
create_email_component	Lưu một phần hoặc chân trang tái sử dụng từ danh sách khối.
update_email_component	Cập nhật siêu dữ liệu thành phần hoặc thay thế khối của nó và tăng phiên bản.
delete_email_component	Xóa một thành phần mà không thay đổi các email đã sao chép khối của nó.

Các thành phần được sao chép vào email khi các email đó được xây dựng, vì vậy các chỉnh sửa sau này ảnh hưởng đến các email mới xây dựng thay vì viết lại nội dung hiện có. Chân trang mặc định giữ liên kết hủy đăng ký được bật, trong khi kết xuất giao dịch ẩn liên kết đó. Email HTML thô giữ đánh dấu riêng của chúng và không nhận các thành phần khối; xử lý hủy đăng ký khi gửi của chúng vẫn không thay đổi.

Kiểm tra A/B

Công cụ	Mô tả
list_ab_tests	Liệt kê các kiểm tra A/B và biến thể, tùy chọn phạm vi theo chuỗi.
get_ab_test	Lấy cài đặt hiệu quả, biến thể, trạng thái bản địa hóa và bản sao bước chuỗi.
get_ab_test_stats	Lấy thống kê tổng hợp và theo biến thể.
restart_ab_test	Khởi động lại kiểm tra A/B đã dừng hoặc hoàn thành.
select_ab_test_winner	Chọn người chiến thắng kiểm tra chiến dịch và xếp hàng đợi phân phối còn lại.
update_ab_test	Cập nhật cài đặt chọn người chiến thắng cho chiến dịch hoặc chuỗi.
update_ab_test_variant	Cập nhật bản nháp chiến dịch hoặc bản sao biến thể chuỗi.
create_ab_test	Tạo kiểm tra chiến dịch hoặc chuyển đổi bước email chuỗi.
add_ab_test_variant	Thêm biến thể vào kiểm tra A/B hiện có.
delete_ab_test_variant	Xóa biến thể kiểm tra A/B ở bản nháp.
delete_ab_test	Xóa kiểm tra A/B.

Sử dụng get_sequence.sequence.emails[].abTest.variants để khám phá ID biến thể chuỗi, chủ đề, văn bản xem trước và số khối; gọi get_ab_test để kiểm tra toàn bộ blocks, settings hiệu quả, trạng thái bản địa hóa hoặc thống kê của mọi biến thể. Cài đặt chiến dịch sử dụng testPercentage, testDurationMinutes và winnerCriteria; cài đặt chuỗi sử dụng testType, winnerThreshold và winnerCriteria. Các giá trị chuỗi kế thừa testPercentage: 100 và testDurationMinutes: 0 là các tín hiệu tương thích, không phải cài đặt thời gian chạy. select_ab_test_winner chỉ áp dụng cho kiểm tra chiến dịch hiện đang chạy và ngay lập tức xếp hàng đợi biến thể chiến thắng cho đối tượng còn lại. update_ab_test thay đổi mô hình cài đặt phù hợp và yêu cầu confirmLiveChange: true khi cài đặt chuỗi ảnh hưởng đến kiểm tra đang hoạt động hoặc đã sử dụng. Cập nhật biến thể chấp nhận html hoặc blocks, không phải cả hai.

create_ab_test chấp nhận chính xác một trong campaignId hoặc automationNodeId; cái sau yêu cầu một đến bốn biến thể bổ sung và chuyển đổi nút email chuỗi thành action_ab_test. Việc chuyển đổi di chuyển chủ đề, văn bản xem trước và khối của bước lên các email biến thể độc lập. Lấy ID kiểm tra và biến thể từ get_sequence, đọc bản sao của mọi biến thể bằng get_ab_test và chỉnh sửa từng biến thể bằng update_ab_test_variant; update_sequence_node và update_template không thể chỉnh sửa bản sao biến thể và thay đổi dành cho toàn bộ bước phải được lặp lại cho mọi biến thể. Nếu update_ab_test_variant không có trong danh sách công cụ MCP, hãy bật nó trên trình kết nối Sequenzy thay vì ghi qua công cụ email khác. Quy trình làm việc đầy đủ yêu cầu ab_tests:read, ab_tests:write và sequences:write, tất cả đều có trong Truy cập tác nhân an toàn hơn. Chỉ với sequences:read, get_sequence giữ bước A/B và bản sao kiểm soát hiển thị nhưng biên tập các trường hồ sơ kiểm tra và trả về danh sách biến thể trống. Một winnerCriteria chuỗi rõ ràng ghi đè mặc định testType, vì vậy các biến thể nội dung vẫn có thể được đánh giá bằng lượt mở. Truyền confirmLiveChange: true khi chuyển đổi nút trong chuỗi đang hoạt động. Cùng với kiểm soát A, kiểm tra A/B hỗ trợ tối đa năm biến thể. Các biến thể chuỗi nhận các mẫu email độc lập và có thể được chỉnh sửa sau khi tạo; một khi chuỗi đang hoạt động hoặc kiểm tra có hoạt động, update_ab_test_variant yêu cầu confirmLiveChange: true. Các biến thể chỉ có thể được thêm hoặc xóa trong khi kiểm tra là bản nháp và các thay đổi chuỗi trực tiếp cũng yêu cầu xác nhận vì chúng ngay lập tức thay đổi vòng quay.

Chiến dịch

Công cụ	Mô tả
list_campaigns	Liệt kê các chiến dịch được phân trang theo trạng thái hoặc nhãn, bao gồm phản hồi của người đánh giá và các trường về nhịp độ gửi để kiểm toán STO trên toàn tài khoản.
get_campaign	Lấy chi tiết, số liệu thống kê, phản hồi của người đánh giá và nhịp độ gửi đã ghi nhận cho một chiến dịch.
get_campaign_audience	Giải quyết nhắm mục tiêu đã lưu, các tham chiếu bị thiếu, bản tóm tắt bằng ngôn ngữ đơn giản và số lượng người nhận trực tiếp.
list_campaign_goals	Liệt kê các mục tiêu chuyển đổi được lưu trữ cho một chiến dịch email (SMS không được hỗ trợ).
create_campaign_goal	Thêm mục tiêu chuyển đổi chiến dịch email dựa trên sự kiện, thuộc tính người đăng ký hoặc thẻ được áp dụng.
update_campaign_goal	Cập nhật mục tiêu chuyển đổi chiến dịch email đã lưu trữ.
delete_campaign_goal	Xóa mục tiêu chuyển đổi chiến dịch email đã lưu trữ.
list_email_sends	Tìm kiếm lịch sử gửi gần đây với ID tài nguyên và URL, tùy chọn giới hạn trong một bước trình tự. Các lần gửi thử nghiệm trực tiếp thành công bị bỏ qua.
get_email_send	Kiểm tra một lần gửi đang xếp hàng, thử nghiệm, đã gửi, bị chặn hoặc thất bại theo ID gửi email bền vững.
list_recipient_suppressions	Liệt kê những người nhận bị chặn liên quan, bao gồm các địa chỉ không hợp lệ toàn cầu được bảo vệ và khiếu nại.
get_recipient_suppression	Kiểm tra tình trạng chặn cục bộ, khiếu nại, vệ sinh email và chặn SES khu vực cho một người nhận chính xác.
remove_recipient_suppression	Xóa mức leo thang chặn mềm của không gian làm việc trong khi vẫn giữ nguyên các biện pháp bảo vệ toàn cầu, chặn cứng và khiếu nại.
create_campaign	Tạo chiến dịch với nội dung, dữ liệu và các ghi đè tùy chọn về danh tính Người gửi/Trả lời.
update_campaign	Cập nhật chiến dịch nháp, bao gồm nội dung, dữ liệu, danh tính, đối tượng và cấu hình STO đã lưu trữ.
schedule_campaign	Lên lịch hoặc đặt lại lịch cho một chiến dịch, tùy chọn ghi đè STO và cửa sổ gửi 1-24 giờ của nó.
send_test_email	Gửi email thử nghiệm đến một địa chỉ.
render_email	Kết xuất HTML an toàn cho email chính xác và báo cáo các thẻ chưa được giải quyết, bao gồm cả lỗi chính tả bị ẩn bởi các giá trị mặc định.
cancel_campaign	Hủy một chiến dịch đã lên lịch hoặc đang gửi.
pause_campaign	Tạm dừng một chiến dịch đang gửi.
resume_campaign	Tiếp tục một chiến dịch đã tạm dừng, tùy chọn trải rộng việc gửi theo thời gian.
delete_campaign	Xóa một chiến dịch.
duplicate_campaign	Nhân bản một chiến dịch thành một bản nháp mới.
resend_campaign_to_non_openers	Tạo bản nháp gửi lại cho những thành viên đối tượng ban đầu chưa mở một chiến dịch đã gửi.

Các chiến dịch do lời nhắc tạo được tạo và lưu trữ trong một yêu cầu API và vẫn ở dạng nháp. Chỉ sử dụng templateId, blocks hoặc html khi sao chép hoặc giữ nguyên nội dung hiện có thay vì yêu cầu tác nhân biên soạn nội dung đó. Bỏ qua tất cả các trường nội dung để tạo bản nháp trống để chỉnh sửa sau.

Mục tiêu chiến dịch ghi nhận những người nhận thực sự được gửi chiến dịch đó trong cửa sổ quy kết đã cấu hình; một lượt mở hoặc nhấp chuột vẫn là tín hiệu chạm cuối mạnh hơn khi có. Mục tiêu sự kiện yêu cầu triggerEventName, mục tiêu thuộc tính người đăng ký yêu cầu attributePath và mục tiêu thẻ được áp dụng yêu cầu triggerTagName. Cửa sổ quy kết chiến dịch mặc định là 168 giờ khi bị bỏ qua.

Để gửi vào cùng một thời điểm đồng hồ treo tường trong múi giờ riêng của từng người nhận, hãy gọi schedule_campaign với sendInRecipientTimezone: true và một IANA scheduledTimezone xác định đồng hồ treo tường được biểu thị bởi scheduledAt. Những người liên hệ không có múi giờ được lưu trữ sẽ nhận chiến dịch tại thời điểm scheduledAt. Chế độ này không thể kết hợp với việc gửi định kỳ hoặc trải rộng.

Tối ưu hóa thời gian gửi được cấu hình cho từng chiến dịch, không phải ở cấp công ty hoặc trình tự. Kiểm tra nó trên các chiến dịch bằng list_campaigns hoặc kiểm tra một chiến dịch bằng get_campaign. Đặt sendTimeOptimization và sendTimeWindowHours (1-24, mặc định 12) trên bản nháp bằng update_campaign hoặc ghi đè chúng khi lên lịch bằng schedule_campaign. spreadOverHours được ưu tiên và vô hiệu hóa STO, cũng như việc gửi theo múi giờ người nhận. Các trình tự thay vào đó sử dụng sendingWindow, một cổng giờ/ngày được phép dùng chung thay vì thời gian gửi dự đoán cho từng người nhận.

Đối với danh tính ở cấp chiến dịch và trình tự, fromEmail cộng với fromName chọn danh tính người gửi có tên hiển thị đó trên hộp thư, tạo danh tính đó khi cần mà không đổi tên các danh tính cùng địa chỉ khác. Một địa chỉ Trả lời thay vào đó có một tên đã lưu trên toàn công ty: khi replyToName khác với tên đó, tên đã lưu được giữ và phản hồi thành công bao gồm hướng dẫn khôi phục trong warnings.

send_email và send_test_email trả về một emailSendId bền vững. Sử dụng list_email_sends để khám phá các ID gần đây theo chủ đề/tiêu đề, người nhận, trạng thái gửi, loại, loại chặn hoặc nguồn; chuyển một ID đến get_email_send để kiểm tra status, errorMessage, nội dung đã lưu và các sự kiện gửi. Các hàng danh sách gửi được giữ trong 14 ngày. Các lần gửi thử nghiệm trực tiếp thành công và các lần gửi thử nghiệm khác bị bỏ qua để chúng không lấn át các lần gửi thực. Các phản hồi cho các lần gửi thử nghiệm đó hiển thị trong list_conversations chỉ khi tính năng thu thập phản hồi đến được bật. Các công việc xếp hàng là chi tiết thực thi nội bộ và không được hiển thị qua hợp đồng MCP. Mỗi lần gửi được trả về có một url bảng điều khiển trực tiếp. Sử dụng list_recipient_suppressions để phân biệt các hàng người nhận không hợp lệ toàn cầu được bảo vệ, chặn cứng công ty được bảo vệ và khiếu nại với các mức leo thang chặn mềm công ty có thể xóa, và sử dụng get_recipient_suppression cho trạng thái khu vực chính xác. remove_recipient_suppression chỉ xóa mức leo thang công ty; các biện pháp chặn toàn cầu và cấp tài khoản Amazon SES, khiếu nại, hủy đăng ký và bảo vệ vệ sinh email vẫn được giữ nguyên. Kết quả vệ sinh cục bộ sử dụng lý do bounced với email_hygiene làm nguồn của nó mà không thay đổi trạng thái đồng ý của người đăng ký.

Các tác nhân nên chuyển một idempotencyKey thuộc sở hữu của người gọi đến send_email trước lần thử đầu tiên và sử dụng lại nó cho mọi lần thử lại của cùng một email logic đó. Sequenzy trả về emailSendId ban đầu trong 14 ngày thay vì tạo một lần gửi khác. Việc sử dụng lại khóa với các đối số gửi khác nhau bị từ chối, vì vậy đừng tạo khóa mới bên trong vòng lặp thử lại.

Các khối email có thể sử dụng quy tắc hiển thị có điều kiện hoặc các nhánh conditional-group. Các điều kiện hỗ trợ biến thời điểm kết xuất và thuộc tính người đăng ký cộng với dữ liệu người đăng ký trực tiếp như tư cách thành viên phân đoạn/danh sách, thẻ, sự kiện, mức độ tương tác, trạng thái đăng ký/SMS và mua hàng Stripe hoặc thương mại. Các điều kiện dữ liệu trực tiếp sử dụng cùng giá trị trường và toán tử như bộ lọc phân đoạn; những người nhận không có kết quả khớp người đăng ký được lưu trữ sử dụng nhánh OTHERWISE.

Các hình dạng khối cốt lõi là { "type": "heading", "content": "Tiêu đề", "level": 1 }, { "type": "text", "content": "<p>Sao chép</p>" }, { "type": "button", "text": "Đặt lịch gọi", "url": "https://example.com", "variant": "primary" } , and { "type": "image", "src": "https://...", "alt": "Mô tả", "width": 100, "widthType": "percent" }. Buttons also accept content như một bí danh cho text và mặc định là biến thể primary. widthType hình ảnh chấp nhận percent hoặc px.

Các khối video YouTube chấp nhận ảnh bìa tùy chỉnh tùy chọn: { "type": "video", "videoUrl": "https://www.youtube.com/watch?v=...", "thumbnailUrl": "https://cdn.example.com/cover.jpg", "alt": "Xem video giới thiệu sản phẩm" }. Việc thay thế các khối mà không có thumbnailUrl khôi phục ảnh tĩnh của chính YouTube trong khi giữ videoUrl làm đích nhấp chuột.

html thô được lưu trữ dưới dạng một khối không trong suốt. Nó giữ nguyên đánh dấu được cung cấp nhưng không thêm logo công ty, các phần có thương hiệu gốc hoặc thiết kế khối theo chủ đề. Sử dụng prompt cho bản nháp có thương hiệu mới hoặc blocks cho thiết kế gốc của trình chỉnh sửa; kết quả biên soạn MCP bao gồm cảnh báo khi sử dụng HTML thô.

Sử dụng update_company với fromEmail và/hoặc replyTo để đặt các giá trị mặc định trên toàn tài khoản. fromEmail phải sử dụng một miền gửi đã cấu hình, đã xác minh; replyTo có thể là bất kỳ hộp thư hợp lệ nào. create_campaign, update_campaign, create_sequence và update_sequence chấp nhận cùng các trường địa chỉ trực tiếp cho các ghi đè cụ thể theo tài nguyên và tạo hồ sơ hỗ trợ khi cần. Gửi fromName hoặc replyToName một mình để đổi tên hồ sơ mặc định hiện có mà không thay đổi địa chỉ của nó. Khi một địa chỉ có nhiều tên hiển thị, hãy sử dụng senderProfileId hoặc replyProfileId từ list_sender_profiles để chọn hồ sơ chính xác để đặt làm mặc định và đổi tên.

update_company cũng quản lý chủ đề email mặc định của công ty thông qua emailTheme (presetId, colors, typography, layout). Các cập nhật chủ đề là một phần - các trường bị bỏ qua giữ nguyên giá trị hiện tại (hoặc mặc định cài sẵn) và các giá trị số được giới hạn trong phạm vi được hỗ trợ. Chuyển emailTheme: null để đặt lại công ty về chủ đề mặc định của nền tảng. Cài đặt bố cục có thể kiểm soát baseRadius dùng chung và một buttonRadius riêng biệt. Trong colors, background tô màu khung vẽ bên ngoài, content tô màu thẻ nội dung bên trong và surface tô màu các thẻ lồng nhau hoặc các ô có màu. Bỏ qua content giữ nguyên giá trị hiện tại của nó; khi không có màu nội dung nào được lưu trữ, thẻ tuân theo background.

Theo dõi phản hồi có sẵn trên cùng các công cụ công ty. Sử dụng replyTrackingEnabled, replyTrackingDomainMode (sequenzy hoặc custom) và forwardReplies với update_company. Các lần đọc của công ty cũng trả về giá trị replyRetentionDays chỉ đọc hiện tại.

Thăm dò ý kiến và khảo sát NPS là các khối email gốc, vì vậy chúng hoạt động ở bất kỳ nơi nào một công cụ email chấp nhận blocks, bao gồm các chiến dịch, mẫu, biến thể A/B, mẫu giao dịch và các bước email trình tự. Các lần gửi thăm dò giao dịch phải phân giải thành chính xác một người nhận hiệu quả sau khi lọc chặn và khử trùng lặp người nhận, và người nhận đó phải đã tồn tại dưới dạng người đăng ký; nếu không, Sequenzy từ chối gửi vì liên kết câu trả lời không thể được quy kết một cách an toàn. Sử dụng thăm dò ý kiến với nút câu trả lời:

{
  "type": "poll",
  "variant": "options",
  "question": "What did you think of this email?",
  "options": [
    { "label": "Loved it", "value": "loved" },
    { "label": "Not for me", "value": "not_for_me" }
  ],
  "attributeKey": "email_feedback"
}

Đối với NPS, hãy sử dụng "variant": "nps", một mảng options rỗng và một thuộc tính như nps_score. Thang điểm luôn là 0-10; các npsLowLabel và npsHighLabel tùy chọn tùy chỉnh chú thích của nó. Mỗi câu trả lời cập nhật thuộc tính người đăng ký và kích hoạt poll.answered cho tự động hóa và webhook gửi đi.

Đặt "allowMultiple": true trên một cuộc thăm dò ý kiến chỉ có văn bản để mở một trang được lưu trữ nơi người nhận có thể chọn nhiều câu trả lời và lưu toàn bộ lựa chọn cùng một lúc. Thuộc tính người đăng ký lưu trữ danh sách giá trị đã chọn, vì vậy các phân đoạn thuộc tính nên sử dụng contains. Các cuộc thăm dò chọn nhiều không thể sử dụng hình ảnh tùy chọn hoặc cấu hình có liên kết đã ký được mã hóa vượt quá giới hạn kích thước an toàn khi gửi. Tóm tắt cuộc thăm dò chiến dịch đặt allowMultiple: true, sử dụng số lượng người trả lời cho totalResponses và có thể báo cáo tỷ lệ phần trăm câu trả lời cộng lại vượt quá 100%.

Các khối thăm dò cũng hỗ trợ kiểu dáng riêng cho thương hiệu. accentColor đổi màu mọi lần xuất hiện, bao gồm cả "brutal"; optionRadius đặt góc của nút câu trả lời theo pixel (0 là hình vuông), độc lập với styles.borderRadius của vùng chứa; và questionColor chỉ đổi màu câu hỏi. fontFamily áp dụng cho cuộc thăm dò. Sử dụng các trường optionFontSize, optionFontWeight, optionLetterSpacing và optionTextTransform cho câu trả lời, hoặc các trường question* tương ứng cho câu hỏi. Kích thước và khoảng cách tính bằng pixel, trọng số từ 100 đến 900 và biến đổi văn bản là "none" hoặc "uppercase".

Biểu mẫu đã lưu

Công cụ	Mô tả
list_forms	Liệt kê các biểu mẫu đã lưu với cài đặt đối tượng do máy chủ quản lý, khối nội dung và URL hành động công khai.
create_form	Tạo và xuất bản một biểu mẫu đã lưu với các trường email/tên tiêu chuẩn, cài đặt đối tượng, chủ đề và hành vi thành công.
update_form	Cập nhật một biểu mẫu đã lưu, bao gồm toàn bộ mảng khối có thứ tự và các trường tùy chỉnh có kiểu dữ liệu.
get_form_embed	Trả về URL hành động công khai, JavaScript được lưu trữ, biểu mẫu gốc tối thiểu và ví dụ tìm nạp cho một biểu mẫu đã lưu.

Đối với Astro, Hugo, Jekyll, Cloudflare Pages, Netlify, GitHub Pages hoặc bất kỳ trang tĩnh nào khác, hãy gọi list_forms, sử dụng create_form nếu một biểu mẫu phù hợp không tồn tại, sau đó gọi get_form_embed. formId không rõ ràng được trả về là khả năng công khai: danh sách, thẻ, hành vi trùng lặp và xử lý thành công vẫn nằm ở phía máy chủ, vì vậy mã trình duyệt được triển khai không bao giờ chứa khóa API Sequenzy. Đánh dấu gốc và độc lập được tạo bao gồm "Powered by Sequenzy" cho các không gian làm việc miễn phí; không gian làm việc trả phí nhận đánh dấu không có thương hiệu. API giải quyết quyền đó ở phía máy chủ, vì vậy người gọi nên sử dụng đoạn mã được trả về mà không thay đổi. Khi cập nhật một biểu mẫu, các trường bị bỏ qua vẫn không thay đổi và các trường chủ đề hợp nhất vào chủ đề hiện tại. Truyền một mảng tagIds rỗng để xóa thẻ hoặc một redirectUrl rỗng để khôi phục hành vi thông báo xác nhận. Trường blocks là một thay thế hoàn chỉnh, vì vậy hãy đọc nội dung hiện tại bằng list_forms trước và giữ lại chính xác một trường email bắt buộc và một nút gửi. Thêm các đầu vào tùy chỉnh dưới dạng các khối form-field với một fieldType được hỗ trợ; các trường chọn, radio và hộp kiểm yêu cầu các tùy chọn, trong khi các giá trị mặc định ẩn được thực thi ở phía máy chủ.

Cửa sổ bật lên đã lưu

Công cụ	Mô tả
list_popups	Liệt kê các cửa sổ bật lên đã lưu với trạng thái và số liệu tương tác, tùy chọn bao gồm toàn bộ nội dung.
get_popup	Lấy các khối, trình kích hoạt, nhắm mục tiêu, lịch trình, tần suất, chủ đề và mã nhúng đã xuất bản của một cửa sổ bật lên.
create_popup	Tạo một cửa sổ bật lên từ một mẫu bắt đầu, xuất bản theo mặc định và trả về tập lệnh triển khai của nó.
update_popup	Cập nhật một phần văn bản, đối tượng, hành vi, chủ đề, khối hoặc trạng thái xuất bản của cửa sổ bật lên.
get_popup_embed	Trả về các đoạn nhúng HTML, React/Next.js, WordPress và Shopify không có bí mật.
duplicate_popup	Sao chép một cửa sổ bật lên thành bản nháp với bộ đếm tương tác độc lập.
delete_popup	Xóa vĩnh viễn một cửa sổ bật lên và bộ đếm tương tác của nó.

Việc triển khai cửa sổ bật lên sử dụng một thẻ tập lệnh công khai; khóa API, cài đặt đối tượng, kích hoạt, nhắm mục tiêu, lập lịch và quy tắc tần suất vẫn ở phía máy chủ. Cửa sổ bật lên thu thập vào mọi danh sách theo mặc định trừ khi listIds được cung cấp. Khi cập nhật các khối, hãy đọc cửa sổ bật lên trước và gửi mảng thay thế hoàn chỉnh, giữ lại chính xác một trường email bắt buộc và một nút gửi. Đặt status thành draft dừng một cửa sổ bật lên mà không làm mất hiệu lực mã nhúng hiện có của nó.

Trang đích

Công cụ	Mô tả
list_landing_pages	Liệt kê các trang đích với trạng thái, số liệu, nội dung và URL.
get_landing_page	Lấy chi tiết trang đích, nội dung trình xây dựng, số liệu và URL đã xuất bản.
render_landing_page	Trả về bản xem trước khách truy cập đã ký trong 24 giờ mà không xuất bản, đếm lượt xem hoặc thu thập đăng ký.
create_landing_page	Tạo một trang đích nháp từ nội dung mẫu mặc định hoặc JSON.
update_landing_page	Chỉnh sửa tên, slug hoặc toàn bộ nội dung tương thích trình chỉnh sửa của trang đích.
publish_landing_page	Xuất bản một trang đích, tùy chọn lưu các chỉnh sửa trước.
unpublish_landing_page	Đưa một trang đích về trạng thái nháp, tùy chọn lưu các chỉnh sửa trước.
duplicate_landing_page	Nhân bản một trang đích thành một bản nháp mới với slug duy nhất.
delete_landing_page	Xóa một trang đích chưa xuất bản.
connect_landing_page_domain	Kết nối một tên miền trang đích tùy chỉnh và trả về chi tiết thiết lập DNS.
update_landing_page_domain_settings	Thay thế hoặc xác minh cài đặt tên miền tùy chỉnh của trang đích.

Nội dung trang đích sử dụng lược đồ JSON tương thích trình chỉnh sửa của Sequenzy với version, template, seo, theme và blocks. Cài đặt SEO bao gồm faviconUrl và hideFromSearchEngines; các trang ẩn xuất bản một chỉ thị noindex . Sử dụng render_landing_page để xem lại trang hiện tại đối diện khách truy cập trước khi xuất bản. previewUrl đã ký của nó hết hạn sau 24 giờ, không được liệt kê, không được lập chỉ mục và không tăng lượt xem trang; biểu mẫu vẫn hiển thị nhưng không thu thập danh bạ. Các khối hiển thị theo thứ tự vị trí: top, hero, form, body, sau đó là footer; sử dụng top cho một thông báo hoặc biểu ngữ toàn chiều rộng phía trên hero. URL CTA nút và giá chấp nhận đích HTTPS bên ngoài hoặc neo trong trang như #form, #section-<sectionId>, #block-<blockId> và #top. Đặt theme.sectionAnimation thành none, fade, slide-up hoặc zoom-in, với theme.sectionAnimationSpeed được đặt thành slow, normal hoặc fast, để kiểm soát các hiệu ứng cuộn được xuất bản. Các tên miền phụ trang đích tùy chỉnh yêu cầu bản ghi CNAME trỏ đến pages.sequenzydns.com; tên miền gốc sử dụng bản ghi A trỏ đến 76.76.21.21 và máy chủ www của chúng chuyển hướng đến gốc khi CNAME của nó trỏ đến pages.sequenzydns.com. Gọi update_landing_page_domain_settings với verify: true sau khi các thay đổi DNS lan truyền.

Chuỗi

Công cụ	Mô tả
list_sequences	Liệt kê các chuỗi với trạng thái bảng điều khiển, bộ lọc tìm kiếm, nhãn, giới hạn và bù.
get_sequence	Lấy chi tiết chuỗi, ID biến thể A/B và số lượng khối với ab_tests:read, các nút, cạnh, bản sao liên kết và cửa sổ gửi chuỗi.
list_sequence_enrollments	Liệt kê các lần ghi danh liên hệ với phân trang và phân bổ chính xác theo danh sách/nhãn/sự kiện/thời gian. Kiểm thử chuỗi trực tiếp không tạo ghi danh.
send_sequence_test_email	Gửi một bước action_email đã lưu đến 1-10 người đánh giá; các bước A/B được kiểm tra theo từng biến thể.
create_sequence	Tạo bản nháp bảng điều khiển trống hoặc chuỗi do AI tạo/bước tường minh.
update_sequence	Cập nhật danh tính, cài đặt, ghi danh, các bước hiện có, logic nhánh hoặc chèn các bước tuyến tính.
update_sequence_node	Bản vá nhận biết loại của một nút chuỗi hiện có.
update_sequence_nodes	Vá nguyên tử nhiều nút chuỗi hiện có.
insert_sequence_step	Chèn bất kỳ bước bảng điều khiển đã nhập, bao gồm tạo AI, webhook gửi đi, chờ và nhánh có dây.
edit_sequence_graph	Di chuyển, kết nối lại, xóa hoặc nhân bản các nút đồ thị; báo cáo người nhận đã di chuyển hoặc hoàn thành.
simulate_sequence	Chạy thử các kết quả khớp hiện tại, mức sẵn sàng kích hoạt và đường dẫn nhánh tùy chọn của liên hệ mà không ghi danh hoặc gửi.
enable_sequence	Kích hoạt một chuỗi.
disable_sequence	Đóng băng một chuỗi, chặn ghi danh mới và giữ người nhận hiện tại.
duplicate_sequence	Tạo bản sao nháp độc lập của đồ thị, email và kiểm thử A/B chuỗi.
archive_sequence	Di chuyển một chuỗi vào kho lưu trữ bảng điều khiển và dừng ghi danh mới.
unarchive_sequence	Khôi phục một chuỗi đã lưu trữ dưới dạng bản nháp bị vô hiệu hóa.
list_sequence_goals	Liệt kê các mục tiêu chuyển đổi theo sự kiện, thuộc tính người đăng ký và nhãn được áp dụng đã lưu cho một chuỗi.
create_sequence_goal	Thêm mục tiêu chuyển đổi theo sự kiện, thuộc tính người đăng ký hoặc nhãn được áp dụng.
update_sequence_goal	Cập nhật mục tiêu chuyển đổi chuỗi đã lưu.
delete_sequence_goal	Xóa mục tiêu chuyển đổi chuỗi đã lưu.
get_sequence_inbound_webhook	Đọc URL gửi đến, trạng thái thiết lập, mẫu và ánh xạ trên MCP tiêu chuẩn; tuyến OpenAI loại bỏ URL chứa thông tin xác thực.
configure_sequence_inbound_webhook	Cấu hình điểm cuối, ánh xạ trường và mẫu; tuyến OpenAI loại bỏ URL chứa thông tin xác thực khỏi kết quả của nó.
rotate_sequence_inbound_webhook_secret	Xoay bí mật điểm cuối chuỗi gửi đến và trả về URL thay thế trên MCP tiêu chuẩn; bỏ qua trên tuyến được OpenAI xem xét.
pause_sequence_enrollments	Dừng ghi danh mới cho một chuỗi đang hoạt động trong khi người nhận hiện tại tiếp tục.
resume_sequence_enrollments	Mở lại ghi danh mới cho một chuỗi đang hoạt động mà không thay đổi người nhận hiện tại.
enroll_subscribers_in_sequence	Ghi danh tối đa 500 người đăng ký theo email, ID người đăng ký hoặc cả hai, với tính bất biến an toàn khi thử lại.
cancel_sequence_enrollments	Dừng ghi danh đang hoạt động hoặc đang chờ theo giá trị trường người đăng ký hoặc sự kiện vào.
realign_sequence_enrollments	Xem trước hoặc xếp hàng di chuyển các lần chờ trực tiếp sớm hơn đến thời điểm mở cửa sổ gửi của chúng.
get_sequence_enrollment_realignment	Thăm dò một công việc căn chỉnh lại đã áp dụng và đọc kết quả hoàn thành hoặc con trỏ tiếp tục của nó.
delete_sequence	Xóa một chuỗi.

Tạo chuỗi hỗ trợ:

• Chỉ tạo tên cho bản nháp trống, bị vô hiệu hóa từ kích hoạt đến hoàn thành khớp với bảng điều khiển.
• Siêu dữ liệu bảng điều khiển và cài đặt gửi: description, labels, userCancellable, BCC chuỗi và danh tính Từ/Trả lời.
• trigger: "contact_added" với listId, một số listIds hoặc listScope: any_contact (mặc định) ghi danh mọi liên hệ được thêm, bao gồm cả liên hệ không tham gia danh sách nào, trong khi any_list chờ tư cách thành viên danh sách thực tế.
• trigger: "tag_added" với tagName hoặc một số tagNames; bất kỳ nhãn nào được cấu hình sẽ ghi danh liên hệ.
• trigger: "segment_entered" cộng segmentId cho tự động hóa vào phân khúc đã lưu.
• trigger: "event_received" cộng {{event.*}} gộp thẻ trong chủ đề hoặc nội dung.
• trigger: "inbound_webhook" cộng siêu dữ liệu tích hợp cho các nút vào webhook tương thích bảng điều khiển.
• trigger: "inactivity" cộng eventName, inactiveDays và inactivityBaseline tùy chọn (sequence_created_at hoặc subscriber_created_at).
• goal cho nội dung email do AI tạo.
• emailStyle: "visual" hoặc "plain" để chọn cách trình bày email do AI tạo dựa trên mục tiêu; khi bỏ qua, tùy chọn đã lưu của công ty được sử dụng.
• steps tường minh với Sequenzy blocks.
• steps tường minh với HTML, mà Sequenzy chuyển đổi thành các khối có thể chỉnh sửa.
• Các bước Cập nhật Người đăng ký tường minh sao chép thuộc tính sự kiện kích hoạt vào trường hồ sơ hoặc thuộc tính tùy chỉnh đã nhập.
• Chờ cố định qua delay / delayMs, chờ trường ngày động qua waitUntil hoặc cổng lịch qua waitUntilWeekday. Cổng ngày trong tuần như { "day": "sunday", "startTime": "09:00", "endTime": "12:00", "timezone": "America/Los_Angeles" } giữ luồng cho đến cửa sổ khớp tiếp theo. Đặt ngay trước email để giữ lần gửi đó trong cửa sổ; bất kỳ bước xen kẽ nào có thể chuyển giao ngoài cửa sổ. Khôi phục hàng đợi kiểm tra lại cửa sổ trước khi giải phóng liên hệ bị trễ.
• Các bước hành động giảm giá động Stripe hoặc Shopify. Bước create_discount tạo mã nhà cung cấp mới khi mỗi người đăng ký đến; email sau có thể sử dụng thẻ gộp như {{discount.code}}, {{discount.percentOff}} và {{discount.expiresAt}}.
• enrollmentMode: "matching_field" và enrollmentFieldPath vô hướng cho tự động hóa sự kiện cụ thể theo sản phẩm, biến thể, đơn hàng hoặc đăng ký. Duyệt mảng với [] thuộc về propertyFilters, không phải khóa ghi danh.

Đối với trình kích hoạt sự kiện tùy chỉnh, kết quả create_sequence thành công bao gồm eventTrackingCode và một đối tượng eventTracking có cấu trúc. Đối tượng chứa điểm cuối sự kiện, danh tính và hợp đồng tải trọng, mọi đường dẫn thuộc tính cần thiết cho ghi danh matching_field, trình kích hoạt propertyFilters đã chuẩn hóa, một tải trọng ví dụ, examplePayloadMatchesFilters, URL tài liệu API sự kiện trực tiếp và các đối số sẵn sàng sử dụng cho get_integration_guide. Nếu trạng thái khớp là false, điều chỉnh ví dụ bằng examplePayloadNote và hợp đồng tải trọng. Thêm nguồn cấp sự kiện này và xác minh các thuộc tính bắt buộc của nó trước khi bật chuỗi nháp.

list_sequence_enrollments trả về enteredVia cho mỗi hàng. Nguồn danh sách và phân khúc giữ ID ổn định của chúng trong value và giải quyết name hiển thị; nguồn nhãn và sự kiện giữ tên của chúng trong value. Trình kích hoạt dựa trên thời gian báo cáo inactivity hoặc frequency thay vì bị xác định sai là ghi danh sự kiện nhận thông thường. Kiểm thử chuỗi trực tiếp không tạo ghi danh; chúng gửi email kiểm thử cô lập và ghi hoạt động trên lần chạy kiểm thử chuỗi thay vào đó.

Đối với một đợt ghi danh thủ công đã xác nhận, tạo idempotencyKey một lần và tái sử dụng chính xác khóa đó chỉ với các mục tiêu có thứ tự giống hệt và targetNodeId. Biên nhận kéo dài 14 ngày. Một lần thử lại trả về enrolled, skipped, notFound, targetNodeId và scheduledFor ban đầu với idempotentReplay: true; nó không tạo mã thông báo hoặc xếp hàng đợt lại.

Ví dụ bước giảm giá động Shopify:

{
  "type": "create_discount",
  "discount": {
    "provider": "shopify",
    "discountType": "percent",
    "percentOff": 20,
    "duration": "once",
    "appliesToAllPlans": true,
    "maxRedemptions": 1,
    "codePrefix": "WINBACK"
  }
}

Ví dụ bước Cập nhật Người đăng ký:

{
  "type": "update_subscriber",
  "nodeType": "action_update_attributes",
  "config": {
    "firstName": "{{event.firstName}}",
    "customAttributeUpdates": [
      { "name": "plan", "value": "{{event.plan}}", "valueType": "text" },
      { "name": "mrr", "value": "{{event.amount}}", "valueType": "number" },
      { "name": "active", "value": "{{event.active}}", "valueType": "boolean" }
    ]
  }
}

Giá trị số và boolean phải là ký tự hoặc một thẻ gộp độc lập. Sử dụng update_sequence.subscriberUpdateSteps với action_update_attributes ID nút từ get_sequence để thay thế cấu hình bước hiện có. Cập nhật trình tự hỗ trợ insertSteps để thêm các bước tuyến tính mới sau một nodeId được trả về bởi get_sequence. Bỏ qua afterNodeId chỉ khi nối thêm vào một trình tự có đúng một đuôi tuyến tính. insertSteps hỗ trợ các bước có thể thêm mà không yêu cầu bản ghi đi kèm, chẳng hạn như email, độ trễ, hành động thẻ/danh sách, cập nhật thuộc tính, giảm giá, điều kiện, bước chờ sự kiện, webhook gửi đi và bước AI. Một bước action_ai yêu cầu thẻ hợp nhất prompt, resultKey duy nhất và một hoặc nhiều outputFields; các bước sau đọc văn bản được tạo hoặc văn bản dự phòng bằng {{ai.KEY.field}}. Giới hạn trường đầu ra kết hợp phải nằm trong ngân sách phản hồi 2000 token của bước. Sử dụng includeTags, includeEventProperties hoặc includeAttributes để chọn đưa ngữ cảnh liên hệ cụ thể vào quá trình tạo và onError (continue, exit hoặc fail) để chọn hành vi khi lỗi. Sử dụng branch cho các nhánh if/else đa đường; cung cấp branch hoặc insertSteps, không cung cấp cả hai. Điều kiện nhánh hỗ trợ kiểm tra sự hiện diện và vắng mặt của thẻ bằng has_tag và does_not_have_tag, cùng với danh sách, phân đoạn đã lưu, sự kiện, liên kết đã nhấp và so sánh trường. Mỗi đường nhánh có thể cung cấp steps mới, một targetNodeId hiện có hoặc cả hai; đường dự phòng sử dụng elseSteps và/hoặc elseTargetNodeId. Một mục tiêu có thể là nút hoàn thành được trả về bởi get_sequence, vì vậy một yêu cầu nguyên tử có thể định tuyến câu trả lời đến hoàn thành và Else đến một bước tiếp theo hiện có. Các mảng emails và steps chỉnh sửa các bước action_email thông thường theo nodeId, emailId hoặc thứ tự mảng. get_sequence.sequence.emails cũng bao gồm các mục action_ab_test; với ab_tests:read, mỗi mục abTest.variants[] chứa ID biến thể, chủ đề, văn bản xem trước và số khối. Gọi get_ab_test để lấy toàn bộ nội dung biến thể trước khi kiểm tra hoặc viết lại nội dung. Một cập nhật vị trí trúng vào một biến thể sẽ bị từ chối và nội dung của nó phải được thay đổi theo từng biến thể bằng update_ab_test_variant; không thử lại qua update_template hoặc update_sequence_node. Sử dụng insertSteps để tạo bước mới và bao gồm delay, delayMs, waitUntil hoặc waitUntilWeekday ở cấp bước khi email được chèn cần bộ hẹn giờ. waitUntil chấp nhận trường ngày từ sự kiện kích hoạt cùng với offset, direction tùy chọn (before hoặc after) và missingAction (continue hoặc exit). waitUntilWeekday chấp nhận day hoặc days, startTime, endTime tùy chọn (mặc định 24:00) và timezone IANA; các liên hệ đã ở trong cửa sổ tiếp tục ngay lập tức. Đối với trình tự đang hoạt động, chỉ truyền confirmStructuralChange: true với insertSteps hoặc branch sau khi xác nhận tác động đến luồng trực tiếp.

insert_sequence_step hiển thị trực tiếp mọi bước trang tổng quan không có bản ghi đi kèm: email, SMS, độ trễ, giảm giá, cập nhật người đăng ký, hành động thẻ/danh sách, webhook gửi đi, tạo AI, điều kiện, chờ và nhánh. Đặt type: "ai" với prompt, resultKey và outputFields để tạo văn bản theo từng liên hệ cho các thẻ hợp nhất {{ai.KEY.field}} sau này. Webhook gửi đi chấp nhận url, method (POST hoặc GET) và headers có giá trị chuỗi. Các bước email hỗ trợ chế độ giao dịch, danh tính theo bước và cài đặt gửi CC/BCC. Đối với cổng chờ, đặt type: "logic_wait_for_event" với eventName, timeoutDays tùy chọn (1-365) và timeoutAction (continue hoặc exit). Đối với nhánh, đặt type: "logic_branch", cung cấp branches có kiểu và kết nối mục tiêu của chúng:

{
  "sequenceId": "seq_123",
  "type": "logic_branch",
  "afterNodeId": "node_email_1",
  "branches": [
    {
      "id": "replied",
      "conditionType": "event_received",
      "eventName": "email.replied",
      "activityScope": "this_sequence",
      "targetNodeId": "node_complete"
    }
  ],
  "elseTargetNodeId": "node_email_2"
}

Mỗi email được liên kết trả về bởi get_sequence bao gồm emailPreset hiệu lực của nó (branded hoặc minimal), khớp với Style > Format trong trang tổng quan. Đặt emailPreset trên một mục emails/steps hoặc trong changes của nút action_email để chỉ thay đổi email được liên kết đó mà không thay đổi chủ đề công ty. Điều này áp dụng cùng phép biến đổi định dạng như trang tổng quan cho các khối Sequenzy gốc, bao gồm các email chứa khối HTML tùy chỉnh được hỗ trợ. Các email được lưu hoàn toàn dưới dạng một khối HTML thô độc lập trả về null cho emailPreset và không hỗ trợ thay đổi định dạng. emailPreset không thể kết hợp với html hoặc htmlContent vì các trường đó thay thế toàn bộ email bằng HTML thô độc lập.

Đối với vị trí trình tự, ưu tiên structuralStepNumber trên các email được liên kết và cấp cao nhất của nút email. Nó được suy ra từ đồ thị hiện tại và khớp với huy hiệu bước hiển thị trong trang tổng quan. Các email nhánh song song có chung độ sâu cấu trúc và việc hợp nhất nhánh không bằng nhau tiếp tục từ đường dài hơn. Trường stepNumber cũ hơn trong email được liên kết và cấu hình nút vẫn là thứ tự được lưu trữ để tương thích ngược và có thể lỗi thời sau khi chỉnh sửa đồ thị.

Mỗi email được liên kết cũng trả về ghi đè emailTheme đã lưu của nó hoặc null khi nó tuân theo chủ đề công ty. Đặt emailTheme trên một mục emails/steps hoặc trong changes của nút action_email để chỉ định kiểu lại bước đó. Cập nhật chủ đề là các bản vá một phần, vì vậy changes: { "emailTheme": { "colors": { "background": "#f3f4f6", "content": "#ffffff" } } } mang lại cho email đó một khung vẽ ngoài màu xám và thẻ nội dung trắng trong khi giữ các màu, kiểu chữ và bố cục khác. Bỏ qua một trong hai màu sẽ giữ nguyên giá trị hiện tại. Truyền emailTheme: null để bỏ ghi đè và tuân theo chủ đề công ty lần nữa. Chỉ sử dụng update_company khi mặc định toàn tài khoản cần thay đổi.

Sử dụng update_sequence_node để chỉnh sửa tại chỗ tập trung hoặc update_sequence_nodes khi nhiều bản vá nút phải được cam kết nguyên tử. Gọi get_sequence trước: mọi mục trong sequence.nodes bao gồm id nút, nodeType, config hiện tại, updatedAt và updateHints với các trường có thể chỉnh sửa và được quản lý cùng mã thông báo đồng thời chính xác để trả về. Truyền mã thông báo đó làm expectedUpdatedAt để từ chối ghi lỗi thời. Các công cụ hỗ trợ mọi loại nút được lưu trữ, bao gồm độ trễ, nội dung email/SMS, hành động, điều kiện, webhook, cấu hình nhánh không thay đổi cấu trúc liên kết và trình kích hoạt. Để thay đổi độ trễ 5 phút thành 7 ngày, hãy gửi changes: { "delay": { "days": 7 } } cho nút logic_delay của nó. Để chuyển nhiều ghi chú kiểu người sáng lập thành Minimal, hãy vá các nút action_email của chúng bằng changes: { "emailPreset": "minimal" }. Chuyển đổi loại nút và thay đổi cạnh/đường dẫn thuộc về edit_sequence_graph. Trình tự đang hoạt động yêu cầu confirmLiveChange: true sau khi người dùng xác nhận tác động; người nhận đang chờ giữ nguyên dấu thời gian đã lên lịch hiện có.

Các bước email hiện có và mới được chèn có thể đặt danh tính Người gửi của riêng chúng bằng senderProfileId hoặc fromEmail cùng với fromName tùy chọn và danh tính Trả lời bằng replyProfileId hoặc replyTo cùng với replyToName tùy chọn. Một fromName riêng chỉ thay đổi tên người gửi hiển thị của bước đó. Một replyToName ở cấp bước tương tự ghi đè tên Trả lời hiển thị cho bước đó mà không đổi tên hồ sơ trả lời toàn công ty. Các bước email mới không có trường danh tính rõ ràng kế thừa danh tính hiệu lực của email trình tự gần nhất. Sau khi hợp nhất nhánh, chỉ các trường danh tính được chia sẻ bởi mọi đường đến được kế thừa; các trường xung đột sử dụng mặc định trình tự hoặc công ty.

Sử dụng edit_sequence_graph với graphRevision mới nhất từ get_sequence để cấu trúc lại một trình tự hiện có một cách nguyên tử. Nó có thể di chuyển một nút trước hoặc sau một nút khác, tái sử dụng mảng sequence.edges đã chuẩn hóa để kết nối lại rõ ràng hoặc sắp xếp lại nhiều nút, xóa một nút hoặc sao chép sâu một nút. Sao chép thử nghiệm A/B tạo các bản ghi kiểm tra, biến thể, email và bản địa hóa độc lập với số liệu thống kê được đặt lại. Di chuyển một nút trước nút dùng chung bên dưới một nhánh kết nối lại mọi đường nhánh hội tụ qua nút đó. Xóa một nút ngay lập tức di chuyển người nhận đang chờ đến người kế thừa sống sót duy nhất của nó hoặc hoàn thành họ khi không còn người kế thừa; kiểm tra sequence.migratedRecipientCount và sequence.completedRecipientCount trong kết quả. Việc xóa bị từ chối khi người nhận đang chờ có nhiều đường tiếp tục sống sót. Các bản sửa đổi lỗi thời, làn nhánh không hợp lệ, chu trình và nút không thể truy cập cũng bị từ chối. Trình tự đang hoạt động yêu cầu confirmStructuralChange: true.

Chạy cancel_sequence_enrollments với dryRun: true trước khi áp dụng hủy hàng loạt.

Chạy realign_sequence_enrollments sau khi thay đổi cửa sổ gửi của trình tự trực tiếp khi các bước chờ hướng email hiện có nên di chuyển sớm hơn đến thời điểm mở mới. Nó mặc định là dryRun: true. Truyền dryRun: false xếp hàng một công việc nền và trả về jobId; thăm dò nó bằng get_sequence_enrollment_realignment. Khi một kết quả hoàn thành có hasMore: true, xếp hàng lần áp dụng có giới hạn tiếp theo với nextCursor của nó. Việc căn chỉnh lại được áp dụng thay đổi thời gian gửi trực tiếp và chỉ nên được sử dụng sau khi người dùng xác nhận bản xem trước.

Khối Email

Công cụ	Mô tả
get_email_block_schema	Liệt kê mọi loại khối email hoặc kiểm tra các trường bắt buộc, giá trị enum, hình dạng mục và ví dụ của một loại.

Gọi get_email_block_schema trước khi tự viết một loại khối bạn chưa sử dụng trước đây. Bỏ qua blockType để liệt kê mọi loại, truyền một loại như list hoặc steps để lấy tài liệu tham khảo đầy đủ hoặc truyền creatableOnly: true để ẩn các loại được quản lý bởi trình chỉnh sửa. Các khối group đã lưu là nội dung chỉnh sửa có cấu trúc: chúng bọc đệ quy các khối con trong bố cục Stack, Row, Grid hoặc Overlay một hình ảnh, nhưng tạo AI và creatableOnly cố ý bỏ qua chúng. Yêu cầu blockType: "group" để kiểm tra các trường của chúng khi đọc hoặc cập nhật nội dung nhóm hiện có. Danh sách là loại khối riêng của chúng thay vì biến thể text: các mục list sử dụng content, trong khi các mục steps sử dụng title và description tùy chọn.

Các công cụ chấp nhận blocks lưu kiểu trực quan theo khối dưới đối tượng styles của khối:

{
  "type": "card",
  "title": "Your update",
  "content": "Everything is ready.",
  "variant": "default",
  "styles": {
    "backgroundColor": "#f8fafc",
    "backgroundOpacity": 85,
    "borderColor": "#cbd5e1",
    "borderWidth": 1,
    "borderRadius": 12
  }
}

Để tương thích với các lời nhắc tác nhân cũ hơn, các khóa kiểu cấp cao nhất như backgroundColor, backgroundOpacity, borderColor, borderWidth và borderRadius cũng được chấp nhận và lưu dưới styles.

Email Giao dịch

Công cụ	Mô tả
list_transactional_emails	Tìm/lọc mẫu và sắp xếp theo số liệu gửi; trả về chủ đề và URL trang tổng quan.
get_transactional_email	Đọc một email giao dịch theo ID hoặc slug.
create_transactional_email	Tạo mẫu giao dịch từ lời nhắc, HTML hoặc khối.
update_transactional_email	Cập nhật siêu dữ liệu hoặc nội dung thân email giao dịch.
send_email	Gửi một email theo mẫu hoặc HTML đến người nhận To, Cc và Bcc dùng chung.

Các mẫu giao dịch được tạo từ lời nhắc được tạo phía máy chủ và mặc định bị vô hiệu hóa để xem xét. Các mẫu HTML hoặc khối rõ ràng giữ mặc định tương thích là bật; truyền enabled rõ ràng để ghi đè một trong hai mặc định. Đối với gửi trực tiếp, hãy truyền to, subject và html; máy chủ MCP ánh xạ html đến trường body của API giao dịch. Đối với email giao dịch đã lưu, hãy truyền slug API của nó qua trường templateId tương thích tên gọi thay thế. Đối với gửi giao dịch, to, cc và bcc mỗi trường chấp nhận một địa chỉ hoặc một mảng tối đa 50. API gửi một email với danh sách người nhận dùng chung và loại bỏ các bản sao chéo trường theo thứ tự ưu tiên to, sau đó cc, rồi bcc. Gửi tiếp thị vẫn yêu cầu chính xác một địa chỉ to được chấp nhận và không hỗ trợ người nhận bổ sung. Biến send_email hỗ trợ mảng lồng nhau cho các khối lặp lại, chẳng hạn như { "event": { "items": [...] } }. Khi người nhận khớp với một người đăng ký đã lưu theo ID ngoài hoặc email, tên và họ đã lưu sẽ tự động điền vào các biến tên bị bỏ trống. Giá trị tường minh, bao gồm cả giá trị trống, được ưu tiên. Mảng attachments tùy chọn chấp nhận tối đa 10 tệp / tổng 7MB. Mỗi mục cần filename và chính xác một trong Base64 content hoặc path HTTP(S) công khai. Đặt contentId để nhúng hình ảnh CID được tham chiếu từ HTML và tùy chọn đặt contentType để ghi đè phát hiện MIME. Khi trackingSettings bị bỏ qua, các mặc định theo dõi API Giao dịch của công ty sẽ được áp dụng. Sử dụng trackingSettings.clickTracking: false hoặc trackingSettings.openTracking: false để tắt việc viết lại liên kết hoặc pixel mở cho một lần gửi. Các tùy chọn theo từng lần gửi này chỉ chọn không tham gia; chúng không thể bật theo dõi đã bị tắt bởi mặc định toàn tài khoản hoặc API Giao dịch. Sử dụng get_tracking_settings và update_tracking_settings để kiểm tra hoặc thay đổi các mặc định đó.

Đối với các lần thử lại của agent và workflow, hãy bao gồm idempotencyKey ổn định (tối đa 255 ký tự) trong send_email. Sử dụng một khóa cho mỗi email logic và gửi cùng các đối số khi thử lại; khóa vẫn hợp lệ trong 14 ngày.

Phân tích

Công cụ	Mô tả
get_stats	Lấy thống kê tổng quan cho 7d, 30d hoặc 90d; lọc theo loại email cấu trúc.
get_transactional_stats	Lấy số liệu mọi thời điểm hoặc theo khoảng thời gian cho một email giao dịch đã lưu theo ID hoặc slug.
get_campaign_stats	Lấy hiệu suất chiến dịch, số liệu trả lời, mục tiêu chuyển đổi đính kèm và tóm tắt Poll/NPS.
list_poll_responses	Liệt kê câu trả lời Poll/NPS mới nhất của từng người trả lời theo khối, kèm danh tính và thời gian phản hồi.
get_sequence_stats	Lấy hiệu suất chuỗi tổng hợp và theo từng bước cộng với số lượng đăng ký đang hoạt động/chờ trực tiếp theo nút hiện tại.
list_email_metrics	So sánh phễu chiến dịch và bước chuỗi, trả lời, chuyển đổi và doanh thu, bao gồm cả các bước chéo chuỗi.
list_campaign_events	Liệt kê các sự kiện email thô được phân trang cho một chiến dịch.
list_sequence_events	Liệt kê các sự kiện thô được phân trang cho một chuỗi, tùy chọn giới hạn ở một bước email.
get_subscriber_activity	Lấy thống kê email, hoạt động và đăng ký của người đăng ký.

Bộ lọc sự kiện chiến dịch và chuỗi chấp nhận transport_failure cùng với các sự kiện gửi, trả lại, khiếu nại, tương tác, hủy đăng ký và trì hoãn. Lỗi vận chuyển mô tả cơ sở hạ tầng MTA hoặc cạn kiệt đường dẫn egress; chúng không phân loại địa chỉ người nhận hợp lệ là bị trả lại.

Các công cụ phân tích loại trừ các lần mở/nhấp của bot, trình quét, xem trước liên kết và tài sản được theo dõi được phát hiện theo mặc định. Truyền includeMachineEngagement: true đến get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber hoặc get_subscriber_activity khi bạn cần chẩn đoán tương tác thô; các hàng hoạt động mở/nhấp được bao gồm hiển thị các trường machine, engagementQuality và classificationReasons khi API trả về hoạt động cấp sự kiện.

get_sequence_stats.enrollmentCounts là ảnh chụp nhanh trực tiếp theo thời điểm của các lần chạy đăng ký đang hoạt động và chờ được nhóm theo nút hiện tại. Nó đếm token đăng ký thay vì nhất thiết là người đăng ký riêng biệt và không bị giới hạn bởi các bộ lọc lịch sử period, start hoặc end.

Sử dụng list_email_metrics để so sánh giữa các chiến dịch hoặc bước chuỗi. Truyền step với các giá trị sequenceId tùy chọn để tổng cùng một bước trên các chuỗi; sử dụng automationNodeId được trả về với list_sequence_events hoặc list_email_sends để kiểm tra người nhận. campaignId không thể kết hợp với sequenceId hoặc step. Phạm vi chiến dịch và chuỗi tường minh giữ lại các email đã cấu hình không có hoạt động để các bên yếu kém không bị bỏ qua một cách âm thầm.

Truyền emailType: "transactional" đến get_stats để lấy tỷ lệ gửi, mở, nhấp và trả lời của API Gửi và SMTP giao dịch. Điều này bao gồm gửi trực tiếp và gửi mẫu đã lưu. Sử dụng emailSendId được trả về bởi send_email với get_email_send khi bạn cần trạng thái và dòng thời gian sự kiện của một lần gửi. Sử dụng get_transactional_stats khi bạn cần tỷ lệ tổng hợp cho một email giao dịch đã lưu. Phản hồi của nó bao gồm các liên kết được nhấp hàng đầu, khiếu nại, trả lời, phân loại trả lại vĩnh viễn/tạm thời mới nhất và số lần mở/nhấp riêng biệt của con người và máy. Gửi nội dung trực tiếp không có ID mẫu ổn định và vẫn khả dụng qua thống kê giao dịch tài khoản cộng với tìm kiếm gửi.

Khi một chiến dịch thu thập câu trả lời Poll hoặc NPS, get_campaign_stats bao gồm một mảng polls cấp cao nhất. Mỗi người đăng ký được tính một lần cho mỗi khối poll bằng câu trả lời mới nhất của họ. Tóm tắt NPS bao gồm điểm số, trung bình và số lượng người ủng hộ/thụ động/gièm pha. Đây là các tóm tắt phản hồi trọn đời ngay cả khi số liệu tương tác sử dụng bộ lọc thời gian.

Sử dụng list_poll_responses để đọc ai đã trả lời gì và khi nào. Nó trả về câu trả lời mới nhất của mỗi người đăng ký cho mỗi khối poll, mới nhất trước, bao gồm email, giá trị đã lưu, khóa thuộc tính và thời gian phản hồi. Truyền blockId để giới hạn một poll; đối với bước email chuỗi, hãy truyền ID nút tự động hóa của nó làm campaignId. Không tái tạo lịch sử này bằng cách quét các thuộc tính người đăng ký: một thuộc tính không có dấu thời gian phản hồi và có thể đã bị ghi đè bởi một email sau đó sử dụng lại cùng khóa.

Để liệt kê chính xác những người trả lời lịch sử đằng sau một số đếm, hãy gọi create_segment với trường pollResponse, toán tử is và giá trị JSON được giới hạn trong chiến dịch và blockId của tóm tắt:

{
  "v": 1,
  "campaignId": "camp_123",
  "blockId": "poll_1",
  "match": { "kind": "answer", "value": "loved" }
}

Đối với NPS, hãy sử dụng một khớp như {"kind":"npsBucket","bucket":"detractors"}; các nhóm hợp lệ là promoters, passives và detractors. attributeKey của tóm tắt lưu trữ phản hồi hiện tại/mới nhất của người đăng ký và có thể bị ghi đè bởi một poll sau đó sử dụng lại khóa, vì vậy nó không phải là một khoan xuống lịch sử chính xác.

Nhóm, Hộp thư đến, Webhook

Công cụ	Mô tả
list_team_members	Liệt kê thành viên nhóm và lời mời đang chờ xử lý.
invite_team_member	Mời một thành viên nhóm làm quản trị viên hoặc người xem, với quyền truy cập thanh toán tùy chọn.
cancel_team_invitation	Hủy lời mời nhóm đang chờ xử lý.
list_conversations	Liệt kê các cuộc hội thoại trả lời của người đăng ký với bộ lọc trạng thái và chưa đọc.
get_conversation	Đọc một cuộc hội thoại và lịch sử tin nhắn của nó.
reply_to_conversation	Xếp hàng một trả lời gửi đi hoặc thêm ghi chú nội bộ.
update_conversation_status	Mở hoặc đóng một cuộc hội thoại.
mark_conversation_read	Đánh dấu tất cả tin nhắn trong một cuộc hội thoại là đã đọc.
list_webhooks	Liệt kê các điểm cuối webhook gửi đi.
create_webhook	Tạo một điểm cuối và trả về bí mật ký một lần của nó trên MCP tiêu chuẩn; bị bỏ qua trên tuyến được OpenAI xem xét.
update_webhook	Cập nhật tên webhook, URL, sự kiện hoặc trạng thái.
delete_webhook	Xóa vĩnh viễn một điểm cuối webhook và lịch sử gửi.
test_webhook	Gửi một sự kiện kiểm tra đến một điểm cuối webhook.
list_webhook_deliveries	Liệt kê các lần thử gửi gần đây cho một webhook.
replay_webhook_delivery	Phát lại một lần gửi webhook.

Các thay đổi đồng ý theo danh sách có sẵn dưới dạng sự kiện gửi đi chọn tham gia: subscriber.list_subscribed và subscriber.list_unsubscribed. Tải trọng của chúng xác định người đăng ký và danh sách, báo cáo action là added hoặc removed và bao gồm source thay đổi (ví dụ preferences_page, dashboard, api hoặc automation).

Sử dụng sự kiện email.failed cho các lỗi gửi cuối cùng như đường dẫn vận chuyển MTA cạn kiệt. Trả lại người nhận tiếp tục sử dụng email.bounced.

Sử dụng sự kiện campaign.sent chỉ rõ ràng khi một workflow cần một thông báo cuối cùng sau khi một chiến dịch email hoặc SMS kết thúc, bao gồm cả gửi không người nhận hợp lệ. Nó không được thêm khi create_webhook bỏ qua events trên MCP tiêu chuẩn; trên tuyến được OpenAI xem xét, hãy thêm nó trong bảng điều khiển khi tạo hoặc chỉnh sửa webhook.

Tạo AI

Công cụ	Mô tả
generate_email	Tạo các khối email có thương hiệu từ một lời nhắc.
generate_sequence	Bí danh không dùng nữa duy trì một bản nháp chuỗi dựa trên mục tiêu.
generate_subject_lines	Tạo các biến thể dòng chủ đề A/B.

Nội dung email được tạo bao gồm logo và chân trang của công ty theo mặc định. generate_email chấp nhận applyBranding: false cho các khối nội dung thô và emailType: "transactional" cho một chân trang không có liên kết hủy đăng ký. Các chiến dịch dựa trên lời nhắc kế thừa phông chữ email đã cấu hình của công ty. Nội dung được tạo được trả về dưới dạng nội dung nháp để xem xét. Sử dụng create_sequence để tạo và duy trì một bản nháp chuỗi bị tắt xuất hiện trong list_sequences; bí danh generate_sequence không dùng nữa cũng làm tương tự.

SMS

Công cụ	Mô tả
generate_sms	Tạo nội dung SMS từ một lời nhắc.
get_sms_settings	Đọc trạng thái sẵn sàng của SMS bổ trợ, tín dụng, mặc định và các số đã cấp phát.
get_sms_usage	So sánh số lần gửi, kết quả giao hàng, tín dụng đã tính phí, hoạt động gần nhất và gửi thử theo số.
update_sms_number_label	Cập nhật nhãn của một số hoặc ghi đè tiền tố thương hiệu theo từng số.
release_sms_number	Trả vĩnh viễn một số cho nhà mạng và giải phóng vị trí không gian làm việc của nó.
send_test_sms	Gửi tin nhắn thử, tùy chọn chọn người gửi đã cấp phát với fromNumberId.

release_sms_number là không thể hoàn tác. Các bước chiến dịch hoặc chuỗi được gắn với một số đã phát hành sẽ bỏ qua việc gửi SMS của chúng cho đến khi chúng được trỏ lại đến một số đang hoạt động. get_sms_usage báo cáo tổng sản xuất riêng biệt với testSends. Khi send_test_sms bỏ qua fromNumberId, nó sử dụng cùng mặc định số hoạt động lâu nhất như các lần gửi sản xuất. Gửi thử là tin nhắn thực, tính phí tín dụng, bỏ qua giờ yên tĩnh và bị giới hạn 100 mỗi công ty trong cửa sổ 24 giờ trượt.

Phản hồi sản phẩm

Chỉ sử dụng submit_feedback khi người dùng yêu cầu rõ ràng trợ lý gửi phản hồi cho nhóm Sequenzy. MCP tiêu chuẩn có thể bao gồm các trường tái tạo có cấu trúc userIntent, toolCalls, expected, actual và resourceIds khi cần cho báo cáo đó. Tuyến được xem xét bởi OpenAI chỉ chấp nhận tin nhắn, danh mục và ngữ cảnh quy trình làm việc tổng quát tùy chọn. Không bao gồm dữ liệu người đăng ký không liên quan, nội dung email, tải trọng API thô, dữ liệu gỡ lỗi, hoặc bí mật.

Tài nguyên

Máy chủ cũng hiển thị các tài nguyên MCP chỉ đọc.

Tài nguyên	Mô tả
sequenzy://dashboard	Số liệu tổng quan trực tiếp trong 7 ngày qua.
sequenzy://company	Cài đặt công ty và bản địa hóa hiện tại.
sequenzy://campaigns/recent	10 chiến dịch gần nhất với trạng thái và số liệu cơ bản.
sequenzy://subscribers/recent	Người đăng ký được thêm gần đây nhất.
sequenzy://subscribers/engaged	Người đăng ký hoạt động hoặc tương tác nhiều nhất.
sequenzy://sequences	Tất cả chuỗi với trạng thái.
sequenzy://templates	Mẫu với trạng thái bản địa hóa.
sequenzy://segments	Phân đoạn đã lưu với số lượng người đăng ký.
sequenzy://tags	Thẻ với số lần sử dụng.
sequenzy://health	Số liệu khả năng giao hàng và trạng thái sức khỏe.
sequenzy://email-blocks	Tham chiếu trường cho mọi loại khối email.
sequenzy://app-routes	Mẫu tuyến bảng điều khiển và tab cài đặt.

Ví dụ lời nhắc

Add john@example.com with tags "vip" and "developer", then put them on the beta list.

Create a 4-email churn prevention sequence for users whose subscription expires soon. Leave it in draft mode.

Create a segment for subscribers who bought Stripe product prod_pro at least 3 times.

Draft a campaign about our new analytics dashboard, target the Pro users segment, and send a test to me.

How did the last campaign perform compared with the one before it?

Bảo mật

• Sử dụng khóa API cá nhân, không dùng bí mật nhóm dùng chung.
• Khóa chỉ truy cập các công ty mà người dùng Sequenzy của bạn có thể truy cập.
• Thu hồi khóa từ Cài đặt -> Khóa API khi không còn cần truy cập.
• Giữ bật lời nhắc phê duyệt của khách hàng cho gửi, lập lịch, xóa và thay đổi hàng loạt.
• Ưu tiên quy trình làm việc nháp cho chiến dịch và chuỗi, sau đó xem xét trong Sequenzy trước khi khởi chạy.

Khắc phục sự cố

SEQUENZY_API_KEY environment variable is required

Đặt SEQUENZY_API_KEY trong cấu hình máy khách MCP, hoặc chạy:

npx @sequenzy/setup

Khóa API không hợp lệ

Tạo khóa cá nhân mới trong Cài đặt -> Khóa API, cập nhật cấu hình MCP của bạn và khởi động lại máy khách.

Thiếu phạm vi khóa API

Gọi get_account và kiểm tra apiKeyPermissions. Kết nối cục bộ nên mở apiKeyPermissions.manageUrl, thêm phạm vi còn thiếu vào khóa đã tải và thử lại mà không cần khởi động lại. update_api_key chỉ có thể thực hiện việc này cho các khóa công ty đã có api_keys:manage; chỉnh sửa khóa cá nhân trên trang Khóa API cấp tài khoản. Kết nối OAuth được lưu trữ có thể thay thế ngắt kết nối và ủy quyền lại với quyền rộng hơn. Lỗi công cụ bao gồm phạm vi hoặc các phạm vi chính xác được yêu cầu.

Tài nguyên trùng lặp

Nếu một lệnh gọi công cụ sẽ tạo tên phân đoạn hoặc miền gửi trùng lặp, máy chủ trả về code ổn định, description thân thiện với tác nhân, resolution cụ thể và docsUrl. Đối với phân đoạn, hãy gọi list_segments và sử dụng lại ID phân đoạn hiện có hoặc chọn tên khác. Đối với trang web, hãy gọi list_websites; nếu miền không được liệt kê cho công ty đã chọn, nó thuộc về công ty hoặc tài khoản khác và phải được xóa, gán lại hoặc thay thế bằng miền gửi khác.

Công cụ không xuất hiện

• Xác nhận npx có sẵn trong môi trường máy khách sử dụng.
• Khởi động lại máy khách MCP sau khi chỉnh sửa cấu hình.
• Kiểm tra cấu hình ở vị trí đúng cụ thể cho máy khách.

Sự cố mạng hoặc URL API

Máy chủ sử dụng https://api.sequenzy.com theo mặc định. Nếu bạn ghi đè, hãy xác minh SEQUENZY_API_URL trỏ đến URL cơ sở API Sequenzy có thể truy cập.

Phát triển

bun install
bun test
bun run type-check
bun run build

Lược đồ công cụ MCP phải duy trì tương thích với máy khách nghiêm ngặt:

• Gốc inputSchema của công cụ phải là lược đồ type: "object" đơn giản.
• Không xuất bản anyOf ở bất kỳ đâu trong lược đồ công cụ.
• Không đặt oneOf, allOf, enum hoặc not ở gốc lược đồ công cụ.
• Thực thi các yêu cầu có điều kiện trong trình xử lý và bao phủ chúng bằng bài kiểm tra.

Kho lưu trữ độc lập này phản chiếu gói MCP được duy trì trong monorepo Sequenzy chính. Xem AGENTS.md để biết quy tắc đồng bộ.

Giấy phép

MIT

Khám phá gốc tác nhân

Sequenzy xuất bản các tệp kê khai có thể đọc bằng máy cho mạng tác nhân và khám phá kiểu A2A:

• Điểm cuối MCP từ xa: https://api.sequenzy.com/v1/mcp
• Tệp kê khai khả năng tác nhân: agent-capability.json
• Thẻ tác nhân kiểu A2A: .well-known/agent-card.json
• Siêu dữ liệu kỹ năng OpenClaw/Moltbot: openclaw/skill.json
• Hướng dẫn vận hành OpenClaw/Moltbot: openclaw/SKILL.md

Các tệp này mô tả Sequenzy như một khả năng tự động hóa email được ủy quyền cho tác nhân. Chúng loại trừ rõ ràng các trường hợp sử dụng quét, thư rác và tiếp cận nguội không được yêu cầu.

Vai trò không gian làm việc

Truy cập khóa tài khoản kết hợp phạm vi khóa với vai trò không gian làm việc hiện tại của bạn. get_account báo cáo các phạm vi bị chặn trong apiKeyPermissions.roleRestrictedScopes; canSendLive có nghĩa là ít nhất một quy trình giao hàng được phép có sẵn, không phải mọi công cụ gửi đều được phép.

Bạn có thể mời marketer để quản lý người đăng ký, chiến dịch tiếp thị và chuỗi mà không cấp quyền truy cập vào thư giao dịch, cài đặt không gian làm việc, nhóm hoặc thanh toán. Nhà tiếp thị chọn hồ sơ người gửi/trả lời hiện có. Các nguồn chiến dịch, A/B và chuỗi hỗ trợ giao dịch vẫn được bảo vệ thông qua bản xem trước, chia sẻ, phân tích và lịch sử gửi. Nhà tiếp thị và thành viên bị hạn chế không thể nhận quyền truy cập thanh toán.