ज्ञानकोष

Zinn® Campaigns API र MCP: विकासकर्ता गाइड

साइन इन, अनुमतिहरू, उदाहरणहरू, सीमाहरू, त्रुटिहरू, वेबहुकहरू र प्रत्येक Zinn® Campaigns API सञ्चालन, साथै AI सहायकले MCP मार्फत कुन-कुन सञ्चालन गर्न सक्छ भन्ने विवरण।

ड्यासबोर्डमा तपाईंले Zinn® Campaigns मा गर्न सक्ने सबै कुरा तपाईं API मार्फत पनि गर्न सक्नुहुन्छ, र यसमध्ये धेरैजसो MCP मार्फत तपाईंको खातामा जोडिएको AI सहायकबाट गर्न सक्नुहुन्छ। यो निर्देशिकाले साइन इन गर्ने तरिका, अनुमतिहरू, दुवै तरिकाको एउटा विस्तृत उदाहरण, सीमाहरू, त्रुटिहरू र Campaigns का ८९ वटै सञ्चालनहरूलाई समेट्छ। तलको सञ्चालन सूची हाम्रो API विशिष्टताबाट सिर्जना गरिएको हो, त्यसैले यो सधैँ API ले गर्ने कामसँग मेल खान्छ। प्रत्येक सञ्चालनको प्रत्येक क्षेत्र zinndigital.com/developers/api/zinn-campaigns मा रहेको API सन्दर्भमा उपलब्ध छ।

साइन इन गर्दै

API कुञ्जीहरू। ड्यासबोर्डमा सेटिङहरू → API कुञ्जीहरू अन्तर्गत एउटा कुञ्जी सिर्जना गर्नुहोस् र यसलाई Authorization: Bearer zdk_live_… को रूपमा पठाउनुहोस् (स्यान्डबक्स मोडमा zdk_test_… कुञ्जीले काम गर्छ)। कुञ्जीलाई आवश्यक पर्ने क्याम्पेनका अनुमतिहरू मात्र दिनुहोस् र त्योभन्दा बढी केही होइन।
AI सहायकहरू (MCP)। एपबाट साइन इन गरेर वा जडान टोकन (zmcp_live_…) प्रयोग गरेर Claude, ChatGPT, Cursor वा कुनै पनि MCP क्लाइन्टलाई https://api.zinndigital.com/v1/mcp मा जडान गर्नुहोस्। तपाईंको खातामा Claude, Cursor वा ChatGPT जडान गर्दै हेर्नुहोस्। सहमति स्क्रिनमा, Zinn® Campaigns का अनुमतिहरूमा चिन्ह लगाउनुहोस्।
अनुमतिहरू। email_marketing.view ले क्याम्पेनहरू, सूचीहरू, सम्पर्कहरू, फारमहरू, प्रेषकहरू, SMS सेटिङहरू र रिपोर्टहरू पढ्छ; email_marketing.manage ले तिनलाई सिर्जना र परिवर्तन गर्छ। तपाईंले आफ्नो इमेल सेवा मार्फत पठाउनुहुने क्याम्पेनहरूले campaigns.view र campaigns.manage प्रयोग गर्छन्।
रिसेलरहरू। आफ्ना ग्राहक संस्थाहरू मध्ये कुनै एकमा कार्य गर्न org_id पास गर्नुहोस्। तपाईंको कुञ्जी वा जडानले ठ्याक्कै एउटा संस्थामा मात्र पहुँच पुर्‍याउँछ भने यसलाई छोड्नुहोस्।

उदाहरण: API मार्फत ड्राफ्ट क्याम्पेन सिर्जना गर्नुहोस्

curl -X POST https://api.zinndigital.com/v1/email-marketing/campaigns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Spring sale",
  "subject": "Our spring sale starts today",
  "list_id": "<list id>",
  "sender_id": "<sender id>",
  "template": "basic"
}'

मस्यौदासहितको उत्तर 201 हो। यसलाई POST /v1/email-marketing/campaigns/{campaign_id}/test मार्फत परीक्षण गर्नुहोस्, GET /v1/email-marketing/campaigns/{campaign_id}/lint मार्फत जाँच गर्नुहोस्, र POST /v1/email-marketing/campaigns/{campaign_id}/send मार्फत पठाउनुहोस्।

उदाहरण: AI सहायकबाट उही मस्यौदा

आफ्नो सहायकलाई सरल शब्दहरूमा सोध्नुहोस्, उदाहरणका लागि "'Our spring sale starts today' विषय भएको Spring sale नामक Zinn® Campaigns इमेलको मस्यौदा तयार गर्नुहोस्"। पृष्ठभूमिमा यसले api_operations_search मार्फत कार्य फेला पार्छ, api_operation_get मार्फत यसका प्यारामिटरहरू पढ्छ, र api_operation_call मार्फत यसलाई सञ्चालन गर्छ:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "api_operation_call",
    "arguments": {
      "operation_id": "createEmailMarketingCampaign",
      "confirm": true,
      "body": {
        "name": "Spring sale",
        "subject": "Our spring sale starts today"
      }
    }
  }
}

सहयोगीले के गर्दैन। तपाईंका प्रापकहरूलाई पठाउने वा पैसा वा भत्ता खर्च गर्ने कुनै पनि कुरा — क्याम्पेन पठाउने, SMS वा WhatsApp सन्देशहरू पठाउने, AI क्रेडिटहरू प्रयोग गरेर लेख्ने, US टेक्स्टिङका लागि दर्ता गर्ने — सहयोगीका लागि अस्वीकार गरिन्छ, ताकि गलत बुझिएको निर्देशन तपाईंका ग्राहकहरूसम्म कहिल्यै नपुगोस्। सहयोगीले मस्यौदा तयार गर्छ; तपाईंले ड्यासबोर्डमा Send थिच्नुहोस् वा आफैं API कल गर्नुहोस्। SMTP पासवर्ड जस्ता गोप्य कुराहरू पनि सहयोगी मार्फत कहिल्यै पठाइँदैन: तिनलाई ड्यासबोर्डमा प्रविष्ट गर्नुहोस्।

सीमाहरू

प्रत्येक व्यक्ति वा API कुञ्जीका लागि प्रति मिनेट १,२०० अनुरोधहरू, र प्रत्येक संस्थाका लागि प्रति मिनेट ६,००० अनुरोधहरू। दुईमध्ये कडा सीमा लागू हुन्छ।
प्रत्येक MCP जडानका लागि प्रति मिनेट ६०० अनुरोधहरू।
सीमा नाघेपछि, जवाफ Retry-After हेडरसहितको 429 हुन्छ: त्यति सेकेन्ड पर्खनुहोस्।
सूची सदस्यहरू थप्न प्रति अनुरोध बढीमा १,००० ठेगानाहरू लाग्छ; तपाईंको योजनाको सम्पर्क र इमेल भत्ताहरू तपाईंले API मार्फत गर्ने सबै कुरामा लागू हुन्छन्।

त्रुटिहरू

प्रत्येक त्रुटिको ढाँचा एउटै हुन्छ:

{"error": {"code": "UNPROCESSABLE_ENTITY", "message": "…", "details": [{"field": "subject", "code": "REQUIRED", "message": "…"}], "request_id": "…"}}

code एउटै समस्याको लागि कहिल्यै परिवर्तन हुँदैन, त्यसैले message को सट्टा यसलाई परीक्षण गर्नुहोस्। तपाईंले सहायता टोलीलाई सम्पर्क गर्दा request_id उद्धृत गर्नुहोस्। तपाईंले सामना गर्नुहुने उत्तरहरू: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS। 403 को अर्थ कुञ्जी वा जडानमा तलको सूचीले उल्लेख गरेको अनुमतिको अभाव छ; 404 ले तपाईंले देख्न नसक्ने संस्थाभित्रको कुरालाई पनि समेट्छ; 422 ले details मा प्रत्येक गलत फिल्ड सूचीबद्ध गर्दछ; 429 पछि, Retry-After हेडरमा तोकिएको सेकेन्डको सङ्ख्या पर्खनुहोस्।

Webhooks

डेलिभरी परिणामहरू तपाईंको इमेल पठाउने प्रदायकबाट Zinn® Campaigns भित्र आउँछन्:

तपाईंको आफ्नै प्रदायकको साथ (उदाहरणका लागि Resend), ड्यासबोर्डमा (अभियानहरू → पठाउने) पठाउने जडानमा यसको वेबहुक साइनिङ गोप्य कोड भण्डार गर्नुहोस्। तपाईंले webhook_url प्राप्त गर्नुहुन्छ; प्रदायकका डेलिभर भएका, बाउन्स भएका र उजुरी परेका घटनाहरूलाई यसमा लक्षित गर्नुहोस्। बाउन्स वा स्प्याम उजुरीले उक्त ठेगानालाई भविष्यका प्रेषणहरूबाट तुरुन्तै हटाउँछ।
Zinn® पठाउने सुविधाको साथ, सेटअप गर्नुपर्ने केही छैन।

प्रतिवेदन कार्यहरू मार्फत परिणामहरू पढ्नुहोस् (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport)।

प्रत्येक Campaigns सञ्चालन

अवलोकन

GET /v1/email-marketing — एक संस्थाको लागि Zinn® Campaigns अवलोकन। सञ्चालन getEmailMarketingOverview। जाँचिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

इमेल अभियानहरू

GET /v1/email-marketing/campaigns — इमेल अभियानहरू, नयाँ पहिला, एक keyset पृष्ठ। सञ्चालन listEmailMarketingCampaigns। जाँच गरिएका अनुमतिहरू: email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/campaigns — मस्यौदा इमेल अभियान सिर्जना गर्नुहोस्। सञ्चालन createEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/campaigns/{campaign_id} — एउटा इमेल अभियान। सञ्चालन getEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
PATCH /v1/email-marketing/campaigns/{campaign_id} — मस्यौदा सम्पादन गर्नुहोस् (वा अस्वीकृत अभियान, जुन फेरि मस्यौदामा फर्किन्छ)। सञ्चालन updateEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/campaigns/{campaign_id}/lint — अभियान पठाउनुअघि डेलिभरीसम्बन्धी समस्याहरूका लागि यसको प्रतिलिपि जाँच गर्नुहोस्। सञ्चालन lintEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/campaigns/{campaign_id}/report — अभियानका तथ्याङ्कहरू। सञ्चालन getEmailMarketingCampaignReport। जाँच गरिएका अनुमतिहरू: email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/campaigns/{campaign_id}/send — यसको सूचीमा अभियान पठाउन सुरु गर्नुहोस्। सञ्चालन sendEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा भत्ता खर्च गर्छ, त्यसैले कुनै व्यक्तिले यसलाई थिच्छ (वास्तविक प्राप्तकर्ताहरूलाई पठाउँछ र भत्ता खर्च गर्छ)।
POST /v1/email-marketing/campaigns/{campaign_id}/test — संगठनको सदस्यलाई अहिले एउटा परीक्षण प्रतिलिपि पठाउनुहोस्। सञ्चालन testEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/campaigns/{campaign_id}/translate — हराइरहेको वा पुरानो भएको प्रत्येक सम्पर्क भाषामा अभियान अनुवाद गर्नुहोस्। सञ्चालन translateEmailMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/campaigns/{campaign_id}/translations — अभियान सूचीको प्रत्येक सम्पर्क भाषा र यसको अनुवाद हालको हो वा होइन। सञ्चालन listEmailMarketingCampaignTranslations। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

AI को साथ लेखन

POST /v1/email-marketing/ai/write — Zinn® AI को मद्दतले संक्षिप्त विवरणबाट ड्राफ्ट अभियान इमेल लेख्नुहोस्। अपरेसन writeEmailMarketingCampaignWithAi। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा छुट खर्च गर्दछ, त्यसैले कुनै व्यक्तिले यो थिच्नुपर्छ (AI लेखनले AI क्रेडिट खर्च गर्छ)।

ब्रान्ड किट

GET /v1/email-marketing/brand-kit — संस्थाको ब्रान्ड किट (नाम, लोगो, रङहरू, फन्ट, आवाज)। अपरेसन getEmailMarketingBrandKit। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
PUT /v1/email-marketing/brand-kit — ब्रान्ड किट सम्पादन गर्नुहोस्। अपरेसन updateEmailMarketingBrandKit। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/brand-kit/read — संस्थाको वेबसाइटबाट ब्रान्ड किट पढ्नुहोस्। अपरेसन readEmailMarketingBrandKit। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

सम्पर्कहरू र एकपटक पठाइने सन्देशहरू

GET /v1/email-marketing/contacts — संस्थाका सम्पर्कहरू, एक पटकमा एउटा keyset पृष्ठ। सञ्चालन listEmailMarketingContacts। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/contacts/{contact_id}/messages — एउटा सम्पर्कलाई एउटा SMS पठाउनुहोस्, Zinn® क्रेडिट ब्यालेन्सबाट भुक्तानी गरिन्छ। सञ्चालन sendEmailMarketingMessage। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा भत्ता खर्च गर्छ, त्यसैले कुनै व्यक्तिले यसलाई थिच्छ (सम्पर्कलाई पठाइने एक पटकको सन्देशले भत्ता खर्च गर्छ)।
GET /v1/email-marketing/messages — संस्थाले पठाएका SMS र WhatsApp सन्देशहरू, सबैभन्दा नयाँ पहिले, एउटा keyset पृष्ठ। सञ्चालन listEmailMarketingMessages। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

सूचीहरू

GET /v1/email-marketing/lists — सदस्यता लिएका / सदस्यता रद्द गरिएका गणनाहरू सहित संस्थाका मेलिङ सूचीहरू। सञ्चालन listEmailMarketingLists। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/lists — मेलिङ सूची सिर्जना गर्नुहोस् (वा त्यो नाम भएको सूची फिर्ता गर्नुहोस्)। सञ्चालन createEmailMarketingList। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/lists/{list_id}/members — इमेल ठेगाना मार्फत सूचीमा सम्पर्कहरू थप्नुहोस् (प्रति अनुरोध बढीमा १,०००)। सञ्चालन addEmailMarketingListMembers। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

Imports

GET /v1/email-marketing/imports — विगतका सम्पर्क आयातहरू, सबैभन्दा नयाँ पहिले, एक पटकमा एक keyset पृष्ठ। सञ्चालन listEmailMarketingImports। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/imports — यसको सहमति प्रमाणीकरण सहित सम्पर्कहरूको एक अंश आयात गर्नुहोस्। सञ्चालन createEmailMarketingImport। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

Sign-up forms

GET /v1/email-marketing/forms — साइन-अप फारमहरू (डबल अप्ट-इन), सबैभन्दा नयाँ पहिले, एक कीसेट पृष्ठ। कार्य listEmailMarketingForms। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/forms — पुष्टि गरिएका व्यक्तिहरूलाई एउटा सूचीमा थप्ने साइन-अप फारम सिर्जना गर्नुहोस्। कार्य createEmailMarketingForm। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
DELETE /v1/email-marketing/forms/{form_id} — साइन-अप फारम मेटाउनुहोस् (पहिले नै पुष्टि गरिएका व्यक्तिहरू सूचीमा रहन्छन्)। कार्य deleteEmailMarketingForm। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
PATCH /v1/email-marketing/forms/{form_id} — साइन-अप फारम परिवर्तन गर्नुहोस् (शब्द, सूची, पुन:निर्देशन, अन वा अफ)। कार्य updateEmailMarketingForm। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

पठाउने कनेक्सनहरू

GET /v1/email-marketing/senders — संस्थाका पठाउने कनेक्सनहरू। अपरेसन listEmailMarketingSenders। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/senders — अभियान प्रेषक जडान गर्नुहोस् (Zinn® पठाउने, वा ग्राहकको आफ्नै SMTP सर्भर)। अपरेसन createEmailMarketingSender। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसमा एउटा गोप्य कुरा समावेश हुन्छ जुन कहिल्यै AI मोडेलमा पुग्नु हुँदैन (बडी नै SMTP पासवर्ड हो)।
DELETE /v1/email-marketing/senders/{sender_id} — पठाउने कनेक्सन र यसको भण्डारण गरिएको पासवर्ड हटाउनुहोस्। अपरेसन deleteEmailMarketingSender। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/senders/{sender_id}/verify — केही पनि नपठाई, पठाउने कनेक्सनले काम गर्छ भनी प्रमाणित गर्नुहोस्। अपरेसन verifyEmailMarketingSender। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
PUT /v1/email-marketing/senders/{sender_id}/webhook — यस कनेक्सनका लागि तपाईंको इमेल प्रदायकको वेबहुक साइनिङ गोप्य कुञ्जी भण्डारण गर्नुहोस्। अपरेसन setEmailMarketingSenderWebhook। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: अर्को प्रणाली (कुनै प्रदायक वा आगन्तुक) द्वारा कल गरिन्छ, तपाईंद्वारा होइन (प्रदायकको वेबहुक गोप्य कुञ्जी भण्डारण गर्दछ)।

SMS र WhatsApp

GET /v1/email-marketing/sms — SMS स्क्रिनलाई के चाहिन्छ — खुला?, रोकिएको?, क्रेडिट ब्यालेन्स र मूल्यहरू। अपरेसन getEmailMarketingSms। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/sms/campaigns — ठूलो संख्यामा पठाइने SMS अभियानहरू, सबैभन्दा नयाँ पहिले, एउटा keyset पृष्ठ। अपरेसन listSmsMarketingCampaigns। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/sms/campaigns — सूचीका लागि ड्राफ्ट SMS सिर्जना गर्नुहोस्। अपरेसन createSmsMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/sms/campaigns/{campaign_id} — एउटा ठूलो संख्याको SMS अभियान। अपरेसन getSmsMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — ड्राफ्ट सम्पादन गर्नुहोस् (वा अस्वीकृत अभियान, जुन पुनः ड्राफ्टमा फर्किन्छ)। अपरेसन updateSmsMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — एउटा ठूलो संख्याको SMS अभियानको तथ्याङ्क। अपरेसन getSmsMarketingCampaignReport। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — एसएमएस प्राप्त गर्न सहमत भएका सूचीका प्रत्येक व्यक्तिलाई एसएमएस पठाउन सुरु गर्नुहोस् — वा क्रेडिटका कारण रोकिएकोलाई पुन: सुरु गर्नुहोस्। सञ्चालन sendSmsMarketingCampaign। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। एआई सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा क्रेडिट खर्च गर्छ, त्यसैले कुनै व्यक्तिले नै यो थिच्नुपर्छ (शुल्क लाग्ने SMS/WhatsApp सन्देशहरू पठाउँछ)।
GET /v1/email-marketing/sms/registrations/us — यस संस्थाको US 10DLC दर्ता, र यसको कति खर्च लाग्छ। सञ्चालन getEmailMarketingUsRegistration। जाँच गरिएका अनुमतिहरू: email_marketing.view। एआई सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/sms/registrations/us — यस संस्थाको ब्रान्ड र अभियान US 10DLC का लागि पेस गर्नुहोस् (पेस गर्दा शुल्क लाग्छ)। सञ्चालन submitEmailMarketingUsRegistration। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। एआई सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा क्रेडिट खर्च गर्छ, त्यसैले कुनै व्यक्तिले नै यो थिच्नुपर्छ (US 10DLC दर्तामा क्यारियर शुल्क लाग्छ)।

तपाईंको आफ्नै इमेल सेवा मार्फत अभियानहरू (टेम्प्लेटहरू, खण्डहरू, दमनहरू)

GET /v1/campaigns — संस्थाका अभियानहरू। सञ्चालन listCampaigns। एआई सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns — टेम्प्लेट र लक्षित वर्गबाट एउटा अभियान सिर्जना गर्नुहोस्। सञ्चालन createCampaign। एआई सहायकबाट: हो, MCP मार्फत।
DELETE /v1/campaigns/esp — प्रदायकको खाता विच्छेद गर्नुहोस् र यसको भण्डारण गरिएको कुञ्जी हटाउनुहोस्। अपरेशन disconnectEsp। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसमा एउटा गोप्य विवरण हुन्छ जुन कहिल्यै AI मोडेलमा पुग्नु हुँदैन (भण्डारण गरिएको ESP कुञ्जी नष्ट गर्दछ)।
GET /v1/campaigns/esp — संस्थाको आफ्नै इमेल प्रदायक खाता। अपरेशन getEspConnection। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/esp — इमेल प्रदायक खाता जडान गर्नुहोस्। अपरेशन connectEsp। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसमा एउटा गोप्य विवरण हुन्छ जुन कहिल्यै AI मोडेलमा पुग्नु हुँदैन (बडी नै ESP API कुञ्जी हो)।
POST /v1/campaigns/esp/verify — प्रदायक खाताले काम गर्छ भनी प्रमाणित गर्नुहोस् र यसका प्रमाणित डोमेनहरू पढ्नुहोस्। अपरेशन verifyEspConnection। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसमा एउटा गोप्य विवरण हुन्छ जुन कहिल्यै AI मोडेलमा पुग्नु हुँदैन (भण्डारण गरिएको ESP कुञ्जी पुनः जाँच गर्दछ)।
POST /v1/campaigns/preview — उदाहरण मानहरूसहित टेम्प्लेट Render गर्नुहोस्। अपरेशन previewCampaignTemplate। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/segments — तपाईंका सुरक्षित गरिएका लक्षित वर्गका खण्डहरू। अपरेशन listCampaignSegments। जाँच गरिएका अनुमतिहरू: campaigns.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/segments — नयाँ लक्षित वर्गको खण्ड सुरक्षित गर्नुहोस्। अपरेशन createCampaignSegment। जाँच गरिएका अनुमतिहरू: campaigns.manage। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/segments/fields — फिल्टर शब्दावली, यसको मान सूचीहरू र जादुई ट्यागहरू। अपरेसन getCampaignSegmentFields। जाँच गरिएका अनुमतिहरू: campaigns.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/segments/preview — यसले कति व्यक्तिहरू सम्म पुग्छ, तिनीहरू को हुन्, र यसले कसलाई बाहिर राख्छ। अपरेसन previewCampaignSegment। जाँच गरिएका अनुमतिहरू: campaigns.view। AI सहायकबाट: हो, MCP मार्फत।
DELETE /v1/campaigns/segments/{segmentId} — सेग्मेन्टलाई सङ्ग्रह (अभिलेख) गर्नुहोस्। अपरेसन archiveCampaignSegment। जाँच गरिएका अनुमतिहरू: campaigns.manage। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/segments/{segmentId} — एउटा सुरक्षित गरिएको सेग्मेन्ट। अपरेसन getCampaignSegment। जाँच गरिएका अनुमतिहरू: campaigns.view। AI सहायकबाट: हो, MCP मार्फत।
PATCH /v1/campaigns/segments/{segmentId} — सेग्मेन्टको पुन: नामाकरण गर्नुहोस् वा यसका फिल्टरहरू परिवर्तन गर्नुहोस्। अपरेसन updateCampaignSegment। जाँच गरिएका अनुमतिहरू: campaigns.manage। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/suppressions — मार्केटिङ प्राप्त गर्न नहुने ठेगानाहरू। अपरेसन listCampaignSuppressions। जाँच गरिएका अनुमतिहरू: campaigns.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/suppressions — दमन (सप्रेसन) सूचीमा ठेगाना थप्नुहोस्। अपरेसन createCampaignSuppression। जाँच गरिएका अनुमतिहरू: campaigns.manage। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/tags — अभियान कम्पोजरले उपलब्ध गराउने म्याजिक-ट्याग प्यालेट। अपरेशन listCampaignTags। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/templates — संस्थाका अभियान टेम्प्लेटहरू। अपरेशन listCampaignTemplates। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/templates — अभियान टेम्प्लेट सिर्जना गर्नुहोस्। अपरेशन createCampaignTemplate। AI सहायकबाट: हो, MCP मार्फत।
DELETE /v1/campaigns/templates/{templateId} — टेम्प्लेट सङ्ग्रह गर्नुहोस् र यसका अनुवाद स्रोतहरू हटाउनुहोस्। अपरेशन archiveCampaignTemplate। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/campaigns/templates/{templateId} — एउटा अभियान टेम्प्लेट। अपरेशन getCampaignTemplate। AI सहायकबाट: हो, MCP मार्फत।
PUT /v1/campaigns/templates/{templateId} — अभियान टेम्प्लेट सम्पादन गर्नुहोस्। अपरेशन updateCampaignTemplate। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/unsubscribe — मार्केटिङ सूचीबाट बाहिरिनुहोस्। कुनै खाता आवश्यक पर्दैन। अपरेशन unsubscribeFromCampaigns। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसमा एउटा गोप्य विवरण हुन्छ जुन कहिल्यै AI मोडेलसम्म पुग्नु हुँदैन (प्राप्तकर्ताको हस्ताक्षर गरिएको सदस्यता खारेजी टोकन लिन्छ)।
DELETE /v1/campaigns/{campaignId} — अभियान मेटाउनुहोस् र यसका डेलिभरी पङ्क्तिहरू हटाउनुहोस्। अपरेशन deleteCampaign। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसका लागि त्यस्तो अनुमति चाहिन्छ जुन AI कनेक्सनहरूलाई दिइँदैन (ESP अभियान मेटाउन campaigns.send चाहिन्छ)।
GET /v1/campaigns/{campaignId} — एउटा अभियान र यसको डेलिभरी रिपोर्ट। सञ्चालन getCampaign। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/campaigns/{campaignId}/control — चालु रहेको पठाउने कार्यलाई पज गर्नुहोस्, पुन: सुरु गर्नुहोस् वा रद्द गर्नुहोस्। सञ्चालन controlCampaign। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा भत्ता खर्च गर्छ, त्यसैले कुनै व्यक्तिले यसलाई थिच्छ (प्रत्यक्ष पठाउने कार्य पज/पुन: सुरु गर्छ)।
POST /v1/campaigns/{campaignId}/send — दिगो पठाउने कार्य सुरु गर्नुहोस्। सञ्चालन sendCampaign। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसले पैसा वा भत्ता खर्च गर्छ, त्यसैले कुनै व्यक्तिले यसलाई थिच्छ (वास्तविक प्रापकहरूलाई ESP अभियान पठाउँछ)।
POST /v1/campaigns/{campaignId}/test — अभियानले वास्तवमा प्रयोग गर्ने च्यानलमा एउटा वास्तविक सन्देश पठाउनुहोस्। सञ्चालन testSendCampaign। AI सहायकबाट: API र ड्यासबोर्ड मात्र: यसका लागि AI जडानहरूलाई प्रदान नगरिएको अनुमति चाहिन्छ (ESP परीक्षण पठाउनका लागि campaigns.send चाहिन्छ)।

सार्वजनिक पृष्ठहरू र आगमन वेबहुकहरू

GET /v1/public/email-marketing/c/{token} — क्लिक काउन्टर। प्रति प्रापक एउटा क्लिक रेकर्ड गर्छ र मूल लिङ्कमा रिडिरेक्ट गर्छ। सञ्चालन emailMarketingClick। AI सहायकबाट: तपाईंका प्रापकहरूले इमेलबाट खोल्ने पृष्ठ (क्लिक-ट्र्याकिङ रिडिरेक्ट)।
GET /v1/public/email-marketing/f/{public_id} — साइन-अप फारमको होस्ट गरिएको पृष्ठ (कुनै लगइन आवश्यक छैन)। सञ्चालन emailMarketingFormPage। AI सहायकबाट: तपाईंका प्रापकहरूले इमेलबाट खोल्ने पृष्ठ (सार्वजनिक साइनअप फारम पृष्ठ)।
POST /v1/public/email-marketing/f/{public_id} — साइन-अप फारम पेश गर्नुहोस् (होस्ट गरिएको पृष्ठ, इम्बेड वा JSON)। अपरेशन emailMarketingFormSubmit। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (आगन्तुकले साइन-अप फारम पेश गर्दछ)।
GET /v1/public/email-marketing/fc — दोहोरो अप्ट-इन प्रमाणीकरण पृष्ठ (लगइन चाहिँदैन)। अपरेशन emailMarketingFormConfirmPage। AI सहायकबाट: तपाईंका प्राप्तकर्ताहरूले इमेलबाट खोल्ने पृष्ठ (दोहोरो अप्ट-इन प्रमाणीकरण पृष्ठ)।
POST /v1/public/email-marketing/fc — साइन-अप पुष्टि गर्नुहोस् (सहमति रेकर्डसहित व्यक्तिलाई सूचीमा थप्दछ)। अपरेशन emailMarketingFormConfirm। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (आगन्तुकले दोहोरो अप्ट-इन पुष्टि गर्दछ)।
GET /v1/public/email-marketing/o/{token} — ओपन-ट्र्याकिङ छवि (१x१ GIF)। प्रति प्राप्तकर्ता एक पटक खोलिएको गणना गर्दछ। अपरेशन emailMarketingOpenPixel। AI सहायकबाट: तपाईंका प्राप्तकर्ताहरूले इमेलबाट खोल्ने पृष्ठ (ओपन-ट्र्याकिङ पिक्सेल)।
GET /v1/public/email-marketing/u/{token} — फुटर सदस्यता खारेज गर्ने लिङ्क (लगइन चाहिँदैन)। अपरेशन emailMarketingUnsubscribePage। AI सहायकबाट: तपाईंका प्राप्तकर्ताहरूले इमेलबाट खोल्ने पृष्ठ (सदस्यता खारेज गर्ने पृष्ठ)।
POST /v1/public/email-marketing/u/{token} — RFC 8058 एक-क्लिक सदस्यता खारेजी (र पृष्ठको "सबै रोक्नुहोस्" बटन)। सञ्चालन emailMarketingUnsubscribeOneClick। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (RFC 8058 एक-क्लिक सदस्यता खारेजी)।
GET /v1/public/email-marketing/warmup-u/{token} — मार्केटिङ पूल वार्म-अप इमेलको सदस्यता खारेजी लिङ्क (लगइन आवश्यक पर्दैन)। सञ्चालन emailMarketingWarmupUnsubscribePage। AI सहायकबाट: तपाईंका प्रापकहरूले इमेलबाट खोल्ने पृष्ठ (वार्म-अप सदस्यता खारेजी पृष्ठ)।
POST /v1/public/email-marketing/warmup-u/{token} — वार्म-अप इमेलबाट RFC 8058 एक-क्लिक सदस्यता खारेजी। सञ्चालन emailMarketingWarmupUnsubscribeOneClick। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (वार्म-अप एक-क्लिक सदस्यता खारेजी)।
POST /v1/webhooks/campaign-events — इमेल प्रदायकबाट हस्ताक्षर गरिएको डेलिभरी घटना इन्जेस्ट गर्नुहोस्। सञ्चालन receiveCampaignDeliveryWebhook। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (हस्ताक्षर गरिएको ESP डेलिभरी वेबहुक)।
POST /v1/webhooks/campaigns/telnyx — हाम्रो SMS विक्रेताबाट आगमन SMS जवाफहरू (STOP / START)। सञ्चालन receiveCampaignsTelnyxInbound। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (हस्ताक्षर गरिएको Telnyx इनबाउन्ड वेबहुक)।
POST /v1/webhooks/email-marketing/{connection_id} — एउटा पठाउने जडानका लागि ग्राहकको आफ्नै इमेल प्रदायकको डेलिभरी घटनाहरू। सञ्चालन receiveEmailMarketingProviderWebhook। AI सहायकबाट: अर्को प्रणालीद्वारा कल गरिएको (प्रदायक वा आगन्तुक), तपाईंद्वारा होइन (हस्ताक्षरित प्रेषक-प्रदायक वेबहुक)।

Flows

GET /v1/email-marketing/flows — इमेल प्रवाहहरू (स्वागत, ड्रिप, वार्षिक मिति), एक किसेट पृष्ठ। सञ्चालन listEmailMarketingFlows। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/flows — एक प्रवाह सिर्जना गर्नुहोस् (यो ड्राफ्टको रूपमा सुरु हुन्छ)। सञ्चालन createEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
DELETE /v1/email-marketing/flows/{flow_id} — एक प्रवाह र यसका दर्ताहरू मेटाउनुहोस् (यसका पठाइएका रनहरू अभियानका रूपमा रहन्छन्)। सञ्चालन deleteEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
GET /v1/email-marketing/flows/{flow_id} — यसका चरणहरू र रिपोर्टसहितको एक प्रवाह (दर्ता भएको, प्रगतिमा रहेको, प्रति चरण रनहरू र प्राप्तकर्ताहरू)। सञ्चालन getEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
PATCH /v1/email-marketing/flows/{flow_id} — प्रवाह परिवर्तन गर्नुहोस्; steps दिइएको खण्डमा, यसले सम्पूर्ण क्रमलाई प्रतिस्थापन गर्दछ। सञ्चालन updateEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/flows/{flow_id}/activate — प्रवाह सुरु गर्नुहोस्; अबदेखि सूचीमा सामेल हुने व्यक्तिहरू मात्र दर्ता हुन्छन्। सञ्चालन activateEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।
POST /v1/email-marketing/flows/{flow_id}/pause — प्रवाह पज गर्नुहोस्; बाँकी चरणहरू प्रतीक्षामा रहन्छन् र यसलाई पुन: सक्रिय नगरेसम्म कसैलाई पनि नयाँ इमेल पठाइँदैन। सञ्चालन pauseEmailMarketingFlow। जाँच गरिएका अनुमतिहरू: email_marketing.manage, email_marketing.view। AI सहायकबाट: हो, MCP मार्फत।

ब्लगबाट पछिल्लो

होस्टिङ, SEO र ठूलो मात्रामा साइटहरू सञ्चालन गर्ने बारे हामीले लेखेका कुराहरू।

होस्टिङ तहबाट एसइओ र लिङ्क निर्माण: २०२६ का अपरेटरको दृष्टिकोण

सन् २०२६ मा होस्टिङले इन्डेक्सिङ र लिङ्क इक्विटीलाई कसरी रूप दिन्छ: पृष्ठहरूलाई इन्डेक्समा राखिराख्ने, निर्माण गर्नुअघि पुराना डोमेनहरू जाँच गर्ने, कुनै सर्च फुटप्रिन्ट बिना लिङ्क निर्माण गर्ने, र पूर्वाधारले एसइओका लागि के गर्न सक्छ र के गर्न सक्दैन भन्ने बारेमा इमानदार दृष्टिकोण।

July 21, 2026

पोस्ट पढ्नुहोस् →

WordPress लाई द्रुत र सुरक्षित बनाउने: कार्यसम्पादन र प्लगइन चेकलिस्ट

द्रुत, सुरक्षित WordPress का लागि एक व्यावहारिक चेकलिस्ट: सर्भर-स्तरको क्यासिङ, प्रति-साइट अब्जेक्ट क्यास, चलाउन लायक केही सीमित प्लगइनहरू, स्ट्याकलाई अद्यावधिक राख्ने, र तपाईंले कहिल्यै क्यास गर्न नहुने WooCommerce पृष्ठहरू।

July 20, 2026

पोस्ट पढ्नुहोस् →

२०२६ मा व्यवस्थित वेब होस्टिङ कसरी छनौट गर्ने: एक खरिदकर्ताको गाइड

कन्ट्रोल प्यानल भएको सस्तो बक्सबाट राम्रो व्यवस्थित होस्टिङलाई वास्तवमा केले फरक पार्छ — माइग्रेसन, ब्याकअप, अलगाव, वास्तविक क्यासिङ र इमानदार स्केलिंग — र तपाईंले प्रतिबद्ध हुनुअघि यसलाई कसरी मूल्याङ्कन गर्ने।

July 19, 2026

पोस्ट पढ्नुहोस् →

ब्लग पढ्नुहोस् →

अझै पनि समस्या भइरहेको छ?

सबै योजनाहरूमा सहयोग समावेश गरिएको छ, हेल्पडेस्क दिनको 24 घण्टा खुला रहन्छ, र तपाईंले हाम्रा कुनै पनि 58 भाषाहरूमा हामीलाई लेख्न सक्नुहुन्छ—हामी तपाईंले बुझ्ने भाषामा जवाफ दिन्छौं।

सहयोगलाई सम्पर्क गर्नुहोस् सबै लेखहरू