Chat Widget | Yaplet HU

Hol találod

A Márka → (a márkád) → Chat widget alatt nyílik meg. A webcíme /dashboard/widgets/<widgetId>. A fülek fölött egy morzsamenü látszik, (a márka neve) › Chat widget, és egy visszanyíl a márka Áttekintés oldalára.

A képernyő osztott: balra a beállítások, jobbra a widget élő előnézete. Keskenyebb képernyőn egy Előnézet / Beállítások gomb vált a kettő között. A jobb felső Változtatások mentése egyszerre írja ki minden fül beállítását — egyetlen kivétellel: a Funkciók fülön lévő Inbox hozzáférés listának saját Mentés gombja van, és a Változtatások mentése nem menti el.

A szerkesztéséhez a Brands jogosultság kell, ami a jogosultságszerkesztőben Márkák és chat widgetek néven jelenik meg. Ugyanez a jog fedi le a márkabeállításokat és az új márkák létrehozását is.

Honnan származik egy chat widget

Nincs widget-lista oldal, és nincs „Új widget” ablak. A chat widget a márkával együtt jön létre: a Márka → ＋ Új márka ablakban van egy Ezeket is hozd létre blokk, jelölőnégyzetekkel a Chat widget, Tudásbázis, Dokumentáció és Vex AI bot számára. Minden négyzet csak akkor látszik, ha a csomagod egyáltalán tartalmazza az adott funkciót, és le van tiltva a „A csomagodban nincs hely további ilyenre.” szöveggel, ha a kereted már elfogyott.

Egy márka widget nélkül is élhet. A widget törlése szándékosan életben hagyja a márkát, tehát a „márka chat buborék nélkül” normális, tartós állapot. Ilyenkor a márka Chat widget sora egy rövid oldalt nyit meg, ami elmagyarázza a helyzetet, és felajánl egy Chat widget hozzáadása gombot — ez is szürke, ha a csomagodban nincs hely további widgetnek. Egy márkához soha nem tartozik egynél több chat widget.

A hat fül

Fül	Mit állítasz ott
Megjelenés	Logó és bot avatár, widget színe, márkaszínek, gombok és üzenetek, kártyák, sarkok, a kezdőlap háttérrétegei, az indító, Kiindulópontok, Újratervezés AI-val
Kezdőoldal	Köszöntés, üdvözlő üzenet, csapat-avatárok, márkajelzés elrejtése és a kezdőképernyő kártyái
Üzenetek	Várható válaszidő, e-mail-gyűjtés, beszélgetés-értékelés
Funkciók	A widget neve és kezdőképernyője, munkamenet-visszajátszás, Súgó, Hírek, Roadmap, inbox hozzáférés, törlés
Telepítés	A beágyazási szkript és a személyazonosság ellenőrzése
Nyelvek	Hol tartanak a saját szövegeid az egyes nyelveken, és a két nyelvi kapcsoló

Megjelenés

A fülnek három szekciója van, fentről lefelé: Widget, Kezdőlap és Indító. A teljes referencia: Megjelenés és témák.

Widget

„Maga a panel: a képeid, a színeid és minden elem formája.” — a widget minden színe ezekből származik, és mindegyiket ellenőrizzük olvashatóságra:

Logó (a Kezdőlap bal felső sarkában látszik) és Bot avatár (az AI válaszai mellett látható kép) — mindkettő egy közös képválasztón keresztül állítható be, aminek a címe „Képeid” — „Minden kép, amit ez a szervezet feltöltött. Válassz egyet újrafelhasználásra, vagy tölts fel újat.” Amit feltöltesz, az automatikusan bekerül a képtárba, és a vezérlőpult bármely más képet kérő helyén újra felhasználható. Logó nélkül a kezdőlapon nem jelenik meg logó; bot avatár nélkül az AI válaszai mellett az AI jel látszik a márkaszíneden.
Widget színe — a widget saját alapszíne: hat minta a Paper-től az Ink-ig, vagy bármilyen saját szín. Ez dönti el, hogy a widget világosnak vagy sötétnek hat.
Márkaszínek — egytől háromig, a legfontosabbal kezdve. Az első festi a gombokat, a linkeket és az aktív fület; a többi a színátmenetekben és a kezdőlap hátterében jelenik meg.
Gombok és üzenetek — Egy szín vagy Színátmenet: hogyan kerülnek a márkaszíneid a gombokra, a látogatók saját üzeneteire és — amíg nem adsz neki saját színeket — az indítóbuborékra.
Kártyák — Semleges, Halvány, Közepes vagy Erős: mennyi márkaszín kerül minden kártyára, címkére és panelre.
Sarkok — Szögletes, Lekerekített, Lágy vagy Teljesen kerek: egyetlen skála a panelhez és mindenhez, ami benne van. Az indítóbuboréknak saját alakja van.

A szekció fejlécében egy kis ikon mutatja, hogy minden szöveg olvasható marad-e; figyelmeztető sáv csak akkor jelenik meg, ha valamelyik szöveg nem éri el a célt, egy Részletek listával a mért párosokról. A fejlécben ül a Kiindulópontok — tizenkét kész megjelenés, Visszavonással — és az Újratervezés AI-val is.

Kezdőlap

A köszöntés mögötti háttér: négy egymásra festett réteg — Szín, Fénykép, Fényfoltok és Vonalak —, plusz a Kiterjedés, ami eldönti, meddig érnek le. Minden réteg kikapcsolható, és bármelyik kombináció működik. Lásd: A kezdőlap háttere.

Indító

A lebegő gomb az ügyfeled oldalán, ami megnyitja a widgetet: melyik sarokban ül (Jobb alsó vagy Bal alsó), melyik ikont mutatja (Üzenet buborék vagy AI ikon), a Buborék színe — a márkaszíneidet követi, vagy kézzel adsz meg egy-három színt —, a Buborék alakja (Kör, Lágy, Lekerekített vagy Szögletes — független a widget Sarkok beállításától), az Ikon színe, amit vagy automatikusan választunk kontrasztra, vagy te rögzítesz, a mért kontraszttal alatta kiírva, és egy választható Kiemelő gyűrű, amely körbefut a buborék szélén. Lásd: Indító gomb.

Újratervezés AI-val

A gomb ugyanazt az AI beállítási ablakot nyitja meg, amit a vezérlőpult máshol is használ. Adj meg egy webcímet, válaszd a Maradjon, ami van vagy az Írd felül lehetőséget, ha a widgetnek már van megjelenése, és nézd meg az eredményt az élő előnézetben — semmi nem íródik ki, amíg rá nem nyomsz a Változtatások mentése gombra. Az Írd felül beállítja a színeket, a kezdőlap hátterét, a sarkokat, a kártyastílust és a buborék megjelenését. Mindkét esetben gyorsgombokat ír a vállalkozásodról; ezeket a mentés után lefordítjuk a többi nyelvre. Köszöntést vagy üdvözlő sort nem ír. A teljes leírás a futáskorlátokkal együtt: Megjelenés és témák.

Kezdőoldal

Kezdőlap beállítások

A Fejléc köszöntés (a nagy sor, pl. „Szia 👋”), alatta az Üdvözlő Üzenet, a Csapat Megjelenítése (látszanak-e az ügyintézők avatárjai) és a Márkajelzés Elrejtése (eltünteti a „Powered by Yaplet” jelvényt; a kapcsoló csak akkor jelenik meg, ha a csomagod vagy egy kiegészítőd tartalmazza a Márkajelzés eltávolítása lehetőséget).

A köszöntést és az üdvözlő üzenetet a saját nyelveden írod be; a többi nyelv a mezők melletti földgömb gomb mögött van. A látogató a saját nyelvén olvassa a szöveget, ha megírtad, különben a te saját szövegedet, az üres mező pedig a Yaplet beépített szövegét mutatja a látogató nyelvén. Lásd: A widget nyelvei.

Kezdőlap kártyák

A kezdőképernyő interaktív kártyái. Közülük kettő rögzített, és mindig elöl áll, ebben a sorrendben: az AI Asszisztens — a „Kérdezz bármit…” mező, alatta az általad megadott gyorsgombokkal — és az Aktív Beszélgetés. Egyik sem mozgatható és nem távolítható el. Alattuk azt a hat típust rendezed el, ami a tiéd: Súgó Cikkek, Dokumentáció, Űrlap, Hírek és Frissítések, Külső Hivatkozás és Beszélgetés Indítása. Azok a kártyatípusok, amelyek a csomagodban nem szereplő funkciókhoz tartoznak, nem tűnnek el: bent maradnak a választóban, szürkén és kattinthatatlanul, alattuk a „Nem része a csomagodnak” felirattal. A Súgó Cikkek és a Dokumentáció ugyanígy szürke marad, amíg a márka közzé nem tesz ilyet a nyilvános címén — ilyenkor a felirat „Tudásbázis szükséges”, illetve „Dokumentáció szükséges”.

Üzenetek

A chat fül: a látogatóknak mutatott Válaszidő — tizenegy rögzített lehetőség közül választva, nem beírva —, hogy elkérje-e a látogatók e-mail-címét, és hogy gyűjtsön-e értékelést a beszélgetés után.

A fülek neve és az értékelés kérdése a Yaplet saját szövege: a widget mindkettőt a látogató saját nyelvén mondja.

Funkciók

Általános

A widget neve — a belső elnevezés, amit a vezérlőpultban látsz, és amit a látogató soha nem olvas —, valamint a Kezdőképernyő: a kezdőlapon nyíljon-e meg a widget, vagy egyenesen a csevegésben.

SDK funkciók

Munkamenet visszajátszás — rögzítse-e a widget a látogatói munkameneteket, hibajelentésekhez és a Munkamenet-visszajátszások képernyőhöz —, plusz a Rögzítési szabályok, amelyekkel bizonyos oldalakra vagy bizonyos látogatókra szűkíthető a rögzítés. Csak akkor látszik, ha a csomagod tartalmazza a munkamenet-visszajátszást.

Súgó

Ez a szakasz nem választ tudásbázist. Csak jelenti, melyik van használatban:

Egy kék értesítés megnevezi azt a tudásbázist, ami éppen a márka nyilvános címén van közzétéve — a képernyőn ez így hangzik: „Ez a tudásbázis van a márka címén (acme.yaplet.help), és ezt mutatja ez a fül.” —, mellette egy Kezelés a márka Tudás oldalán gombbal. Ha ott nincs semmi közzétéve, helyette borostyánszínű figyelmeztetést kapsz: „Nincs tudásbázis a márka címén.” Amit itt beállíthatsz, az csak a megjelenítés: hogy a fül egyáltalán látszik-e, és hogy a súgó szekció végén megjelenjen-e link a márka dokumentációjához.

Hírfolyam

Hogy látszik-e a Hírek fül. A nevét a Yaplet adja, a látogató nyelvén.

Roadmap

Hogy látszik-e a Fejlesztések fül, valamint az, hogy melyik funkciókérés-táblát mutatja. Ez a táblaválasztó az egyetlen tartalomválasztó a widgeten, mert a táblák a szervezethez tartoznak, nem a márkához. Ha megváltoztatod, mentés után újratöltődik az oldal.

Inbox hozzáférés

A szervezeted minden tagja egy-egy kapcsolóval. Ez a widget márkájához ad hozzáférést, nem az egyetlen widgethez — ha valakit kikapcsolsz, az egész márkát elveszíti, a többi képernyőjével együtt. Pontosan ugyanazt a hozzáférést írja, mint a Szervezet oldal Márka hozzáférés szakasza. A tulajdonosok és adminok mindig hozzáférnek, „Mindig hozzáfér” jelvényt kapnak, és a kapcsolójuk le van tiltva. Ennek a szakasznak saját Mentés gombja van, és az oldal Változtatások mentése gombja nem menti el.

Veszélyzóna

A Funkciók fül alján törlöd a widgetet. Az ablak mindkét felével nyíltan elszámol:

Ami törlődik: a widget és minden benne folytatott beszélgetés — az ablak meg is számolja neked („A widget · 128 beszélgetés”). Ez azt jelenti: a csevegések, az üzeneteik és eseményeik, a látogatók, a munkamenet-visszajátszások, és minden banner-kampány, amit ehhez a widgethez állítottál be. Nincs visszavonás.Ami megmarad: a márka és minden, ami hozzá tartozik. A nyilvános címed és a tudásbázisa tovább működik, ahogy a dokumentáció, a tudás, a termékek és a Vex AI ügynök is — az ügyfeled oldalairól egyszerűen eltűnik a chat buborék, és később visszatehetsz egy widgetet.Csak a widget törlése egyetlen kattintással megtörténik, miután elolvastad a számot. Alatta van egy bejelöletlen négyzet, „A teljes márka törlése is”, ami kibontja a teljes márkatörlési megerősítést: valós számokat mindenről, ami elveszne, figyelmeztetést a hozzárendelés nélkül maradó, de tovább számlázódó telefonszámokról, és egy mezőt, ahová be kell írnod a márka nevét. Ez a négyzet gyorsítás, nem az egyetlen út. A Márkabeállítások → Veszélyzóna bármikor közvetlenül törli a márkát, és viszi vele a widgetet is. Ezt az ablakot akkor használd, ha a szűkebb dolgot akarod: leszedni a chat buborékot egy oldalról úgy, hogy a márka és minden, ami hozzá tartozik, tovább működjön.

Telepítés

A Telepítés fülön él a beágyazási szkript.

Másold ki a szkriptet, és illeszd be a weboldaladba a záró </body> tag fölé, minden oldalon, ahol a widgetnek meg kell jelennie.

A személyazonosság ellenőrzése a szkript alatt, ugyanezen a fülön található, mert aki a kódrészletet beilleszti, ugyanaz, akinek a szerveren alá kell írnia a felhasználói azonosítókat. Ha az oldaladon bejelentkezett felhasználók vannak, és Yaplet.identify() hívást tervezel, szükséged lesz rá: a identify() hívásokat elutasítjuk, ha nem tartalmaznak érvényes userHash értéket, enélkül pedig a bejelentkezett felhasználóid névtelen látogatók maradnak. A panel kérésre megjeleníti ennek a widgetnek a saját titkos kulcsát — minden chat widgetnek külön van, és addig be sem töltjük az oldalba —, megmutatja a két kódmintát (írd alá a felhasználó azonosítóját a backendeden, majd add át a hasht az identify() harmadik paramétereként), és le is cserélheted a kulcsot. A csere azonnal elrontja az adott widget összes identify() hívását, amíg az újat nem élesíted, szóval csak tudatosan csináld.

Nyelvek

Itt van a két nyelvi kapcsoló: a Böngészőnyelv követése — az új widgeteknél bekapcsolva — a látogató böngészőjének nyelvén nyitja meg a widgetet, ha az a kilenc nyelv egyike, amelyet a widget beszél, a Nyelvválasztó — alapból látható — pedig megjeleníti a földgömb gombot a kezdőképernyőn, hogy a látogatók maguk válthassanak nyelvet. A fül nyelvenként azt is megmutatja, hány saját szöveged van már lefordítva. Lásd: A widget nyelvei.

Élő előnézet

A szín-, szöveg- és elrendezés-változások abban a pillanatban megjelennek az előnézetben, ahogy megcsinálod őket — nem kell mentened ahhoz, hogy megnézd. Ha a Megjelenés fül Kezdőlap szekciójában egy lehetőségre kattintasz, az előnézet a kezdőképernyőre is vált. A mentés az, amitől a látogatók számára is valósággá válnak. Az egyetlen beállítás, ami másképp működik, a roadmap tábla: ha azt cseréled, a mentés után újratöltjük az oldalt, hogy az előnézet felvegye az új táblát.

Ami a márkához tartozik

Több minden a márkához tartozik, nem a widgethez. Ezek bármelyikének módosítása semmit nem semmisít meg és semmibe nem kerül, és egyik sem kér megerősítést az AI tanítóadatainak törléséhez vagy újragenerálásához.

Mi	Hol találod
Nyilvános webcím (a widget URL)	Márka → Márkabeállítások → Nyilvános cím
A felület nyelve	Márka → Márkabeállítások → Általános — és minden látogató választhat sajátot, lásd: A widget nyelvei
Melyik AI válaszol	Márka → Vex — a márkának egy van, és a widget azt használja
Melyik tudásbázist mutatja a Súgó fül	Márka → Tudás
Melyik dokumentációra mutat link	Márka → Tudás
Melyik űrlapot nyithatja meg egy kártya	Ticketek → (a tábla) → Űrlapok — az űrlapok azon a táblán élnek, amit töltenek

Automatizálás AI-val

A widgetet a Copilot segítségével vagy bármely MCP-kompatibilis klienssel is módosíthatod — írd le, mit szeretnél, és az AI elvégzi. Hogy pontosan mire képes, azt a Widget eszközök referencia mutatja meg. Chatbotot csatlakoztatni egy widgethez nincs köztük, mert az AI a márkáé — és annak módosítása, hogy egy márka melyik tudásbázist teszi közzé, puszta nyilvántartási változás, ami semmit nem töröl.