База от знания

Zinn® Campaigns API и MCP: ръководство за разработчици

Влизане, разрешения, примери, лимити, грешки, уебхукове и всяка операция от API на Zinn® Campaigns, включително кои от тях AI асистент може да изпълнява чрез MCP.

Zinn®, нашият викинг, чете контролния си списък до списък със статии, една от които е отворена.

Всичко, което можете да правите в 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.

Пример: същата чернова от ИИ асистент

Попитайте Вашия асистент с прости думи, например „създайте чернова на имейл в 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 съобщения, писане с кредити за изкуствен интелект, регистриране за US съобщения — се отказва на асистента, така че погрешно разбрана инструкция никога да не може да достигне до вашите клиенти. Асистентът подготвя черновата; вие натискате Изпрати в контролния панел или извиквате API сами. Конфиденциални данни като парола за SMTP също никога не се предават чрез асистент: въведете ги в контролния панел.

Ограничения

  • 1200 заявки в минута за всяко лице или API ключ и 6000 заявки в минута за всяка организация. Прилага се по-строгото от двете.
  • 600 заявки в минута за всяка MCP връзка.
  • При надвишаване на лимита отговорът е 429 със заглавна част Retry-After: изчакайте посочения брой секунди.
  • Добавянето на членове към списък приема най-много 1000 адреса на заявка; лимитите за контакти и имейли на вашия план се прилагат за всичко, което правите чрез 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), съхранете неговия таен ключ за подписване на уебкука във връзката за изпращане в таблото за управление (Campaigns → Sending). Получавате webhook_url; насочете събитията на доставчика за доставено, върнато и подадено оплакване към него. Върнато съобщение или оплакване за спам премахва адреса от бъдещи изпращания незабавно.
  • При изпращане със Zinn® няма нищо за настройване.

Прочетете резултатите с операциите за отчети (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).

Всяка операция на Campaigns

Общ преглед

  • GET /v1/email-marketing — Общ преглед на Zinn® Campaigns за една организация. Операция getEmailMarketingOverview. Проверени разрешения: email_marketing.view. От AI асистент: да, чрез MCP.

Имейл кампании

  • GET /v1/email-marketing/campaigns — Имейл кампании, най-новите първо, една страница от набор ключове. Операция 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. От асистент с изкуствен интелект: само през API и табло за управление: изразходва средства или лимит, така че се натиска от човек (писането с изкуствен интелект изразходва кредити за AI).

Комплект за бранд идентичност

  • GET /v1/email-marketing/brand-kit — Комплект за бранд идентичност на организацията (име, лого, цветове, шрифт, тон на комуникация). Операция getEmailMarketingBrandKit. Проверени разрешения: email_marketing.view. От асистент с изкуствен интелект: да, чрез MCP.
  • PUT /v1/email-marketing/brand-kit — Редактирайте комплекта за бранд идентичност. Операция updateEmailMarketingBrandKit. Проверени разрешения: email_marketing.manage, email_marketing.view. От асистент с изкуствен интелект: да, чрез MCP.
  • POST /v1/email-marketing/brand-kit/read — Извлечете комплекта за бранд идентичност от уебсайта на организацията. Операция readEmailMarketingBrandKit. Проверени разрешения: email_marketing.manage, email_marketing.view. От асистент с изкуствен интелект: да, чрез MCP.

Контакти и еднократни съобщения

  • GET /v1/email-marketing/contacts — Контактите на организацията, по една keyset страница наведнъж. Операция listEmailMarketingContacts. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/contacts/{contact_id}/messages — Изпращане на един SMS до един контакт, заплатен от кредитния баланс на Zinn®. Операция sendEmailMarketingMessage. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: само през API и табло за управление: изразходва пари или лимит, така че човек го натиска (еднократно съобщение до контакт изразходва лимит).
  • GET /v1/email-marketing/messages — SMS и WhatsApp съобщения, изпратени от организацията, най-новите първо, една keyset страница. Операция listEmailMarketingMessages. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез 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 — Добавете контакти към списък по имейл адрес (най-много 1000 на заявка). Операция 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 — Регистрационни формуляри (двойно потвърждение), най-новите първо, една страница с keyset. Операция listEmailMarketingForms. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/forms — Създаване на регистрационен формуляр, който добавя потвърдените потребители към един списък. Операция createEmailMarketingForm. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • DELETE /v1/email-marketing/forms/{form_id} — Изтриване на регистрационен формуляр (вече потвърдените потребители остават в списъка). Операция deleteEmailMarketingForm. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • PATCH /v1/email-marketing/forms/{form_id} — Промяна на регистрационен формуляр (текст, списък, пренасочване, включено или изключено). Операция updateEmailMarketingForm. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез 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. От ИИ асистент: да, чрез MCP.
  • GET /v1/email-marketing/sms/campaigns — Кампании за масови SMS съобщения, най-новите първо, една keyset страница. Операция listSmsMarketingCampaigns. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/sms/campaigns — Създайте чернова на SMS към списък. Операция createSmsMarketingCampaign. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id} — Една кампания за масови SMS съобщения. Операция getSmsMarketingCampaign. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Редактирайте чернова (или отхвърлена кампания, която се връща в чернова). Операция updateSmsMarketingCampaign. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Числата на кампания за масови SMS съобщения. Операция getSmsMarketingCampaignReport. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Започнете изпращането на SMS до всички в списъка, които са се съгласили да получават SMS — или възобновете кампания, спряна поради изчерпан кредит. Операция 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. От ИИ асистент: да, чрез MCP.
  • POST /v1/campaigns/segments/preview — До колко хора достига това, кои са те и кого пропуска. Операция previewCampaignSegment. Проверени разрешения: campaigns.view. От ИИ асистент: да, чрез MCP.
  • DELETE /v1/campaigns/segments/{segmentId} — Архивиране на сегмент. Операция archiveCampaignSegment. Проверени разрешения: campaigns.manage. От ИИ асистент: да, чрез MCP.
  • GET /v1/campaigns/segments/{segmentId} — Един запазен сегмент. Операция getCampaignSegment. Проверени разрешения: campaigns.view. От ИИ асистент: да, чрез MCP.
  • PATCH /v1/campaigns/segments/{segmentId} — Преименуване на сегмент или промяна на неговите филтри. Операция updateCampaignSegment. Проверени разрешения: campaigns.manage. От ИИ асистент: да, чрез MCP.
  • GET /v1/campaigns/suppressions — Адреси, които не трябва да получават маркетинг. Операция listCampaignSuppressions. Проверени разрешения: campaigns.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/campaigns/suppressions — Добавяне на адрес към списъка за изключване. Операция createCampaignSuppression. Проверени разрешения: campaigns.manage. От ИИ асистент: да, чрез 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. От ИИ асистент: извиква се от друга система (доставчик или посетител), а не от Вас (посетител изпраща регистрационен формуляр).
  • GET /v1/public/email-marketing/fc — Страницата за двойно потвърждение (без вход). Операция emailMarketingFormConfirmPage. От ИИ асистент: страница, която Вашите получатели отварят от имейл (страницата за двойно потвърждение).
  • POST /v1/public/email-marketing/fc — Потвърждаване на регистрация (добавя лицето към списъка със запис за съгласие). Операция emailMarketingFormConfirm. От ИИ асистент: извиква се от друга система (доставчик или посетител), а не от Вас (посетител потвърждава двойно съгласие).
  • GET /v1/public/email-marketing/o/{token} — Изображението за проследяване на отварянията (1x1 GIF). Отчита едно отваряне на получател. Операция emailMarketingOpenPixel. От ИИ асистент: страница, която Вашите получатели отварят от имейл (пикселът за проследяване на отварянията).
  • GET /v1/public/email-marketing/u/{token} — Връзката за отписване в долния колонтитул (без вход). Операция emailMarketingUnsubscribePage. От ИИ асистент: страница, която Вашите получатели отварят от имейл (страницата за отписване).
  • 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. От ИИ асистент: извиква се от друга система (доставчик или посетител), а не от Вас (подписан уебхук от доставчик-изпращач).

Flows

  • GET /v1/email-marketing/flows — Имейл потоци (за добре дошли, капкови, годишна дата), една страница с ключове. Операция listEmailMarketingFlows. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/flows — Създайте поток (започва като чернова). Операция createEmailMarketingFlow. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • DELETE /v1/email-marketing/flows/{flow_id} — Изтрийте поток и неговите записвания (неговите изпратени изпълнения остават като кампании). Операция deleteEmailMarketingFlow. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • GET /v1/email-marketing/flows/{flow_id} — Един поток с неговите стъпки и отчет (записани, в процес на изпълнение, стартирания и получатели за всяка стъпка). Операция getEmailMarketingFlow. Проверени разрешения: email_marketing.view. От ИИ асистент: да, чрез MCP.
  • PATCH /v1/email-marketing/flows/{flow_id} — Промяна на поток; когато е зададено, steps заменя цялата последователност. Операция updateEmailMarketingFlow. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/flows/{flow_id}/activate — Включване на поток; записват се само хора, които се присъединяват към списъка от този момент нататък. Операция activateEmailMarketingFlow. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.
  • POST /v1/email-marketing/flows/{flow_id}/pause — Поставяне на поток на пауза; дължимите стъпки изчакват и не се изпращат имейли на нови хора, докато не бъде включен отново. Операция pauseEmailMarketingFlow. Проверени разрешения: email_marketing.manage, email_marketing.view. От ИИ асистент: да, чрез MCP.

Най-новото от блога

Какво сме писали за хостинга, SEO и мащабното управление на сайтове.

SEO и изграждане на връзки от слоя на хостинга: Поглед на оператора за 2026 г.

Как хостингът влияе на индексирането и предаването на линк авторитет през 2026 г.: запазване на страниците индексирани, проверка на стари домейни преди изграждане върху тях, изграждане на линкове без SEO отпечатък и честен поглед върху това какво инфраструктурата може и не може да направи за SEO.

Прочетете публикацията →

Как да направите WordPress бърз и сигурен: контролен списък за производителност и плъгини

Практичен контролен списък за бърз и сигурен WordPress: кеширане на ниво сървър, обектен кеш за всеки сайт, малкото добавки, които си струва да използвате, поддържане на стека актуален и страниците на WooCommerce, които никога не трябва да кеширате.

Прочетете публикацията →

Как да изберете управляван уеб хостинг през 2026 г.: Ръководство за купувача

Какво всъщност отличава добрия управляван хостинг от евтина кутия с контролен панел — миграции, резервни копия, изолация, реално кеширане и честно мащабиране — и как да го прецените, преди да се ангажирате.

Прочетете публикацията →

Прочетете блога →

Все още се затруднявате?

Поддръжката е включена във всеки план, отделът работи 24 часа в денонощието и можете да ни пишете на всеки от нашите 58 езика — ние ви отговаряме на вашия.

Свържете се с поддръжката Всички статии