Све што можете да урадите у Zinn® Campaigns на контролној табли можете урадити и путем API-ја, а већину тога и преко AI асистента повезаног са вашим налогом путем MCP-а. Овај водич покрива пријављивање, дозволе, детаљан пример за оба начина, ограничења, грешке и сваку од 89 Campaigns операција. Листа операција у наставку генерисана је из наше API спецификације, тако да увек одговара ономе што API ради. Свако поље сваке операције налази се у API референци на zinndigital.com/developers/api/zinn-campaigns.
Пријављивање
- API кључеви. Креирајте кључ на контролној табли под Подешавања → API кључеви и пошаљите га као
Authorization: Bearer zdk_live_… (zdk_test_… кључ ради у пробном режиму). Доделите кључу само дозволе за 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 имејла под називом Spring sale са темом 'Наша пролећна распродаја почиње данас'“. У позадини он проналази операцију помоћу 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 лозинка се такође никада не преносе преко асистента: унесите их на контролној табли.
Ограничења
- 1.200 захтева у минуту за сваку особу или API кључ, и 6.000 захтева у минуту за сваку организацију. Примењује се строже од ова два.
- 600 захтева у минуту за сваку MCP везу.
- Преко ограничења, одговор је
429 са заглављем Retry-After: сачекајте толико секунди.
- Додавање чланова листе прихвата највише 1.000 адреса по захтеву; дозвољене квоте за контакте и имејлове из вашег пакета примењују се на све што радите преко 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), сачувајте тајну за потписивање његове веб-куке на вези за слање на контролној табли (Кампање → Слање). Добијате
webhook_url; усмерите догађаје испоручено, одбијено и жалбе добављача ка њему. Одбијање или жалба на непожељну пошту одмах уклања адресу из будућих слања.
- Са Zinn® слањем, нема шта да се подешава.
Прочитајте резултате помоћу операција извештавања (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).
Свака Campaigns операција
Преглед
GET /v1/email-marketing — Zinn® Campaigns преглед за једну организацију. Операција getEmailMarketingOverview. Проверене дозволе: email_marketing.view. Од вештачке интелигенције: да, преко 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-а.
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. Из АИ асистента: да, путем MCP-а.
POST /v1/email-marketing/senders — Повежите пошиљаоца кампање (Zinn® слање или сопствени SMTP сервер клијента). Операција createEmailMarketingSender. Проверене дозволе: email_marketing.manage, email_marketing.view. Из АИ асистента: само API и контролна табла: садржи тајну која никада не сме доспети до АИ модела (тело захтева је SMTP лозинка).
DELETE /v1/email-marketing/senders/{sender_id} — Уклоните везу за слање и њену сачувану лозинку. Операција deleteEmailMarketingSender. Проверене дозволе: email_marketing.manage, email_marketing.view. Из АИ асистента: да, путем MCP-а.
POST /v1/email-marketing/senders/{sender_id}/verify — Докажите да веза за слање ради, без слања ичега. Операција verifyEmailMarketingSender. Проверене дозволе: email_marketing.manage, email_marketing.view. Из АИ асистента: да, путем MCP-а.
PUT /v1/email-marketing/senders/{sender_id}/webhook — Сачувајте тајни кључ за потписивање веб-хука вашег добављача е-поште за ову везу. Операција setEmailMarketingSenderWebhook. Проверене дозволе: email_marketing.manage, email_marketing.view. Из АИ асистента: позива га други систем (добављач или посетилац), а не ви (чува тајни кључ веб-хука добављача).
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 — Речник филтера, његове листе вредности и магичне ознаке. Операција 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. Од АИ асистента: позива је други систем (провајдер или посетилац), а не ви (RFC 8058 одјава једним кликом).
GET /v1/public/email-marketing/warmup-u/{token} — Веза за одјаву из имејла за загревање маркетиншког пула (без пријављивања). Операција emailMarketingWarmupUnsubscribePage. Од АИ асистента: страница коју ваши примаоци отварају из имејла (страница за одјаву са загревања).
POST /v1/public/email-marketing/warmup-u/{token} — RFC 8058 одјава једним кликом са имејлова за загревање. Операција emailMarketingWarmupUnsubscribeOneClick. Од АИ асистента: позива је други систем (провајдер или посетилац), а не ви (одјава једним кликом са загревања).
POST /v1/webhooks/campaign-events — Пријем потписаног догађаја испоруке од провајдера имејл услуга. Операција receiveCampaignDeliveryWebhook. Од АИ асистента: позива је други систем (провајдер или посетилац), а не ви (потписани веб-хук испоруке ESP-а).
POST /v1/webhooks/campaigns/telnyx — Долазни SMS одговори (STOP / START) од нашег добављача SMS услуга. Операција receiveCampaignsTelnyxInbound. Од АИ асистента: позива је други систем (провајдер или посетилац), а не ви (потписани долазни веб-хук добављача Telnyx).
POST /v1/webhooks/email-marketing/{connection_id} — Догађаји испоруке клијентовог сопственог имејл добављача за једно слање везе. Операција receiveEmailMarketingProviderWebhook. Од стране AI асистента: позива је други систем (добављач или посетилац), а не ви (потписани веб-хук пошиљаоца-добављача).
Токови
GET /v1/email-marketing/flows — Имејл токови (добродошлица, кап по кап, годишњи датум), једна 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-а.