Hírlevél eszközök

Áttekintés

A Hírlevél eszköz kategória az e-mail kampányokat, az e-mail automatizálásokat, a feliratkozók kezelését és az e-mail teljesítmény analitikákat fedi le. Teljesen megtervezett kampányokat hozhatsz létre AI-generált tartalommal, összetett e-mail automatizálásokat építhetsz több lépéssel, feliratkozókat adhatsz hozzá és rendezheted őket csoportokba és szegmensekbe, és figyelemmel kísérheted az e-mailjeid teljesítményét.

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

Tartalom források

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

Források kombinálása: Kombináld a fromTemplateId-t a generateContent-tel, és az AI új tartalmat állít össze annak a sablonnak a Tartalomterületére — a fejléc, a lábléc és a stílus pontosan úgy marad, ahogy megtervezted. A useDefaultTemplate ugyanezt teszi az Alapértelmezett sablonoddal. Kombináld a fromCampaignId-t a generateContent-tel, és annak a levélnek a szövege anyagként hasznosul újra az új tartalomhoz (add hozzá a useDefaultTemplate-et vagy a fromTemplateId-t a keret kiválasztásához; különben az AI a teljes levelet megtervezi). A sablonokat a list_records-szal találod (table: email_templates).

Címzett opciók

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, a rendszer semmit nem találgat: a generateMode dönt — az alapértelmezett "new" új tartalmat ír, az "edit" átírja a meglévőt. Azt, hogy a fejléc és a lábléc védett-e, magának a levélnek a HTML-je dönti el: ha van benne Tartalomterület (mert sablonból készült), az AI csak azon belül dolgozik, és a keret pontosan úgy marad, ahogy van; ha nincs, az egész levélen dolgozik. A sablonból létrehozott vagy sablonba összeállított kampány megőrzi a kapcsolatát a sablonnal, és a szerkesztő a sablon nevét mutatja — pontosan úgy, mint az irányítópulton készített.

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.
• "Hozz létre egy kampányt az alapértelmezett sablonomban, amely bejelenti az új árazásunkat, két AI-képpel." (az Alapértelmezett sablon Tartalomterületére állítja össze a tartalmat, és legenerálja a képeket)

get_email_stats

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

Paraméterek

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)

get_domain_setup_state

Visszaadja egy küldési domain élő beállítási állapotát, hogy az e-mail-domain konfigurációt valós DNS-adatok alapján hibakeresd — soha nem kitalált értékekből. Használd arra, hogy végigvezesd a felhasználót a DNS-rekordok hozzáadásán, a domain ellenőrzésén vagy a márkás linkkövetés engedélyezésén.

Paraméterek

Mit ad vissza

• DNS-rekordok — a pontos név/érték párok, amelyeket a felhasználónak hozzá kell adnia, mindegyik a valós állapotával (found, missing vagy pending), élő DNS-hez hasonlítva. Az auth csoportba tartozó rekordok kötelezőek a küldéshez; az ssl és tracking opcionális, és csak a márkás linkkövetéshez szükséges.
• Beállítási fázis — hol tart a domain a küldési hitelesítés → SSL → linkkövetés folyamatban.
• DNS-szolgáltató — az észlelt szolgáltató és a névszerverei, így pontosan megmondhatod a felhasználónak, hová adja hozzá a rekordokat.
• CAA állapot — hogy egy meglévő CAA-rekord blokkolja-e a tanúsítvány kiállítását a márkás követéshez.

Hogyan működik

• A rekordértékeket az élő DNS-állapotból olvassa, így az asszisztens elmagyarázza, hová kell hozzáadni a még hiányzó rekordokat ahelyett, hogy kitalálná őket.
• Olyan domaint igényel, amely már hozzá van adva a Beállítások > E-mail domainek alatt.

Példa promptok

• Segíts befejezni a küldési domainem beállítását — mely DNS-rekordok hiányoznak még?
• Ellenőrizve van már az e-mail domainem?
• Nem működik a linkkövetésem — mi a baj a DNS-emmel?
• Hová adjam hozzá ezeket a rekordokat, és ki a DNS-szolgáltatóm?

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.

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.

Hogyan működik:

• Amikor description-t adsz meg, az AI látja a teljes jelenlegi automatizálást é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 és a triggerSettings-szel.
• Az automatizálás be- vagy kikapcsolása innen nem lehetséges. Nincs active paraméter; az aktiválás szándékosan csak az irányítópulton végezhető el, mert a bekapcsolás valódi e-mailek küldését indítja el. Itt építed és szerkeszted, élesre pedig te magad kapcsolod.

action: "edit_email"

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

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:

Csomópont típusok

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.
• Mutasd meg a bevezető automatizálásom felépítését, és azt, mely csomópontoknak nincs még tartalma.
• Í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)

manage_subscribers

Hírlevél-feliratkozók hozzáadása, szerkesztése és rendszerezése.

Műveletek

Paraméterek

Hogyan működik

• Listahigiénia minden hozzáadásnál: az érvénytelen címeket, no-reply/rendszer postafiókokat és eldobható domaineket kihagyja, és okonként számolva jelenti a válaszban. A már létező e-maileket érintetlenül hagyja és duplicates-ként számolja — meglévő névjegyek rendszerezésére az add_to_group való.
• Az új névjegyek NEW állapotban indulnak, és egy háttérfolyamat automatikusan ellenőrzi és VERIFIED (küldhető) állapotba lépteti őket — hozzáadáskor nem kell állapotot megadni.
• Dupla megerősítéses védelem: VERIFIED állapotot csak olyan névjegyre állíthatsz, amelynek jelenlegi állapota REMOVED. A BOUNCED, COMPLAINT és NEW rendszerkezelt állapotok, egyáltalán nem állíthatók be.
• Az egyéni mezőknek már létezniük kell (Hírlevél > Feliratkozók > Mezők). Az ismeretlen címkéket az ignoredFieldTags mezőben jelenti vissza, sosem ejti el némán.
• A csomagod feliratkozói limitje érvényesül — a válasz elmagyarázza, ha egy hozzáadás túllépné.
• 500-nál több névjegyhez oszd el őket több hívásra.

Példa promptok

• „Add hozzá a [email protected] címet a hírlevélhez.”
• „Add hozzá ezt a 20 e-mail címet a hírlevélhez, és tedd őket a Béta tesztelők csoportba.”
• „Állítsd Jane plan mezőjét 'pro'-ra.”
• „Iratkoztasd le a [email protected] címet.”
• „Iratkoztasd le mindenkit erről az e-mail listáról.” (a set_state műveletet használja)
• „Tedd át ezeket a feliratkozókat a VIP csoportba.” (az add_to_group műveletet használja)

manage_audience_list

A kampányok által célozható közönségek létrehozása és szerkesztése: névjegycsoportok (statikus gyűjtők, amelyekbe névjegyeket helyezel) és szegmensek (mentett szűrők — tagjuk mindenki, aki a küldés pillanatában illeszkedik a feltételekre). Törlés nincs — csoportot és szegmenst itt csak létrehozni és szerkeszteni lehet.

Műveletek

Szegmens szűrők

A szűrők strukturált feltételek, nem szabad szöveg:

{
    "match": "all",
    "conditions": [
        { "field": "email", "operator": "ends_with", "value": "@gmail.com" },
        { "field": "engagement", "operator": "greater_than", "value": 5 }
    ]
}

• match: "all" = minden feltételnek teljesülnie kell (ÉS), "any" = legalább egynek (VAGY).
• Egy feltétel lehet beágyazott csoport is: { "match": "any", "conditions": [...] } — egy szint mélységig.
• field: email, name, state, engagement, created_at, vagy bármely egyéni mező címkéje.
• Operátorok mezőtípusonként: szöveg: equals, not_equals, contains, starts_with, ends_with (és not_ változataik), is_set, is_not_set; szám: equals, not_equals, greater_than, less_than; dátum: greater_than (utána), less_than (előtte), valamint more_than_ago / less_than_ago "30_days" formátumú értékekkel.
• state értékek: NEW, UNVERIFIED, VERIFIED, UNSUBSCRIBED, REMOVED, BOUNCED, COMPLAINT.
• Az értékek nem tartalmazhatnak vesszőt, zárójelet, idézőjelet vagy visszaperjelet.

Hogyan működik

• Minden szegmens mentés és előnézet visszaadja a pontos találatszámot és egy 10 névjegyes mintát — mindig ellenőrizd, hogy azt kaptad-e, amit szerettél volna.
• Az irányítópulton látható számok automatikusan frissülnek: a szegmensszámok mentéskor/előnézetkor, a csoportszámok tagságváltozáskor.
• A kampányok pillanatképet készítenek a szegmensről, amikor címzettként kiválasztod — a szegmens későbbi szerkesztése nem változtatja meg a már beállított kampányokat; ott válaszd ki újra a szegmenst az új szűrőkhöz.

Példa promptok

• „Hozz létre egy VIP ügyfelek nevű csoportot.”
• „Hozz létre egy szegmenst az aktív Gmail-feliratkozókból — 5 feletti aktivitással.”
• „Hány névjegy csatlakozott az elmúlt 30 napban? Előbb nézd meg szegmens-előnézetként.”
• „Frissítsd az Inaktív szegmensemet, hogy az aktivitás 0 is feltétel legyen.”
• „Nevezd át a 'Béta' csoportot 'Béta tesztelők'-re.”

Általános munkafolyamat minták

Gyors kampány

1. Létrehozás AI tartalommal → manage_campaign generateContent-tel
2. Címzettek beállítása → manage_campaign (frissítés) recipients-szel
3. Á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 e-mail automatizálás építése

1. A struktúra létrehozása → manage_email_workflow (create)
2. Minden e-mail megtervezése → manage_email_workflow (edit_email) minden e-mail csomóponthoz
3. Kapcsold be → nyisd meg az irányítópulton a Marketing → Hírlevél → E-mail automatizálások oldalon

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.