Widget eszközök

Áttekintés

A widgetek az ügyfelek által látható chat felületek, amelyeket a weboldaladba ágyazol be. A Widget eszköz kategória teljes kontrollt ad az új widgetek létrehozása, jelenlegi beállításaik beolvasása, megjelenésük, Kezdőlapjuk és viselkedésük testreszabása, valamint a telepítési kódok lekérése felett.

manage_widget

Létrehoz egy új widgetet vagy frissít egy meglévőt. Ez egy hatékony eszköz, amely mindent kezel az elnevezéstől a teljes téma testreszabásig.

Paraméterek

Hogyan működik

Widget létrehozása:

• Hagyd el az id paramétert. Egy új widget jön létre alapértelmezett beállításokkal.
• Azonnal testreszabhatod további paraméterek átadásával a létrehozással együtt.
• Egy új márka is létrejön, amely a widgetet tartja. Ez a márka üresen indul — nem örökli meg a meglévő tudásbázisodat, dokumentációdat vagy útitervedet. Ha csak a meglévő widgetedet akartad átszínezni, add meg annak az id-ját.

Widget frissítése:

• Add meg a frissíteni kívánt widget id-ját. Csak az átadott mezők változnak — minden más marad a régi.
• A menü frissítések összefűzésre kerülnek: ha csak a news.show-t változtatod, az összes többi menübeállítás változatlan marad.

Színrendszer:

• Legfeljebb négy dolgot állítasz be: canvas, brandColors, backdrop, brandPaint. Más nincs.
• Minden más — az összes felület, mind a négy szövegszint, a címkék, a jelvények, a színátmenetek, az indítógomb és a Kezdőlap formái — ezekből számolódik, és minden szövegszínt ellenőrzünk pontosan azon a háttéren, amin megjelenik, így a widget bármilyen színnel olvasható marad.
• Ha a négyből bármelyiket megadod, a másik három marad, ahogy volt, így akár csak a hátteret is módosíthatod.

A Kezdőlap háttere:

• Rétegek egymásra festve, mindegyiket külön választod meg, és mindegyiket ki is lehet kapcsolni: a backdrop szín, a widgetre feltöltött fénykép, a homeGlow formák és a homeLines vonalak. Minden kombináció érvényes — egyik réteg sem kapcsolja ki a másikat.
• A fénykép egyszerűen akkor látszik, ha a widgetre fel van töltve. A képet a vezérlőpulton töltöd fel, nem ezen az eszközön keresztül, és a többi réteggel együtt működik — így egy widgeten lehet fénykép és formák is fölötte.
• Hogy mindez meddig ér le, azt a heroExtent dönti el.

Elrendezés:

• A heroExtent, a surfaceFinish és a cornerPreset független a színektől: nem nyúlunk hozzájuk, ha canvas, brandColors, backdrop vagy brandPaint értéket adsz meg. Ha kihagyod őket, a widget megtartja, ami volt.
• A cornerPreset az ügyfeled saját oldalán is eléri a panelt, nem csak a widgeten belül. Az a widget, amelyiknél még soha nem állítottak be sarok-előbeállítást, a mai kinézetét tartja; a beállítás — akár "rounded"-ra is — az, amitől a widget a külső sarkait is az előbeállításból kezdi rajzolni.

Indítógomb:

• Az indítógomb az a gomb a saját weboldaladon, amely megnyitja a chatet. Az alakja független a widget kinézetétől, és nem követi a cornerPreset-et.
• Amíg nem állítod be, a színei a márkaszíneidet és a brandPaint-et követik (egy szín vagy színátmenet), a jel színét pedig automatikusan választjuk. A launcherColors: "brand" és a launcherIconColor: "auto" ezt állítja vissza.

A Kezdőlap szövegei, kártyái és gyorsgombjai:

• A greeting, a welcome, a kártyák címei és leírásai, valamint a gombok szövegei a márka saját nyelvén íródnak — ugyanazok a mezők, amelyekbe a widget Kezdőlap fülén gépelsz. Hogy ez melyik nyelv, azt a get_widget mondja meg (copy_language). Amíg le nem fordítod, a más nyelven olvasó látogató úgy látja a szöveget, ahogy megírtad, nem pedig a Yaplet beépített szövegét a saját nyelvén — az eszköz válasza ezt jelzi is. A fordítás a vezérlőpulton, a widget Nyelvek fülén történik, egy kattintással, ingyenesen.
• A cards és a quickButtons mindig a teljes listát cseréli le. Előbb olvasd be a widgetet a get_widget-tel: az a tétel, amelyik egy meglévő id-t visz, megtartja azt a kártyát vagy gombot az összes nyelvű szövegével együtt; az id nélküli tétel újként kerül be; amit kihagysz, az törlődik.
• Kártyatípusok: MESSAGE (beszélgetés indítása), LINK (az url címen lévő oldal megnyitása), FORM (a formId űrlap futtatása), DOCS (a márka közzétett dokumentációja), HELP (az articleIds tudásbáziscikkei) és NEWS (hírek: newsMode "latest", vagy "manual" a newsIds listával). Csak a MESSAGE, LINK, FORM és DOCS kártyának van title és description mezője.
• Gyorsgomb-típusok: MESSAGE (elküldi a value mondatot), LINK (megnyitja a value címet), a FORM, az ARTICLE és a NEWS_ARTICLE (megnyitja azt az űrlapot, cikket vagy hírt, amelynek az azonosítója a value), valamint a DOCS (megnyitja a márka közzétett dokumentációját; ehhez nem kell value). Minden gombnak van label felirata.
• Ugyanazok a csomagkorlátok érvényesek, mint a vezérlőpulton: űrlap, dokumentáció, tudásbáziscikk vagy hír csak akkor kerülhet a Kezdőlapra, ha a csomagod tartalmazza az adott funkciót. Minden megadott azonosítónak a saját szervezetedhez kell tartoznia.
• A Kezdőlap tetején lévő AI asszisztens mező és a folyamatban lévő beszélgetés kártyája mindig ott van, és nem része a listának.

Válaszidő:

A replyTimeIndex egy sorszám egy rögzített listában, nem mondat — így minden látogató a saját nyelvén olvassa az ígéretet:

Példa promptok

• Hozz létre egy új widgetet.
• Hozz létre egy Prémium Szupport nevű widgetet sötétkék kiemelési színnel.
• Változtasd meg a widgetem témáját #1A1A2E háttérrel és #E94560 kiemelési színnel.
• Rejtsd el a Hírek és a Fejlesztések fület a widgeten.
• Kapcsold be a beszélgetés-értékelést a widgetemen.
• Állítsd a widgetem válaszidejét 10-20 percre.
• Váltsd át a márkámat németre.
• Engedélyezd az e-mail megkérése beállítást az alapértelmezett widgeten.
• Tegyél nagy, kerek fényfoltokat a kezdőlapomra, és halvány rácsot fölé.
• Legyen a márkaszínem a #6C63FF és a #FF6B6B, a gombok pedig színátmenetesek.
• Nevezd át a widgetemet Ügyfélportál-ra.
• Legyen az indítógombom egy szögletes piros gomb kiemelő vonallal.
• Állítsd vissza az indítógombot a márkaszíneimre.
• Változtasd meg a widgetem köszöntését erre: „Üdv az Acme-nál!".
• Adj hozzá egy kártyát, ami az árazási oldalunkra visz, és vedd ki az űrlap kártyát.
• Cseréld le a gyorsgombjaimat erre a kettőre: „Nyitvatartás" és „Asztalfoglalás".

get_widget

Beolvassa egy widget jelenlegi beállításait, anélkül hogy bármit módosítana.

Paraméterek

Hogyan működik

Mindent visszaad, amit a manage_widget módosítani tud, ugyanazokkal a nevekkel: színek, indítógomb, a Kezdőlap háttere és elrendezése, viselkedés, menük és maga a Kezdőlap — a köszöntés, a köszöntés alatti sor, valamint a kártyák és a gyorsgombok az azonosítóikkal és a márka saját nyelvén írt szövegeikkel (copy_language). A null szöveg azt jelenti, hogy a widget a Yaplet beépített szövegét mutatja, amelyet minden látogató a saját nyelvén olvas.

A Copilot így olvassa be a widgetet, mielőtt kártyákat vagy gyorsgombokat szerkeszt, mert a manage_widget ezeket a listákat egészben cseréli le, és egy meglévő kártyát vagy gombot csak az azonosítója alapján tart meg. Semmit nem módosít, ezért a Copilot nem kér hozzá jóváhagyást.

Példa promptok

• Hogy néz ki most a widgetem?
• Milyen gyorsgombok vannak a widgetemen?

get_widget_install_code

Legenerálja a widgeted weboldalra való telepítéséhez szükséges JavaScript kódot.

Paraméterek

Hogyan működik

Visszaadja a widget részleteit egy kész beillesztő kódrészlettel (script taggel), amelyet beilleszthetsz a weboldal HTML-jébe. A szkript aszinkron módon tölti be a Yaplet widgetet, és nem lassítja le az oldaladat.

Példa promptok

• Add meg az alapértelmezett widgetem telepítési kódját.
• Hogyan telepíthetem a Prémium Szupport widgetet a weboldalamra?
• Generáld a beágyazási szkriptet a widgetemhez.

link_to_widget

Chatbotot, tudásbázist, dokumentációt vagy útiterv-táblát kapcsol össze egy widgettel, vagy szünteti meg a kapcsolatot.

Paraméterek

Hogyan működik

Chatbot összekapcsolás:

• Beállítja a widget AI ügynökét. Csak AI típusú chatbotot fogad el — chat munkafolyamat nem kerülhet ebbe a helyre, az eszköz magyarázattal visszautasítja.
• Ugyanez a választás a widget márkájára is felíródik, és az AI valójában onnan olvas.
• Adj meg id: null értéket a widget AI ügynökének törléséhez. Ez nem a fenti lépés fordítottja: csak a widgetről veszi le a botot. A márka megtartja a Vex ügynökét, és az továbbra is megjelenik a Márka → Vex oldalon; a márka chat munkafolyamatait pedig nem érinti.

Tudásbázis / Dokumentáció / Útiterv összekapcsolás:

• Frissíti a widget kapcsolt erőforrását, tudásbázis és dokumentáció esetén pedig ugyanazt a választást felírja a widget márkájára is — az AI és a nyilvános súgóoldal valójában onnan olvas.
• Semmi nem törlődik és semmi nem dolgozódik fel újra. Amit egy forrás megtanult, az a forráshoz tartozik, nem ahhoz a widgethez, amelyik éppen megjeleníti — a későbbi visszakapcsolás azonnali és ingyenes.
• Láthatatlan viszont nem marad. A tudásbázis vagy a dokumentáció összekapcsolása azt is jelenti, hogy az kerül ki a márka nyilvános címére, az addigi pedig lekerül róla; id: null esetén a márka nyilvános címén nem marad kint semmi.
• A válasz tartalmaz training_data_cleared és training_data_needs_refresh jelzőt is, valamint egy megjegyzést a tanítási adatok frissítéséről a widget beállításaiból. Hagyd figyelmen kívül őket: semmilyen indexelt tartalom nem törlődik, és nincs mit frissíteni.

Példa promptok

• Csatlakoztasd a Támogatás tudásbázisomat a widgethez.
• Cseréld le a widgeten lévő tudásbázist az imént létrehozottra.
• Kapcsold össze a dokumentációt és az útitervet az alapértelmezett widgetemmel.
• Melyik tudásbázist szolgálja ki jelenleg a widgetem?
• Töröld az útiterv kapcsolatot a widgetemről.

Általános munkafolyamat minták

Teljes widget beállítás

Egy teljes widget beállítás általában a következőket tartalmazza:

1. Widget létrehozása → manage_widget
2. Megjelenés testreszabása → manage_widget (frissítés színekkel, indítógombbal, menükkel stb.)
3. A Kezdőlap kitöltése → manage_widget (köszöntés, kártyák, gyorsgombok)
4. Telepítési kód lekérése → get_widget_install_code

Példa prompt: Állíts be egy teljes widgetet: hozz létre egyet Szupport Chat névvel kék témával, és add meg a telepítési kódot.

A Kezdőlap szerkesztése

1. A widget beolvasása → get_widget (a jelenlegi kártyák és gyorsgombok az azonosítóikkal)
2. Az új listák elküldése → manage_widget a cards és/vagy a quickButtons mezővel, megtartva minden maradó kártya vagy gomb id-ját

Példa prompt: Tartsd meg az első két gyorsgombomat, a többit töröld, és adj hozzá egyet, ami a visszaküldési űrlapunkat nyitja meg.

Téma testreszabás

Egyetlen hívással teljes vizuális átalakítást végezhetsz:

Példa prompt: Add a widgetemnek sötét témát #0F0F23 háttérrel, #6C63FF és #FF6B6B márkaszínekkel, színátmenetes háttérrel, valamint foltokkal és halvány ráccsal a kezdőlapon.