Hírlevél eszközök

Áttekintés

A Hírlevél eszköz kategória az e-mail kampányokat, automatizálási munkafolyamatokat és e-mail teljesítmény analitikákat fedi le. Teljesen megtervezett kampányokat hozhatsz létre AI-generált tartalommal, összetett automatizálási munkafolyamatokat építhetsz több lépéssel, és figyelemmel kísérheted az e-mailjeid teljesítményét.

Szükséges jogosultság:Copilot.Newsletter

manage_campaign

Hírlevél e-mail kampány létrehozása vagy frissítése. A kampányok mindig VÁZLAT státuszban jönnek létre — az irányítópultról tekinted át és küldöd el őket.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`id`	string	Nem	Kampány azonosító. Hagyd el a létrehozáshoz, add meg a frissítéshez.
`name`	string	Feltételes	Kampány neve. Létrehozáskor kötelező.
`subject`	string	Nem	E-mail tárgy sor.
`preheader`	string	Nem	Előnézeti szöveg, amely az e-mail inboxban jelenik meg.
`senderName`	string	Nem	A feladó megjelenített neve. Kihagyás esetén automatikusan észlelve.
`senderEmailId`	string	Nem	Feladó e-mail azonosító. Kihagyás esetén automatikusan észlelve.
`content`	string	Nem	Közvetlen HTML e-mail tartalom (tábla-alapú elrendezés inline stílusokkal).
`generateContent`	string	Nem	AI prompt e-mail HTML generálásához az alapoktól, vagy szerkesztési utasítások forrással kombinálva.
`fromTemplateId`	string	Nem	Mentett sablon tartalmának használata kiindulópontként.
`fromCampaignId`	string	Nem	Tartalom másolása korábbi kampányból.
`useVariables`	boolean	Nem	`{{variable}}` helyőrzők engedélyezése az AI-generált tartalomban (pl. `{{name}}`, `{{email}}`, `{{unsubscribeURL}}`).
`recipients`	object	Nem	Célközönség. Lásd a címzett opciókat alább.

Tartalom források

Négyféleképpen adhatsz meg e-mail tartalmat (válassz egyet):

Forrás	Hogyan működik
`content`	Illeszd be a saját HTML-edet közvetlenül. Tábla-alapú elrendezést kell használnod inline stílusokkal az e-mail kompatibilitáshoz.
`generateContent`	Írd le az e-mailt, és az AI professzionális HTML-t generál. Automatikusan tábla-alapú elrendezést használ.
`fromTemplateId`	Tartalom másolása mentett e-mail sablonból. Sablon azonosítókat a `list_records`-szal találsz (table: `email_templates`).
`fromCampaignId`	Tartalom másolása korábbi kampányból. Kampány azonosítókat a `list_records`-szal találsz (table: `campaigns`).

Források kombinálása: Kombinálhatod a fromTemplateId-t vagy fromCampaignId-t a generateContent-tel, hogy az AI szerkessze a meglévő tartalmat. Például vedd a múlt havi kampányt, és kérd az AI-t a főcím frissítésére.

Címzett opciók

Opció	Leírás
`allActive`	Célzás az összes ellenőrzött feliratkozóra.
`segmentIds`	Névjegy szegmens azonosítók tömbje. Azonosítókat a `list_records`-szal találsz (table: `contact_segments`).
`groupIds`	Névjegycsoport azonosítók tömbje. Azonosítókat a `list_records`-szal találsz (table: `contact_groups`).

Ezek kölcsönösen kizárják egymást — kampányonként csak egy címzett módszert használj.

Hogyan működik

Kampány létrehozása:

Csak a name kötelező, de jellemzően a subject-et és tartalmat is megadod.
Egy ellenőrzött feladó e-mail automatikusan észlelésre kerül a szervezeted e-mail domainekből. Felülírhatod a senderEmailId-vel.
Visszaad egy dashboardUrl-t, ahol áttekintheted és elküldheted a kampányt.

Kampány frissítése:

Csak VÁZLAT kampányok frissíthetők.
Ha generateContent-et adsz meg forrás nélkül, és a kampánynak már van tartalma, az AI szerkeszti a meglévő tartalmat.

Fontos: Ez az eszköz nem tud kampányokat küldeni. Mindig VÁZLAT státuszban hozza létre őket. Használd a visszaadott dashboardUrl-t az áttekintéshez és küldéshez az irányítópultról.

Példa promptok

Hozz létre egy Márciusi frissítés nevű hírlevél kampányt Mi újság márciusban tárggyal.
Generálj egy promóciós e-mailt a tavaszi akciónkról 50% kedvezménnyel minden termékre.
Hozz létre egy kampányt az Üdvözlő sablonom alapján. (először listázza a sablonokat, majd létrehozza a kampányt)
Vedd az utolsó kampányomat és hozz létre egy újat a főcímmel Nyári akció-ra cserélve. (listázza a kampányokat, megtalálja az utolsót, AI szerkesztéssel újat hoz létre)
Állítsd be a márciusi kampányom címzettjeit az összes aktív feliratkozóra.
Célozd a Prémium felhasználók csoportot ehhez a kampányhoz.
Frissítsd a vázlat kampányom tárgy sorát.
Hozz létre egy üdvözlő e-mail kampányt AI tartalommal, személyre szabási változókkal, és célozd az Új regisztráltak csoportot.

get_email_stats

E-mail teljesítmény statisztikák lekérése kampányhoz vagy munkafolyamathoz.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`source`	string	Igen	`"campaign"` vagy `"workflow"`.
`sourceId`	string	Igen	A kampány vagy munkafolyamat azonosítója.

Hogyan működik

E-mail teljesítmény metrikákat ad vissza, beleértve: küldések, megnyitások, kattintások, visszapattanások, leiratkozások és egyebek.
A kampánynak vagy munkafolyamatnak a szervezetedhez kell tartoznia.

Példa promptok

Mik a márciusi kampányom statisztikái? (először listázza a kampányokat az azonosító megtalálásához)
Mutasd a megnyitási és kattintási arányt az utolsó kampányomra.
Hogyan teljesít az üdvözlő sorozat munkafolyamatom?
Hasonlítsd össze az utolsó két kampányom statisztikáit. (listázza a kampányokat, mindegyikhez lekéri a statisztikákat)

manage_email_workflow

Hírlevél automatizálási munkafolyamatok létrehozása, frissítése, vagy e-mail tartalom szerkesztése bennük. Ez a leghatalmasabb hírlevél eszköz — AI-t használ teljes munkafolyamat struktúrák generálásához természetes nyelvű leírásokból.

Műveletek

Ennek az eszköznek három működési módja van, az action paraméterrel vezérelve:

action: "create"

Új munkafolyamat generálása AI leírásból.

Paraméter	Típus	Kötelező	Leírás
`action`	`"create"`	Igen
`name`	string	Igen	Munkafolyamat neve.
`description`	string	Igen	A munkafolyamat természetes nyelvű leírása. Az AI generálja a teljes struktúrát.
`triggerType`	string	Nem	Javaslat a trigger típushoz: `"MANUAL"`, `"DATE"`, `"SUBSCRIBE"`, `"UNSUBSCRIBE"`, vagy `"API"`. Az AI automatikusan észleli, ha kihagyod.

Hogyan működik:

Az AI generálja a teljes munkafolyamat struktúrát: trigger konfiguráció, összes csomópont (e-mailek, késleltetések, feltételek, műveletek), és a köztük lévő kapcsolatok.
Az AI hozzáfér a szervezeted kontextusához: névjegycsoportok, egyedi mezők, más munkafolyamatok és ellenőrzött feladó e-mailek.
Az e-mail csomópontok csak tárggyal/előfejléccel jönnek létre — használd az action: "edit_email"-t HTML tartalom hozzáadásához minden e-mailhez.
Minden csomópont pozíciója automatikusan kiszámításra kerül az elrendezési motor által.

action: "update"

Meglévő munkafolyamat módosítása.

Paraméter	Típus	Kötelező	Leírás
`action`	`"update"`	Igen
`id`	string	Igen	Munkafolyamat azonosító.
`name`	string	Nem	Munkafolyamat átnevezése.
`description`	string	Nem	Az AI látja az aktuális munkafolyamatot és alkalmazza a változtatásaidat (csomópontok hozzáadása/eltávolítása/átstrukturálása).
`triggerSettings`	object	Nem	Közvetlen trigger konfigurációs objektum.
`active`	boolean	Nem	Munkafolyamat aktiválása vagy deaktiválása.

Hogyan működik:

Amikor description-t adsz meg, az AI látja a teljes jelenlegi munkafolyamatot és generál egy frissített verziót.
A meglévő csomópontok megőrzésre kerülnek, ahol lehetséges, és újak kerülnek hozzáadásra.
Egyetlen hívásban kombinálhatod a description-t a name-mel, triggerSettings-szel és active-val.

action: "edit_email"

Egy adott e-mail csomópont HTML tartalmának beállítása a munkafolyamaton belül.

Paraméter	Típus	Kötelező	Leírás
`action`	`"edit_email"`	Igen
`id`	string	Igen	Munkafolyamat azonosító.
`emailNodeId`	string	Igen	A csomópont azonosítója a munkafolyamaton belül (pl. `"2"` vagy `"5"`).
`subject`	string	Nem	E-mail tárgy sor ehhez a csomóponthoz.
`preheader`	string	Nem	E-mail előnézeti szöveg.
`content`	string	Nem	Közvetlen HTML e-mail tartalom.
`generateContent`	string	Nem	AI generálja vagy szerkeszti az e-mail HTML-t.
`fromTemplateId`	string	Nem	Sablon tartalmának használata.
`fromCampaignId`	string	Nem	Tartalom másolása kampányból.
`useVariables`	boolean	Nem	`{{variable}}` helyőrzők engedélyezése.
`senderEmailId`	string	Nem	Feladó e-mail azonosító ehhez a csomóponthoz.
`senderName`	string	Nem	Feladó megjelenített neve.

Hogyan működik:

Beállítja az e-mail tartalmat a megadott csomóponthoz.
A tartalom forrás opciók ugyanúgy működnek, mint a manage_campaign-nál.
A munkafolyamat struktúra mutatja, mely csomópontok e-mail csomópontok — használd azok csomópont azonosítóit itt.

Ajánlott iteratív munkafolyamat

Az e-mail munkafolyamatok építése iteratív folyamatként működik a legjobban:

Munkafolyamat struktúra létrehozása

Használd az action: "create"-et a teljes automatizálási folyamat leírásával. Ez generálja az összes csomópontot és kapcsolatot.

Struktúra áttekintése

A válasz mutatja az összes csomópontot és típusukat. Azonosítsd az e-mail csomópont azonosítókat.

Minden e-mail megtervezése

Használd az action: "edit_email"-t minden e-mail csomóponthoz, AI-val generálva a tartalmat vagy saját HTML-t megadva.

Finomítás és aktiválás

Használd az action: "update"-et strukturális változtatásokhoz, majd állítsd active: true-ra, ha kész.

Csomópont típusok

Típus	Leírás
`trigger`	A kiindulópont — mikor aktiválódik a munkafolyamat (feliratkozás, leiratkozás, dátum, manuális, API).
`email`	E-mailt küld a névjegynek.
`delay`	Megadott időtartamot vár a folytatás előtt.
`condition`	Feltétel alapján ágazik el (igen/nem útvonalakat hoz létre).
`action`	Műveletet hajt végre: mező frissítése, másolás/áthelyezés/eltávolítás csoportokból, leiratkozás.
`webhook`	Webhookot küld egy külső URL-re.
`fetch`	Adatot kér le egy külső URL-ről.
`workflow`	Másik munkafolyamatot indít el.

Példa promptok

Hozz létre egy üdvözlő e-mail munkafolyamatot: amikor valaki feliratkozik, küldj egy üdvözlő e-mailt azonnal, várj 3 napot, küldj egy tippek e-mailt.
Hozz létre egy bevezető sorozatot: feliratkozás trigger, várj 1 napot, küldj üdvözlőt, várj 3 napot, ellenőrizd, megnyitották-e az üdvözlő e-mailt, ha igen küldj köszönetet, ha nem küldj emlékeztetőt.
Adj hozzá egy feltételt a munkafolyamatomhoz, hogy ellenőrizze, a névjegy országa US-e, és csak az US névjegyeknek küldje a promóciós e-mailt.
Nevezd át a munkafolyamatomat Új ügyfél bevezető-re.
Aktiváld a bevezető munkafolyamatomat.
Írd meg az üdvözlő e-mail tartalmat az első e-mail csomóponthoz — legyen meleg, professzionális, és tartalmazza a logónkat.
Generáld az emlékeztető e-mailt az 5-ös csomóponthoz — bátorítsa az olvasót, hogy tekintse meg az első lépések útmutatónkat.
Használd az Üdvözlő sablonomat az első e-mailhez, de változtasd a főcímet erre: Üdvözlünk a csapatban!
Mutasd az üdvözlő munkafolyamatom statisztikáit. (a get_email_stats-ot használja)

Általános munkafolyamat minták

Gyors kampány

Létrehozás AI tartalommal → manage_campaign generateContent-tel
Címzettek beállítása → manage_campaign (frissítés) recipients-szel
Áttekintés és küldés → Használd a visszaadott dashboardUrl-t

Példa prompt: Hozz létre egy Ünnepi akció kampányt AI-generált promóciós tartalommal 30% kedvezményről mindenre, célozd az összes aktív feliratkozót.

Teljes munkafolyamat építés

Munkafolyamat struktúra létrehozása → manage_email_workflow (create)
Minden e-mail megtervezése → manage_email_workflow (edit_email) minden e-mail csomóponthoz
Aktiválás → manage_email_workflow (update) active: true-val

Példa prompt: Építs nekem egy teljes újra-bevonási munkafolyamatot: amikor valaki 30 napja nem nyitott meg e-mailt, küldj egy hiányzol nekünk e-mailt, várj egy hetet, ha még mindig nem nyitott meg, küldj egy utolsó emlékeztetőt kedvezményes ajánlattal, majd iratkoztasd le, ha nincs válasz.