Elköteleződés eszközök
Az elköteleződés eszközökkel banner-, felmérés-, termékbemutató-, chat üzenet- és hírvázlatokat készíthetsz. Állítsd be megjelenési szabályokkal, mikor és hol jelenjenek meg, célozz ország vagy oldal-URL szerint, és generálj hírtartalmat AI-val.
Áttekintés
Az Elköteleződés eszköz kategória kezeli az összes proaktív ügyfélmegszólítást: bannerek, alkalmazáson belüli chat üzenetek, felmérések, termékbemutatók és hírek. Elkészítheted ezek vázlatát, részletes megjelenési szabályokat állíthatsz be arra, hogy mikor és hol jelenjenek meg, és sorba rendezheted őket a listában.
Outreach.Banners, Outreach.Messages, Outreach.Surveys, Outreach.Tours, vagy Outreach.News — ugyanaz a jogosultság, amivel az adott elemet az irányítópulton kezelnéd.manage_outreach, a jogosultsági kulcsok Outreach.-csel kezdődnek, és a webcímek /dashboard/outreach/… formájúak.manage_outreach
Elköteleződési elem (banner, felmérés, termékbemutató vagy chat üzenet) létrehozása vagy frissítése.
Paraméterek
| Paraméter | Típus | Kötelező | Leírás |
|---|---|---|---|
type | string | Igen | Az elem típusa: "banner", "message", "survey", vagy "tour". |
id | string | Nem | Elem azonosító. Hagyd el a létrehozáshoz, add meg a frissítéshez. |
name | string | Nem | Megjelenített név. |
content | string | Nem | Törzsszöveg (bannerekhez és üzenetekhez). |
widgetId | string | Nem | Társítandó widget. Kihagyás esetén a szervezet alapértelmezett widgetjét rendeli hozzá. |
config | object | Nem | Nyers konfigurációs objektum haladó beállításokhoz (banner stílus, felmérési folyamat, bemutató lépések stb.). |
position | number | Nem | Megjelenési sorrend, ahol az 1 az első. Kihagyás esetén a végére kerül. Ha a hely foglalt, az alatta lévők lejjebb tolódnak. |
Megjelenési szabályok (természetes nyelven):
| Paraméter | Típus | Leírás |
|---|---|---|
trigger | string | Mikor aktiválódjon: "session_start", "page_view", vagy "custom_event". |
triggerDelay | number | Késleltetés másodpercben az aktiváló esemény után. |
customEventName | string | Egyedi JavaScript esemény neve (csak trigger: "custom_event" esetén). |
pageUrlContains | string | Csak olyan oldalakon jelenjen meg, amelyek URL-je tartalmazza ezt a karakterláncot. |
timeOnPageSeconds | number | Csak azután jelenjen meg, hogy a látogató ennyi másodpercet töltött az oldalon. |
frequency | string | Milyen gyakran jelenjen meg: "once", "every_time", vagy "limited". |
frequencyDays | number | Korlátozott gyakoriságnál: hány napon belül. |
frequencyTimes | number | Korlátozott gyakoriságnál: maximum hányszor jelenjen meg. |
countryEquals | string | Csak az adott országból érkező látogatóknak jelenjen meg (ISO 2 betűs kód, pl. "US"). |
countryNotEquals | string | Elrejtés az adott országból érkező látogatók elől. |
| Paraméter | Típus | Leírás |
|---|---|---|
triggerSettings | object | Nyers trigger konfiguráció JSON — felülírja az összes természetes nyelvi trigger paramétert. Haladó használathoz. |
Hogyan működik
Elem létrehozása:
- Csak a
typekötelező. Alapértelmezett név generálódik (pl. „New Banner”). - Az elem a szervezeted alapértelmezett widgetjéhez társul, hacsak nem adod meg a
widgetId-t. Egy widget egy márkához tartozik, tehát ez dönti el, melyik márka látogatói látják. Ha a szervezetednek nincs alapértelmezett widgetje, a hívás magyarázattal elszáll. - Alapértelmezett konfigurációk kerülnek alkalmazásra típus alapján:
- Banner: inline stílus, sárga szín, nincs bezáró gomb.
- Felmérés: üdvözlő üzenet + köszönetüzenet folyamat.
- Termékbemutató: üres lépések, nincs bezáró gomb.
- Chat üzenet: üres konfiguráció.
- A válasz tartalmaz egy
dashboardUrl-t, amely közvetlenül az elem szerkesztőjére mutat.
Megjelenési szabályok:
- Használhatsz természetes nyelvi paramétereket (mint
trigger,pageUrlContains,countryEquals), és az eszköz automatikusan felépíti a trigger konfigurációt. - Vagy átadhatsz nyers
triggerSettingsJSON-t a teljes kontrollhoz. - A természetes nyelvi paraméterek és a
triggerSettingskölcsönösen kizárják egymást — ha mindkettő meg van adva, atriggerSettingsélvez elsőbbséget.
Elem frissítése:
- Add meg az
id-t éstype-ot, valamint a módosítandó mezőket. - Az elem bármilyen frissítése — a neve, a tartalma, a sorrendje, a widgetje vagy a megjelenési szabályai — eldobja mindazt, ami már kézbesítésre sorban állt, de még nem ment ki, így az elem az új változat szerint megy ki, nem a régi szerint.
published paraméter és nincs közzétételi művelet. A vázlatot a visszakapott dashboardUrl-en nézed át, és te magad kapcsolod élesre. Ez szándékos: a közzététel valódi látogatók elé tesz valamit.Példa promptok
- Készíts egy banner vázlatot az ünnepi akciónkról.
- Hozz létre egy Ügyfél visszajelzés nevű felmérést, amely oldalmegtekintéskor 10 másodperc után aktiválódik.
- Hozz létre egy termékbemutatót az új irányítópultunkhoz.
- Hozz létre egy chat üzenetet, amely az ároldalon jelenik meg csak amerikai látogatóknak.
- Állítsd be a bannert, hogy csak egyszer jelenjen meg látogatónként.
- Változtasd a triggert, hogy 30 másodperc eltöltése után az oldalon jelenjen meg.
- Tedd az akciós bannert a lista elejére.
- Frissítsd a banner tartalmát erre: 50% kedvezmény mindenre — csak ma!
- Hozz létre egy felmérést, amely csak a /checkout-ot tartalmazó oldalakon jelenik meg és 5 másodperc után aktiválódik.
- Állítsd be az elemet maximum 3 megjelenésre 7 napon belül.
- Célozd csak a Németországból érkező látogatókat.
- Hozz létre egy chat üzenetet, amelyet a purchase_complete nevű egyedi JavaScript esemény aktivál.
manage_outreach_news
Hír (hírcikk a widget Hírek fülén) létrehozása vagy frissítése. Támogatja az AI tartalom generálást.
Paraméterek
| Paraméter | Típus | Kötelező | Leírás |
|---|---|---|---|
id | string | Nem | Hír azonosító. Hagyd el a létrehozáshoz, add meg a frissítéshez. |
title | string | Feltételes | Hír címe. Létrehozáskor kötelező. |
content | string | Feltételes | HTML tartalom. Létrehozáskor kötelező, hacsak nem használod a generateContent-et. |
generateContent | string | Nem | Írd le a hírcikket, és az AI generálja a HTML-t. Kölcsönösen kizárja a content-et. |
language | string | Nem | Tartalom nyelve (pl. "en", "hu"). Létrehozáskor alapértelmezés: "en". |
widgetId | string | Nem | A widget, amelyben ez a hír megjelenik. Kihagyás esetén a szervezet alapértelmezett widgetjét rendeli hozzá. |
position | number | Nem | Megjelenési sorrend, ahol az 1 az első. Kihagyás esetén a végére kerül. Ha a hely foglalt, az alatta lévők lejjebb tolódnak. |
Hogyan működik
Hír létrehozása:
- Add meg a
title-t és vagy acontent-et (saját HTML) vagy agenerateContent-et (leírás, amelyből az AI megírja). - Az AI jól strukturált HTML hírcikkeket ír fejlécekkel, bekezdésekkel, listákkal és más standard elemekkel. A tartalomgenerálás AI kreditet fogyaszt, ugyanúgy, mint bárhol máshol a Yapletben.
- Visszaad egy
dashboardUrl-t, ahol megtekintheted és szerkesztheted a hírt a vizuális szerkesztőben.
Hír frissítése:
- Add meg az
id-t és a módosítandó mezőket. - A tartalmat AI-val is újraírathatod a
generateContentátadásával — a meglévő tartalmat teljesen lecseréli, nem szerkeszti. - Borítóképet innen nem lehet beállítani. Nincs kép paraméter; a borítóképet az irányítópult szerkesztőjében töltsd fel és csatold.
Példa promptok
- Készíts egy hírvázlatot az új funkció frissítésünkről — generáld a tartalmat AI-val.
- Írj egy Product Update v2.0 című hírcikket az új irányítópult funkcióinkról.
- Hozz létre egy hírt a cég mérföldkövéről — elértük a 10 000 ügyfelet.
- Frissítsd a hír címét erre: Tavaszi 2026 termékfrissítés.
- Generálj egy hírcikket a közelgő webinárium sorozatunkról.
- Hozz létre egy magyar nyelvű hírt az EU piacra való terjeszkedésünkről.
- Tedd a termékfrissítési hírt a lista elejére.
Általános munkafolyamat minták
Promóciós kampány
Készíts egy összehangolt elköteleződési csomagot:
- Banner vázlat →
manage_outreachtípussal:"banner" - Célzott chat üzenet vázlat →
manage_outreachtípussal:"message", oldal URL szűrővel - Hír megírása →
manage_outreach_newsgenerateContent-tel - Átnézés és közzététel → nyisd meg mindegyik visszakapott
dashboardUrl-t, és kapcsold élesre
Példa prompt: Készíts egy teljes promóciós kampány vázlatot: bannert az akció bejelentéséhez, célzott chat üzenetet az ároldalra, és hírt az akcióról. Generálj minden tartalmat AI-val, és add meg az átnézési linkeket.
Visszajelzés gyűjtés
- Felmérés vázlat →
manage_outreachtípussal:"survey", trigger az oldalon töltött idő után - Célzás beállítása → oldal URL szűrő és gyakoriság
- Átnézés és közzététel → nyisd meg a visszakapott
dashboardUrl-t, és kapcsold élesre
Példa prompt: Készíts egy visszajelzési felmérés vázlatot, amely 60 másodperc után jelenik meg bármely /dashboard-ot tartalmazó oldalon, csak egyszer látogatónként, és csak amerikai látogatóknak.
Termékbejelentések
- Hír megírása →
manage_outreach_newsgenerateContent-tel - Banner vázlat →
manage_outreachtípussal:"banner"a figyelem felkeltéséhez - Mindkettő átnézése és közzététele → nyisd meg mindegyik visszakapott
dashboardUrl-t, és kapcsold élesre
Példa prompt: Jelentsd be az új funkciónkat: írj egy hírt AI-generált tartalommal az új analitikai irányítópultunkról, és készíts egy banner vázlatot, amely a hírekhez irányítja a látogatókat.