Zinn® Campaigns API និង MCP៖ ការណែនាំសម្រាប់អ្នកអភិវឌ្ឍន៍

អ្វីៗទាំងអស់ដែលលោកអ្នកអាចធ្វើបាននៅក្នុង Zinn® Campaigns នៅលើផ្ទាំងគ្រប់គ្រង លោកអ្នកក៏អាចធ្វើបានតាមរយៈ API ផងដែរ ហើយភាគច្រើននៃកិច្ចការទាំងនោះអាចធ្វើបានពីជំនួយការ AI ដែលបានភ្ជាប់ទៅគណនីរបស់អ្នកតាមរយៈ MCP។ ការណែនាំនេះរៀបរាប់អំពីការចូលប្រើ ប្រព័ន្ធអនុញ្ញាត ឧទាហរណ៍ជាក់ស្តែងតាមវិធីទាំងពីរ ដែនកំណត់ កំហុស និងរាល់ប្រតិបត្តិការទាំង 89 របស់ Campaigns។ បញ្ជីប្រតិបត្តិការខាងក្រោមត្រូវបានបង្កើតឡើងពីការបញ្ជាក់លម្អិតនៃ API របស់យើង ដូច្នេះវាត្រូវគ្នានឹងអ្វីដែល API ដំណើរការជានិច្ច។ គ្រប់ប្រឡោះទិន្នន័យនៃគ្រប់ប្រតិបត្តិការទាំងអស់គឺមាននៅក្នុងឯកសារយោង API តាមរយៈ zinndigital.com/developers/api/zinn-campaigns។

ការចូលប្រើ

• សោ API។ បង្កើតសោមួយនៅក្នុងផ្ទាំងគ្រប់គ្រងក្រោម ការកំណត់ → សោ API ហើយផ្ញើវាជា Authorization: Bearer zdk_live_… (សោ zdk_test_… ដំណើរការក្នុងទម្រង់ sandbox)។ ផ្ដល់សិទ្ធិ Campaigns ដែលសោត្រូវការ និងកុំផ្ដល់លើសពីនេះ។
• ជំនួយការ AI (MCP)។ ភ្ជាប់ Claude, ChatGPT, Cursor ឬម៉ាស៊ីនភ្ញៀវ MCP ណាមួយទៅកាន់ https://api.zinndigital.com/v1/mcp តាមរយៈការចូលគណនីពីកម្មវិធី ឬដោយប្រើថូខឹនភ្ជាប់ (zmcp_live_…)។ សូមមើល ការភ្ជាប់ 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

សូមស្នើជំនួយការរបស់អ្នកជាពាក្យសាមញ្ញ ឧទាហរណ៍ "ព្រាងអ៊ីមែល 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 — ត្រូវបាន​បដិសេធ​ចំពោះ​ជំនួយការ ដូច្នេះ​ការណែនាំ​ដែល​យល់​ខុស​មិន​អាច​ទៅដល់​អតិថិជន​របស់​អ្នក​បានឡើយ។ ជំនួយការ​រៀបចំ​សេចក្តីព្រាង អ្នក​ចុច ផ្ញើ នៅលើផ្ទាំងគ្រប់គ្រង ឬ​ហៅប្រើ API ដោយ​ផ្ទាល់ខ្លួនឯង។ ព័ត៌មានសម្ងាត់​ដូចជា​ពាក្យសម្ងាត់ SMTP ក៏​មិនដែល​ត្រូវបាន​បញ្ជូន​តាមរយៈ​ជំនួយការ​ដែរ៖ សូម​បញ្ចូល​ពួកវា​នៅក្នុង​ផ្ទាំងគ្រប់គ្រង។

ដែនកំណត់

• ១,២០០ សំណើ​ក្នុងមួយនាទី សម្រាប់​បុគ្គល ឬ API key នីមួយៗ និង ៦,០០០ សំណើ​ក្នុងមួយនាទី សម្រាប់​ស្ថាប័ន​នីមួយៗ។ ដែនកំណត់​ណា​ដែល​តឹងរ៉ឹង​ជាង គឺ​ត្រូវបាន​អនុវត្ត។
• ៦០០ សំណើ​ក្នុងមួយនាទី សម្រាប់​ការតភ្ជាប់ MCP នីមួយៗ។
• លើសពី​ដែនកំណត់ ចម្លើយ​គឺ 429 ជាមួយ​បឋមកថា Retry-After៖ សូម​រង់ចាំ​ចំនួន​វិនាទី​នោះ។
• ការបន្ថែម​សមាជិក​បញ្ជី​ទទួល​បាន​យ៉ាងច្រើន​បំផុត ១,០០០ អាសយដ្ឋាន​ក្នុង​មួយសំណើ កូតា​ទំនាក់ទំនង និង​អ៊ីមែល​នៃ​គម្រោង​របស់​អ្នក ត្រូវបាន​អនុវត្ត​ចំពោះ​អ្វីៗ​ទាំងអស់​ដែល​អ្នក​ធ្វើ​តាមរយៈ 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។

វ៉ិបហ៊ុក

លទ្ធផលនៃការចែកចាយមកកាន់ Zinn® Campaigns ពីអ្នកផ្តល់សេវាដែលផ្ញើអ៊ីមែលរបស់អ្នក៖

• ជាមួយនឹងអ្នកផ្តល់សេវាផ្ទាល់ខ្លួនរបស់អ្នក (ឧទាហរណ៍ Resend) សូមរក្សាទុកលេខសម្ងាត់ចុះហត្ថលេខាវ៉ិបហ៊ុករបស់វានៅលើការតភ្ជាប់ការផ្ញើនៅក្នុងផ្ទាំងគ្រប់គ្រង (Campaigns → ការផ្ញើ)។ អ្នកទទួលបាន 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 — ផ្ញើសារ 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 — បន្ថែមទំនាក់ទំនងទៅក្នុងបញ្ជីតាមរយៈអាសយដ្ឋានអ៊ីមែល (ច្រើនបំផុត 1,000 ក្នុងមួយសំណើ)។ ប្រតិបត្តិការ addEmailMarketingListMembers។ សិទ្ធិអនុញ្ញាតដែលបានពិនិត្យ៖ email_marketing.manage, email_marketing.view។ ពីជំនួយការ AI៖ បាទ/ចាស តាមរយៈ MCP។

ការនាំចូល

• 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។

ទម្រង់ចុះឈ្មោះ

• GET /v1/email-marketing/forms — ទម្រង់ចុះឈ្មោះ (double opt-in) ដែលថ្មីបំផុតនៅខាងមុខ មួយទំព័រ keyset។ ប្រតិបត្តិការ 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 — រក្សាទុកកូដសម្ងាត់ចុះហត្ថលេខា webhook របស់អ្នកផ្តល់សេវាអ៊ីមែលរបស់អ្នកសម្រាប់ការតភ្ជាប់នេះ។ ប្រតិបត្តិការ setEmailMarketingSenderWebhook។ សិទ្ធិដែលបានពិនិត្យ៖ email_marketing.manage, email_marketing.view។ ពីជំនួយការ AI៖ ត្រូវបានហៅដោយប្រព័ន្ធផ្សេងទៀត (អ្នកផ្តល់សេវា ឬអ្នកចូលមើល) មិនមែនដោយអ្នកទេ (រក្សាទុកកូដសម្ងាត់ webhook របស់អ្នកផ្តល់សេវា)។

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 ជាដាច់ខាត (តួខ្លឹមសារគឺជាសោ API របស់ ESP)។
• 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)។

ទំព័រសាធារណៈ និង webhook ចូល

• 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 — ទំព័របញ្ជាក់ double opt-in (មិនបាច់ចូលគណនី)។ ប្រតិបត្តិការ emailMarketingFormConfirmPage។ ពីជំនួយការ AI៖ ទំព័រដែលអ្នកទទួលរបស់អ្នកបើកពីអ៊ីមែល (ទំព័របញ្ជាក់ double opt-in)។
• POST /v1/public/email-marketing/fc — បញ្ជាក់ការចុះឈ្មោះ (បន្ថែមបុគ្គលនោះទៅក្នុងបញ្ជីដែលមានកំណត់ត្រានៃការយល់ព្រម)។ ប្រតិបត្តិការ emailMarketingFormConfirm។ ពីជំនួយការ AI៖ ត្រូវបានហៅដោយប្រព័ន្ធផ្សេង (អ្នកផ្តល់សេវា ឬអ្នកចូលមើល) មិនមែនដោយអ្នកទេ (អ្នកចូលមើលបញ្ជាក់ពី double opt-in)។
• GET /v1/public/email-marketing/o/{token} — រូបភាពតាមដានការបើក (GIF ទំហំ 1x1)។ រាប់ការបើកម្តងក្នុងម្នាក់សម្រាប់អ្នកទទួល។ ប្រតិបត្តិការ 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៖ ត្រូវបានហៅដោយប្រព័ន្ធផ្សេងទៀត (អ្នកផ្តល់សេវា ឬអ្នកចូលមើល) មិនមែនដោយអ្នកទេ (webhook ចែកចាយ ESP ដែលបានចុះហត្ថលេខា)។
• POST /v1/webhooks/campaigns/telnyx — ការឆ្លើយតបសារ SMS ចូល (STOP / START) ពីក្រុមហ៊ុនផ្តល់សេវា SMS របស់យើង។ ប្រតិបត្តិការ receiveCampaignsTelnyxInbound។ ពីជំនួយការ AI៖ ត្រូវបានហៅដោយប្រព័ន្ធផ្សេងទៀត (អ្នកផ្តល់សេវា ឬអ្នកចូលមើល) មិនមែនដោយអ្នកទេ (webhook ចូល Telnyx ដែលបានចុះហត្ថលេខា)។
• POST /v1/webhooks/email-marketing/{connection_id} — ព្រឹត្តិការណ៍ចែកចាយនៃអ្នកផ្តល់សេវាអ៊ីមែលផ្ទាល់ខ្លួនរបស់អតិថិជនសម្រាប់ការតភ្ជាប់ផ្ញើមួយ។ ប្រតិបត្តិការ receiveEmailMarketingProviderWebhook។ ពីជំនួយការ AI៖ ត្រូវបានហៅដោយប្រព័ន្ធមួយផ្សេងទៀត (អ្នកផ្តល់សេវា ឬអ្នកចូលមើល) មិនមែនដោយលោកអ្នកទេ (webhook របស់អ្នកផ្តល់សេវា-អ្នកផ្ញើដែលមានហត្ថលេខា)។

លំហូរ

• GET /v1/email-marketing/flows — លំហូរអ៊ីមែល (ស្វាគមន៍, drip, កាលបរិច្ឆេទប្រចាំឆ្នាំ) មួយទំព័រ keyset។ ប្រតិបត្តិការ 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។