Sequenzy MCP

आधिकारिक

SaaS के लिए ईमेल मार्केटिंग उपकरण

Sequenzy MCP के साथ आप क्या कर सकते हैं?

  • सब्सक्राइबर और सेगमेंट प्रबंधित करें — अपने असिस्टेंट से लिस्ट बनाने, टैग लागू करने, बल्क टैग समेटने, या create_list जैसे टूल्स के माध्यम से सिंथेटिक इवेंट परीक्षण करने के लिए कहें।
  • कैंपेन बनाएं और भेजें — create_campaign और send_campaign जैसे टूल्स का उपयोग करके ईमेल कैंपेन का मसौदा तैयार करें, शेड्यूल करें, पूर्वावलोकन करें, या भेजें, जिसमें समाधान किए गए ऑडियंस पूर्वावलोकन और रूपांतरण लक्ष्य शामिल हों।
  • लैंडिंग पेज और फॉर्म बनाएं — create_landing_page के माध्यम से लिस्ट-स्कोप्ड साइनअप फॉर्म और लैंडिंग पेज को रिस्पॉन्सिव ब्लॉक लेआउट के साथ डिज़ाइन करें, फिर उन्हें प्रकाशित करें या स्टैटिक-साइट एम्बेड प्राप्त करें।
  • ऑडियंस को Meta पर सिंक करें — Facebook और Instagram रीटार्गेटिंग के लिए डायनामिक सेगमेंट को Meta कस्टम ऑडियंस पर पुश करें।
  • सीक्वेंस और ऑटोमेशन प्रबंधित करें — create_sequence और जैसे टूल्स का उपयोग करके एंट्री ट्रिगर, स्टॉप शर्तों, और समीक्षकों को परीक्षण भेजने के साथ मल्टी-स्टेप ईमेल सीक्वेंस बनाएं।
  • डिलिवरेबिलिटी और भेजने की निगरानी करें — get_sending_status और resume_sending के साथ रुके हुए भेजने का निदान करें, बाउंस/शिकायत सप्रेशन का निरीक्षण करें, और पात्र हार्ड-बाउंस पॉज़ को पुनर्स्थापित करें।

दस्तावेज़

Sequenzy MCP सर्वर

Sequenzy के लिए आधिकारिक MCP सर्वर, जो AI-संचालित ईमेल मार्केटिंग प्लेटफ़ॉर्म है।

Sequenzy को Claude Desktop, Claude Code, Codex, Cursor, Windsurf, VS Code Copilot, OpenClaw और अन्य MCP क्लाइंट्स से कनेक्ट करें ताकि आपका AI सहायक हाथ से लिखे API कॉल के बजाय संरचित टूल्स के साथ ईमेल संचालन प्रबंधित कर सके।

आप क्या कर सकते हैं

  • सब्सक्राइबर, टैग, सूचियाँ और डायनामिक सेगमेंट प्रबंधित करें, जिसमें बल्क टैग समाधान और सिंथेटिक इवेंट परीक्षण शामिल हैं।
  • Facebook और Instagram रीटार्गेटिंग के लिए सेगमेंट को Meta कस्टम ऑडियंस में सिंक करें।
  • उत्पाद प्रबंधित करें और खरीद स्वचालन के लिए डिजिटल डिलीवरी फ़ाइलें संलग्न करें।
  • ऑल्ट टेक्स्ट और पुन: प्रयोज्य रिस्पॉन्सिव क्रॉप सेटिंग्स के साथ होस्टेड ईमेल छवियाँ अपलोड करें।
  • कैंपेन ड्राफ्ट करें, अपडेट करें, शेड्यूल करें और निरीक्षण करें, जिसमें हल किए गए ऑडियंस पूर्वावलोकन, स्थायी रूपांतरण लक्ष्य और From, Reply-To, CC और BCC पहचान शामिल हैं।
  • कैंपेन, अनुक्रम चरणों और टेम्पलेट्स को बिना भेजे उनके सटीक ईमेल-सुरक्षित HTML में रेंडर करें।
  • ईमेल में एक-क्लिक Poll और NPS सर्वेक्षण ब्लॉक जोड़ें और कैंपेन प्रतिक्रिया सारांश निरीक्षण करें।
  • ईमेल अनुक्रम बनाएं और संपादित करें, जिसमें मल्टी-लिस्ट/टैग ट्रिगर, प्रवेश-ऑडियंस और प्रॉपर्टी-फ़िल्टर स्टॉप शर्तें, भेजने की पहचान ओवरराइड, मौजूदा ग्राफ़ पुनर्गठन और आंतरिक समीक्षकों को सीधे चरण परीक्षण भेजना शामिल है।
  • कैंपेन रद्द करें, रोकें, फिर से शुरू करें, डुप्लिकेट करें या हटाएं और संपर्कों को अनुक्रमों में नामांकित करें।
  • ट्रांज़ैक्शनल ईमेल टेम्पलेट प्रबंधित करें और साझा To, Cc और Bcc प्राप्तकर्ता सूचियों को ट्रांज़ैक्शनल ईमेल भेजें।
  • सक्षम लोकेल्स के लिए स्थानीयकृत टेम्पलेट वेरिएंट प्रदान करें या AI अनुवाद कतारबद्ध करें।
  • लैंडिंग पेज बनाएं, पूर्वावलोकन करें, संपादित करें, प्रकाशित करें, अप्रकाशित करें और हटाएं।
  • रिस्पॉन्सिव स्टैक, रो, ग्रिड और सिंगल-इमेज ओवरले ब्लॉक समूहों (फोरग्राउंड गैप नियंत्रण सहित) के साथ लिस्ट-स्कोप्ड सेव्ड साइनअप फ़ॉर्म बनाएं, फिर क्लाइंट-सुरक्षित स्टैटिक-साइट एम्बेड लौटाएं।
  • समान पुनरावर्ती ब्लॉक लेआउट के साथ सेव्ड साइनअप पॉपअप बनाएं, लक्षित करें, प्रकाशित करें, डुप्लिकेट करें और तैनात करें।
  • प्रकाशित लैंडिंग पेजों के लिए कस्टम डोमेन कनेक्ट और सत्यापित करें।
  • टीम आमंत्रण, इनबॉक्स वार्तालाप और आउटबाउंड वेबहुक एंडपॉइंट प्रबंधित करें।
  • ईमेल कॉपी, विषय पंक्तियाँ और मल्टी-स्टेप अनुक्रम उत्पन्न करें।
  • एनालिटिक्स, सब्सक्राइबर गतिविधि, डिलीवरेबिलिटी स्वास्थ्य, कंपनी-स्तरीय भेजने की रोक, एकीकरण, प्रकाशित इवेंट पेलोड स्कीमा, भेजने की पहचान, ट्रैकिंग सेटिंग्स और डैशबोर्ड URL निरीक्षण करें।
  • निरीक्षण करें कि क्या किसी वर्कस्पेस के लिए "Sent with Sequenzy" दृश्यमान है, मालिक सदस्यता इसे क्यों हटाती है या नहीं हटाती है, और अपग्रेड या नवीनीकरण के लिए कैननिकल सदस्यता पृष्ठ खोलें। एंटाइटलमेंट परिवर्तन मौजूदा लाइव अनुक्रमों से भविष्य के भेजने पर लागू होते हैं, बिना उनके ब्लॉक संपादित किए।
  • निदान करें कि भेजना क्यों रोका गया है और सूची सफाई की पुष्टि के बाद पात्र हार्ड-बाउंस रोक को पुनर्स्थापित करें।
  • सटीक-प्राप्तकर्ता बाउंस, शिकायत और ईमेल-स्वच्छता दमन निरीक्षण करें, और साझा SES दमन सूची को उजागर किए बिना पात्र पुराने बाउंस साफ़ करें।
  • कंपनी उत्पाद जानकारी, खाता-व्यापी भेजने की पहचान डिफ़ॉल्ट कॉन्फ़िगर करें, व्यक्तिगत प्रेषक और उत्तर-से प्रोफ़ाइल का नाम बदलें, प्रेषक डोमेन प्रबंधित करें और सामान्य फ्रेमवर्क के लिए एकीकरण उदाहरण निरीक्षण करें।

हर प्रकाशित MCP टूल में स्पष्ट readOnlyHint, destructiveHint और openWorldHint एनोटेशन शामिल हैं ताकि संगत क्लाइंट सटीक टूल-उपयोग सुविधाएँ प्रदर्शित कर सकें। टूल outputSchema परिभाषाएँ भी प्रकाशित करते हैं और structuredContent लौटाते हैं, जिससे क्लाइंट और मॉडल को अनुवर्ती कॉल के लिए मशीन-पठनीय परिणाम आकार मिलते हैं।

त्वरित सेटअप

सबसे आसान सेटअप मार्ग Sequenzy विज़ार्ड है:

npx @sequenzy/setup

विज़ार्ड ब्राउज़र लॉगिन प्रवाह खोलता है, व्यक्तिगत API कुंजी बनाता है, समर्थित AI क्लाइंट्स का पता लगाता है और संभव होने पर उन्हें स्वचालित रूप से कॉन्फ़िगर करता है।

होस्टेड रिमोट MCP

Streamable HTTP MCP का समर्थन करने वाले क्लाइंट्स के लिए, स्थानीय stdio प्रक्रिया चलाने के बजाय Sequenzy के होस्टेड एंडपॉइंट का उपयोग करें:

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

ChatGPT और OpenAI प्लगइन निर्देशिका समीक्षित होस्टेड सतह का उपयोग करते हैं:

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

वह सतह समान कार्यान्वयन साझा करती है और छह ऑपरेशनों को छोड़कर मानक टूल सेट रखती है: connect_integration, create_api_key, create_webhook, list_webhook_deliveries, replay_webhook_delivery और rotate_sequence_inbound_webhook_secret। सामान्यीकृत, स्पष्ट रूप से अनुरोधित उत्पाद फीडबैक के लिए कम स्कीमा के साथ फीडबैक उपलब्ध रहता है।

रिमोट क्लाइंट्स को समर्थित होने पर Sequenzy OAuth प्रवाह के साथ प्रमाणित करना चाहिए। स्थानीय और स्वचालन क्लाइंट अभी भी SEQUENZY_API_KEY के साथ नीचे दिए गए stdio पैकेज का उपयोग कर सकते हैं।

होस्टेड एंडपॉइंट और stdio पैकेज MCP विनिर्देश 2026-07-28 का समर्थन करते हैं, जबकि 2025-युग के क्लाइंट्स के साथ संगत रहते हैं। आधुनिक HTTP क्लाइंट प्रति-अनुरोध खोज और विधि हेडर का उपयोग करते हैं; मौजूदा क्लाइंट समान एंडपॉइंट और पैकेज कमांड के माध्यम से काम करते रहते हैं।

मशीन-पठनीय खोज फ़ाइलें:

डेटा और गोपनीयता

Sequenzy MCP क्लाइंट को केवल वह डेटा भेजता है जो उपयोगकर्ता द्वारा चलाने के लिए कहे गए टूल के लिए आवश्यक होता है, चयनित वर्कस्पेस और उस क्लाइंट को दी गई कुंजी या OAuth स्कोप के भीतर। अनुरोधित टूल के आधार पर, इसमें वर्कस्पेस नाम और ID शामिल हो सकते हैं; सब्सक्राइबर संपर्क, सहमति, ऑडियंस, विशेषता, इवेंट, सहभागिता, उत्तर, सर्वेक्षण और वाणिज्य डेटा; कैंपेन और स्वचालन सामग्री; डिलीवरी एनालिटिक्स; और एकीकरण या वेबहुक स्थिति। पूर्ण श्रेणियों, उद्देश्यों, प्राप्तकर्ताओं, प्रतिधारण अवधियों और उपयोगकर्ता नियंत्रणों के लिए Sequenzy गोपनीयता नीति देखें।

भुगतान-कार्ड डेटा, स्वास्थ्य या चिकित्सा डेटा, सरकारी पहचानकर्ता, बायोमेट्रिक या आनुवंशिक डेटा, प्रमाणीकरण क्रेडेंशियल, संवेदनशील जनसांख्यिकीय डेटा या सटीक जियोलोकेशन सबमिट करने के लिए खुले-अंत वाले कस्टम विशेषताओं, इवेंट्स, नोट्स, फ़ॉर्म, वेबहुक नमूनों, ईमेल चर या फीडबैक का उपयोग न करें।

OpenAI-समीक्षित मार्ग प्रासंगिक खुले-अंत इनपुट पर उन प्रतिबंधों को बताता और लागू करता है, जिसमें profile.ssn जैसे नेस्टेड विशेषता पथ, lat/lng जैसे समन्वय जोड़े, और Religion: ... या GPS coordinates: ... जैसी लेबलित गद्य शामिल हैं। यह किसी भी तर्क में क्रेडेंशियल-युक्त URL को अस्वीकार करता है, चाहे क्रेडेंशियल userinfo, पथ, क्वेरी या फ्रैगमेंट में हो, जैसे कि एक्सेस टोकन या URL हस्ताक्षर के साथ फ़ॉर्म या पॉपअप redirectUrl। मर्ज टैग के अंदर प्रतिबंधित विशेषता चयनकर्ता उसी विषय के बारे में सामान्य लिखित कॉपी को अवरुद्ध किए बिना अस्वीकार कर दिए जाते हैं। इस सतह पर, render_email नमूना डेटा या नीति-जांचा इनलाइन subscriber स्वीकार करता है, लेकिन subscriberId नहीं, इसलिए यह अनिरीक्षित संग्रहीत कस्टम विशेषताओं को हल नहीं कर सकता। इसके परिणाम प्रतिबंधित फ़ील्ड, कच्चे API त्रुटियाँ, डीबग पेलोड, आंतरिक अनुरोध/ट्रेस/सत्र पहचानकर्ता, अनावश्यक खाता या क्रेडेंशियल पहचानकर्ता, संग्रहीत क्रेडेंशियल-युक्त URL और इनबाउंड-वेबहुक URL हटाते हैं। मानक रिमोट MCP और स्थानीय stdio पैकेज विश्वसनीय क्लाइंट्स के लिए पूर्ण अनुबंध बनाए रखते हैं, जिसमें क्रेडेंशियल-आधारित एकीकरण सेटअप, एक-बार API-कुंजी और वेबहुक रहस्य, इनबाउंड-वेबहुक URL और विस्तृत API त्रुटियाँ शामिल हैं। जब रहस्य AI वार्तालाप के बाहर रहने चाहिए तो डैशबोर्ड या स्थानीय CLI पसंद करें। submit_feedback केवल तब चलता है जब उपयोगकर्ता स्पष्ट रूप से पूछता है; इसकी OpenAI स्कीमा सामान्यीकृत संदेश, श्रेणी और वैकल्पिक वर्कफ़्लो संदर्भ तक सीमित है, और मार्ग ईमेल पता या संसाधन ID वाले फीडबैक टेक्स्ट को अस्वीकार करता है।

समीक्षित सतह जो गारंटी देती है वह सीमित है। यह आकार द्वारा प्रतिबंधित डेटा को पहचानता है: किसी भी नेस्टिंग गहराई पर passport_id, user.ssn या api_secret जैसे अंग्रेजी फ़ील्ड-नाम शब्द, Diagnosis: ... जैसी लेबलित गद्य, ज्ञात क्रेडेंशियल आकार, दशमलव समन्वय जोड़े, और किसी भी स्ट्रिंग के अंदर क्रेडेंशियल-युक्त URL, HTML सहित। यह अलेबलित गद्य, गैर-अंग्रेजी फ़ील्ड नाम या मानों की व्याख्या नहीं करता जिन्हें क्लाइंट जानबूझकर अस्पष्ट करता है; वे फ़िल्टर के बजाय उपरोक्त उपयोग प्रतिबंध द्वारा कवर रहते हैं।

मैनुअल सेटअप

सभी stdio MCP क्लाइंट समान कमांड का उपयोग करते हैं:

  • कमांड: npx
  • तर्क: -y @sequenzy/mcp
  • आवश्यक env: SEQUENZY_API_KEY=seq_user_your_key_here

वैकल्पिक पर्यावरण चर:

  • SEQUENZY_API_URL - Sequenzy API आधार URL। डिफ़ॉल्ट https://api.sequenzy.com है।
  • SEQUENZY_APP_URL - ऐप URL सहायकों द्वारा उपयोग किया जाने वाला Sequenzy डैशबोर्ड आधार URL। डिफ़ॉल्ट https://sequenzy.com है।

Claude Desktop

इसे अपने Claude Desktop कॉन्फ़िग में जोड़ें:

  • 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"
      }
    }
  }
}

कॉन्फ़िग संपादित करने के बाद Claude Desktop पुनः आरंभ करें।

Claude Code

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

नेटिव Windows पर, npx को cmd /c के साथ लपेटें:

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

साझा प्रोजेक्ट कॉन्फ़िग के लिए, .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

~/.codex/config.toml में मैनुअल Codex कॉन्फ़िग:

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

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

Cursor

Sequenzy OAuth के साथ होस्टेड कनेक्शन के लिए Cursor Marketplace से Sequenzy इंस्टॉल करें। प्लगइन कनेक्ट होता है:

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

इंस्टॉल करने के बाद, ब्राउज़र साइन-इन प्रवाह पूरा करें। Cursor का एजेंट तब चैट से Sequenzy टूल्स का उपयोग कर सकता है, जिसमें Grok चयनित मॉडल होने पर भी शामिल है।

मैनुअल स्थानीय stdio सेटअप के लिए, इसे ~/.cursor/mcp.json में जोड़ें:

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

Windsurf

Cursor के समान JSON आकार का उपयोग करें।

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

VS Code Copilot

VS Code एक servers ऑब्जेक्ट का उपयोग करता है:

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

अन्य MCP क्लाइंट

OpenClaw, Hermes और अन्य MCP-संगत क्लाइंट्स के लिए, क्लाइंट को npx -y @sequenzy/mcp पर इंगित करें और SEQUENZY_API_KEY सेट करें।

API कुंजी प्राप्त करना

  1. Sequenzy डैशबोर्ड खोलें।
  2. व्यक्तिगत कुंजी बनाने के लिए MCP सेटअप प्रवाह का उपयोग करें, या कंपनी कुंजी बनाने के लिए सेटिंग्स -> API कुंजियाँ खोलें।
  3. अनुमति प्रीसेट या एकीकरण के लिए आवश्यक सटीक कस्टम स्कोप चुनें।
  4. कुंजी को अपने MCP क्लाइंट कॉन्फ़िग में जोड़ें।

व्यक्तिगत कुंजियाँ seq_user_ से शुरू होती हैं। आप उन्हें किसी भी समय डैशबोर्ड में रद्द कर सकते हैं।

कंपनी कुंजियों को भी रहस्य उजागर किए बिना साफ़ किया जा सकता है। कुंजी ID, नाम, गैर-गोपनीय उपसर्ग, अनुमतियाँ, अंतिम-उपयोग टाइमस्टैम्प और isCurrent मार्कर की तुलना करने के लिए list_api_keys को कॉल करें, फिर सटीक ID को revoke_api_key को पास करें। delete_api_key उसी स्थायी ऑपरेशन के लिए संगतता उपनाम है। सूची और रद्दीकरण प्रतिक्रियाओं में कभी भी सादा कुंजी या संग्रहीत कुंजी हैश नहीं होता है।

लापता API कुंजी अनुमतियों से पुनर्प्राप्ति

यदि कोई टूल campaigns:read या templates:write जैसा लापता स्कोप रिपोर्ट करता है, तो get_account को कॉल करें। इसका apiKeyPermissions फ़ील्ड वर्तमान कुंजी पहचान और प्रकार, स्कोप, सामान्य लापता मार्केटिंग पढ़ने के स्कोप और सीधा manageUrl सूचीबद्ध करता है। OpenAI-समीक्षित मार्ग उपयोगकर्ता के खाता ID या सक्रिय कुंजी की पहचान के बिना समान अनुमतियाँ लौटाता है। व्यक्तिगत कुंजियाँ खाता API कुंजियाँ खोलती हैं; कंपनी कुंजियाँ चयनित वर्कस्पेस की API कुंजी सेटिंग्स खोलती हैं। यदि कुंजी में account:read शामिल नहीं है, तो Sequenzy डैशबोर्ड सीधे खोलें और मिलान API कुंजी पृष्ठ चुनें।

अनुमतियाँ स्थान पर संपादन योग्य हैं, इसलिए manageUrl खोलें। कंपनी कुंजी के लिए, इसे संपादित करने से पहले सक्रिय कुंजी की पहचान करने के लिए list_api_keys और इसके isCurrent फ्लैग का उपयोग करें, फिर क्रेडेंशियल बदले या क्लाइंट पुनः आरंभ किए बिना विफल टूल को फिर से प्रयास करें। api_keys:manage के साथ कंपनी कुंजी का उपयोग करने वाला एजेंट इसके बजाय update_api_key को कॉल कर सकता है; व्यक्तिगत कुंजियों को खाता-स्तरीय पृष्ठ पर संपादित किया जाना चाहिए क्योंकि वह टूल केवल कंपनी कुंजियों का प्रबंधन करता है। इसके scopes और preset इनपुट विलय के बजाय पूरी अनुमति चयन को प्रतिस्थापित करते हैं, इसलिए हर मौजूदा स्कोप को संरक्षित करें जो अभी भी आवश्यक है। होस्टेड OAuth कनेक्शन वैकल्पिक रूप से व्यापक अनुमतियों के साथ डिस्कनेक्ट और पुनः अधिकृत कर सकते हैं। जब सक्रिय कुंजी में स्वयं api_keys:manage का अभाव हो, तो request_api_key_handoff को कॉल करें, बजाय update_api_key को पुनः प्रयास करने के। इसके लिए account:read आवश्यक है और यह अनुरोधित कुंजी नाम, अनुमतियों, और वैकल्पिक पूर्ववर्ती के साथ पहले से भरा हुआ एक स्वामी-समीक्षा URL लौटाता है। यह कभी भी कुंजी नहीं बनाता या लौटाता नहीं है; कार्यक्षेत्र स्वामी फ़ॉर्म की समीक्षा करता है, ब्राउज़र में प्रतिस्थापन बनाता है, और इसे क्लाइंट में कॉपी करता है। replaceApiKeyId: "current" पास करें ताकि प्रतिस्थापन बनाए जाने के बाद सक्रिय कुंजी के निरस्तीकरण की पेशकश की जा सके। यदि सक्रिय कुंजी में भी account:read का अभाव है, तो सीधे डैशबोर्ड का उपयोग करें।

डिफ़ॉल्ट सुरक्षित एजेंट पहुंच प्रीसेट में lists:write और tags:write शामिल हैं, इसलिए एजेंट सूची और टैग परिभाषाएँ बना और अपडेट कर सकते हैं, और इसमें मौजूदा संपर्कों पर टैग लागू करने के लिए subscribers:tag शामिल है। इसमें ab_tests:read, ab_tests:write, और sequences:write भी शामिल हैं, इसलिए एजेंट अनुक्रम A/B वैरिएंट कॉपी का ऑडिट और संपादन कर सकते हैं, जिसमें कार्ट और ब्राउज़ परित्याग संदेश शामिल हैं। इसमें subscribers:write शामिल नहीं है, इसलिए यह संपर्कों को सूचियों में नहीं जोड़ सकता या उन्हें सूचियों से नहीं हटा सकता। किसी सूची या टैग को हटाने के लिए अभी भी मेल खाती lists:delete या tags:delete अनुमति की आवश्यकता होती है।

AI ड्राफ्टिंग प्रीसेट में subscribers:write शामिल है, इसलिए ड्राफ्टिंग एजेंट सूची बना सकते हैं और साथ ही उसे बना भी सकते हैं। listIds लागू करने वाले आयातों को भी lists:write की आवश्यकता होती है; अनुक्रम नामांकन या डबल-ऑप्ट-इन डिलीवरी के लिए अतिरिक्त रूप से automations:trigger की आवश्यकता होती है।

उपकरण

मानक सतह वर्तमान में 243 MCP उपकरण उजागर करती है। OpenAI-समीक्षित सतह 237 उजागर करती है; केवल ऊपर सूचीबद्ध छह ऑपरेशन छोड़े गए हैं।

उपकरण उन तर्कों को अस्वीकार करते हैं जिन्हें वे घोषित नहीं करते हैं, बजाय उन्हें चुपचाप अनदेखा करने के। त्रुटियाँ असमर्थित फ़ील्ड का नाम बताती हैं, समर्थित तर्कों की सूची देती हैं, और सामान्य गलतियों जैसे कि आविष्कृत सब्सक्राइबर फ़िल्टर या सॉर्ट विकल्पों के लिए केंद्रित मार्गदर्शन प्रदान करती हैं।

खाता, कंपनियाँ, सेटअप

टूलविवरण
get_accountखाता जानकारी, उपलब्ध कंपनियाँ, वर्तमान कुंजी अनुमतियाँ, और API कुंजी प्रबंधन URL प्राप्त करें।
select_companyभविष्य के टूल कॉल के लिए सक्रिय कंपनी सेट करें।
get_app_urlsअभियानों, लैंडिंग पृष्ठों, अनुक्रमों, ईमेल, सेटिंग्स, सदस्यता प्रबंधन, डोमेन, और भेजे गए ईमेल विवरणों के लिए डैशबोर्ड URL बनाएँ। settingsTab: "billing" खाता -> सदस्यता पर हल होता है।
create_companyनई कंपनी या ब्रांड बनाएँ।
get_companyकंपनी विवरण, उत्पाद जानकारी, ब्रांड संदर्भ, स्थानीयकरण, उत्तर-ट्रैकिंग सेटिंग्स, वर्तमान From/Reply-To डिफ़ॉल्ट, और प्रभावी केवल-पठनीय emailBranding अधिकार योजना/स्थिति कारण और सदस्यता URL के साथ पढ़ें; STO को स्पष्ट रूप से केवल-अभियान के रूप में पहचाना गया है।
update_companyउत्पाद जानकारी, ब्रांड संदर्भ, ईमेल थीम, उत्तर ट्रैकिंग, और खाता-व्यापी From/Reply-To प्रोफ़ाइल डिफ़ॉल्ट या नाम संपादित करें।
get_sync_rulesकंपनी की इवेंट-से-टैग नियम और क्या यह विरासत में मिला प्लेटफ़ॉर्म प्रीसेट उपयोग करती है, पढ़ें।
update_sync_rulesसभी सिंक नियम बदलें; उन्हें अक्षम करने के लिए [] पास करें या SaaS/ईकॉमर्स प्लेटफ़ॉर्म प्रीसेट में ऑप्ट इन करने के लिए null पास करें।
get_shopify_automation_settingsकनेक्टेड Shopify स्टोर के लिए ब्राउज़-परित्याग, कार्ट-परित्याग, और मूल्य-कटौती सेटिंग्स पढ़ें।
update_shopify_automation_settingsShopify स्वचालन सेटिंग्स को आंशिक रूप से अपडेट करें या किसी व्यक्तिगत अनुभाग को उसके प्लेटफ़ॉर्म डिफ़ॉल्ट पर रीसेट करें।
create_api_keyकंपनी API कुंजी बनाएँ और मानक MCP पर इसका एक-बार गुप्त मान लौटाएँ; OpenAI-समीक्षित मार्ग से हटा दिया गया।
request_api_key_handoffजब सक्रिय कुंजी स्वयं API कुंजी प्रबंधित नहीं कर सकती, तो स्वामी-समीक्षित निर्माण/रोटेशन URL तैयार करें।
list_api_keysसुरक्षित पहचान और सफाई के लिए कंपनी API कुंजियों को गैर-गुप्त मेटाडेटा के रूप में सूचीबद्ध करें।
update_api_keyकुंजी मान बदले बिना कंपनी API कुंजी का नाम बदलें या उसकी अनुमति प्रीसेट या स्कोप बदलें।
revoke_api_keylist_api_keys के साथ जाँच करने के बाद किसी सटीक कंपनी API कुंजी को ID द्वारा स्थायी रूप से रद्द करें।
delete_api_keyrevoke_api_key के लिए संगतता उपनाम।
list_websitesसंग्रहीत समग्र, SPF, DKIM, और MAIL FROM स्थिति के साथ भेजने वाले डोमेन सूचीबद्ध करें।
add_sending_domainभेजने वाला डोमेन जोड़ें और उसके समूह-विशिष्ट DNS सेटअप रिकॉर्ड लौटाएँ।
add_websiteadd_sending_domain के लिए संगतता उपनाम।
check_websiteभेजने वाले डोमेन के संग्रहीत SPF, DKIM, MAIL FROM, और समग्र सत्यापन विवरण पढ़ें।
verify_sending_domainताज़ा भेजने-डोमेन DNS/प्रदाता सत्यापन चलाएँ और वर्तमान स्थिति और निदान लौटाएँ।
list_integrationsक्रेडेंशियल लौटाए बिना कनेक्शन और सिंक स्वास्थ्य के साथ कनेक्टेड एकीकरण सूचीबद्ध करें।
get_sending_statusसक्रिय, रोके गए, या निलंबित भेजने का निदान करें, जिसमें प्रवर्तन हर, समीक्षा गेट, और सुधार चरण शामिल हैं।
resume_sendingसूची को साफ़ करने की स्पष्ट पुष्टि के बाद पात्र हार्ड-बाउंस रोक को पुनर्स्थापित करें।
get_tracking_settingsखाता-व्यापी और Transactional API खोलें/क्लिक डिफ़ॉल्ट, सदस्यता समाप्ति, एट्रिब्यूशन, UTM, क्लिक-डोमेन, उत्तर-ट्रैकिंग, और डबल-ऑप्ट-इन सेटिंग्स पढ़ें।
update_tracking_settingsखाता-व्यापी और Transactional API ट्रैकिंग डिफ़ॉल्ट, एट्रिब्यूशन, UTM, और खाता-व्यापी डबल ऑप्ट-इन अपडेट करें।
get_integration_guideफ्रेमवर्क-विशिष्ट एकीकरण उदाहरण प्राप्त करें।
get_integrationएक कनेक्टेड एकीकरण, उसकी इवेंट वायरिंग, सूची लक्ष्यीकरण, हाल की गतिविधि, और अनुशंसाओं का निरीक्षण करें।
list_integration_capabilitiesप्रदाता क्षमताओं की तुलना करें चाहे वे कनेक्टेड हों या नहीं।
connect_integrationमानक MCP पर समर्थित API-कुंजी या वेबहुक-गुप्त प्रदाताओं को कनेक्ट करें, जिसमें प्रबंधित Lemon Squeezy वेबहुक, केवल-आउटबाउंड Attio, और वैकल्पिक PostHog/Segment इतिहास आयात शामिल हैं; OpenAI-समीक्षित मार्ग से हटा दिया गया।
get_event_schemaप्रदाता द्वारा प्रकाशित इवेंट पेलोड उदाहरण, गुण पथ, प्रकार, और मर्ज टैग का निरीक्षण करें।
list_integration_activityबनाए रखा गया एकीकरण-विशिष्ट वेबहुक और सिंक गतिविधि लॉग पढ़ें।
set_integration_sync_enabledलाइव वेबहुक कनेक्टेड छोड़ते हुए बल्क आयात और बैकफ़िल सक्षम या अक्षम करें।
set_integration_list_targetingचुनें कि समर्थित एकीकरण द्वारा बनाए गए संपर्क भविष्य के प्रदाता लेखन पर कौन सी सूचियों में शामिल हों।
sync_integrationसहेजे गए एकीकरण कॉन्फ़िगरेशन का उपयोग करके भुगतान राजस्व, Supabase उपयोगकर्ता, या PostHog/Segment इवेंट-इतिहास आयात कतारबद्ध करें।
get_integration_pixelShopify की लाइव पिक्सेल/कॉन्फ़िगरेशन स्थिति पढ़ें और पुष्टि किए गए डार्क इवेंट को अज्ञात पठन से अलग करें।
activate_integration_pixelShopify के स्टोरफ्रंट पिक्सेल को इंस्टॉल या पुनः इंगित करें; जब यह पहले से वर्तमान हो तो यह आइडेम्पोटेंट है।
list_web_tracking_keysप्रकाशन योग्य वेबसाइट-ट्रैकिंग कुंजियाँ, मूल प्रतिबंध, उपयोग स्थिति, और इंस्टॉल स्निपेट सूचीबद्ध करें।
get_web_tracking_keyएक वेबसाइट-ट्रैकिंग कुंजी को उसके सटीक इंस्टॉल स्निपेट और इन्जेस्ट एंडपॉइंट के साथ प्राप्त करें।
create_web_tracking_keyगैर-Shopify स्टोरफ्रंट या वेबसाइट के लिए एक प्रकाशन योग्य ट्रैकिंग कुंजी बनाएं।
update_web_tracking_keyवेबसाइट-ट्रैकिंग कुंजी का नाम बदलें, प्रतिबंधित करें, रद्द करें, या पुनः सक्षम करें।
delete_web_tracking_keyस्निपेट हटाए जाने के बाद वेबसाइट-ट्रैकिंग कुंजी को स्थायी रूप से हटाएं।
list_sender_profilesप्रेषक और उत्तर-से प्रोफ़ाइल, डिफ़ॉल्ट, और भेजने-डोमेन तत्परता सूचीबद्ध करें।
update_sender_profileखाता डिफ़ॉल्ट बदले बिना एक प्रेषक या उत्तर-से प्रोफ़ाइल का नाम बदलें।
delete_sender_profileलाइव भेजने वाली सतहों और अंतिम शेष प्रेषक के लिए सुरक्षा उपायों के साथ, एक अप्रयुक्त प्रेषक प्रोफ़ाइल को स्थायी रूप से हटाएं।
get_notification_preferencesवर्तमान उपयोगकर्ता की प्रति-कंपनी खाता सूचना सेटिंग्स और समर्थित मोड पढ़ें, जिसमें सोमवार साप्ताहिक रिपोर्ट शामिल है।
update_notification_preferencesवर्तमान उपयोगकर्ता के खाता सूचना वितरण मोड अपडेट करें, जिसमें साप्ताहिक-रिपोर्ट ऑप्ट-आउट शामिल है, बिना सहकर्मियों को प्रभावित किए।
render_emailअंतिम ईमेल-सुरक्षित HTML प्रस्तुत करें और अनसुलझे मर्ज टैग का निदान करें, जिसमें डिफ़ॉल्ट द्वारा छिपी टाइपो त्रुटियाँ शामिल हैं। OpenAI-समीक्षित मार्ग नमूना डेटा या नीति-जाँच इनलाइन सब्सक्राइबर स्वीकार करता है, संग्रहीत सब्सक्राइबर आईडी नहीं।
get_sending_status Postgres-समर्थित पॉज़ स्थिति, समीक्षा गेट्स, और
सुधार उपलब्ध रखता है जब sender-health एनालिटिक्स अस्थायी रूप से अनुपलब्ध हों;
उस डिग्रेडेड स्थिति में senderHealth null है।

render_email unresolvedMergeTags लौटाता है ताकि कॉल करने वाले किसी अज्ञात नाम को एक मान्यता प्राप्त टैग से अलग कर सकें जो पूर्वावलोकित संपर्क के लिए केवल खाली है। अज्ञात नाम तब भी रिपोर्ट किए जाते हैं जब default फ़िल्टर ने टेक्स्ट प्रदान किया हो: उदाहरण के लिए, {{ subscriber.frstName | default: "there" }} हर संपर्क के लिए एक उचित अभिवादन प्रस्तुत करता है जबकि संग्रहीत पहले नामों को दरकिनार करता है। एक मान्यता प्राप्त नाम जो एक संपर्क के लिए खाली है, तब रिपोर्ट नहीं किया जाता जब उसका डिफ़ॉल्ट उपयोग किया जाता है। OpenAI-समीक्षित मार्ग मर्ज टैग के अंदर प्रतिबंधित कस्टम-विशेषता चयनकर्ताओं को अस्वीकार करता है। यह subscriberId तर्क को भी छोड़ देता है; नीति-जांचे गए इनलाइन subscriber का उपयोग करें, या नमूना पूर्वावलोकन के लिए सब्सक्राइबर डेटा छोड़ दें।

एक अनुक्रम चरण को प्रस्तुत करने के लिए जिसका nodeType action_ab_test है, चरण का sequenceId और nodeId एक साथ variantId के साथ पास करें get_sequence.sequence.emails[].abTest.variants से। इन चरणों का अपना कोई ईमेल नहीं होता, इसलिए वैरिएंट आवश्यक है; उनकी प्रतिस्पर्धी प्रति को पढ़ने और प्रस्तुत करने के लिए भी ab_tests:read स्कोप की आवश्यकता होती है।

Supabase के लिए, sync_integration डैशबोर्ड में सहेजे गए प्रोजेक्ट, स्कीमा, टेबल, सूची चयन, और सहमति मैपिंग का पुन: उपयोग करता है। यह एक मनमाना टेबल को लक्षित नहीं कर सकता। लाइव डेटाबेस ट्रिगर स्थापित करने के बाद इसे चलाएं ताकि ट्रिगर स्थापित होने से पहले मौजूद उपयोगकर्ताओं को आयात किया जा सके, फिर प्रगति और पंक्ति-स्तरीय परिणामों के लिए get_integration और list_integration_activity को पोल करें।

set_integration_sync_enabled केवल बल्क आयात और बैकफ़िल को नियंत्रित करता है; यह किसी प्रदाता के लाइव वेबहुक को संपर्क बनाने से नहीं रोकता। उनके भविष्य की सूची सदस्यताएँ चुनने के लिए set_integration_list_targeting का उपयोग करें: null कार्यक्षेत्र डिफ़ॉल्ट का पालन करता है, [] किसी सूची में शामिल नहीं होता, और एक भरी हुई सरणी उन सूचियों को लक्षित करती है। परिवर्तन पूर्वव्यापी नहीं है और मौजूदा सदस्यताओं को कभी नहीं हटाता। यह डिफ़ॉल्ट any_contact अनुक्रमों को भी नहीं रोकता, जो सूची-रहित संपर्कों को नामांकित करते हैं; स्पष्ट any_list और विशिष्ट-सूची अनुक्रम मिलान सदस्यता की आवश्यकता रखते हैं। सूची लक्ष्यीकरण को pause_sequence_enrollments के साथ जोड़ें जब उन डिफ़ॉल्ट नामांकनों को भी रोकना हो। Supabase, Stripe, Shopify, Wix, और Webflow इस नियंत्रण का समर्थन करते हैं।

PostHog के लिए, sync_integration संग्रहीत व्यक्तिगत API कुंजी के साथ इवेंट-इतिहास आयात को शुरुआत से पुनः आरंभ करता है। आयातित इवेंट डीडुप्लिकेटेड होते हैं, इसलिए एक असफल आयात को पुनः प्रयास करने से डुप्लिकेट नहीं बनते।

Segment के लिए, मानक MCP पर connect_integration लाइव वेबहुक कनेक्ट होने के बाद वैकल्पिक रूप से Unify से हाल का इवेंट इतिहास आयात कर सकता है। आयात मौजूदा संपर्कों को Profile API के माध्यम से चलाता है, API के सबसे हाल के 14 दिनों को कवर करता है, बिना मिलान प्रोफ़ाइल वाले संपर्कों को छोड़ देता है, और पुनः प्रयास और लाइव वेबहुक ओवरलैप को सुरक्षित रूप से डीडुप्लिकेट करता है। नए कनेक्शन स्वचालित पेज/स्क्रीन कॉल को छोड़ देते हैं जब तक उन नामों को स्पष्ट रूप से अनुमत सूची में नहीं जोड़ा जाता। Segment वेबहुक रहस्य 16-153 UTF-8 बाइट्स होने चाहिए। OpenAI-समीक्षित मार्ग पर, जो connect_integration को छोड़ देता है, इसके बजाय डैशबोर्ड या स्थानीय CLI में Segment कनेक्ट करें। सहेजे गए क्रेडेंशियल्स के साथ पुनः प्रयास करने के लिए sync_integration का उपयोग करें।

Lemon Squeezy के लिए, provider: "lemon_squeezy", एक API कुंजी, और संख्यात्मक स्टोर ID को providerAccountId के रूप में पास करें। डिफ़ॉल्ट प्रबंधित सेटअप के लिए webhookSecret छोड़ दें; प्रतिक्रिया webhookProvisioning और testMode रिपोर्ट करती है। केवल मैन्युअल वेबहुक सेटअप के लिए 16-40 वर्णों का हस्ताक्षर रहस्य प्रदान करें, लौटाए गए webhookUrl का उपयोग करके। क्रेडेंशियल्स कभी नहीं लौटाए जाते।

Attio के लिए, मानक MCP पर connect_integration वेबहुक रहस्य के बिना एक कार्यक्षेत्र एक्सेस टोकन स्वीकार करता है, वैकल्पिक settings.listMap के साथ Sequenzy सूची ID से Attio लोग-सूची UUID या API स्लग के मानचित्र के रूप में, साथ ही गैर-मुफ्त-मेल डोमेन से कंपनी मिलान को नियंत्रित करने के लिए syncCompanyFromDomain। OpenAI-समीक्षित मार्ग पर, डैशबोर्ड या स्थानीय CLI में Attio कनेक्ट करें, फिर समान सेटिंग्स के लिए update_attio_settings का उपयोग करें। एकीकरण केवल-आउटबाउंड है: मैप की गई Sequenzy सूचियों में नए जुड़ाव व्यक्ति को अपसेर्ट करते हैं और उन्हें Attio सूची में जोड़ते हैं; सूची हटाने से Attio में रिकॉर्ड नहीं हटते।

get_event_schema लिखने से पहले {{event.*}} मर्ज टैग या एक इवेंट प्रॉपर्टी फ़िल्टर कॉल करें। दस्तावेजित अंतर्निहित इवेंट सूचीबद्ध करने के लिए eventName छोड़ दें; एक इवेंट नाम प्रदान करें ताकि प्रदाता-विशिष्ट उदाहरण पेलोड और प्रॉपर्टी पथ प्राप्त हों, और वैकल्पिक रूप से provider द्वारा फ़िल्टर करें। कस्टम इवेंट नाम तब भी मान्य रहते हैं जब परिणाम documented: false रिपोर्ट करता है; इसका केवल मतलब है कि कोई संदर्भ नमूना प्रकाशित नहीं है। वास्तविक वितरण डेटा के लिए एकीकरण गतिविधि या अनुक्रम नामांकन का उपयोग करें क्योंकि यह टूल स्थिर संदर्भ डेटा लौटाता है।

एक नए भेजने वाले डोमेन के लिए, add_sending_domain कॉल करें, लौटाए गए website.dnsRecords में DNS रिकॉर्ड प्रकाशित करें, DNS प्रसार की प्रतीक्षा करें, और फिर verify_sending_domain कॉल करें। एक निश्चित प्रदाता या रिकॉर्ड गिनती मानने के बजाय हर लौटाए गए रिकॉर्ड को प्रकाशित करें: एकीकृत डोमेन में आवश्यक DMARC शामिल है, जबकि विरासत डोमेन Amazon SES MAIL FROM और इनबाउंड-उत्तर रिकॉर्ड लौटा सकते हैं। यदि सत्यापन निर्माण से पहले प्रयास किया जाता है, तो त्रुटि अनुरोधित डोमेन के साथ add_sending_domain पर वापस इंगित करती है।

Shopify के लिए, उत्पाद दृश्य, कार्ट गतिविधि, या ब्राउज़-परित्याग ट्रिगर पर भरोसा करने से पहले get_integration_pixel कॉल करें। परिणाम Shopify से लाइव पढ़ा जाता है क्योंकि व्यापारी पिक्सेल को स्वतंत्र रूप से हटा सकते हैं। यदि pixel.healthy गलत है, तो dependentEvents उन ट्रिगरों के नाम बताता है जो नहीं आ सकते; पिक्सेल स्थापित या पुनः इंगित करने के लिए activate_integration_pixel कॉल करें। सक्रियण आइडेम्पोटेंट है, और इवेंट अगली स्टोरफ्रंट यात्रा पर शुरू होते हैं बैकफ़िल होने के बजाय।

कस्टम, हेडलेस, टिकटिंग, या SaaS वेबसाइटों के लिए, उत्पाद-दृश्य या कार्ट ट्रिगर पर भरोसा करने से पहले list_web_tracking_keys का उपयोग करें। एक स्पष्ट मूल अनुमत सूची के साथ एक कुंजी बनाएं, लौटाए गए installSnippet को स्थापित करें, फिर ग्राहक के प्रमाणित बैकएंड को POST /api/v1/web-tracking-identities के माध्यम से एक अल्पकालिक प्रमाण मिंट करने दें और साइन-इन या चेकआउट पर sequenzy.identify(email, identityToken) कॉल करें। एक प्रकाशन योग्य कुंजी अकेले केवल अनाम गतिविधि रिकॉर्ड करती है और सब्सक्राइबर स्वचालन को ट्रिगर नहीं कर सकती। लौटाया गया स्निपेट अपने async लोडर से पहले सिंक्रोनस विधि स्टब्स स्थापित करता है, इसलिए पेज बूटस्ट्रैप के दौरान की गई पहचान और इवेंट कॉल SDK तैयार होने तक कतारबद्ध रहते हैं। स्थायी रूप से हटाने से पहले update_web_tracking_key के साथ एक कुंजी को रद्द करना पसंद करें।

नई कंपनियां बिना किसी सिंक नियम के शुरू होती हैं। विरासत प्रीसेट SaaS/ईकॉमर्स कंपनियों के लिए null को update_sync_rules में पास करके उपलब्ध रहता है; सेवाएं और परामर्श कंपनियों को सामान्य रूप से [] रखना चाहिए या स्पष्ट नियम परिभाषित करने चाहिए।

प्रोफ़ाइल ID खोजने के लिए list_sender_profiles का उपयोग करें, फिर केवल उसका प्रदर्शन नाम बदलने के लिए update_sender_profile कॉल करें। उत्तर-से प्रोफ़ाइल के लिए type: "reply" पास करें; प्रेषक डिफ़ॉल्ट है। पता, भेजने वाला डोमेन, और खाता-व्यापी डिफ़ॉल्ट From/Reply-To चयन अपरिवर्तित रहते हैं। नाम बदलने के लिए companies:manage स्कोप की आवश्यकता होती है।

एक अप्रचलित From पहचान को स्थायी रूप से हटाने के लिए delete_sender_profile का उपयोग करें। यह अंतिम प्रेषक और किसी भी प्रोफ़ाइल को अस्वीकार करता है जो लाइव अभियान, सक्रिय अनुक्रम (चरण ओवरराइड सहित), या लेनदेन ईमेल द्वारा उपयोग की जाती है। पात्र ड्राफ्ट और खाता डिफ़ॉल्ट लौटाए गए fallbackSenderProfileId पर चले जाते हैं; भेजने से पहले इसकी समीक्षा करें। उत्तर-से प्रोफ़ाइल इस हटाने वाले टूल द्वारा समर्थित नहीं हैं।

Shopify कार्ट परित्याग डिफ़ॉल्ट रूप से सक्षम है। यह एक घंटे की कार्ट निष्क्रियता के बाद ecommerce.cart_abandoned फायर करता है, जिसमें 24-घंटे का प्रति-सब्सक्राइबर कोल्डाउन होता है। update_shopify_automation_settings का उपयोग करके cartAbandonment.enabled, delayHours, या cooldownHours फ़ील्ड बदलें; ब्राउज़ परित्याग या मूल्य-गिरावट सेटिंग्स को बदले बिना उन डिफ़ॉल्ट को पुनर्स्थापित करने के लिए cartAbandonment: null पास करें। समय मान सकारात्मक होने चाहिए; delayHours 168 पर और cooldownHours 720 पर सीमित है।

सब्सक्राइबर

टूलविवरण
add_subscriberएक सब्सक्राइबर जोड़ें; स्थिति केवल-निर्माण है, इसलिए मौजूदा संपर्क के लिए update_subscriber का उपयोग करें।
create_subscriber_importवैकल्पिक रिट्री-सुरक्षित idempotencyKey के साथ 5,000 तक पूर्ण CRM रिकॉर्ड कतारबद्ध करें; सक्षम ईमेल-स्वच्छता जांच अंतर्ग्रहण के बाद अलग से जारी रहती है।
get_subscriber_importकतारबद्ध आयात के लिए प्रगति, पंक्ति परिणाम गिनती, और विफलता सारांश पढ़ें।
update_subscriberमूल प्रोफ़ाइल और फ़ोन फ़ील्ड, SMS सहमति, विशेषताएँ, टैग, या वैश्विक स्थिति अपडेट करें।
remove_subscriberदमन इतिहास संरक्षित करते हुए सदस्यता समाप्त करें, या केवल hardDelete: true के साथ स्थायी रूप से हटाएं।
get_subscriberईमेल या बाहरी ID द्वारा सब्सक्राइबर विवरण प्राप्त करें।
search_subscribersक्वेरी, टैग, सूची, स्थिति, खंड, या एक कस्टम विशेषता द्वारा खोजें, स्वचालित या फिर से शुरू करने योग्य पेजिनेशन के साथ।
trigger_subscriber_eventएक कस्टम इवेंट ठीक वैसे ही उत्सर्जित करें जैसे एक एकीकरण करेगा, सिंक नियम लागू करके और अनुक्रम ट्रिगर मिलान करके।
trigger_subscriber_eventsएक सब्सक्राइबर के लिए कई क्रमबद्ध कस्टम इवेंट उत्सर्जित करें।
import_subscriber_eventsसंपर्कों में 25 तक स्रोत-पहचाने गए इवेंट आयात करें; मौन इतिहास के लिए प्रत्येक पंक्ति एक घंटे से अधिक पुरानी होनी चाहिए।
bulk_add_subscriber_tags500 तक मौजूदा सब्सक्राइबर में टैग जोड़ें; subscribers:tag की आवश्यकता है और tags:write की भी आवश्यकता हो सकती है।
bulk_remove_subscriber_tags500 तक मौजूदा सब्सक्राइबर से टैग हटाएं; subscribers:tag या subscribers:write की आवश्यकता है।

CRM ऑनबोर्डिंग के लिए create_subscriber_import का उपयोग करें, add_subscriber पर लूप करने के बजाय। एक कॉल 5,000 पूर्ण रिकॉर्ड स्वीकार करता है और एक अतुल्यकालिक आयात ID लौटाता है; इसे get_subscriber_import के साथ पोल करें। एक completed आयात में अभी भी पंक्ति विफलताएँ हो सकती हैं, इसलिए failedCount और failedReasons का निरीक्षण करें। हर बहिष्कृत पंक्ति का हिसाब है: skippedReasons का योग skippedCount है, और failedReasons का योग failedCount है। अनुमान लगाने के बजाय आयात ID के साथ किसी भी कमी की रिपोर्ट करें। जब ईमेल स्वच्छता सक्षम होती है, तो वितरण योग्यता जांच अंतर्ग्रहण के बाद अलग से जारी रहती है और परिणाम सूची स्वास्थ्य में दिखाई देते हैं; आयात स्थिति उन फैसलों की प्रतीक्षा नहीं करती या उन्हें शामिल नहीं करती। अमान्य फैसले बाद के भेजने से दबाए जाते हैं। केवल तब optInMode: "confirmed" का उपयोग करें जब सहमति पहले ही सत्यापित हो चुकी हो।

import_subscriber_events के लिए, ईमेल आवश्यक है जब एक पंक्ति एक नया संपर्क बना सकती है; externalId केवल मौजूदा संपर्क के लिए अकेला खड़ा हो सकता है। हर पंक्ति पर एक स्थिर eventId प्रदान करें। पुनः प्रयास मूल रसीद का पुन: उपयोग करता है और डाउनस्ट्रीम पुनर्प्राप्ति को आइडेम्पोटेंट रूप से पुनः प्रयास करता है। ऐतिहासिक वर्गीकरण प्रति संपर्क है: यदि किसी संपर्क के लिए कोई पंक्ति हाल की है, तो उस संपर्क का पूरा समूह लाइव साइड-इफेक्ट पथ का उपयोग करता है।

अनुपालन दमन के लिए, update_subscriber को status: "unsubscribed" के साथ कॉल करें (या hardDelete के बिना remove_subscriber का उपयोग करें)। add_subscriber को एक अलग स्थिति के साथ पुनः प्रयास न करें: उस टूल पर स्थिति केवल तब लागू होती है जब संपर्क पहली बार बनाया जाता है, और एक बेमेल छोड़ा गया परिणाम त्रुटि के रूप में रिपोर्ट किया जाता है। जब add_subscriber में listIds छोड़ दिया जाता है, तो कॉल द्वारा बनाया गया संपर्क कार्यक्षेत्र की डिफ़ॉल्ट सूचियों का पालन करता है, जबकि मौजूदा संपर्क अपनी वर्तमान सूची सदस्यता बनाए रखता है। जब किसी मौजूदा संपर्क को विशिष्ट सूचियों में शामिल होना चाहिए, तो सूची आईडी स्पष्ट रूप से पास करें; किसी भी सूची को लक्षित न करने के लिए [] पास करें।

update_subscriber.phone संपर्क पर दिखाए गए मूल फ़ोन फ़ील्ड को लिखता है, कोई कस्टम विशेषता नहीं। स्पष्ट लिखित सहमति सत्यापित करने के बाद ही smsConsent: true पास करें, या संपर्क को ऑप्ट आउट करने के लिए false पास करें। smsConsent के बिना फ़ोन बदलने से SMS सहमति रीसेट हो जाती है क्योंकि सहमति पुराने नंबर से संबंधित होती है।

add_subscriber, update_subscriber, और create_subscriber_import एक IANA timezone स्वीकार करते हैं जैसे America/New_York। मान मूल संपर्क प्रोफ़ाइल पर संग्रहीत होता है और प्राप्तकर्ता-स्थानीय अभियान वितरण सक्षम करता है। इसे साफ़ करने के लिए update_subscriber में एक खाली समयक्षेत्र पास करें; अमान्य आयात-पंक्ति मान शेष आयात को अस्वीकार किए बिना अनदेखा कर दिए जाते हैं।

उत्पाद और डिजिटल वितरण

टूलविवरण
list_productsStripe, Shopify, WooCommerce, मैनुअल, या Commerce API डेटा से सिंक किए गए उत्पादों की सूची बनाएं।
upsert_productsआपके उत्पाद आईडी द्वारा कुंजीबद्ध 100 तक Commerce API उत्पाद बनाएं या अपडेट करें।
delete_productCommerce API के माध्यम से पहले पुश किए गए उत्पाद को हटाएं।
attach_product_fileकिसी उत्पाद से होस्टेड या स्थानीय रूप से अपलोड की गई वितरण फ़ाइल संलग्न करें।
remove_product_fileसंलग्न उत्पाद वितरण फ़ाइल हटाएं।
sync_productsStripe उत्पाद कैटलॉग सिंक कतारबद्ध करें, वैकल्पिक रूप से आईडी द्वारा एक एकीकरण चुनें।

उत्पाद वितरण फ़ाइल संलग्न होने के बाद, मिलान खरीद घटनाओं में download.url और download.name शामिल होते हैं, इसलिए खरीद-ट्रिगर ईमेल {{event.download.url}} जैसे मर्ज टैग का उपयोग कर सकते हैं।

Stripe उत्पादों के लिए, list_products प्रत्येक सक्रिय मूल्य को एक वैरिएंट के रूप में लौटाता है, जिसमें Stripe मूल्य आईडी variantId में होती है। उस आईडी का उपयोग खरीद अनुक्रम में सटीक मूल्य को लक्षित करने के लिए करें, भले ही यह उत्पाद की डिफ़ॉल्ट मूल्य न हो।

छवि संपत्तियाँ

टूलविवरण
upload_image_assetएक ईमेल छवि अपलोड करें और उसका होस्टेड मीडिया रिकॉर्ड और सम्मिलित करने के लिए तैयार छवि ब्लॉक लौटाएं।

टूल 5MB तक की PNG, JPEG, GIF, और WebP छवियाँ स्वीकार करता है। स्थानीय stdio क्लाइंट filePath पास कर सकते हैं। होस्टेड/रिमोट क्लाइंट जो अनुलग्नक बाइट्स तक पहुंच सकते हैं, filename के साथ imageBase64 पास कर सकते हैं। पहुंच-योग्यता के लिए altText प्रदान करें, फिर स्क्रीनशॉट प्रस्तुति को मानकीकृत करने के लिए displayWidthPercent, cropHeight, objectFit (cover या contain), और align का उपयोग करें। लौटाया गया imageBlock सीधे अभियान, अनुक्रम, टेम्पलेट, और लेनदेन-ईमेल टूल द्वारा स्वीकार किए गए ब्लॉक सरणी में कॉपी किया जा सकता है।

प्रमाणित छवि बाइट्स हमेशा SEQUENZY_API_URL द्वारा कॉन्फ़िगर किए गए मूल पर अपलोड की जाती हैं, भले ही एक रिवर्स प्रॉक्सी किसी अन्य होस्ट के तहत समकक्ष अपलोड URL लौटाता हो। API क्रेडेंशियल उस वैकल्पिक मूल पर कभी अग्रेषित नहीं किए जाते हैं।

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

सूचियाँ, टैग, खंड

टूलविवरण
list_tagsसभी टैग सूचीबद्ध करें।
create_tagवैकल्पिक रंग के साथ टैग परिभाषा बनाएं।
update_tagटैग रंग अपडेट करें।
delete_tagटैग हटाएं और इसे सदस्यों से हटाएं।
list_listsसदस्य सूचियाँ सूचीबद्ध करें।
create_listसदस्य सूची बनाएं।
update_listसदस्य सूची का नाम बदलें या वर्णन करें।
delete_listसदस्य सूची हटाएं।
add_subscribers_to_listईमेल सरणी से किसी सूची में 500 तक सदस्य जोड़ें।
remove_subscribers_from_listकिसी सूची से 500 तक सदस्य हटाएं।
list_segmentsसहेजे गए खंड और गणनाएँ सूचीबद्ध करें।
create_segmentनेस्टेड या समान-तत्व सरणी-फ़िल्टर किए गए खंड बनाएं।
update_segmentखंड नाम, फ़िल्टर, रूट समूह, या जॉइन ऑपरेटर अपडेट करें।
delete_segmentखंड हटाएं (segments:delete आवश्यक है)।
get_segment_countखंड के लिए सक्रिय सदस्य गणना का पूर्वावलोकन करें।

सदस्य निर्यात के लिए, search_subscribers listId, सटीक listName, या list (पहले आईडी, फिर सटीक नाम) स्वीकार करता है। यह attribute प्लस attributeValue भी स्वीकार करता है, जिसमें contains के लिए attributeOperator, संख्यात्मक तुलना, या is_not_empty शामिल है; संयुक्त "attributeName:value" रूप समर्थित रहता है। फ़िल्टर AND के साथ संयोजित होते हैं; OR तर्क, नेस्टेड समूह, बहिष्करण, सहभागिता, या घटना शर्तों के लिए सहेजे गए खंड का उपयोग करें। यदि limit छोड़ दिया गया है, तो टूल स्वचालित रूप से हर मिलान पृष्ठ लाता है। खंडित पढ़ने के लिए, limit पास करें और hasMore सत्य होने पर pagination.nextCursor (या pagination.nextOffset) का पालन करें। offset और page 1,000,000 छोड़े गए मिलानों से नीचे समर्थित हैं; गहरे दर्शकों के लिए कर्सर का उपयोग करें।

थोक सूची जनसंख्या के लिए, add_subscribers_to_list का उपयोग करें; बैकिंग API एंडपॉइंट POST /api/v1/lists/{listId}/subscribers है जिसमें कोई /bulk प्रत्यय नहीं है:

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

प्रति अनुरोध अधिकतम 500 ईमेल भेजें। मानक API दर सीमाएँ अभी भी लागू हैं: प्रति API कुंजी 100 अनुरोध प्रति मिनट और 20 अनुरोध प्रति सेकंड बर्स्ट। CSV-संचालित CLI आयात के लिए, स्वीकृत ईमेल हेडर में email, e-mail, email address, और mail शामिल हैं; यदि कोई मान्यता प्राप्त हेडर मौजूद नहीं है, तो CLI पहला कॉलम पढ़ता है।

खंड फ़िल्टर विशेषताओं, घटनाओं, सहेजे गए खंड सदस्यता, सहभागिता घटनाओं, Stripe उत्पाद खरीद नियमों, और वाणिज्य उत्पाद खरीद नियमों का समर्थन करते हैं। मैच-एनी खंडों के लिए filterJoinOperator: "or" का उपयोग करें, या नेस्टेड तर्क के लिए v2 root समूह पास करें।

ऑब्जेक्ट-सरणी विशेषताओं के लिए, वाइल्डकार्ड पथ जैसे history_events[].eventvenue_id:2103 का उपयोग करें। जब एक AND समूह भी history_events[].showing_date फ़िल्टर करता है, तो दोनों शर्तों को एक साझा history_events[] तत्व से मेल खाना चाहिए; असंबंधित इतिहास प्रविष्टियों के मान संयोजित नहीं होते हैं। खंड हटाने के लिए segments:delete आवश्यक है; segments:write पर्याप्त नहीं है।

प्रत्येक खंड फ़िल्टर फ़ील्ड अपने स्वयं के ऑपरेटरों को मान्य करता है:

  • 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, ईमेल सहभागिता फ़ील्ड: is, is_not, at_least, less_than_count
  • emailBounced: 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

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" }

वाणिज्य उत्पाद फ़िल्टर वाणिज्य ऑर्डर के माध्यम से खरीदे गए उत्पादों से मेल खाते हैं। मान प्रदाता-स्कोप्ड आईडी के लिए provider:productId (shopify, woocommerce, या api), किसी भी प्रदाता से मेल खाने के लिए एक बेयर उत्पाद आईडी, या थ्रेशोल्ड ऑपरेटरों के लिए provider:productId:count हो सकते हैं:

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

emailSent, emailDelivered, emailOpened, emailClicked, emailBounced, और emailComplained जैसे सहभागिता फ़ील्ड 7d, 30d, 90d, 180d, या all जैसी रोलिंग विंडो स्वीकार करते हैं। उपस्थिति ऑपरेटर marketing:<timeRange> (मार्केटिंग-नीति अभियान, स्वचालन, और Send API ट्रैफ़िक) या transactional:<timeRange> (लेनदेन-नीति भेजने) के साथ वितरण नीति द्वारा स्कोप कर सकते हैं; नीति स्कोप के लिए भेजने-समय नीति स्नैपशॉट की आवश्यकता होती है, इसलिए अस्पष्ट पुराने स्वचालन और Send API घटनाएँ केवल बिना स्कोप वाले फ़िल्टर के माध्यम से उपलब्ध रहती हैं। emailBounced is_temporary_bounce और is_permanent_bounce के साथ स्कोप्ड मानों का भी समर्थन करता है। at_least और less_than_count के साथ, count:timeRange का उपयोग करें, जैसे 10:30d या 10:all। उपस्थिति ऑपरेटर इसके बजाय campaign:cmp_123 जैसे अभियान स्कोप का उपयोग कर सकते हैं; अभियान और ईमेल-प्रकार स्कोप को गणना ऑपरेटरों के साथ संयोजित नहीं किया जा सकता है।

दर्शक सिंक (Meta Ads)

टूलविवरण
list_audience_syncsशेड्यूल और अंतिम सिंक स्थिति के साथ खंड-से-दर्शक सिंक सूचीबद्ध करें।
list_ad_accountsसिंकिंग के लिए उपलब्ध Meta विज्ञापन खाते सूचीबद्ध करें।
create_audience_syncशेड्यूल पर खंड को Meta कस्टम दर्शक में पुश करें।
update_audience_syncसिंक आवृत्ति बदलें (hourly, daily, weekly) या रोकें/फिर से शुरू करें।
delete_audience_syncसिंक मैपिंग हटाएं; Meta दर्शक स्वयं रखा जाता है।
sync_audience_nowनियमित शेड्यूल के बाहर तत्काल अपलोड ट्रिगर करें।

Sequenzy डैशबोर्ड (सेटिंग्स -> एकीकरण) में Meta Ads एकीकरण कनेक्ट होना आवश्यक है। create_audience_sync एक मौजूदा खंड (segmentId) या एक तैयार टेम्पलेट (predefinedSegmentId, उदाहरण के लिए zero-ltv, no-purchase-1y, recent-buyers, high-spenders-ecom, non-buyers, engaged) स्वीकार करता है - टेम्पलेट खंड पहले उपयोग पर स्वचालित रूप से बनाया जाता है, और पहला अपलोड तुरंत चलता है।

दर्शक केवल-जोड़ हैं: जो सदस्य बाद में खंड छोड़ देते हैं वे Meta दर्शक में रहते हैं। Meta को विज्ञापन वितरण के लिए दर्शक का उपयोग करने से पहले 100+ मिलान वाले लोगों की आवश्यकता होती है।

टेम्पलेट

टूलविवरण
list_templatesलोकलाइज़ेशन स्थिति, लेबल और isTemplate फ़िल्टरिंग के साथ टेम्पलेट सूचीबद्ध करें, और पेजिनेशन।
get_templateटेम्पलेट विवरण, सामग्री और लोकलाइज़्ड वेरिएंट पढ़ें।
create_templateप्रॉम्प्ट, HTML, या Sequenzy ब्लॉक से टेम्पलेट बनाएं; पुन: प्रयोज्य मास्टर डिज़ाइन सहेजने के लिए isTemplate: true का उपयोग करें।
update_templateटेम्पलेट मेटाडेटा, इनबॉक्स पूर्वावलोकन टेक्स्ट, लेबल, HTML, या ब्लॉक अपडेट करें; isTemplate के साथ मास्टर को चिह्नित या अचिह्नित करें।
set_template_localizationकॉलर-आपूर्ति किया गया लोकलाइज़्ड वेरिएंट बनाएं या बदलें।
sync_template_localizationsचयनित या सभी सक्षम गैर-प्राथमिक लोकेल के लिए AI अनुवाद कतारबद्ध करें।
delete_templateटेम्पलेट हटाएं।

list_templates डिफ़ॉल्ट रूप से नवीनतम पहले 50 ईमेल बॉडी लौटाता है और limit तक 100 स्वीकार करता है। offset को pagination.count से आगे बढ़ाएं जबकि pagination.hasMore सत्य है; pagination.total पूर्ण मिलान गिनती की रिपोर्ट करता है, जिसमें अभियान और ट्रांज़ैक्शनल-ईमेल बॉडी शामिल हैं।

केवल सहेजे गए मास्टर डिज़ाइन लौटाने के लिए list_templates पर isTemplate: true सेट करें, या सामान्य ईमेल बॉडी लौटाने के लिए false। चिह्नित मास्टर को डैशबोर्ड अनुक्रम चरणों और अभियानों के लिए प्रारंभिक बिंदु के रूप में पेश किया जाता है; एक से शुरू करने पर एक स्वतंत्र प्रति बनती है ताकि संपादन मास्टर को अक्षुण्ण छोड़ दें।

स्टैंडअलोन/अनुक्रम स्रोत-डिज़ाइन कॉपी करना और चयनित लेआउट के भीतर AI पुनर्लेखन वर्तमान में केवल डैशबोर्ड-आधारित है। यह रिलीज़ जानबूझकर उन वर्कफ़्लो को इंटरैक्टिव ऑथरिंग में रखता है, जहाँ उपयोगकर्ता अनुक्रम चरण सहेजने से पहले स्रोत, अनुवाद और किसी भी फ़ॉलबैक प्रति की समीक्षा कर सकते हैं। REST, CLI, और MCP कोई समकक्ष स्टैंडअलोन/अनुक्रम स्रोत-डिज़ाइन ऑपरेशन उजागर नहीं करते हैं। create_template के साथ prompt मौजूदा लेआउट को संरक्षित किए बिना नई सामग्री उत्पन्न करता है; आपूर्ति किया गया HTML या ब्लॉक लोकलाइज़्ड वेरिएंट को स्वचालित रूप से कॉपी किए बिना एक नई बॉडी बनाते हैं। इंटरफ़ेस उपलब्धता दस्तावेज़ देखें।

अभियान प्रतियां पहले से ही REST POST /api/v1/campaigns और MCP create_campaign के साथ templateId के माध्यम से काम करती हैं; इसे AI पुनर्लेखन के लिए prompt के साथ नहीं जोड़ा जा सकता है।

प्राकृतिक भाषा में अनुरोधित नई सामग्री के लिए, prompt पास करें ताकि Sequenzy सर्वर-साइड ब्रांडेड नेटिव ब्लॉक उत्पन्न करे। blocks का उपयोग केवल समाप्त कॉलर-आपूर्ति Sequenzy सामग्री के लिए करें, और html का उपयोग केवल आपूर्ति किए गए या स्पष्ट रूप से अनुरोधित मार्कअप को संरक्षित करते समय करें। prompt, blocks, और html परस्पर अनन्य हैं; style और tone केवल prompt के साथ मान्य हैं।

set_template_localization का उपयोग करें जब अनुवादित प्रति आपके अपने लोकलाइज़ेशन वर्कफ़्लो से आती है। इसके लिए एक सक्षम गैर-प्राथमिक locale, एक लोकलाइज़्ड subject, और html या blocks में से ठीक एक की आवश्यकता होती है। चयनित लोकेल का अनुवाद करने के लिए Sequenzy से पूछने के लिए sync_template_localizations का उपयोग करें; हर सक्षम गैर-प्राथमिक लोकेल को सिंक करने के लिए locales छोड़ें। स्पष्ट सिंक तब भी काम करता है जब स्वचालित सहेजने-पर लोकलाइज़ेशन अक्षम हो।

पुन: प्रयोज्य ईमेल घटक

टूलविवरण
list_email_componentsसहेजे गए अनुभाग और फ़ुटर सूचीबद्ध करें, वैकल्पिक रूप से पिन किए गए डिफ़ॉल्ट तक सीमित।
get_email_componentएक घटक के ब्लॉक, मेटाडेटा, संस्करण और डिफ़ॉल्ट-स्लॉट स्थिति पढ़ें।
get_default_email_componentfooter जैसे डिफ़ॉल्ट स्लॉट में वर्तमान में पिन किया गया घटक पढ़ें।
set_default_email_componentनए बनाए गए ब्लॉक ईमेल द्वारा उपयोग किया जाने वाला कंपनी डिफ़ॉल्ट फ़ुटर बनाएं या बदलें।
create_email_componentब्लॉक सूची से पुन: प्रयोज्य अनुभाग या फ़ुटर सहेजें।
update_email_componentघटक मेटाडेटा अपडेट करें या उसके ब्लॉक बदलें और उसका संस्करण बढ़ाएं।
delete_email_componentएक घटक हटाएं बिना उन ईमेल को बदले जिन्होंने पहले ही उसके ब्लॉक कॉपी कर लिए हैं।

घटकों को ईमेल में तब कॉपी किया जाता है जब वे ईमेल बनाए जाते हैं, इसलिए बाद के संपादन मौजूदा सामग्री को फिर से लिखने के बजाय नए बनाए गए ईमेल को प्रभावित करते हैं। डिफ़ॉल्ट फ़ुटर अपना अनसब्सक्राइब लिंक सक्षम रखता है, जबकि ट्रांज़ैक्शनल रेंडरिंग उस लिंक को छुपाती है। रॉ HTML ईमेल अपना मार्कअप रखते हैं और ब्लॉक घटक प्राप्त नहीं करते हैं; उनका भेजने-समय अनसब्सक्राइब हैंडलिंग अपरिवर्तित रहती है।

A/B परीक्षण

टूलविवरण
list_ab_testsA/B परीक्षण और वेरिएंट सूचीबद्ध करें, वैकल्पिक रूप से अनुक्रम द्वारा स्कोप किया गया।
get_ab_testप्रभावी सेटिंग्स, वेरिएंट, लोकलाइज़ेशन स्थिति और अनुक्रम-चरण प्रति प्राप्त करें।
get_ab_test_statsकुल और प्रति-वेरिएंट आँकड़े प्राप्त करें।
restart_ab_testरोका या पूरा किया गया A/B परीक्षण पुनः आरंभ करें।
select_ab_test_winnerअभियान परीक्षण विजेता चुनें और शेष डिलीवरी कतारबद्ध करें।
update_ab_testअभियान या अनुक्रम विजेता-चयन सेटिंग्स अपडेट करें।
update_ab_test_variantअभियान ड्राफ़्ट या अनुक्रम वेरिएंट प्रति अपडेट करें।
create_ab_testअभियान परीक्षण बनाएं या अनुक्रम ईमेल चरण परिवर्तित करें।
add_ab_test_variantमौजूदा A/B परीक्षण में वेरिएंट जोड़ें।
delete_ab_test_variantड्राफ़्ट A/B परीक्षण वेरिएंट हटाएं।
delete_ab_testA/B परीक्षण हटाएं।

अनुक्रम वेरिएंट आईडी, विषय, पूर्वावलोकन टेक्स्ट और ब्लॉक गिनती खोजने के लिए get_sequence.sequence.emails[].abTest.variants का उपयोग करें; हर वेरिएंट की पूर्ण blocks, प्रभावी settings, लोकलाइज़ेशन स्थिति या आँकड़े ऑडिट करने के लिए get_ab_test को कॉल करें। अभियान सेटिंग्स testPercentage, testDurationMinutes, और winnerCriteria का उपयोग करती हैं; अनुक्रम सेटिंग्स testType, winnerThreshold, और winnerCriteria का उपयोग करती हैं। विरासत अनुक्रम मान testPercentage: 100 और testDurationMinutes: 0 संगतता सेंटिनल हैं, रनटाइम सेटिंग्स नहीं। select_ab_test_winner केवल एक अभियान परीक्षण पर लागू होता है जो वर्तमान में परीक्षण कर रहा है और तुरंत शेष दर्शकों के लिए विजेता वेरिएंट कतारबद्ध करता है। update_ab_test उपयुक्त सेटिंग्स मॉडल बदलता है और confirmLiveChange: true की आवश्यकता होती है जब अनुक्रम सेटिंग्स एक सक्रिय या पहले से उपयोग किए गए परीक्षण को प्रभावित करती हैं। वेरिएंट अपडेट या तो html या blocks स्वीकार करते हैं, दोनों नहीं।

create_ab_test ठीक एक campaignId या automationNodeId स्वीकार करता है; बाद वाले को एक से चार अतिरिक्त वेरिएंट की आवश्यकता होती है और एक अनुक्रम ईमेल नोड को action_ab_test में परिवर्तित करता है। रूपांतरण चरण के विषय, पूर्वावलोकन टेक्स्ट और ब्लॉक को स्वतंत्र वेरिएंट ईमेल पर ले जाता है। परीक्षण और वेरिएंट आईडी get_sequence से प्राप्त करें, get_ab_test के साथ हर वेरिएंट की प्रति पढ़ें, और update_ab_test_variant के साथ प्रत्येक को संपादित करें; update_sequence_node और update_template वेरिएंट प्रति संपादित नहीं कर सकते हैं, और पूरे चरण के लिए इच्छित परिवर्तन हर वेरिएंट के लिए दोहराया जाना चाहिए। यदि update_ab_test_variant MCP टूल सूची में नहीं है, तो किसी अन्य ईमेल टूल के माध्यम से लिखने के बजाय इसे Sequenzy कनेक्टर पर सक्षम करें। पूर्ण वर्कफ़्लो के लिए ab_tests:read, ab_tests:write, और sequences:write की आवश्यकता होती है, जो सभी सुरक्षित एजेंट पहुंच में शामिल हैं। केवल sequences:read के साथ, get_sequence A/B चरण और नियंत्रण प्रति दृश्यमान रखता है लेकिन परीक्षण-रिकॉर्ड फ़ील्ड को संपादित करता है और एक खाली वेरिएंट सूची लौटाता है। एक स्पष्ट अनुक्रम winnerCriteria testType डिफ़ॉल्ट को ओवरराइड करता है, इसलिए सामग्री वेरिएंट का अभी भी खुलने से मूल्यांकन किया जा सकता है। सक्रिय अनुक्रम में नोड परिवर्तित करते समय confirmLiveChange: true पास करें। नियंत्रण A के साथ, एक A/B परीक्षण अधिकतम पाँच वेरिएंट का समर्थन करता है। अनुक्रम वेरिएंट स्वतंत्र ईमेल टेम्पलेट प्राप्त करते हैं और निर्माण के बाद संपादित किए जा सकते हैं; एक बार अनुक्रम सक्रिय या परीक्षण में गतिविधि होने पर, update_ab_test_variant को confirmLiveChange: true की आवश्यकता होती है। वेरिएंट केवल तभी जोड़े या हटाए जा सकते हैं जब परीक्षण ड्राफ़्ट हो, और लाइव-अनुक्रम परिवर्तनों के लिए भी पुष्टि की आवश्यकता होती है क्योंकि वे तुरंत रोटेशन बदलते हैं।

अभियान

टूलविवरण
list_campaignsस्थिति या लेबल द्वारा पृष्ठांकित अभियानों की सूची बनाएं, जिसमें समीक्षक प्रतिक्रिया और डिलीवरी-गति फ़ील्ड शामिल हैं, जो खाता-व्यापी STO ऑडिट के लिए उपयोगी हैं।
get_campaignकिसी अभियान के लिए विवरण, आँकड़े, समीक्षक प्रतिक्रिया और रिकॉर्ड की गई डिलीवरी गति प्राप्त करें।
get_campaign_audienceसहेजी गई लक्ष्यीकरण, लापता संदर्भ, सरल-भाषा सारांश और लाइव प्राप्तकर्ता गणना हल करें।
list_campaign_goalsएक ईमेल अभियान के लिए संग्रहीत रूपांतरण लक्ष्यों की सूची बनाएं (SMS समर्थित नहीं है)।
create_campaign_goalएक ईवेंट, सब्सक्राइबर-विशेषता, या टैग-लागू ईमेल-अभियान रूपांतरण लक्ष्य जोड़ें।
update_campaign_goalसंग्रहीत ईमेल-अभियान रूपांतरण लक्ष्य अपडेट करें।
delete_campaign_goalसंग्रहीत ईमेल-अभियान रूपांतरण लक्ष्य हटाएं।
list_email_sendsसंसाधन आईडी और URL के साथ हाल की डिलीवरी इतिहास खोजें, वैकल्पिक रूप से एक अनुक्रम चरण तक सीमित। सफल लाइव-परीक्षण भेजों को छोड़ दिया जाता है।
get_email_sendस्थायी ईमेल-भेजने वाले आईडी द्वारा कतारबद्ध, परीक्षण, भेजे गए, दबाए गए, या विफल डिलीवरी का निरीक्षण करें।
list_recipient_suppressionsसंबंधित दबाए गए प्राप्तकर्ताओं की सूची बनाएं, जिसमें संरक्षित वैश्विक अमान्य पते और शिकायतें शामिल हैं।
get_recipient_suppressionएक सटीक प्राप्तकर्ता के लिए स्थानीय बाउंस, शिकायत, ईमेल-स्वच्छता और क्षेत्रीय SES दमन जाँचें।
remove_recipient_suppressionवैश्विक, हार्ड-बाउंस और शिकायत सुरक्षा बनाए रखते हुए कार्यक्षेत्र सॉफ्ट-बाउंस वृद्धि हटाएं।
create_campaignसामग्री, डेटा और वैकल्पिक From/Reply-To पहचान ओवरराइड के साथ एक अभियान बनाएं।
update_campaignएक ड्राफ्ट अभियान अपडेट करें, जिसमें सामग्री, डेटा, पहचान, दर्शक और संग्रहीत STO कॉन्फ़िगरेशन शामिल हैं।
schedule_campaignएक अभियान शेड्यूल या पुनर्निर्धारित करें, वैकल्पिक रूप से STO और इसकी 1-24 घंटे की डिलीवरी विंडो ओवरराइड करें।
send_test_emailएक पते पर परीक्षण ईमेल भेजें।
render_emailसटीक ईमेल-सुरक्षित HTML प्रस्तुत करें और अनसुलझे टैग रिपोर्ट करें, जिसमें डिफ़ॉल्ट द्वारा छिपी टाइपो शामिल हैं।
cancel_campaignएक शेड्यूल या भेजने वाला अभियान रद्द करें।
pause_campaignएक भेजने वाला अभियान रोकें।
resume_campaignएक रोका गया अभियान फिर से शुरू करें, वैकल्पिक रूप से समय के साथ डिलीवरी फैलाएं।
delete_campaignएक अभियान हटाएं।
duplicate_campaignएक अभियान को नए ड्राफ्ट में डुप्लिकेट करें।
resend_campaign_to_non_openersमूल दर्शक सदस्यों के लिए एक ड्राफ्ट पुनर्भेज बनाएं जिन्होंने भेजे गए अभियान को नहीं खोला।

प्रॉम्प्ट-निर्मित अभियान एक API अनुरोध में उत्पन्न और संग्रहीत होते हैं और ड्राफ्ट बने रहते हैं। templateId, blocks, या html का उपयोग केवल तब करें जब मौजूदा सामग्री की प्रतिलिपि बनाना या संरक्षित करना हो, न कि एजेंट से इसे लिखवाने के लिए। बाद में संपादन के लिए एक खाली ड्राफ्ट बनाने के लिए सभी सामग्री फ़ील्ड छोड़ दें।

अभियान लक्ष्य उन प्राप्तकर्ताओं को श्रेय देते हैं जिन्हें वास्तव में कॉन्फ़िगर किए गए एट्रिब्यूशन विंडो के भीतर वह अभियान भेजा गया था; जब मौजूद हो तो एक खोलना या क्लिक मजबूत अंतिम-स्पर्श संकेत बना रहता है। ईवेंट लक्ष्यों के लिए triggerEventName आवश्यक है, सब्सक्राइबर-विशेषता लक्ष्यों के लिए attributePath आवश्यक है, और टैग-लागू लक्ष्यों के लिए triggerTagName आवश्यक है। अभियान एट्रिब्यूशन विंडो डिफ़ॉल्ट रूप से 168 घंटे होती है जब इसे छोड़ दिया जाता है।

प्रत्येक प्राप्तकर्ता के अपने समय क्षेत्र में समान दीवार-घड़ी समय पर डिलीवरी करने के लिए, schedule_campaign को sendInRecipientTimezone: true और एक IANA scheduledTimezone के साथ कॉल करें जो scheduledAt द्वारा दर्शाई गई दीवार घड़ी की पहचान करता है। संग्रहीत समय क्षेत्र के बिना संपर्कों को अभियान scheduledAt क्षण पर प्राप्त होता है। इस मोड को आवर्ती या फैली हुई डिलीवरी के साथ नहीं जोड़ा जा सकता।

भेजने का समय अनुकूलन प्रति अभियान कॉन्फ़िगर किया जाता है, कंपनी या अनुक्रम स्तर पर नहीं। इसे list_campaigns के साथ अभियानों में ऑडिट करें, या एक अभियान का निरीक्षण get_campaign के साथ करें। sendTimeOptimization और sendTimeWindowHours (1-24, डिफ़ॉल्ट 12) को update_campaign के साथ ड्राफ्ट पर सेट करें, या शेड्यूलिंग के दौरान schedule_campaign के साथ उन्हें ओवरराइड करें। spreadOverHours प्राथमिकता लेता है और STO को अक्षम करता है, जैसा कि प्राप्तकर्ता-समय क्षेत्र डिलीवरी करता है। अनुक्रम इसके बजाय sendingWindow का उपयोग करते हैं, जो प्रति-प्राप्तकर्ता अनुमानित भेजने के समय के बजाय एक साझा अनुमत-घंटे/दिन गेट है।

अभियान- और अनुक्रम-स्तरीय पहचान के लिए, fromEmail प्लस fromName मेलबॉक्स पर उस प्रदर्शन नाम के साथ प्रेषक पहचान का चयन करता है, इसे बनाता है जब आवश्यक हो, बिना अन्य समान-पते वाली पहचानों का नाम बदले। एक Reply-To पता इसके बजाय एक कंपनी-व्यापी सहेजा गया नाम रखता है: जब replyToName उस नाम से भिन्न होता है, सहेजा गया नाम रखा जाता है और सफल प्रतिक्रिया में warnings में पुनर्प्राप्ति मार्गदर्शन शामिल होता है।

send_email और send_test_email एक स्थायी emailSendId लौटाते हैं। उपयोग करें list_email_sends विषय/शीर्षक, प्राप्तकर्ता, डिलीवरी स्थिति, प्रकार, बाउंस प्रकार या स्रोत द्वारा हाल की आईडी खोजने के लिए; एक आईडी को get_email_send पर पास करें status, errorMessage, संग्रहीत बॉडी और डिलीवरी ईवेंट का निरीक्षण करने के लिए। डिलीवरी-सूची पंक्तियाँ 14 दिनों के लिए बनाए रखी जाती हैं। सफल लाइव-परीक्षण और अन्य परीक्षण भेजों को छोड़ दिया जाता है ताकि वे वास्तविक डिलीवरी को न दबाएँ। उन परीक्षण भेजों के उत्तर list_conversations में केवल तब दिखाई देते हैं जब इनबाउंड उत्तर कैप्चर सक्षम हो। कतार कार्य आंतरिक निष्पादन विवरण हैं और MCP अनुबंध के माध्यम से उजागर नहीं होते हैं। हर लौटाई गई डिलीवरी में एक सीधा डैशबोर्ड url होता है। list_recipient_suppressions का उपयोग संरक्षित वैश्विक अमान्य-प्राप्तकर्ता, संरक्षित कंपनी हार्ड-बाउंस और शिकायत पंक्तियों को हटाने योग्य कंपनी सॉफ्ट-बाउंस वृद्धि से अलग करने के लिए करें, और सटीक क्षेत्रीय स्थिति के लिए get_recipient_suppression का उपयोग करें। remove_recipient_suppression केवल कंपनी वृद्धि हटाता है; वैश्विक और Amazon SES खाता-स्तरीय दमन, शिकायतें, अनसब्सक्राइब और ईमेल-स्वच्छता सुरक्षाएँ बरकरार रहती हैं। एक स्थानीय स्वच्छता परिणाम bounced कारण का उपयोग करता है email_hygiene इसके स्रोत के रूप में, बिना सब्सक्राइबर की सहमति स्थिति बदले।

एजेंटों को पहले प्रयास से पहले send_email को कॉलर-स्वामित्व वाला idempotencyKey पास करना चाहिए और उसी तार्किक ईमेल के हर पुनः प्रयास के लिए इसे पुनः उपयोग करना चाहिए। Sequenzy 14 दिनों के लिए मूल emailSendId लौटाता है, बजाय एक और डिलीवरी बनाने के। विभिन्न भेजने के तर्कों के साथ कुंजी का पुनः उपयोग अस्वीकार कर दिया जाता है, इसलिए पुनः प्रयास लूप के अंदर एक नई कुंजी उत्पन्न न करें।

ईमेल ब्लॉक सशर्त प्रदर्शन नियम या conditional-group शाखाओं का उपयोग कर सकते हैं। शर्तें रेंडर-समय चर और सब्सक्राइबर विशेषताओं के साथ-साथ लाइव सब्सक्राइबर डेटा जैसे सेगमेंट/सूची सदस्यता, टैग, ईवेंट, जुड़ाव, सदस्यता/SMS स्थिति और Stripe या वाणिज्य खरीद का समर्थन करती हैं। लाइव-डेटा शर्तें सेगमेंट फ़िल्टर के समान फ़ील्ड मान और ऑपरेटरों का उपयोग करती हैं; संग्रहीत सब्सक्राइबर मिलान के बिना प्राप्तकर्ता OTHERWISE शाखा का उपयोग करते हैं।

कोर ब्लॉक आकार हैं { "type": "heading", "content": "Title", "level": 1 }, { "type": "text", "content": "<p>Copy</p>" }, { "type": "button", "text": "Book a call", "url": "https://example.com", "variant": "primary" } , and { "type": "image", "src": "https://...", "alt": "Description", "width": 100, "widthType": "percent" }. Buttons also accept content के रूप में text के लिए एक उपनाम और डिफ़ॉल्ट रूप से primary वैरिएंट। छवि widthType स्वीकार करता है percent या px।

YouTube वीडियो ब्लॉक एक वैकल्पिक कस्टम कवर स्वीकार करते हैं: { "type": "video", "videoUrl": "https://www.youtube.com/watch?v=...", "thumbnailUrl": "https://cdn.example.com/cover.jpg", "alt": "Watch the product tour" }। thumbnailUrl के बिना ब्लॉक बदलने से YouTube की अपनी स्थिर छवि बहाल होती है जबकि videoUrl क्लिक गंतव्य के रूप में रहता है।

कच्चा html एक अपारदर्शी ब्लॉक के रूप में संग्रहीत होता है। यह प्रदान किए गए मार्कअप को संरक्षित करता है लेकिन कंपनी लोगो, मूल ब्रांडेड अनुभाग या थीम-संचालित ब्लॉक डिज़ाइन नहीं जोड़ता। नए ब्रांडेड ड्राफ्ट के लिए prompt या संपादक-मूल डिज़ाइन के लिए blocks का उपयोग करें; MCP लेखन परिणामों में कच्चे HTML का उपयोग होने पर एक चेतावनी शामिल होती है।

खाता-व्यापी डिफ़ॉल्ट सेट करने के लिए fromEmail और/या replyTo के साथ update_company का उपयोग करें। fromEmail को एक कॉन्फ़िगर किया गया, सत्यापित भेजने वाला डोमेन उपयोग करना चाहिए; replyTo कोई भी मान्य मेलबॉक्स हो सकता है। create_campaign, update_campaign, create_sequence और update_sequence संसाधन-विशिष्ट ओवरराइड के लिए समान प्रत्यक्ष-पता फ़ील्ड स्वीकार करते हैं और आवश्यकता होने पर बैकिंग प्रोफ़ाइल बनाते हैं। मौजूदा डिफ़ॉल्ट प्रोफ़ाइल का नाम बदलने के लिए अकेले fromName या replyToName भेजें बिना उसका पता बदले। जब एक पते में कई प्रदर्शन नाम हों, तो सटीक प्रोफ़ाइल का चयन करने के लिए list_sender_profiles से senderProfileId या replyProfileId का उपयोग करें जिसे डिफ़ॉल्ट बनाना और नाम बदलना है।

update_company कंपनी के डिफ़ॉल्ट ईमेल थीम को भी प्रबंधित करता है emailTheme (presetId, colors, typography, layout) के माध्यम से। थीम अपडेट आंशिक हैं - छोड़े गए फ़ील्ड अपना वर्तमान मान (या प्रीसेट डिफ़ॉल्ट) रखते हैं और संख्यात्मक मान समर्थित श्रेणियों में क्लैम्प किए जाते हैं। कंपनी को प्लेटफ़ॉर्म डिफ़ॉल्ट थीम पर रीसेट करने के लिए emailTheme: null पास करें। लेआउट सेटिंग्स साझा baseRadius और एक अलग buttonRadius को नियंत्रित कर सकती हैं। colors के भीतर, background बाहरी कैनवास को पेंट करता है, content आंतरिक सामग्री कार्ड को पेंट करता है, और surface नेस्टेड कार्ड या टिंटेड टाइल्स को पेंट करता है। content छोड़ने से इसका वर्तमान मान संरक्षित रहता है; जब कोई सामग्री रंग संग्रहीत नहीं होता है, तो कार्ड background का अनुसरण करता है।

उत्तर ट्रैकिंग उसी कंपनी टूल पर उपलब्ध है। उपयोग करें replyTrackingEnabled, replyTrackingDomainMode (sequenzy या custom), और forwardReplies update_company के साथ। कंपनी रीड्स वर्तमान केवल-पढ़ने योग्य replyRetentionDays मान भी लौटाती हैं।

पोल और NPS सर्वेक्षण मूल ईमेल ब्लॉक हैं, इसलिए वे कहीं भी काम करते हैं जहाँ एक ईमेल टूल blocks स्वीकार करता है, जिसमें अभियान, टेम्पलेट, A/B वेरिएंट, लेन-देन टेम्पलेट और अनुक्रम ईमेल चरण शामिल हैं। लेन-देन पोल भेजों को दमन फ़िल्टरिंग और प्राप्तकर्ता डीडुप्लिकेशन के बाद बिल्कुल एक प्रभावी प्राप्तकर्ता तक हल करना चाहिए, और वह प्राप्तकर्ता पहले से ही एक सब्सक्राइबर के रूप में मौजूद होना चाहिए; अन्यथा Sequenzy भेजने को अस्वीकार कर देता है क्योंकि उत्तर लिंक सुरक्षित रूप से एट्रिब्यूट नहीं किया जा सकता। उत्तर-बटन पोल का उपयोग करें:

{
  "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"
}

For NPS, use "variant": "nps", an empty options array, and an attribute such as nps_score. The scale is always 0-10; optional npsLowLabel and npsHighLabel customize its captions. Each answer updates the subscriber attribute and fires poll.answered for automations and outbound webhooks.

Set "allowMultiple": true on a text-only options poll to open a hosted page where recipients can check several answers and save the whole selection at once. The subscriber attribute stores the selected-value list, so attribute segments should use contains. Multi-select polls cannot use option images or configurations whose encoded signed links exceed the delivery-safe size limit. Campaign poll summaries set allowMultiple: true, use respondent count for totalResponses, and can report answer percentages that add up past 100%.

Poll blocks also support brand-specific styling. accentColor recolors every appearance, including "brutal"; optionRadius sets answer-button corners in pixels (0 is square), independently of the container's styles.borderRadius; and questionColor recolors only the question. fontFamily applies to the poll. Use the optionFontSize, optionFontWeight, optionLetterSpacing, and optionTextTransform fields for answers, or the matching question* fields for the question. Sizes and spacing are pixels, weights range from 100 to 900, and text transforms are "none" or "uppercase".

सहेजे गए फ़ॉर्म

टूलविवरण
list_formsसहेजे गए फ़ॉर्म को उनकी सर्वर-प्रबंधित दर्शक सेटिंग्स, सामग्री ब्लॉक और सार्वजनिक क्रिया URL के साथ सूचीबद्ध करें।
create_formमानक ईमेल/नाम फ़ील्ड, दर्शक सेटिंग्स, थीम और सफलता व्यवहार के साथ एक सहेजा गया फ़ॉर्म बनाएं और प्रकाशित करें।
update_formएक सहेजे गए फ़ॉर्म को अपडेट करें, जिसमें उसकी पूर्ण क्रमबद्ध ब्लॉक सरणी और टाइप किए गए कस्टम फ़ील्ड शामिल हैं।
get_form_embedएक सहेजे गए फ़ॉर्म के लिए सार्वजनिक क्रिया URL, होस्टेड JavaScript, न्यूनतम मूल फ़ॉर्म और fetch उदाहरण लौटाएं।

Astro, Hugo, Jekyll, Cloudflare Pages, Netlify, GitHub Pages, या किसी अन्य स्थैतिक साइट के लिए, list_forms को कॉल करें, यदि कोई उपयुक्त फ़ॉर्म मौजूद नहीं है तो create_form का उपयोग करें, फिर get_form_embed को कॉल करें। लौटाया गया अपारदर्शी formId सार्वजनिक क्षमता है: सूचियाँ, टैग, डुप्लिकेट व्यवहार और सफलता हैंडलिंग सर्वर-साइड बनी रहती है, इसलिए तैनात ब्राउज़र कोड में कभी भी Sequenzy API कुंजी नहीं होती है। जनरेट किए गए मूल और स्टैंडअलोन मार्कअप में मुफ्त कार्यक्षेत्रों के लिए "Powered by Sequenzy" शामिल है; भुगतान किए गए कार्यक्षेत्रों को बिना ब्रांडिंग वाला मार्कअप मिलता है। API उस अधिकार को सर्वर-साइड हल करता है, इसलिए कॉल करने वालों को लौटाए गए स्निपेट का उपयोग अपरिवर्तित करना चाहिए। फ़ॉर्म अपडेट करते समय, छोड़े गए फ़ील्ड अपरिवर्तित रहते हैं और थीम फ़ील्ड वर्तमान थीम में मर्ज हो जाते हैं। टैग साफ़ करने के लिए एक खाली tagIds सरणी पास करें या पुष्टिकरण-संदेश व्यवहार को पुनर्स्थापित करने के लिए एक खाली redirectUrl पास करें। blocks फ़ील्ड एक पूर्ण प्रतिस्थापन है, इसलिए पहले list_forms के साथ वर्तमान सामग्री पढ़ें और ठीक एक आवश्यक ईमेल फ़ील्ड और एक सबमिट बटन बनाए रखें। कस्टम इनपुट को समर्थित fieldType के साथ form-field ब्लॉक के रूप में जोड़ें; चयन, रेडियो और चेकबॉक्स फ़ील्ड को विकल्पों की आवश्यकता होती है, जबकि छिपे हुए डिफ़ॉल्ट सर्वर-साइड लागू किए जाते हैं।

सहेजे गए पॉपअप

टूलविवरण
list_popupsसहेजे गए पॉपअप को स्थिति और सहभागिता आँकड़ों के साथ सूचीबद्ध करें, वैकल्पिक रूप से पूर्ण सामग्री सहित।
get_popupएक पॉपअप के ब्लॉक, ट्रिगर, लक्ष्यीकरण, शेड्यूल, आवृत्ति, थीम और प्रकाशित एम्बेड कोड प्राप्त करें।
create_popupएक प्रारंभिक टेम्पलेट से पॉपअप बनाएं, डिफ़ॉल्ट रूप से प्रकाशित, और उसकी तैनाती स्क्रिप्ट लौटाएं।
update_popupपॉपअप कॉपी, दर्शक, व्यवहार, थीम, ब्लॉक या प्रकाशन स्थिति को आंशिक रूप से अपडेट करें।
get_popup_embedगुप्त-मुक्त HTML, React/Next.js, WordPress और Shopify एम्बेड स्निपेट लौटाएं।
duplicate_popupएक पॉपअप को स्वतंत्र सहभागिता काउंटरों के साथ ड्राफ्ट में कॉपी करें।
delete_popupएक पॉपअप और उसके सहभागिता काउंटरों को स्थायी रूप से हटाएं।

पॉपअप तैनाती एक सार्वजनिक स्क्रिप्ट टैग का उपयोग करती है; API कुंजियाँ, दर्शक सेटिंग्स, ट्रिगरिंग, लक्ष्यीकरण, शेड्यूलिंग और आवृत्ति नियम सर्वर-साइड बने रहते हैं। पॉपअप डिफ़ॉल्ट रूप से हर सूची में कैप्चर होते हैं जब तक कि listIds प्रदान नहीं किया जाता है। जब ब्लॉक अपडेट करते हैं, तो पहले पॉपअप पढ़ें और पूर्ण प्रतिस्थापन सरणी भेजें, ठीक एक आवश्यक ईमेल फ़ील्ड और एक सबमिट बटन बनाए रखें। सेटिंग status को draft पर पॉपअप को उसके मौजूदा एम्बेड कोड को अमान्य किए बिना रोक देता है।

लैंडिंग पेज

टूलविवरण
list_landing_pagesलैंडिंग पेज को स्थिति, मेट्रिक्स, सामग्री और URL के साथ सूचीबद्ध करें।
get_landing_pageलैंडिंग पेज विवरण, बिल्डर सामग्री, मेट्रिक्स और प्रकाशित URL प्राप्त करें।
render_landing_pageप्रकाशित किए बिना, दृश्य गिनने या साइनअप एकत्र किए बिना एक हस्ताक्षरित 24-घंटे का आगंतुक पूर्वावलोकन लौटाएं।
create_landing_pageडिफ़ॉल्ट टेम्पलेट सामग्री या JSON से एक ड्राफ्ट लैंडिंग पेज बनाएं।
update_landing_pageलैंडिंग पेज का नाम, स्लग या पूर्ण संपादक-संगत सामग्री संपादित करें।
publish_landing_pageलैंडिंग पेज प्रकाशित करें, वैकल्पिक रूप से पहले संपादन सहेजें।
unpublish_landing_pageलैंडिंग पेज को ड्राफ्ट स्थिति में लौटाएं, वैकल्पिक रूप से पहले संपादन सहेजें।
duplicate_landing_pageएक लैंडिंग पेज को अद्वितीय स्लग के साथ नए ड्राफ्ट में डुप्लिकेट करें।
delete_landing_pageएक अप्रकाशित लैंडिंग पेज हटाएं।
connect_landing_page_domainएक कस्टम लैंडिंग पेज डोमेन कनेक्ट करें और DNS सेटअप विवरण लौटाएं।
update_landing_page_domain_settingsलैंडिंग पेज कस्टम डोमेन सेटिंग्स बदलें या सत्यापित करें।

लैंडिंग पेज सामग्री Sequenzy के संपादक-संगत JSON स्कीमा का उपयोग करती है जिसमें version, template, seo, theme और blocks शामिल हैं। SEO सेटिंग्स में faviconUrl और hideFromSearchEngines शामिल हैं; छिपे हुए पेज एक noindex निर्देश प्रकाशित करते हैं। प्रकाशित करने से पहले वर्तमान आगंतुक-सामना वाले पेज की समीक्षा करने के लिए render_landing_page का उपयोग करें। इसका हस्ताक्षरित previewUrl 24 घंटे के बाद समाप्त हो जाता है, यह सूचीबद्ध नहीं है, अनुक्रमित नहीं है, और पेज दृश्य नहीं बढ़ाता है; फ़ॉर्म दृश्यमान रहते हैं लेकिन संपर्क एकत्र नहीं करते हैं। ब्लॉक स्लॉट क्रम में प्रस्तुत होते हैं: top, hero, form, body, फिर footer; हीरो के ऊपर पूर्ण-चौड़ाई वाली घोषणा या बैनर के लिए top का उपयोग करें। बटन और मूल्य निर्धारण CTA URL बाहरी HTTPS गंतव्यों या इन-पेज एंकर जैसे #form, #section-<sectionId>, #block-<blockId> और #top स्वीकार करते हैं। प्रकाशित स्क्रॉल रिवील को नियंत्रित करने के लिए theme.sectionAnimation को none, fade, slide-up या zoom-in पर सेट करें, जिसमें theme.sectionAnimationSpeed को slow, normal या fast पर सेट किया गया हो। कस्टम लैंडिंग पेज सबडोमेन को pages.sequenzydns.com की ओर इशारा करते हुए CNAME रिकॉर्ड की आवश्यकता होती है; रूट डोमेन एक A रिकॉर्ड का उपयोग करते हैं जो 76.76.21.21 की ओर इशारा करता है, और उनका www होस्ट रूट पर रीडायरेक्ट करता है जब इसका CNAME pages.sequenzydns.com की ओर इशारा करता है। DNS परिवर्तन प्रसारित होने के बाद verify: true के साथ update_landing_page_domain_settings को कॉल करें।

अनुक्रम

टूलविवरण
list_sequencesडैशबोर्ड स्थिति, खोज, लेबल, सीमा और ऑफसेट फ़िल्टर के साथ अनुक्रम सूचीबद्ध करें।
get_sequenceab_tests:read, नोड्स, किनारों, लिंक्ड कॉपी और अनुक्रम भेजने की विंडो के साथ अनुक्रम विवरण, A/B वैरिएंट आईडी और ब्लॉक गणना प्राप्त करें।
list_sequence_enrollmentsपेजिनेशन और सटीक सूची/टैग/इवेंट/समय-आधारित प्रवेश विशेषता के साथ संपर्क नामांकन सूचीबद्ध करें। लाइव अनुक्रम परीक्षण नामांकन नहीं बनाते हैं।
send_sequence_test_email1-10 समीक्षकों को एक सहेजा गया action_email चरण भेजें; A/B चरणों की प्रति वैरिएंट जाँच की जाती है।
create_sequenceएक खाली डैशबोर्ड ड्राफ्ट या AI-जनरेटेड/स्पष्ट-चरण अनुक्रम बनाएं।
update_sequenceपहचान, सेटिंग्स, नामांकन, मौजूदा चरण, शाखा तर्क अपडेट करें, या रैखिक चरण सम्मिलित करें।
update_sequence_nodeएक मौजूदा अनुक्रम नोड का प्रकार-जागरूक पैच।
update_sequence_nodesकई मौजूदा अनुक्रम नोड्स को परमाणु रूप से पैच करें।
insert_sequence_stepकोई भी टाइप किया गया डैशबोर्ड चरण सम्मिलित करें, जिसमें AI जनरेशन, आउटबाउंड वेबहुक, प्रतीक्षा और वायर्ड शाखाएँ शामिल हैं।
edit_sequence_graphग्राफ़ नोड्स को स्थानांतरित करें, पुनः कनेक्ट करें, हटाएं या डुप्लिकेट करें; स्थानांतरित या पूर्ण प्राप्तकर्ताओं की रिपोर्ट करें।
simulate_sequenceनामांकन या भेजने के बिना वर्तमान मिलान, सक्रियण तत्परता और वैकल्पिक संपर्क की शाखा पथ का ड्राई-रन करें।
enable_sequenceएक अनुक्रम सक्रिय करें।
disable_sequenceएक अनुक्रम फ्रीज़ करें, नए नामांकन अवरुद्ध करें और वर्तमान प्राप्तकर्ताओं को रोकें।
duplicate_sequenceग्राफ़, ईमेल और अनुक्रम A/B परीक्षणों की एक स्वतंत्र ड्राफ्ट प्रति बनाएं।
archive_sequenceएक अनुक्रम को डैशबोर्ड संग्रह में ले जाएं और नए नामांकन रोकें।
unarchive_sequenceएक संग्रहीत अनुक्रम को अक्षम ड्राफ्ट के रूप में पुनर्स्थापित करें।
list_sequence_goalsकिसी अनुक्रम के लिए संग्रहीत इवेंट, सब्सक्राइबर-विशेषता और टैग-लागू रूपांतरण लक्ष्य सूचीबद्ध करें।
create_sequence_goalएक इवेंट, सब्सक्राइबर-विशेषता या टैग-लागू रूपांतरण लक्ष्य जोड़ें।
update_sequence_goalएक संग्रहीत अनुक्रम रूपांतरण लक्ष्य अपडेट करें।
delete_sequence_goalएक संग्रहीत अनुक्रम रूपांतरण लक्ष्य हटाएं।
get_sequence_inbound_webhookमानक MCP पर इनबाउंड URL, सेटअप स्थिति, नमूना और मैपिंग पढ़ें; OpenAI मार्ग क्रेडेंशियल-युक्त URL हटाता है।
configure_sequence_inbound_webhookएंडपॉइंट, फ़ील्ड मैपिंग और नमूना कॉन्फ़िगर करें; OpenAI मार्ग अपने परिणाम से क्रेडेंशियल-युक्त URL हटाता है।
rotate_sequence_inbound_webhook_secretएक इनबाउंड अनुक्रम एंडपॉइंट का गुप्त कुंजी घुमाएं और मानक MCP पर उसका प्रतिस्थापन URL लौटाएं; OpenAI-समीक्षित मार्ग से हटा दिया गया।
pause_sequence_enrollmentsएक सक्रिय अनुक्रम के लिए नए नामांकन रोकें जबकि वर्तमान प्राप्तकर्ता जारी रहें।
resume_sequence_enrollmentsवर्तमान प्राप्तकर्ताओं को बदले बिना एक सक्रिय अनुक्रम के लिए नए नामांकन फिर से खोलें।
enroll_subscribers_in_sequenceईमेल, सब्सक्राइबर आईडी या दोनों द्वारा 500 तक सब्सक्राइबर नामांकित करें, रीट्राई-सुरक्षित आइडेम्पोटेंसी के साथ।
cancel_sequence_enrollmentsसब्सक्राइबर या प्रवेश-इवेंट फ़ील्ड मानों द्वारा सक्रिय या प्रतीक्षा नामांकन रोकें।
realign_sequence_enrollmentsलाइव प्रतीक्षाओं को उनकी भेजने-विंडो खुलने पर पहले स्थानांतरित करने का पूर्वावलोकन या कतारबद्ध करें।
get_sequence_enrollment_realignmentएक लागू पुनर्संरेखण कार्य को पोल करें और उसका पूर्ण परिणाम या निरंतरता कर्सर पढ़ें।
delete_sequenceएक अनुक्रम हटाएं।

अनुक्रम निर्माण समर्थन करता है:

  • डैशबोर्ड से मेल खाने वाले खाली, अक्षम ट्रिगर-से-पूर्ण ड्राफ्ट के लिए केवल-नाम निर्माण।
  • डैशबोर्ड मेटाडेटा और डिलीवरी सेटिंग्स: description, labels, userCancellable, अनुक्रम BCC, और From/Reply-To पहचान।
  • trigger: "contact_added" के साथ listId, कई listIds, या listScope: any_contact (डिफ़ॉल्ट) हर जोड़े गए संपर्क को नामांकित करता है, जिसमें संपर्क भी शामिल हैं जो किसी सूची में शामिल नहीं होते, जबकि any_list वास्तविक सूची सदस्यता की प्रतीक्षा करता है।
  • trigger: "tag_added" के साथ tagName या कई tagNames; कोई भी कॉन्फ़िगर किया गया टैग संपर्क को नामांकित करता है।
  • सहेजे-सेगमेंट प्रवेश स्वचालन के लिए trigger: "segment_entered" प्लस segmentId।
  • विषय या बॉडी सामग्री में मर्ज टैग के लिए trigger: "event_received" प्लस {{event.*}}।
  • डैशबोर्ड-संगत वेबहुक प्रवेश नोड्स के लिए trigger: "inbound_webhook" प्लस एकीकरण मेटाडेटा।
  • trigger: "inactivity" प्लस eventName, inactiveDays, और वैकल्पिक inactivityBaseline (sequence_created_at या subscriber_created_at)।
  • AI-जनरेटेड ईमेल सामग्री के लिए goal।
  • लक्ष्य-आधारित AI-जनरेटेड ईमेल की प्रस्तुति चुनने के लिए emailStyle: "visual" या "plain"; छोड़े जाने पर, कंपनी की सहेजी गई प्राथमिकता उपयोग की जाती है।
  • Sequenzy blocks के साथ स्पष्ट steps।
  • HTML के साथ स्पष्ट steps, जिसे Sequenzy संपादन योग्य ब्लॉकों में परिवर्तित करता है।
  • स्पष्ट Update Subscriber चरण जो ट्रिगर-इवेंट गुणों को प्रोफ़ाइल फ़ील्ड या टाइप किए गए कस्टम विशेषताओं में कॉपी करते हैं।
  • delay / delayMs के माध्यम से निश्चित प्रतीक्षा, waitUntil के माध्यम से गतिशील दिनांक-फ़ील्ड प्रतीक्षा, या waitUntilWeekday के माध्यम से कैलेंडर गेट। { "day": "sunday", "startTime": "09:00", "endTime": "12:00", "timezone": "America/Los_Angeles" } जैसा सप्ताहांत गेट अगले मिलान विंडो तक प्रवाह को रोकता है। इसे ईमेल से ठीक पहले रखें ताकि वह भेजना विंडो के भीतर रहे; कोई भी हस्तक्षेप करने वाला चरण डिलीवरी को उसके बाहर स्थानांतरित कर सकता है। कतार पुनर्प्राप्ति विलंबित संपर्क को जारी करने से पहले विंडो की फिर से जाँच करती है।
  • गतिशील Stripe या Shopify छूट क्रिया चरण। एक create_discount चरण एक नया प्रदाता कोड बनाता है जब प्रत्येक सब्सक्राइबर उस तक पहुँचता है; बाद के ईमेल {{discount.code}}, {{discount.percentOff}}, और {{discount.expiresAt}} जैसे मर्ज टैग का उपयोग कर सकते हैं।
  • उत्पाद-, वैरिएंट-, ऑर्डर- या सब्सक्रिप्शन-विशिष्ट इवेंट स्वचालन के लिए enrollmentMode: "matching_field" और एक स्केलर enrollmentFieldPath। [] के साथ ऐरे ट्रैवर्सल propertyFilters में होता है, नामांकन कुंजी में नहीं।

कस्टम इवेंट ट्रिगर के लिए, सफल create_sequence परिणाम में eventTrackingCode और एक संरचित eventTracking ऑब्जेक्ट शामिल होता है। ऑब्जेक्ट में इवेंट एंडपॉइंट, पहचान और पेलोड अनुबंध, matching_field नामांकन के लिए आवश्यक कोई भी गुण पथ, सामान्यीकृत ट्रिगर propertyFilters, एक उदाहरण पेलोड, examplePayloadMatchesFilters, प्रत्यक्ष इवेंट API दस्तावेज़ URL, और get_integration_guide के लिए उपयोग-तैयार तर्क शामिल होते हैं। यदि मिलान स्थिति गलत है, तो examplePayloadNote और पेलोड अनुबंध का उपयोग करके उदाहरण को अनुकूलित करें। ड्राफ्ट अनुक्रम सक्षम करने से पहले इस इवेंट फ़ीड को जोड़ें और इसके आवश्यक गुणों को सत्यापित करें।

list_sequence_enrollments प्रत्येक पंक्ति के लिए enteredVia लौटाता है। सूची और सेगमेंट स्रोत अपनी स्थिर आईडी को value में रखते हैं और एक प्रदर्शन name हल करते हैं; टैग और इवेंट स्रोत अपने नाम value में बनाए रखते हैं। समय-आधारित ट्रिगर सामान्य प्राप्त-इवेंट नामांकन के रूप में गलत पहचाने जाने के बजाय inactivity या frequency रिपोर्ट करते हैं। लाइव अनुक्रम परीक्षण नामांकन नहीं बनाते हैं; वे पृथक परीक्षण ईमेल भेजते हैं और अनुक्रम परीक्षण रन पर गतिविधि रिकॉर्ड करते हैं इसके बजाय।

पुष्टि किए गए मैनुअल नामांकन बैच के लिए, idempotencyKey एक बार उत्पन्न करें और उस सटीक कुंजी को केवल समान क्रमबद्ध लक्ष्यों और targetNodeId के साथ पुनः उपयोग करें। रसीदें 14 दिनों तक रहती हैं। एक रीट्राई मूल enrolled, skipped, notFound, targetNodeId, और scheduledFor मानों को idempotentReplay: true के साथ लौटाता है; यह टोकन नहीं बनाता या बैच को फिर से कतारबद्ध नहीं करता।

उदाहरण गतिशील Shopify छूट चरण:

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

उदाहरण Update Subscriber चरण:

{
  "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" }
    ]
  }
}

संख्या और बूलियन मान शाब्दिक या एक स्टैंडअलोन मर्ज टैग होने चाहिए। उपयोग करें update_sequence.subscriberUpdateSteps एक action_update_attributes के साथ get_sequence से नोड आईडी किसी मौजूदा चरण के कॉन्फ़िगरेशन को बदलने के लिए। अनुक्रम अद्यतन insertSteps का समर्थन करते हैं, जो nodeId के बाद नए रैखिक चरण जोड़ने के लिए है, जो get_sequence द्वारा लौटाया गया है। afterNodeId को केवल तभी छोड़ें जब अनुक्रम में ठीक एक रैखिक पूंछ हो और आप उसमें जोड़ रहे हों। insertSteps ऐसे जोड़ने योग्य चरणों का समर्थन करता है जिन्हें साथी रिकॉर्ड की आवश्यकता नहीं होती, जैसे ईमेल, विलंब, टैग/सूची क्रियाएँ, विशेषता अद्यतन, छूट, शर्तें, घटना-प्रतीक्षा चरण, आउटबाउंड वेबहुक, और AI चरण। एक action_ai चरण के लिए एक मर्ज-टैग prompt, अद्वितीय resultKey, और एक या अधिक outputFields की आवश्यकता होती है; बाद के चरण {{ai.KEY.field}} के साथ उत्पन्न या फ़ॉलबैक टेक्स्ट पढ़ते हैं। संयुक्त आउटपुट-फ़ील्ड सीमाएँ चरण के 2000-टोकन प्रतिक्रिया बजट में फिट होनी चाहिए। विशिष्ट संपर्क संदर्भ को जनरेशन में शामिल करने के लिए includeTags, includeEventProperties, या includeAttributes का उपयोग करें, और विफलता व्यवहार चुनने के लिए onError (continue, exit, या fail) का उपयोग करें। बहु-पथ if/else शाखाओं के लिए branch का उपयोग करें; या तो branch या insertSteps प्रदान करें, दोनों नहीं। शाखा शर्तें has_tag और does_not_have_tag के साथ टैग उपस्थिति और अनुपस्थिति जाँच, साथ ही सूचियाँ, सहेजे गए खंड, घटनाएँ, क्लिक किए गए लिंक, और फ़ील्ड तुलनाओं का समर्थन करती हैं। प्रत्येक शाखा पथ नया steps, मौजूदा targetNodeId, या दोनों प्रदान कर सकता है; फ़ॉलबैक elseSteps और/या elseTargetNodeId का उपयोग करता है। एक लक्ष्य get_sequence द्वारा लौटाया गया पूर्णता नोड हो सकता है, इसलिए एक परमाणु अनुरोध उत्तरों को पूर्णता पर और Else को मौजूदा अनुवर्ती पर रूट कर सकता है। emails और steps सरणियाँ सामान्य action_email चरणों को nodeId, emailId, या सरणी क्रम द्वारा संपादित करती हैं। get_sequence.sequence.emails में action_ab_test प्रविष्टियाँ भी शामिल हैं; ab_tests:read के साथ, प्रत्येक abTest.variants[] प्रविष्टि में वैरिएंट ID, विषय, पूर्वावलोकन टेक्स्ट, और ब्लॉक गिनती होती है। ऑडिटिंग या कॉपी को फिर से लिखने से पहले पूर्ण वैरिएंट बॉडी के लिए get_ab_test को कॉल करें। एक स्थितीय अद्यतन जो एक पर पड़ता है, अस्वीकार कर दिया जाता है, और उसकी कॉपी को update_ab_test_variant के साथ प्रति वैरिएंट बदला जाना चाहिए; update_template या update_sequence_node के माध्यम से पुनः प्रयास न करें। नए चरण बनाने के लिए insertSteps का उपयोग करें और जब डाला गया ईमेल टाइमर की आवश्यकता हो तो चरण-स्तरीय delay, delayMs, waitUntil, या waitUntilWeekday शामिल करें। waitUntil ट्रिगर घटना से एक दिनांक फ़ील्ड के साथ वैकल्पिक offset, direction (before या after), और missingAction (continue या exit) स्वीकार करता है। waitUntilWeekday day या days, startTime, वैकल्पिक endTime (डिफ़ॉल्ट 24:00), और एक IANA timezone स्वीकार करता है; पहले से विंडो के भीतर संपर्क तुरंत जारी रहते हैं। सक्रिय अनुक्रमों के लिए, लाइव-फ्लो प्रभाव की पुष्टि करने के बाद ही confirmStructuralChange: true को insertSteps या branch के साथ पास करें।

insert_sequence_step हर साथी-रिकॉर्ड-मुक्त डैशबोर्ड चरण को सीधे उजागर करता है: ईमेल, SMS, विलंब, छूट, सब्सक्राइबर अद्यतन, टैग/सूची क्रिया, आउटबाउंड वेबहुक, AI जनरेशन, शर्त, प्रतीक्षा, और शाखा। बाद के {{ai.KEY.field}} मर्ज टैग के लिए प्रति-संपर्क टेक्स्ट उत्पन्न करने हेतु type: "ai" को prompt, resultKey, और outputFields के साथ सेट करें। आउटबाउंड वेबहुक url, method (POST या GET), और स्ट्रिंग-मूल्यवान headers स्वीकार करते हैं। ईमेल चरण लेन-देन मोड, प्रति-चरण पहचान, और CC/BCC डिलीवरी सेटिंग्स का समर्थन करते हैं। प्रतीक्षा गेट के लिए, सेट करें type: "logic_wait_for_event" को eventName, वैकल्पिक timeoutDays (1-365), और timeoutAction (continue या exit) के साथ। शाखा के लिए, सेट करें type: "logic_branch", टाइप किया हुआ branches प्रदान करें, और उनके लक्ष्यों को जोड़ें:

{
  "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"
}

get_sequence द्वारा लौटाया गया प्रत्येक लिंक किया गया ईमेल अपना प्रभावी emailPreset (branded या minimal) शामिल करता है, जो डैशबोर्ड में Style > Format से मेल खाता है। केवल उस लिंक किए गए ईमेल को बदलने के लिए emailPreset को emails/steps आइटम पर, या action_email नोड के changes में सेट करें, बिना कंपनी थीम बदले। यह डैशबोर्ड के समान प्रारूप परिवर्तन को मूल Sequenzy ब्लॉकों पर लागू करता है, जिसमें समर्थित कस्टम HTML ब्लॉक वाले ईमेल शामिल हैं। पूरी तरह से एक स्टैंडअलोन कच्चे HTML ब्लॉक के रूप में संग्रहीत ईमेल emailPreset के लिए null लौटाते हैं और प्रारूप परिवर्तनों का समर्थन नहीं करते। emailPreset को html या htmlContent के साथ नहीं जोड़ा जा सकता क्योंकि वे फ़ील्ड पूरे ईमेल को स्टैंडअलोन कच्चे HTML से बदल देते हैं।

अनुक्रम स्थिति के लिए, लिंक किए गए ईमेल और ईमेल नोड्स के शीर्ष स्तर पर structuralStepNumber को प्राथमिकता दें। यह वर्तमान ग्राफ़ से प्राप्त होता है और डैशबोर्ड में दिखाए गए चरण बैज से मेल खाता है। समानांतर शाखा ईमेल जानबूझकर समान संरचनात्मक गहराई साझा करते हैं, और एक असमान शाखा विलय लंबे आने वाले पथ से जारी रहता है। लिंक किए गए ईमेल और नोड कॉन्फ़िगरेशन में पुराना stepNumber फ़ील्ड पिछड़े संगतता के लिए संग्रहीत क्रमिक बना रहता है और ग्राफ़ संपादनों के बाद पुराना हो सकता है।

प्रत्येक लिंक किया गया ईमेल अपना संग्रहीत emailTheme ओवरराइड भी लौटाता है, या null जब यह कंपनी थीम का पालन करता है। केवल उस चरण को फिर से स्टाइल करने के लिए emailTheme को emails/steps आइटम पर या action_email नोड के changes में सेट करें। थीम अद्यतन आंशिक पैच हैं, इसलिए changes: { "emailTheme": { "colors": { "background": "#f3f4f6", "content": "#ffffff" } } } उस ईमेल को ग्रे बाहरी कैनवास और सफेद सामग्री कार्ड देता है जबकि उसके अन्य रंग, टाइपोग्राफी, और लेआउट बनाए रखता है। किसी भी रंग को छोड़ने से उसका वर्तमान मान बना रहता है। ओवरराइड हटाने और फिर से कंपनी थीम का पालन करने के लिए emailTheme: null पास करें। केवल तभी update_company का उपयोग करें जब खाता-व्यापी डिफ़ॉल्ट बदलना चाहिए।

केंद्रित इन-प्लेस संपादन के लिए update_sequence_node का उपयोग करें, या update_sequence_nodes जब कई नोड पैच परमाणु रूप से प्रतिबद्ध होने चाहिए। पहले get_sequence को कॉल करें: sequence.nodes में प्रत्येक आइटम में नोड id, nodeType, वर्तमान config, updatedAt, और updateHints शामिल हैं, जिसमें संपादन योग्य और प्रबंधित फ़ील्ड के साथ सटीक समवर्ती टोकन लौटाने के लिए शामिल है। उस टोकन को पुराने लेखन को अस्वीकार करने के लिए expectedUpdatedAt के रूप में पास करें। उपकरण हर संग्रहीत नोड प्रकार का समर्थन करते हैं, जिसमें विलंब, ईमेल/SMS सामग्री, क्रियाएँ, शर्तें, वेबहुक, टोपोलॉजी परिवर्तनों के बिना शाखा कॉन्फ़िगरेशन, और ट्रिगर शामिल हैं। 5-मिनट के विलंब को 7 दिनों में बदलने के लिए, उसके logic_delay नोड के लिए changes: { "delay": { "days": 7 } } भेजें। कई संस्थापक-शैली नोट्स को Minimal बनाने के लिए, उनके action_email नोड्स को changes: { "emailPreset": "minimal" } के साथ पैच करें। नोड-प्रकार रूपांतरण और किनारे/पथ परिवर्तन edit_sequence_graph में हैं। सक्रिय अनुक्रमों को उपयोगकर्ता के प्रभाव की पुष्टि करने के बाद confirmLiveChange: true की आवश्यकता होती है; पहले से प्रतीक्षा कर रहे प्राप्तकर्ता अपने मौजूदा निर्धारित टाइमस्टैम्प को बनाए रखते हैं।

मौजूदा और नए डाले गए ईमेल चरण अपनी स्वयं की From पहचान senderProfileId या fromEmail के साथ वैकल्पिक fromName, और अपनी Reply-To पहचान replyProfileId या replyTo के साथ वैकल्पिक replyToName सेट कर सकते हैं। एक अकेला fromName केवल उस चरण के दृश्य प्रेषक नाम को बदलता है। एक चरण-स्तरीय replyToName समान रूप से उस चरण के लिए दृश्य Reply-To नाम को ओवरराइड करता है बिना कंपनी-व्यापी उत्तर प्रोफ़ाइल का नाम बदले। स्पष्ट पहचान फ़ील्ड के बिना नए ईमेल चरण निकटतम अनुक्रम ईमेल की प्रभावी पहचान प्राप्त करते हैं। शाखा विलय के बाद, केवल प्रत्येक आने वाले पथ द्वारा साझा किए गए पहचान फ़ील्ड विरासत में मिलते हैं; संघर्षशील फ़ील्ड अनुक्रम या कंपनी डिफ़ॉल्ट का उपयोग करते हैं।

get_sequence से नवीनतम graphRevision के साथ edit_sequence_graph का उपयोग करके मौजूदा अनुक्रम को परमाणु रूप से पुनर्संरचित करें। यह एक नोड को दूसरे नोड से पहले या बाद में ले जा सकता है, स्पष्ट पुन: कनेक्शन या बहु-नोड पुन: क्रम के लिए सामान्यीकृत sequence.edges सरणी का पुन: उपयोग कर सकता है, एक नोड हटा सकता है, या एक नोड की गहरी प्रतिलिपि बना सकता है। A/B परीक्षण दोहराव स्वतंत्र परीक्षण, वैरिएंट, ईमेल, और स्थानीयकरण रिकॉर्ड रीसेट आँकड़ों के साथ बनाता है। एक शाखा के नीचे साझा नोड से पहले एक नोड ले जाना हर अभिसरण शाखा पथ को उस नोड के माध्यम से फिर से जोड़ता है। एक नोड हटाने से पार्क किए गए प्राप्तकर्ता तुरंत उसके अद्वितीय जीवित उत्तराधिकारी पर चले जाते हैं, या जब कोई उत्तराधिकारी नहीं बचता तो उन्हें पूरा करता है; परिणाम में sequence.migratedRecipientCount और sequence.completedRecipientCount का निरीक्षण करें। विलोपन तब अस्वीकार कर दिया जाता है जब पार्क किए गए प्राप्तकर्ताओं के पास कई जीवित निरंतरताएँ होंगी। पुराने संशोधन, अमान्य शाखा लेन, चक्र, और अप्राप्य नोड भी अस्वीकार कर दिए जाते हैं। सक्रिय अनुक्रमों को confirmStructuralChange: true की आवश्यकता होती है।

थोक रद्दीकरण लागू करने से पहले dryRun: true के साथ cancel_sequence_enrollments चलाएँ।

लाइव अनुक्रम की भेजने की विंडो बदलने के बाद realign_sequence_enrollments चलाएँ जब मौजूदा ईमेल-बद्ध प्रतीक्षाओं को नए उद्घाटन पर पहले स्थानांतरित करना चाहिए। यह डिफ़ॉल्ट रूप से dryRun: true है। dryRun: false पास करने से एक पृष्ठभूमि कार्य कतारबद्ध होता है और jobId लौटाता है; इसे get_sequence_enrollment_realignment के साथ पोल करें। जब एक पूर्ण परिणाम में hasMore: true हो, तो उसके साथ अगला बाउंडेड आवेदन कतारबद्ध करें nextCursor। लागू पुन: संरेखण लाइव डिलीवरी समय बदलता है और केवल उपयोगकर्ता के पूर्वावलोकन की पुष्टि करने के बाद उपयोग किया जाना चाहिए।

ईमेल ब्लॉक

उपकरणविवरण
get_email_block_schemaहर ईमेल ब्लॉक प्रकार सूचीबद्ध करें या एक प्रकार के आवश्यक फ़ील्ड, एनम मान, आइटम आकार, और उदाहरण का निरीक्षण करें।

किसी ब्लॉक प्रकार को हाथ से लिखने से पहले get_email_block_schema को कॉल करें जिसे आपने पहले उपयोग नहीं किया है। हर प्रकार सूचीबद्ध करने के लिए blockType छोड़ें, पूर्ण संदर्भ के लिए list या steps जैसा प्रकार पास करें, या संपादक द्वारा प्रबंधित प्रकार छिपाने के लिए creatableOnly: true पास करें। संग्रहीत group ब्लॉक संरचनात्मक संपादक सामग्री हैं: वे पुनरावर्ती रूप से चाइल्ड ब्लॉकों को Stack, Row, Grid, या एकल-छवि Overlay लेआउट में लपेटते हैं, लेकिन AI जनरेशन और creatableOnly जानबूझकर उन्हें छोड़ देते हैं। मौजूदा समूहीकृत सामग्री पढ़ते या अद्यतन करते समय उनके फ़ील्ड का निरीक्षण करने के लिए blockType: "group" का अनुरोध करें। सूचियाँ text के बजाय अपना स्वयं का ब्लॉक प्रकार हैं वैरिएंट: list आइटम content का उपयोग करते हैं, जबकि steps आइटम title और एक वैकल्पिक description का उपयोग करते हैं।

blocks स्वीकार करने वाले उपकरण एक ब्लॉक के styles ऑब्जेक्ट के अंतर्गत प्रति-ब्लॉक दृश्य स्टाइलिंग बनाए रखते हैं:

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

पुराने एजेंट प्रॉम्प्ट के साथ संगतता के लिए, शीर्ष-स्तरीय स्टाइल कुंजियाँ जैसे backgroundColor, backgroundOpacity, borderColor, borderWidth, और borderRadius भी स्वीकार की जाती हैं और styles के अंतर्गत सहेजी जाती हैं।

लेन-देन ईमेल

उपकरणविवरण
list_transactional_emailsटेम्पलेट खोजें/फ़िल्टर करें और डिलीवरी मेट्रिक्स द्वारा क्रमबद्ध करें; विषय और डैशबोर्ड URL लौटाता है।
get_transactional_emailID या स्लग द्वारा लेन-देन ईमेल पढ़ें।
create_transactional_emailप्रॉम्प्ट, HTML, या ब्लॉक से लेन-देन टेम्पलेट बनाएं।
update_transactional_emailलेन-देन मेटाडेटा या बॉडी सामग्री अद्यतन करें।
send_emailसाझा To, Cc, और Bcc प्राप्तकर्ताओं को टेम्पलेट या HTML द्वारा एक ईमेल भेजें।

प्रॉम्प्ट-निर्मित लेन-देन टेम्पलेट सर्वर-साइड उत्पन्न होते हैं और डिफ़ॉल्ट रूप से समीक्षा के लिए अक्षम होते हैं। स्पष्ट HTML या ब्लॉक टेम्पलेट सक्षम की संगतता डिफ़ॉल्ट बनाए रखते हैं; किसी भी डिफ़ॉल्ट को ओवरराइड करने के लिए enabled स्पष्ट रूप से पास करें। प्रत्यक्ष भेजने के लिए, to, subject, और html पास करें; MCP सर्वर html को ट्रांज़ैक्शनल API के body फ़ील्ड में मैप करता है। सहेजे गए ट्रांज़ैक्शनल ईमेल के लिए, उसका API स्लग संगतता-नामित templateId फ़ील्ड के माध्यम से पास करें। ट्रांज़ैक्शनल भेजने के लिए, to, cc, और bcc प्रत्येक एक पता या अधिकतम 50 तक की एक सरणी स्वीकार करते हैं। API एक साझा प्राप्तकर्ता सूची के साथ एक ईमेल भेजता है और to, फिर cc, फिर bcc प्राथमिकता क्रम में क्रॉस-फ़ील्ड डुप्लिकेट हटाता है। मार्केटिंग भेजने के लिए अभी भी ठीक एक स्वीकृत to पता आवश्यक है और अतिरिक्त प्राप्तकर्ताओं का समर्थन नहीं करता है। send_email चर दोहराए जाने वाले ब्लॉकों के लिए नेस्टेड सरणियों का समर्थन करते हैं, जैसे { "event": { "items": [...] } }। जब प्राप्तकर्ता बाहरी ID या ईमेल द्वारा संग्रहीत सब्सक्राइबर से मेल खाता है, तो सहेजे गए पहले और अंतिम नाम स्वचालित रूप से छोड़े गए नाम चर भर देते हैं। स्पष्ट मान, रिक्त सहित, प्राथमिकता लेते हैं। वैकल्पिक attachments सरणी अधिकतम 10 फ़ाइलें / कुल 7MB स्वीकार करती है। प्रत्येक आइटम को filename और Base64 content या एक सार्वजनिक HTTP(S) path में से ठीक एक की आवश्यकता होती है। HTML से संदर्भित CID छवि एम्बेड करने के लिए contentId सेट करें और वैकल्पिक रूप से MIME पहचान को ओवरराइड करने के लिए contentType सेट करें। जब trackingSettings छोड़ दिया जाता है, तो कंपनी के ट्रांज़ैक्शनल API ट्रैकिंग डिफ़ॉल्ट लागू होते हैं। एक भेजने के लिए लिंक पुनर्लेखन या ओपन पिक्सेल अक्षम करने के लिए trackingSettings.clickTracking: false या trackingSettings.openTracking: false का उपयोग करें। ये प्रति-भेज विकल्प केवल ऑप्ट आउट करते हैं; वे खाता-व्यापी या ट्रांज़ैक्शनल API डिफ़ॉल्ट द्वारा अक्षम ट्रैकिंग सक्षम नहीं कर सकते। उन डिफ़ॉल्ट का निरीक्षण या परिवर्तन करने के लिए get_tracking_settings और update_tracking_settings का उपयोग करें।

एजेंट और वर्कफ़्लो पुनर्प्रयासों के लिए, send_email में एक स्थिर idempotencyKey (अधिकतम 255 वर्ण) शामिल करें। प्रति तार्किक ईमेल एक कुंजी का उपयोग करें और पुनर्प्रयास करते समय समान तर्क भेजें; कुंजी 14 दिनों के लिए मान्य रहती है।

एनालिटिक्स

टूलविवरण
get_stats7d, 30d, या 90d के लिए समग्र आँकड़े प्राप्त करें; संरचनात्मक ईमेल प्रकार द्वारा फ़िल्टर करें।
get_transactional_statsID या स्लग द्वारा एक सहेजे गए ट्रांज़ैक्शनल ईमेल के लिए सभी-समय या समय-सीमित मेट्रिक्स प्राप्त करें।
get_campaign_statsअभियान प्रदर्शन, उत्तर मेट्रिक्स, संलग्न रूपांतरण लक्ष्य, और Poll/NPS सारांश प्राप्त करें।
list_poll_responsesप्रत्येक ब्लॉक के लिए प्रत्येक उत्तरदाता का नवीनतम Poll/NPS उत्तर, पहचान और प्रतिक्रिया समय के साथ सूचीबद्ध करें।
get_sequence_statsसमग्र और प्रति-चरण अनुक्रम प्रदर्शन के साथ-साथ वर्तमान नोड द्वारा लाइव सक्रिय/प्रतीक्षा नामांकन गणना प्राप्त करें।
list_email_metricsअभियान और अनुक्रम-चरण फ़नल, उत्तर, रूपांतरण, और राजस्व की तुलना करें, जिसमें क्रॉस-अनुक्रम चरण शामिल हैं।
list_campaign_eventsएक अभियान के लिए पृष्ठांकित कच्चे ईमेल इवेंट सूचीबद्ध करें।
list_sequence_eventsएक अनुक्रम के लिए पृष्ठांकित कच्चे इवेंट सूचीबद्ध करें, वैकल्पिक रूप से एक ईमेल चरण तक सीमित।
get_subscriber_activityसब्सक्राइबर ईमेल आँकड़े, गतिविधि, और नामांकन प्राप्त करें।

अभियान और अनुक्रम इवेंट फ़िल्टर डिलीवरी, बाउंस, शिकायत, सहभागिता, अनसब्सक्राइब, और विलंब इवेंट के साथ transport_failure स्वीकार करते हैं। परिवहन विफलताएँ MTA बुनियादी ढाँचे या ईग्रेस-पथ थकावट का वर्णन करती हैं; वे एक वैध प्राप्तकर्ता पते को बाउंस के रूप में वर्गीकृत नहीं करते हैं।

एनालिटिक्स टूल डिफ़ॉल्ट रूप से पहचाने गए बॉट, स्कैनर, लिंक-पूर्वावलोकन, और ट्रैक किए गए एसेट ओपन/क्लिक को बाहर करते हैं। जब आपको कच्चे सहभागिता निदान की आवश्यकता हो तो includeMachineEngagement: true को get_stats, get_campaign_stats, get_sequence_stats, get_ab_test_stats, get_subscriber, या get_subscriber_activity में पास करें; शामिल ओपन/क्लिक गतिविधि पंक्तियाँ machine, engagementQuality, और classificationReasons फ़ील्ड उजागर करती हैं जहाँ API इवेंट-स्तरीय गतिविधि लौटाता है।

get_sequence_stats.enrollmentCounts वर्तमान नोड द्वारा समूहीकृत सक्रिय और प्रतीक्षा नामांकन रन का एक लाइव बिंदु-समय स्नैपशॉट है। यह नामांकन टोकन गिनता है न कि आवश्यक रूप से अलग सब्सक्राइबर, और यह ऐतिहासिक period, start, या end फ़िल्टर द्वारा सीमित नहीं है।

अभियानों या अनुक्रम चरणों में तुलना के लिए list_email_metrics का उपयोग करें। अनुक्रमों में एक ही चरण को कुल करने के लिए वैकल्पिक sequenceId मानों के साथ step पास करें; प्राप्तकर्ताओं का निरीक्षण करने के लिए list_sequence_events या list_email_sends के साथ लौटाए गए automationNodeId का उपयोग करें। campaignId को sequenceId या step के साथ नहीं जोड़ा जा सकता। स्पष्ट अभियान और अनुक्रम दायरे शून्य गतिविधि वाले कॉन्फ़िगर किए गए ईमेल बनाए रखते हैं ताकि कमजोर प्रदर्शन करने वाले चुपचाप छोड़े न जाएँ।

Send API और ट्रांज़ैक्शनल SMTP डिलीवरी, ओपन, क्लिक, और उत्तर दरों के लिए get_stats में emailType: "transactional" पास करें। इसमें प्रत्यक्ष और सहेजे गए टेम्पलेट भेजना शामिल है। जब आपको एक डिलीवरी की स्थिति और इवेंट टाइमलाइन की आवश्यकता हो तो send_email द्वारा लौटाए गए emailSendId का उपयोग get_email_send के साथ करें। एक सहेजे गए ट्रांज़ैक्शनल ईमेल के लिए समग्र दरों की आवश्यकता होने पर get_transactional_stats का उपयोग करें। इसकी प्रतिक्रिया में शीर्ष क्लिक किए गए लिंक, शिकायतें, उत्तर, नवीनतम स्थायी/क्षणिक बाउंस वर्गीकरण, और अलग मानव और मशीन ओपन/क्लिक गणना शामिल हैं। प्रत्यक्ष-सामग्री भेजने में स्थिर टेम्पलेट ID नहीं होती है और खाता ट्रांज़ैक्शनल आँकड़ों के साथ-साथ डिलीवरी खोज के माध्यम से उपलब्ध रहती है।

जब एक अभियान Poll या NPS उत्तर एकत्र करता है, तो get_campaign_stats में एक शीर्ष-स्तरीय polls सरणी शामिल होती है। प्रत्येक सब्सक्राइबर अपने नवीनतम उत्तर का उपयोग करके प्रति poll ब्लॉक एक बार गिना जाता है। NPS सारांश में स्कोर, औसत, और प्रवर्तक/निष्क्रिय/आलोचक गणना शामिल हैं। ये आजीवन प्रतिक्रिया सारांश हैं भले ही सहभागिता मेट्रिक्स समय फ़िल्टर का उपयोग करें।

किसने क्या और कब उत्तर दिया यह पढ़ने के लिए list_poll_responses का उपयोग करें। यह प्रत्येक poll ब्लॉक के लिए प्रत्येक सब्सक्राइबर का नवीनतम उत्तर लौटाता है, नवीनतम पहले, जिसमें ईमेल, संग्रहीत मान, विशेषता कुंजी, और प्रतिक्रिया समय शामिल है। एक poll को सीमित करने के लिए blockId पास करें; एक अनुक्रम ईमेल चरण के लिए, इसका स्वचालन नोड ID campaignId के रूप में पास करें। सब्सक्राइबर विशेषताओं को स्कैन करके इस इतिहास का पुनर्निर्माण न करें: एक विशेषता में प्रतिक्रिया टाइमस्टैम्प नहीं होता है और बाद के ईमेल द्वारा उसी कुंजी का पुन: उपयोग करने पर इसे अधिलेखित किया जा सकता है।

एक गणना के पीछे सटीक ऐतिहासिक उत्तरदाताओं को सूचीबद्ध करने के लिए, फ़ील्ड pollResponse, ऑपरेटर is, और अभियान और सारांश के blockId तक सीमित JSON मान के साथ create_segment कॉल करें:

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

NPS के लिए, जैसे मिलान का उपयोग करें {"kind":"npsBucket","bucket":"detractors"}; मान्य बकेट हैं promoters, passives, और detractors। सारांश का attributeKey सब्सक्राइबर का वर्तमान/नवीनतम प्रतिक्रिया संग्रहीत करता है और बाद के poll द्वारा कुंजी का पुन: उपयोग करने पर अधिलेखित किया जा सकता है, इसलिए यह सटीक ऐतिहासिक ड्रिल-डाउन नहीं है।

टीम, इनबॉक्स, वेबहुक

टूलविवरण
list_team_membersटीम सदस्यों और लंबित निमंत्रण सूचीबद्ध करें।
invite_team_memberएक सहकर्मी को व्यवस्थापक या दर्शक के रूप में आमंत्रित करें, वैकल्पिक बिलिंग पहुँच के साथ।
cancel_team_invitationएक लंबित टीम निमंत्रण रद्द करें।
list_conversationsस्थिति और अपठित फ़िल्टर के साथ सब्सक्राइबर उत्तर वार्तालाप सूचीबद्ध करें।
get_conversationएक वार्तालाप और उसका संदेश इतिहास पढ़ें।
reply_to_conversationएक आउटबाउंड उत्तर कतारबद्ध करें या एक आंतरिक नोट जोड़ें।
update_conversation_statusएक वार्तालाप खोलें या बंद करें।
mark_conversation_readएक वार्तालाप में सभी संदेशों को पढ़े हुए के रूप में चिह्नित करें।
list_webhooksआउटबाउंड वेबहुक एंडपॉइंट सूचीबद्ध करें।
create_webhookएक एंडपॉइंट बनाएं और मानक MCP पर इसका एक-बार हस्ताक्षर रहस्य लौटाएं; OpenAI-समीक्षित मार्ग से हटा दिया गया।
update_webhookवेबहुक नाम, URL, इवेंट, या स्थिति अपडेट करें।
delete_webhookएक वेबहुक एंडपॉइंट और डिलीवरी इतिहास स्थायी रूप से हटाएं।
test_webhookएक वेबहुक एंडपॉइंट पर एक परीक्षण इवेंट भेजें।
list_webhook_deliveriesएक वेबहुक के लिए हाल के डिलीवरी प्रयास सूचीबद्ध करें।
replay_webhook_deliveryएक वेबहुक डिलीवरी फिर से चलाएँ।

प्रति-सूची सहमति परिवर्तन ऑप्ट-इन आउटबाउंड इवेंट के रूप में उपलब्ध हैं: subscriber.list_subscribed और subscriber.list_unsubscribed। उनके पेलोड सब्सक्राइबर और सूची की पहचान करते हैं, action को added या removed के रूप में रिपोर्ट करते हैं, और परिवर्तन source शामिल करते हैं (उदाहरण के लिए preferences_page, dashboard, api, या automation)।

थक गए MTA परिवहन पथ जैसे टर्मिनल डिलीवरी विफलताओं के लिए email.failed इवेंट का उपयोग करें। प्राप्तकर्ता बाउंस email.bounced का उपयोग जारी रखते हैं।

स्पष्ट-केवल campaign.sent इवेंट का उपयोग करें जब एक वर्कफ़्लो को एक ईमेल या SMS अभियान निपटाने के बाद एक टर्मिनल अधिसूचना की आवश्यकता होती है, जिसमें एक वैध शून्य-प्राप्तकर्ता भेजना शामिल है। यह तब नहीं जोड़ा जाता है जब create_webhook मानक MCP पर events छोड़ देता है; OpenAI-समीक्षित मार्ग पर, वेबहुक बनाते या संपादित करते समय इसे डैशबोर्ड में जोड़ें।

AI जनरेशन

टूलविवरण
generate_emailएक प्रॉम्प्ट से ब्रांडेड ईमेल ब्लॉक उत्पन्न करें।
generate_sequenceअप्रचलित उपनाम जो लक्ष्य-आधारित अनुक्रम ड्राफ्ट बनाए रखता है।
generate_subject_linesA/B विषय पंक्ति वेरिएंट उत्पन्न करें।

उत्पन्न ईमेल सामग्री में डिफ़ॉल्ट रूप से कंपनी का लोगो और फुटर शामिल होता है। generate_email कच्चे सामग्री ब्लॉकों के लिए applyBranding: false और अनसब्सक्राइब लिंक के बिना फुटर के लिए emailType: "transactional" स्वीकार करता है। प्रॉम्प्ट-आधारित अभियान कंपनी के कॉन्फ़िगर किए गए ईमेल फ़ॉन्ट विरासत में लेते हैं। उत्पन्न सामग्री समीक्षा के लिए ड्राफ्ट सामग्री के रूप में लौटाई जाती है। create_sequence का उपयोग करें एक अक्षम अनुक्रम ड्राफ्ट उत्पन्न करने और बनाए रखने के लिए जो list_sequences में दिखाई देता है; अप्रचलित generate_sequence उपनाम वही करता है।

SMS

टूलविवरण
generate_smsप्रॉम्प्ट से SMS कॉपी जनरेट करें।
get_sms_settingsSMS ऐड-ऑन तैयारी, क्रेडिट, डिफ़ॉल्ट और प्रावधानित नंबर पढ़ें।
get_sms_usageनंबर के अनुसार भेजे गए संदेश, डिलीवरी परिणाम, चार्ज किए गए क्रेडिट, अंतिम गतिविधि और परीक्षण भेजने की तुलना करें।
update_sms_number_labelकिसी नंबर का लेबल या प्रति-नंबर ब्रांड-उपसर्ग ओवरराइड अपडेट करें।
release_sms_numberकिसी नंबर को स्थायी रूप से कैरियर को लौटाएं और उसका वर्कस्पेस स्लॉट खाली करें।
send_test_smsएक परीक्षण संदेश भेजें, वैकल्पिक रूप से fromNumberId के साथ एक प्रावधानित प्रेषक चुनें।

release_sms_number अपरिवर्तनीय है। किसी जारी किए गए नंबर से जुड़े अभियान या अनुक्रम चरण अपने SMS भेजना छोड़ देंगे जब तक कि उन्हें किसी सक्रिय नंबर पर पुनर्निर्देशित नहीं किया जाता। get_sms_usage उत्पादन कुल को testSends से अलग रिपोर्ट करता है। जब send_test_sms fromNumberId को छोड़ देता है, तो यह उत्पादन भेजने के समान सबसे पुराने-सक्रिय-नंबर डिफ़ॉल्ट का उपयोग करता है। परीक्षण भेजना वास्तविक, क्रेडिट-चार्ज किए गए संदेश हैं जो शांत घंटों को बायपास करते हैं और प्रति कंपनी 100 तक सीमित हैं, 24 घंटे की रोलिंग विंडो में।

उत्पाद प्रतिक्रिया

submit_feedback का उपयोग केवल तब करें जब उपयोगकर्ता स्पष्ट रूप से सहायक से Sequenzy टीम को प्रतिक्रिया भेजने के लिए कहता है। मानक MCP में संरचित पुनरुत्पादन फ़ील्ड userIntent, toolCalls, expected, actual, और resourceIds शामिल हो सकते हैं जब उस रिपोर्ट के लिए आवश्यक हो। OpenAI-समीक्षित मार्ग केवल संदेश, श्रेणी और वैकल्पिक सामान्यीकृत वर्कफ़्लो संदर्भ स्वीकार करता है। असंबंधित सब्सक्राइबर डेटा, ईमेल सामग्री, कच्चे API पेलोड, डीबग डेटा या रहस्य शामिल न करें।

संसाधन

सर्वर केवल-पठनीय MCP संसाधन भी उजागर करता है।

संसाधनविवरण
sequenzy://dashboardपिछले 7 दिनों के लिए लाइव अवलोकन आँकड़े।
sequenzy://companyवर्तमान कंपनी और स्थानीयकरण सेटिंग्स।
sequenzy://campaigns/recentस्थिति और बुनियादी आँकड़ों के साथ पिछले 10 अभियान।
sequenzy://subscribers/recentसबसे हाल ही में जोड़े गए सब्सक्राइबर।
sequenzy://subscribers/engagedसबसे सक्रिय या व्यस्त सब्सक्राइबर।
sequenzy://sequencesस्थिति के साथ सभी अनुक्रम।
sequenzy://templatesस्थानीयकरण स्थिति के साथ टेम्पलेट।
sequenzy://segmentsसब्सक्राइबर गणना के साथ सहेजे गए सेगमेंट।
sequenzy://tagsउपयोग गणना के साथ टैग।
sequenzy://healthडिलीवरेबिलिटी मेट्रिक्स और स्वास्थ्य स्थिति।
sequenzy://email-blocksप्रत्येक ईमेल ब्लॉक प्रकार के लिए फ़ील्ड संदर्भ।
sequenzy://app-routesडैशबोर्ड रूट टेम्पलेट और सेटिंग्स टैब।

उदाहरण प्रॉम्प्ट

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?

सुरक्षा

  • साझा टीम रहस्यों के बजाय व्यक्तिगत API कुंजियों का उपयोग करें।
  • कुंजियाँ केवल उन कंपनियों तक पहुँचती हैं जिन्हें आपका Sequenzy उपयोगकर्ता एक्सेस कर सकता है।
  • जब एक्सेस की आवश्यकता न हो तो सेटिंग्स -> API कुंजियाँ से कुंजियाँ रद्द करें।
  • भेजने, शेड्यूलिंग, हटाने और बल्क परिवर्तनों के लिए क्लाइंट अनुमोदन प्रॉम्प्ट सक्षम रखें।
  • अभियानों और अनुक्रमों के लिए ड्राफ्ट वर्कफ़्लो पसंद करें, फिर लॉन्च से पहले Sequenzy में समीक्षा करें।

समस्या निवारण

SEQUENZY_API_KEY environment variable is required

MCP क्लाइंट कॉन्फ़िग में SEQUENZY_API_KEY सेट करें, या चलाएँ:

npx @sequenzy/setup

अमान्य API कुंजी

सेटिंग्स -> API कुंजियाँ में एक नई व्यक्तिगत कुंजी बनाएँ, अपना MCP कॉन्फ़िग अपडेट करें और क्लाइंट को पुनरारंभ करें।

API कुंजी स्कोप गायब

get_account को कॉल करें और apiKeyPermissions का निरीक्षण करें। स्थानीय कनेक्शन apiKeyPermissions.manageUrl खोलें, लोड की गई कुंजी में गायब स्कोप जोड़ें और पुनरारंभ किए बिना पुनः प्रयास करें। update_api_key यह केवल उन कंपनी कुंजियों के लिए कर सकता है जिनके पास पहले से api_keys:manage है; व्यक्तिगत कुंजियों को खाता-स्तरीय API कुंजियाँ पृष्ठ पर संपादित करें। होस्टेड OAuth कनेक्शन वैकल्पिक रूप से व्यापक अनुमतियों के साथ डिस्कनेक्ट और पुनः अधिकृत कर सकते हैं। टूल त्रुटि में आवश्यक सटीक स्कोप या स्कोप शामिल हैं।

डुप्लिकेट संसाधन

यदि कोई टूल कॉल एक डुप्लिकेट सेगमेंट नाम या भेजने वाला डोमेन बनाएगा, तो सर्वर एक स्थिर code, एक एजेंट-अनुकूल description, एक ठोस resolution, और एक docsUrl लौटाता है। सेगमेंट के लिए, list_segments को कॉल करें और मौजूदा सेगमेंट ID का पुनः उपयोग करें या एक अलग नाम चुनें। वेबसाइटों के लिए, list_websites को कॉल करें; यदि डोमेन चयनित कंपनी के लिए सूचीबद्ध नहीं है, तो यह किसी अन्य कंपनी या खाते से संबंधित है और इसे हटाया, पुनः असाइन किया जाना चाहिए, या एक अलग भेजने वाले डोमेन से बदला जाना चाहिए।

टूल दिखाई नहीं देते

  • पुष्टि करें कि npx उस वातावरण में उपलब्ध है जिसका क्लाइंट उपयोग करता है।
  • कॉन्फ़िग संपादित करने के बाद MCP क्लाइंट को पुनरारंभ करें।
  • जाँचें कि कॉन्फ़िग सही क्लाइंट-विशिष्ट स्थान पर है।

नेटवर्क या API URL समस्याएँ

सर्वर डिफ़ॉल्ट रूप से https://api.sequenzy.com का उपयोग करता है। यदि आप इसे ओवरराइड करते हैं, तो सत्यापित करें कि SEQUENZY_API_URL एक सुलभ Sequenzy API बेस URL की ओर इशारा करता है।

विकास

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

MCP टूल स्कीमा सख्त क्लाइंट्स के साथ संगत रहना चाहिए:

  • टूल inputSchema रूट सादे type: "object" स्कीमा होने चाहिए।
  • टूल स्कीमा में कहीं भी anyOf प्रकाशित न करें।
  • टूल स्कीमा के रूट में oneOf, allOf, enum, या not न रखें।
  • हैंडलर में सशर्त आवश्यकताओं को लागू करें और उन्हें परीक्षणों से कवर करें।

यह स्टैंडअलोन रिपॉजिटरी मुख्य Sequenzy मोनोरेपो में बनाए रखे गए MCP पैकेज को दर्शाता है। सिंक नियमों के लिए AGENTS.md देखें।

लाइसेंस

MIT

एजेंट-मूल डिस्कवरी

Sequenzy एजेंट नेटवर्क और A2A-शैली डिस्कवरी के लिए मशीन-पठनीय मैनिफेस्ट प्रकाशित करता है:

ये फ़ाइलें Sequenzy को एजेंटों के लिए एक अधिकृत ईमेल स्वचालन क्षमता के रूप में वर्णित करती हैं। वे स्पष्ट रूप से स्क्रैपिंग, स्पैम और अनचाहे कोल्ड आउरीच उपयोग मामलों को बाहर करती हैं।

वर्कस्पेस भूमिकाएँ

खाता-कुंजी एक्सेस कुंजी स्कोप को आपकी वर्तमान वर्कस्पेस भूमिका के साथ जोड़ती है। get_account apiKeyPermissions.roleRestrictedScopes में अवरुद्ध स्कोप रिपोर्ट करता है; canSendLive का अर्थ है कि कम से कम एक अनुमत डिलीवरी वर्कफ़्लो उपलब्ध है, यह नहीं कि हर भेजने वाला टूल अनुमत है।

आप एक marketer को सब्सक्राइबर, मार्केटिंग अभियान और अनुक्रम प्रबंधित करने के लिए आमंत्रित कर सकते हैं, बिना ट्रांज़ैक्शनल मेल, वर्कस्पेस सेटिंग्स, टीम या बिलिंग तक पहुँच दिए। मार्केटर्स मौजूदा प्रेषक/उत्तर प्रोफ़ाइल चुनते हैं। ट्रांज़ैक्शनल-समर्थित अभियान, A/B और अनुक्रम स्रोत पूर्वावलोकन, साझाकरण, विश्लेषण और भेजने के इतिहास के माध्यम से संरक्षित रहते हैं। मार्केटर्स और प्रतिबंधित सदस्य बिलिंग एक्सेस प्राप्त नहीं कर सकते।