Widget eszközök | Yaplet HU

Á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, megjelenésük és viselkedésük testreszabása, telepítési kódok lekérése, és chatbotokhoz és tudásbázisokhoz való csatlakoztatásuk felett.

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

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

Paraméter	Típus	Kötelező	Leírás
`id`	string	Nem	Widget azonosító. Hagyd el új widget létrehozásához, add meg a frissítéshez.
`isDefault`	boolean	Nem	Csak létrehozáshoz — összekapcsolja az alapértelmezett KB-t, útitervet és dokumentációt az új widgettel.
`name`	string	Nem	A widget megjelenített neve.
`language`	string	Nem	Widget nyelve: `"en"` vagy `"hu"`.
`replyTime`	string	Nem	Várható válaszidő a látogatóknak (pl. `"a few minutes"`, `"in a few hours"`).
`feedbackButtonPosition`	string	Nem	Indítógomb pozíciója: `"BOTTOM_RIGHT"` vagy `"BOTTOM_LEFT"`.
`buttonIcon`	string	Nem	Indítógomb ikon stílus: `"button"` (üzenetbuborék) vagy `"button-2"` (AI ikon).
`backgroundType`	string	Nem	Főképernyő dekoráció: `"decoration"`, `"decoration_blobs"`, `"decoration_lighting"`, `"decoration_gradient"`, `"decoration_ripple"`, `"decoration_grid"`, `"full_image"`, `"small_image"`, vagy `"none"`.
`hideBranding`	boolean	Nem	Yaplet márkajelzés elrejtése a widgetben.
`showTeam`	boolean	Nem	Csapattagok avatárjainak megjelenítése a widgetben.
`askForEmail`	boolean	Nem	Az e-mail-cím megkérése a látogatóktól.
`collectRating`	boolean	Nem	Értékelés kérése, amikor a chat véget ér.
`askForRatingLabel`	string	Nem	Egyedi szöveg az értékelési felszólításhoz.
`menus`	object	Nem	Navigációs menü konfiguráció. Minden kulcs (`home`, `messages`, `news`, `roadmap`, `help`) rendelkezhet `show` (boolean) és `title` (string) tulajdonsággal.
`generalBackground`	string	Nem	Fő chat háttér hex szín (pl. `"#FFFFFF"`). Alszínek automatikusan generálódnak.
`generalAccent`	string	Nem	Elsődleges kiemelés/felület hex szín (pl. `"#083BD9"`). Alszínek automatikusan generálódnak.
`homeTopBackground`	string	Nem	Főképernyő teteje/fejléce háttér hex szín.
`homeBackground`	string	Nem	Főképernyő törzs háttér hex szín.
`homeHighlightLeft`	string	Nem	Főképernyő dekoráció bal oldali kiemelés hex szín.
`homeHighlightRight`	string	Nem	Főképernyő dekoráció jobb oldali kiemelés hex szín.

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.
Használd az isDefault: true értéket a szervezet alapértelmezett tudásbázisának, dokumentációjának és útitervének automatikus összekapcsolásához.

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:

Csak a fő színeket kell beállítanod (generalBackground, generalAccent a chathez; homeTopBackground, homeBackground, homeHighlightLeft, homeHighlightRight a főképernyőhöz).
Az összes levezetett alszín (szöveg színek, szegély árnyalatok, buborék színek stb.) automatikusan generálódik ezekből a fő színekből.

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ír és útiterv füleket a widgeten.
Engedélyezd az e-mail megkérése beállítást az alapértelmezett widgeten.
Változtasd a főképernyő hátterét gradiens dekorációra meleg színekkel.
Mozgasd az indítógombot bal alsó sarokba.
Nevezd át a widgetemet Ügyfélportál-ra.

get_widget_install_code

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

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`widgetId`	string	Igen	A telepítési kódért igényelt widget azonosítója.

Hogyan működik

Visszaadja a widget részleteit egy kész <script> tag-gel, 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 útitervet kapcsol össze egy widgettel, vagy szünteti meg a kapcsolatot.

Paraméterek

Paraméter	Típus	Kötelező	Leírás
`widgetId`	string	Igen	A widget, amelyhez összekapcsolsz.
`type`	string	Igen	Mit kapcsolj össze: `"chatbot"`, `"knowledgebase"`, `"documentation"`, vagy `"roadmap"`.
`id`	string vagy null	Igen	A kapcsolandó erőforrás azonosítója. Adj meg `null`-t a kapcsolat megszüntetéséhez.

Hogyan működik

Chatbot összekapcsolás:

A chatbotot összekapcsolja a widgettel, hogy reagálhasson a látogatókra.
Add meg az id: null értéket a chatbot widgetről való lecsatlakoztatásához.

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

Frissíti a widget kapcsolt erőforrását.
Amikor megváltoztatsz egy kapcsolt tudásbázist vagy dokumentációt, a régi AI tanítási adatok automatikusan tisztításra kerülnek.
A válasz jelzi, ha a tanítási adatokat frissíteni kell (ez az irányítópulton, a widget beállításaiban történik).

Példa promptok

Kapcsold össze a Szupport Bot chatbotomat az alapértelmezett widgetemmel.
Csatlakoztasd a Súgó Központ tudásbázisomat a widgethez.
Csatlakoztasd le a chatbotot a widgetemről.
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.

Á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:

Widget létrehozása → manage_widget
Megjelenés testreszabása → manage_widget (frissítés színekkel, menükkel stb.)
Chatbot összekapcsolása → link_to_widget típussal: "chatbot"
Tudásbázis összekapcsolása → link_to_widget típussal: "knowledgebase"
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, kapcsold össze az AI chatbotomat, csatlakoztasd a tudásbázisomat, és add meg a telepítési kódot.

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 kiemeléssel, és gradiens dekorációval a főképernyőn #1A1A2E felső háttérrel és #6C63FF / #FF6B6B kiemelésekkel.