Zinn® Campaigns API i MCP: vodič za razvojne inženjere

Sve što možete učiniti na nadzornoj ploči u sklopu Zinn® Campaigns možete učiniti i putem API-ja, a većinu toga i putem AI asistenta povezanog s Vašim računom preko MCP-a. Ovaj vodič pokriva prijavu, dozvole, praktičan primjer za oba načina, ograničenja, pogreške i svaku od 89 Campaigns operacija. Popis operacija u nastavku generiran je iz naše API specifikacije, tako da uvijek odgovara onome što API radi. Svako polje svake operacije nalazi se u API referenci na zinndigital.com/developers/api/zinn-campaigns.

Prijava

• API ključevi. Izradite ključ na upravljačkoj ploči pod Postavke → API ključevi i pošaljite ga kao Authorization: Bearer zdk_live_… (ključ zdk_test_… radi u testnom načinu rada). Dodijelite ključu samo ona dopuštenja za Campaigns koja su mu potrebna i ništa više.
• AI asistenti (MCP). Povežite Claude, ChatGPT, Cursor ili bilo koji MCP klijent s https://api.zinndigital.com/v1/mcp, bilo prijavom iz aplikacije ili pomoću tokena za povezivanje (zmcp_live_…). Pogledajte Povezivanje alata Claude, Cursor ili ChatGPT s vašim računom. Na zaslonu za privolu označite dopuštenja za Zinn® Campaigns.
• Dopuštenja. email_marketing.view čita kampanje, popise, kontakte, obrasce, pošiljatelje, SMS postavke i izvješća; email_marketing.manage ih stvara i mijenja. Kampanje koje šaljete putem vlastite usluge e-pošte koriste campaigns.view i campaigns.manage.
• Preprodavači. Proslijedite org_id za djelovanje na jednoj od vaših klijentskih organizacija. Izostavite ga kada vaš ključ ili veza doseže točno jednu organizaciju.

Primjer: izradite skicu kampanje pomoću API-ja

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"
}'

Odgovor je 201 sa skicom. Testirajte ga pomoću POST /v1/email-marketing/campaigns/{campaign_id}/test, provjerite ga pomoću GET /v1/email-marketing/campaigns/{campaign_id}/lint i pošaljite ga pomoću POST /v1/email-marketing/campaigns/{campaign_id}/send.

Primjer: ista skica od AI pomoćnika

Zatražite od svog pomoćnika jednostavnim riječima, na primjer "izradi skicu e-poruke za Zinn® Campaigns pod nazivom Proljetna rasprodaja s predmetom 'Naša proljetna rasprodaja počinje danas'". U pozadini pronalazi operaciju pomoću api_operations_search, čita njezine parametre pomoću api_operation_get i pokreće je pomoću 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"
      }
    }
  }
}

Što asistent neće učiniti. Sve što šalje vašim primateljima ili troši novac ili kvotu — slanje kampanje, slanje SMS ili WhatsApp poruka, pisanje s AI kreditima, registracija za US slanje poruka — odbija se asistentu, tako da pogrešno shvaćena uputa nikada ne može doći do vaših korisnika. Asistent priprema skicu; vi pritisnete Pošalji na nadzornoj ploči ili sami pozovete API. Tajni podaci kao što je SMTP lozinka također se nikada ne prosljeđuju putem asistenta: unesite ih na nadzornoj ploči.

Ograničenja

• 1.200 zahtjeva u minuti za svaku osobu ili API ključ, te 6.000 zahtjeva u minuti za svaku organizaciju. Primjenjuje se strože od ta dva ograničenja.
• 600 zahtjeva u minuti za svaku MCP vezu.
• Iznad ograničenja odgovor je 429 sa zaglavljem Retry-After: pričekajte toliko sekundi.
• Dodavanje članova popisa prihvaća najviše 1.000 adresa po zahtjevu; ograničenja kontakata i e-pošte vašeg plana primjenjuju se na sve što radite putem API-ja.

Pogreške

Svaka pogreška ima isti oblik:

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

code se nikada ne mijenja za isti problem, stoga testirajte njega, a ne message. Navedite request_id kada se obraćate podršci. Odgovori na koje ćete naići: 401 UNAUTHORIZED, 403 FORBIDDEN, 404 NOT_FOUND, 409 CONFLICT, 422 UNPROCESSABLE_ENTITY, 429 TOO_MANY_REQUESTS. 403 znači da ključu ili vezi nedostaje dopuštenje navedeno na donjem popisu; 404 također obuhvaća nešto u organizaciji što ne možete vidjeti; 422 navodi svako neispravno polje u details; nakon 429, pričekajte broj sekundi naveden u zaglavlju Retry-After.

Webhooks

Rezultati isporuke dolaze u Zinn® Campaigns od pružatelja usluga koji šalje vašu e-poštu:

• Uz vlastitog pružatelja usluga (na primjer Resend), pohranite njegov tajni ključ za potpisivanje webhooka na vezi za slanje na upravljačkoj ploči (Campaigns → Sending). Dobit ćete webhook_url; usmjerite događaje delivered, bounced i complained pružatelja usluga na njega. Vraćena pošta ili prijava neželjene pošte odmah uklanja adresu iz budućih slanja.
• Uz Zinn® slanje, nema potrebe za postavljanjem.

Očitajte rezultate pomoću operacija izvješćivanja (getEmailMarketingCampaignReport, getSmsMarketingCampaignReport).

Svaka operacija sustava Campaigns

Pregled

• GET /v1/email-marketing — pregled sustava Zinn® Campaigns za jednu organizaciju. Operacija getEmailMarketingOverview. Provjerena dopuštenja: email_marketing.view. Od AI asistenta: da, putem MCP-a.

Kampanje e-pošte

• GET /v1/email-marketing/campaigns — Kampanje e-pošte, najnovije prve, jedna keyset stranica. Operacija listEmailMarketingCampaigns. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/campaigns — Stvorite skicu kampanje e-pošte. Operacija createEmailMarketingCampaign. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/campaigns/{campaign_id} — Jedna kampanja e-pošte. Operacija getEmailMarketingCampaign. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• PATCH /v1/email-marketing/campaigns/{campaign_id} — Uredite skicu (ili odbijenu kampanju, koja se vraća u status skice). Operacija updateEmailMarketingCampaign. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/campaigns/{campaign_id}/lint — Provjerite tekst kampanje na probleme s isporučivošću prije slanja. Operacija lintEmailMarketingCampaign. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/campaigns/{campaign_id}/report — Brojke kampanje. Operacija getEmailMarketingCampaignReport. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/campaigns/{campaign_id}/send — Pokrenite slanje kampanje na njezin popis. Operacija sendEmailMarketingCampaign. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI pomoćnika: samo API i upravljačka ploča: troši novac ili kvotu, pa je pritišće stvarna osoba (šalje stvarnim primateljima i troši kvotu).
• POST /v1/email-marketing/campaigns/{campaign_id}/test — Pošaljite sada jedan probni primjerak članu organizacije. Operacija testEmailMarketingCampaign. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI pomoćnika: da, putem MCP-a.
• POST /v1/email-marketing/campaigns/{campaign_id}/translate — Prevedite kampanju na svaki jezik kontakta koji nedostaje ili je zastario. Operacija translateEmailMarketingCampaign. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI pomoćnika: da, putem MCP-a.
• GET /v1/email-marketing/campaigns/{campaign_id}/translations — Svaki jezik kontakta na popisu kampanje i podatak o tome je li njegov prijevod ažuran. Operacija listEmailMarketingCampaignTranslations. Provjerene dozvole: email_marketing.view. Iz AI pomoćnika: da, putem MCP-a.

Pisanje uz AI

• POST /v1/email-marketing/ai/write — Napišite skicu kampanjske e-pošte iz kratkog sažetka pomoću Zinn® AI-ja. Operacija writeEmailMarketingCampaignWithAi. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: samo API i nadzorna ploča: troši novac ili kvotu, pa je pritišće stvarna osoba (AI pisanje troši AI kredite).

Komplet brenda

• GET /v1/email-marketing/brand-kit — Komplet brenda organizacije (naziv, logotip, boje, font, ton komunikacije). Operacija getEmailMarketingBrandKit. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• PUT /v1/email-marketing/brand-kit — Uredite komplet brenda. Operacija updateEmailMarketingBrandKit. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/brand-kit/read — Učitajte komplet brenda s web-mjesta organizacije. Operacija readEmailMarketingBrandKit. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.

Kontakti i jednokratne poruke

• GET /v1/email-marketing/contacts — Kontakti organizacije, jedna stranica skupa ključeva odjednom. Operacija listEmailMarketingContacts. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/contacts/{contact_id}/messages — Pošaljite jedan SMS jednom kontaktu, plaćeno iz Zinn® stanja kredita. Operacija sendEmailMarketingMessage. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: samo API i upravljačka ploča: troši novac ili dodijeljeni iznos, stoga ga pritišće stvarna osoba (jednokratna poruka kontaktu troši dodijeljeni iznos).
• GET /v1/email-marketing/messages — SMS i WhatsApp poruke koje je organizacija poslala, najnovije prvo, jedna stranica skupa ključeva. Operacija listEmailMarketingMessages. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.

Popisi

• GET /v1/email-marketing/lists — Popisi za slanje e-pošte organizacije s brojem pretplaćenih i odjavljenih korisnika. Operacija listEmailMarketingLists. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, preko MCP-a.
• POST /v1/email-marketing/lists — Izradite popis za slanje e-pošte (ili vratite onaj s tim nazivom). Operacija createEmailMarketingList. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, preko MCP-a.
• POST /v1/email-marketing/lists/{list_id}/members — Dodajte kontakte na popis prema adresi e-pošte (najviše 1.000 po zahtjevu). Operacija addEmailMarketingListMembers. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, preko MCP-a.

Uvozi

• GET /v1/email-marketing/imports — Prethodni uvozi kontakata, najnoviji na početku, jedna stranica skupa ključeva odjednom. Operacija listEmailMarketingImports. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, preko MCP-a.
• POST /v1/email-marketing/imports — Uvezite jedan dio kontakata s pripadajućom potvrdom o privoli. Operacija createEmailMarketingImport. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, preko MCP-a.

Obrasci za prijavu

• GET /v1/email-marketing/forms — Obrasci za prijavu (dvostruka prijava), najnoviji prvo, jedna stranica skupa ključeva. Operacija listEmailMarketingForms. Provjerene dozvole: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/forms — Izradite obrazac za prijavu koji dodaje potvrđene osobe na jedan popis. Operacija createEmailMarketingForm. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• DELETE /v1/email-marketing/forms/{form_id} — Izbrišite obrazac za prijavu (već potvrđene osobe ostaju na popisu). Operacija deleteEmailMarketingForm. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• PATCH /v1/email-marketing/forms/{form_id} — Promijenite obrazac za prijavu (tekst, popis, preusmjeravanje, uključeno ili isključeno). Operacija updateEmailMarketingForm. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.

Veze za slanje

• GET /v1/email-marketing/senders — Veze za slanje organizacije. Operacija listEmailMarketingSenders. Provjerene dozvole: email_marketing.view. Iz AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/senders — Povežite pošiljatelja kampanje (Zinn® slanje ili vlastiti SMTP poslužitelj klijenta). Operacija createEmailMarketingSender. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI asistenta: samo API i upravljačka ploča: prenosi tajnu koja nikada ne smije doći do AI modela (tijelo je SMTP lozinka).
• DELETE /v1/email-marketing/senders/{sender_id} — Uklonite vezu za slanje i njezinu pohranjenu lozinku. Operacija deleteEmailMarketingSender. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/senders/{sender_id}/verify — Dokažite da veza za slanje radi, bez slanja ičega. Operacija verifyEmailMarketingSender. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI asistenta: da, putem MCP-a.
• PUT /v1/email-marketing/senders/{sender_id}/webhook — Pohranite tajni ključ za potpisivanje webhooka vašeg pružatelja usluga e-pošte za ovu vezu. Operacija setEmailMarketingSenderWebhook. Provjerene dozvole: email_marketing.manage, email_marketing.view. Iz AI asistenta: poziva drugi sustav (pružatelj usluga ili posjetitelj), a ne vi (pohranjuje tajni ključ webhooka pružatelja usluga).

SMS i WhatsApp

• GET /v1/email-marketing/sms — Što je potrebno zaslonu SMS — otvoreno?, pauzirano?, stanje kredita i cijene. Operacija getEmailMarketingSms. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/sms/campaigns — Masovne SMS kampanje, najnovije prvo, jedna stranica keyseta. Operacija listSmsMarketingCampaigns. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/sms/campaigns — Stvorite skicu SMS-a za popis. Operacija createSmsMarketingCampaign. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/sms/campaigns/{campaign_id} — Jedna masovna SMS kampanja. Operacija getSmsMarketingCampaign. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• PATCH /v1/email-marketing/sms/campaigns/{campaign_id} — Uredite skicu (ili odbijenu kampanju, koja se vraća u skicu). Operacija updateSmsMarketingCampaign. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• GET /v1/email-marketing/sms/campaigns/{campaign_id}/report — Brojke masovne SMS kampanje. Operacija getSmsMarketingCampaignReport. Provjerena dopuštenja: email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/sms/campaigns/{campaign_id}/send — Pokrenite slanje SMS-a svima s popisa koji su pristali na SMS — ili nastavite kampanju pauziranu zbog kredita. Operacija sendSmsMarketingCampaign. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Od AI asistenta: samo API i nadzorna ploča: troši novac ili dodijeljena sredstva, stoga je pritišće čovjek (šalje plaćene SMS/WhatsApp poruke).
• GET /v1/email-marketing/sms/registrations/us — US 10DLC registracija ove organizacije i njezin trošak. Operacija getEmailMarketingUsRegistration. Provjerena dopuštenja: email_marketing.view. Od AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/sms/registrations/us — Pošaljite brend i kampanju ove organizacije za US 10DLC (naplaćuje se prilikom slanja). Operacija submitEmailMarketingUsRegistration. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Od AI asistenta: samo API i nadzorna ploča: troši novac ili dodijeljena sredstva, stoga je pritišće čovjek (US 10DLC registracija uključuje naknade operatera).

Kampanje putem vlastite usluge e-pošte (predlošci, segmenti, potiskivanja)

• GET /v1/campaigns — Kampanje organizacije. Operacija listCampaigns. Od AI asistenta: da, putem MCP-a.
• POST /v1/campaigns — Izradite kampanju iz predloška i publike. Operacija createCampaign. Od AI asistenta: da, putem MCP-a.
• DELETE /v1/campaigns/esp — Prekinite vezu s računom pružatelja usluge i uklonite njegov pohranjeni ključ. Operacija disconnectEsp. Od AI asistenta: samo API i nadzorna ploča: prenosi tajnu koja nikada ne smije doći do AI modela (uništava pohranjeni ESP ključ).
• GET /v1/campaigns/esp — Vlastiti račun pružatelja usluge e-pošte organizacije. Operacija getEspConnection. Od AI asistenta: da, putem MCP-a.
• POST /v1/campaigns/esp — Povežite račun pružatelja usluge e-pošte. Operacija connectEsp. Od AI asistenta: samo API i nadzorna ploča: prenosi tajnu koja nikada ne smije doći do AI modela (tijelo zahtjeva je ESP API ključ).
• POST /v1/campaigns/esp/verify — Potvrdite da račun pružatelja usluge radi i očitajte njegove verificirane domene. Operacija verifyEspConnection. Od AI asistenta: samo API i nadzorna ploča: prenosi tajnu koja nikada ne smije doći do AI modela (ponovno provjerava pohranjeni ESP ključ).
• POST /v1/campaigns/preview — Render predložak s primjercima vrijednosti. Operacija previewCampaignTemplate. Od AI asistenta: da, putem MCP-a.
• GET /v1/campaigns/segments — Vaši spremljeni segmenti publike. Operacija listCampaignSegments. Provjerena dopuštenja: campaigns.view. Od AI asistenta: da, putem MCP-a.
• POST /v1/campaigns/segments — Spremite novi segment publike. Operacija createCampaignSegment. Provjerena dopuštenja: campaigns.manage. Od AI asistenta: da, putem MCP-a.
• GET /v1/campaigns/segments/fields — Rječnik filtara, njegovi popisi vrijednosti i čarobne oznake. Operacija getCampaignSegmentFields. Provjerene dozvole: campaigns.view. Putem AI asistenta: da, kroz MCP.
• POST /v1/campaigns/segments/preview — Koliko ljudi ovo obuhvaća, tko su oni i koga izostavlja. Operacija previewCampaignSegment. Provjerene dozvole: campaigns.view. Putem AI asistenta: da, kroz MCP.
• DELETE /v1/campaigns/segments/{segmentId} — Arhivirajte segment. Operacija archiveCampaignSegment. Provjerene dozvole: campaigns.manage. Putem AI asistenta: da, kroz MCP.
• GET /v1/campaigns/segments/{segmentId} — Jedan spremljeni segment. Operacija getCampaignSegment. Provjerene dozvole: campaigns.view. Putem AI asistenta: da, kroz MCP.
• PATCH /v1/campaigns/segments/{segmentId} — Preimenujte segment ili promijenite njegove filtre. Operacija updateCampaignSegment. Provjerene dozvole: campaigns.manage. Putem AI asistenta: da, kroz MCP.
• GET /v1/campaigns/suppressions — Adrese koje ne smiju primati marketinške poruke. Operacija listCampaignSuppressions. Provjerene dozvole: campaigns.view. Putem AI asistenta: da, kroz MCP.
• POST /v1/campaigns/suppressions — Dodajte adresu na popis izuzeća. Operacija createCampaignSuppression. Provjerene dozvole: campaigns.manage. Putem AI asistenta: da, kroz MCP.
• GET /v1/campaigns/tags — Paleta čarobnih oznaka koju nudi sastavljač kampanje. Operacija listCampaignTags. Od AI asistenta: da, putem MCP-a.
• GET /v1/campaigns/templates — Predlošci kampanja organizacije. Operacija listCampaignTemplates. Od AI asistenta: da, putem MCP-a.
• POST /v1/campaigns/templates — Izradite predložak kampanje. Operacija createCampaignTemplate. Od AI asistenta: da, putem MCP-a.
• DELETE /v1/campaigns/templates/{templateId} — Arhivirajte predložak i povucite njegove izvore prijevoda. Operacija archiveCampaignTemplate. Od AI asistenta: da, putem MCP-a.
• GET /v1/campaigns/templates/{templateId} — Jedan predložak kampanje. Operacija getCampaignTemplate. Od AI asistenta: da, putem MCP-a.
• PUT /v1/campaigns/templates/{templateId} — Uredite predložak kampanje. Operacija updateCampaignTemplate. Od AI asistenta: da, putem MCP-a.
• POST /v1/campaigns/unsubscribe — Napustite marketinški popis. Račun nije potreban. Operacija unsubscribeFromCampaigns. Od AI asistenta: samo API i nadzorna ploča: nosi tajnu koja nikada ne smije doći do AI modela (uzima potpisani token za odjavu primatelja).
• DELETE /v1/campaigns/{campaignId} — Izbrišite kampanju i povucite njezine retke isporuke. Operacija deleteCampaign. Od AI asistenta: samo API i nadzorna ploča: zahtijeva dozvolu koja se ne nudi AI vezama (brisanje ESP kampanje zahtijeva campaigns.send).
• GET /v1/campaigns/{campaignId} — Jedna kampanja i njezino izvješće o isporuci. Operacija getCampaign. Putem AI asistenta: da, putem MCP-a.
• POST /v1/campaigns/{campaignId}/control — Pauzirajte, nastavite ili otkažite slanje u tijeku. Operacija controlCampaign. Putem AI asistenta: samo API i nadzorna ploča: troši novac ili dodijeljenu kvotu, pa ga pritišće stvarna osoba (pauzira/nastavlja slanje uživo).
• POST /v1/campaigns/{campaignId}/send — Pokrenite trajno slanje. Operacija sendCampaign. Putem AI asistenta: samo API i nadzorna ploča: troši novac ili dodijeljenu kvotu, pa ga pritišće stvarna osoba (šalje ESP kampanju stvarnim primateljima).
• POST /v1/campaigns/{campaignId}/test — Pošaljite jednu stvarnu poruku putem kanala koji će kampanja stvarno koristiti. Operacija testSendCampaign. Putem AI asistenta: samo API i nadzorna ploča: potrebna je dozvola koja se ne nudi AI vezama (ESP testno slanje zahtijeva campaigns.send).

Javne stranice i dolazni web-hookovi

• GET /v1/public/email-marketing/c/{token} — Brojač klikova. Bilježi jedan klik po primatelju i preusmjerava na izvornu poveznicu. Operacija emailMarketingClick. Putem AI asistenta: stranica koju Vaši primatelji otvaraju iz e-pošte (preusmjeravanje za praćenje klikova).
• GET /v1/public/email-marketing/f/{public_id} — Hostirana stranica obrasca za prijavu (bez prijave). Operacija emailMarketingFormPage. Putem AI asistenta: stranica koju Vaši primatelji otvaraju iz e-pošte (javna stranica obrasca za prijavu).
• POST /v1/public/email-marketing/f/{public_id} — Pošaljite obrazac za prijavu (hostirana stranica, ugrađeni obrazac ili JSON). Operacija emailMarketingFormSubmit. Od AI asistenta: poziva ga drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (posjetitelj šalje obrazac za prijavu).
• GET /v1/public/email-marketing/fc — Stranica za potvrdu dvostruke privole (bez prijave). Operacija emailMarketingFormConfirmPage. Od AI asistenta: stranica koju vaši primatelji otvaraju iz e-pošte (stranica za potvrdu dvostruke privole).
• POST /v1/public/email-marketing/fc — Potvrdite prijavu (dodaje osobu na popis uz zapis o privoli). Operacija emailMarketingFormConfirm. Od AI asistenta: poziva ga drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (posjetitelj potvrđuje dvostruku privolu).
• GET /v1/public/email-marketing/o/{token} — Slika za praćenje otvaranja (GIF veličine 1x1). Broji jedno otvaranje po primatelju. Operacija emailMarketingOpenPixel. Od AI asistenta: stranica koju vaši primatelji otvaraju iz e-pošte (piksel za praćenje otvaranja).
• GET /v1/public/email-marketing/u/{token} — Poveznica za odjavu u podnožju (bez prijave). Operacija emailMarketingUnsubscribePage. Od AI asistenta: stranica koju vaši primatelji otvaraju iz e-pošte (stranica za odjavu).
• POST /v1/public/email-marketing/u/{token} — RFC 8058 odjava jednim klikom (i gumb "zaustavi sve" na stranici). Operacija emailMarketingUnsubscribeOneClick. Od AI asistenta: poziva drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (RFC 8058 odjava jednim klikom).
• GET /v1/public/email-marketing/warmup-u/{token} — Poveznica za odjavu e-pošte za zagrijavanje marketinškog skupa (bez prijave). Operacija emailMarketingWarmupUnsubscribePage. Od AI asistenta: stranica koju vaši primatelji otvaraju iz e-poruke (stranica za odjavu zagrijavanja).
• POST /v1/public/email-marketing/warmup-u/{token} — RFC 8058 odjava jednim klikom iz e-pošte za zagrijavanje. Operacija emailMarketingWarmupUnsubscribeOneClick. Od AI asistenta: poziva drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (odjava zagrijavanja jednim klikom).
• POST /v1/webhooks/campaign-events — Unos potpisanog događaja isporuke od pružatelja usluga e-pošte. Operacija receiveCampaignDeliveryWebhook. Od AI asistenta: poziva drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (potpisani ESP webhook za isporuku).
• POST /v1/webhooks/campaigns/telnyx — Dolazni SMS odgovori (STOP / START) od našeg dobavljača SMS usluga. Operacija receiveCampaignsTelnyxInbound. Od AI asistenta: poziva drugi sustav (pružatelj usluge ili posjetitelj), a ne vi (potpisani Telnyx dolazni webhook).
• POST /v1/webhooks/email-marketing/{connection_id} — Događaji isporuke korisnikova vlastitog pružatelja e-pošte za jednu vezu za slanje. Operacija receiveEmailMarketingProviderWebhook. Od AI pomoćnika: poziva drugi sustav (pružatelj ili posjetitelj), a ne Vi (potpisani webhook pošiljatelja-pružatelja).

Flows

• GET /v1/email-marketing/flows — Tokovi e-pošte (dobrodošlica, drip, godišnji datum), jedna stranica sa skupom ključeva. Operacija listEmailMarketingFlows. Provjerena dopuštenja: email_marketing.view. Od AI pomoćnika: da, putem MCP-a.
• POST /v1/email-marketing/flows — Stvorite tok (započinje kao skica). Operacija createEmailMarketingFlow. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Od AI pomoćnika: da, putem MCP-a.
• DELETE /v1/email-marketing/flows/{flow_id} — Izbrišite tok i njegove prijave (poslana pokretanja ostaju kao kampanje). Operacija deleteEmailMarketingFlow. Provjerena dopuštenja: email_marketing.manage, email_marketing.view. Od AI pomoćnika: da, putem MCP-a.
• GET /v1/email-marketing/flows/{flow_id} — Jedan tok s koracima i izvješćem (prijavljeni, u tijeku, pokretanja i primatelji po koraku). Operacija getEmailMarketingFlow. Provjerena dopuštenja: email_marketing.view. Od AI pomoćnika: da, putem MCP-a.
• PATCH /v1/email-marketing/flows/{flow_id} — Promijenite tijek; steps, kada je naveden, zamjenjuje cijeli slijed. Operacija updateEmailMarketingFlow. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/flows/{flow_id}/activate — Uključite tijek; samo se osobe koje se od sada pridruže popisu uključuju. Operacija activateEmailMarketingFlow. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.
• POST /v1/email-marketing/flows/{flow_id}/pause — Pauzirajte tijek; dospjeli koraci čekaju i nitko novi ne dobiva e-poštu dok se ponovno ne uključi. Operacija pauseEmailMarketingFlow. Provjerene dozvole: email_marketing.manage, email_marketing.view. Putem AI asistenta: da, putem MCP-a.