Zinn® Campaigns API နှင့် MCP- ဆော့ဖ်ဝဲရေးသားသူ လမ်းညွှန်

ဒက်ရှ်ဘုတ်ပေါ်ရှိ Zinn® Campaigns တွင် သင်လုပ်ဆောင်နိုင်သမျှ အရာအားလုံးကို API မှတစ်ဆင့်လည်း လုပ်ဆောင်နိုင်ပြီး အများစုကို MCP မှတစ်ဆင့် သင့်အကောင့်နှင့် ချိတ်ဆက်ထားသော AI အကူအညီပေးသူထံမှလည်း လုပ်ဆောင်နိုင်ပါသည်။ ဤလမ်းညွှန်တွင် အကောင့်ဝင်ခြင်း၊ ခွင့်ပြုချက်များ၊ နည်းလမ်းနှစ်ခုစလုံးအတွက် ဥပမာတစ်ခု၊ ကန့်သတ်ချက်များ၊ အမှားအယွင်းများနှင့် Campaigns လုပ်ဆောင်ချက် ၈၉ ခုစလုံးကို အကျုံးဝင်ဖော်ပြထားသည်။ အောက်ဖော်ပြပါ လုပ်ဆောင်ချက်စာရင်းကို ကျွန်ုပ်တို့၏ API သတ်မှတ်ချက်များမှ ထုတ်ယူထားသောကြောင့် API လုပ်ဆောင်သည့်အရာနှင့် အမြဲတမ်း ကိုက်ညီမှုရှိပါသည်။ လုပ်ဆောင်ချက်တိုင်း၏ ကွက်လပ်တိုင်းကို zinndigital.com/developers/api/zinn-campaigns ရှိ API ကိုးကားချက်တွင် ကြည့်ရှုနိုင်ပါသည်။

အကောင့်ဝင်ခြင်း

• API ကီးများ။ ဒက်ရှ်ဘုတ်ရှိ ဆက်တင်များ → API ကီးများ အောက်တွင် ကီးတစ်ခု ဖန်တီးပြီး ၎င်းကို Authorization: Bearer zdk_live_… အဖြစ် ပေးပို့ပါ (sandbox မုဒ်တွင် 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 လက်မှတ်ရေးထိုးခြင်း လျှို့ဝှက်ကုဒ်ကို သိမ်းဆည်းပါ။ သင်သည် 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။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• POST /v1/email-marketing/campaigns — အီးမေးလ် ကမ်ပိန်း မူကြမ်းတစ်ခု ဖန်တီးပါ။ လုပ်ဆောင်ချက် createEmailMarketingCampaign။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.manage၊ email_marketing.view။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• GET /v1/email-marketing/campaigns/{campaign_id} — အီးမေးလ် ကမ်ပိန်းတစ်ခု။ လုပ်ဆောင်ချက် getEmailMarketingCampaign။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.view။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• PATCH /v1/email-marketing/campaigns/{campaign_id} — မူကြမ်းတစ်ခုကို တည်းဖြတ်ပါ (သို့မဟုတ် မူကြမ်းအဖြစ် ပြန်လည်ရောက်ရှိသွားသော ငြင်းပယ်ခံရသည့် ကမ်ပိန်း)။ လုပ်ဆောင်ချက် updateEmailMarketingCampaign။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.manage၊ email_marketing.view။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• GET /v1/email-marketing/campaigns/{campaign_id}/lint — မပို့မီ ကမ်ပိန်း၏ စာသားတွင် ပေးပို့နိုင်စွမ်းဆိုင်ရာ ပြဿနာများ ရှိမရှိ စစ်ဆေးပါ။ လုပ်ဆောင်ချက် lintEmailMarketingCampaign။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.view။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• GET /v1/email-marketing/campaigns/{campaign_id}/report — ကမ်ပိန်းတစ်ခု၏ ကိန်းဂဏန်းများ။ လုပ်ဆောင်ချက် getEmailMarketingCampaignReport။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.view။ AI လက်ထောက်ထံမှ- ဟုတ်ကဲ့၊ 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 — Zinn® ခရက်ဒစ်လက်ကျန်ငွေမှ ပေးချေပြီး အဆက်အသွယ်တစ်ခုသို့ SMS တစ်စောင် ပေးပို့ပါ။ လုပ်ဆောင်ချက် 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 — SMS လက်ခံရန် သဘောတူထားသော စာရင်းပါ လူတိုင်းထံ SMS စတင်ပေးပို့ပါ — သို့မဟုတ် ခရက်ဒစ်ကြောင့် ခေတ္တရပ်ထားသည်ကို ပြန်လည်စတင်ပါ။ လုပ်ဆောင်ချက် sendSmsMarketingCampaign။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.manage, email_marketing.view။ AI အကူအညီပေးသူထံမှ- API နှင့် ဒက်ရှ်ဘုတ်တွင်သာဖြစ်သည်- ၎င်းသည် ငွေကြေး သို့မဟုတ် ခွင့်ပြုပမာဏကို ကုန်ကျစေသောကြောင့် လူတစ်ဦးက ကိုယ်တိုင်နှိပ်ရပါမည် (အခပေး SMS/WhatsApp မက်ဆေ့ဂျ်များကို ပေးပို့သည်)။
• GET /v1/email-marketing/sms/registrations/us — ဤအဖွဲ့အစည်း၏ US 10DLC မှတ်ပုံတင်ခြင်းနှင့် ကုန်ကျစရိတ်။ လုပ်ဆောင်ချက် getEmailMarketingUsRegistration။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.view။ AI အကူအညီပေးသူထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• POST /v1/email-marketing/sms/registrations/us — ဤအဖွဲ့အစည်း၏ အမှတ်တံဆိပ်နှင့် ကမ်ပိန်းကို US 10DLC အတွက် တင်သွင်းပါ (တင်သွင်းချိန်တွင် ကောက်ခံပါသည်)။ လုပ်ဆောင်ချက် submitEmailMarketingUsRegistration။ စစ်ဆေးပြီးသော ခွင့်ပြုချက်များ- email_marketing.manage, email_marketing.view။ AI အကူအညီပေးသူထံမှ- API နှင့် ဒက်ရှ်ဘုတ်တွင်သာဖြစ်သည်- ၎င်းသည် ငွေကြေး သို့မဟုတ် ခွင့်ပြုပမာဏကို ကုန်ကျစေသောကြောင့် လူတစ်ဦးက ကိုယ်တိုင်နှိပ်ရပါမည် (US 10DLC မှတ်ပုံတင်ခြင်းတွင် မိုဘိုင်းအော်ပရေတာ အခကြေးငွေများ ပါဝင်သည်)။

သင့်ကိုယ်ပိုင် အီးမေးလ်ဝန်ဆောင်မှုမှတစ်ဆင့် ကမ်ပိန်းများ (ပုံစံခွက်များ၊ ကဏ္ဍခွဲများ၊ ပယ်ဖျက်မှုများ)

• GET /v1/campaigns — အဖွဲ့အစည်း၏ ကမ်ပိန်းများ။ လုပ်ဆောင်ချက် listCampaigns။ AI အကူအညီပေးသူထံမှ- ဟုတ်ကဲ့၊ MCP မှတစ်ဆင့်။
• POST /v1/campaigns — ပုံစံခွက်နှင့် ပစ်မှတ်ပရိသတ်တို့မှ ကမ်ပိန်းတစ်ခု ဖန်တီးပါ။ လုပ်ဆောင်ချက် createCampaign။ AI အကူအညီပေးသူထံမှ- ဟုတ်ကဲ့၊ 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 — စစ်ထုတ်မှု ဝေါဟာရ၊ ၎င်း၏တန်ဖိုးစာရင်းများနှင့် magic tag များ။ လုပ်ဆောင်ချက် 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} — အဖွင့်ကို ခြေရာခံသည့် ပုံ (1x1 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 မှတစ်ဆင့်။