---
title: Weboldali widget, ügynök linkje és telefonos alkalmazás
description: Hogyan helyezhető el az ügynök a weboldalon egyetlen kódsorral, hogyan működik a rövid link a közösségi média és üzenetküldő alkalmazások számára, és hogyan telepíti a vásárló az ügynököt telefonjára alkalmazásként.
section: guide
keywords: weboldal widget, widget kód, Tilda, Shopify, WordPress, ügynök link, PWA, push értesítés, link előnézet
updated: 2026-09-06
---
Az ügynök két formában jelenik meg. A weboldalon egy sarokban lévő ablak, ami gombra nyílik. Közösségi médiában és üzenetküldőkben egy rövid linkkel elérhető oldal, ami kis boltként működik és telefonra alkalmazásként telepíthető. A katalógus, a feltételek, a beszélgetések és a megkeresések azonban közösek: az ügynök egy.

Az alább leírtak mind a „Widget és link” szekcióban találhatók.

## Az ügynök linkje

Egy rövid cím, például `comag.vibevox.pro/c/your-shop`. Elhelyezhető Instagram, TikTok vagy Telegram profilfejlécben, elküldhető WhatsAppon, vagy beilleszthető YouTube videó leírásába.

Üzenetküldőbe küldve a link kártyává alakul: borítókép, bolt neve és leírás. Mindhárom mező testreszabható:

- **Előnézeti cím** — alapértelmezetten a bolt neve.
- **Előnézeti leírás** — egy rövid mondat arról, hogy mit lehet kérdezni.
- **Borítókép** — automatikusan generálódik az akcentusszínéből, logójából és termékfotóiból. Feltölthet sajátot is, mérete 1200 x 630 képpont.

Az előnézet ellenőrzésének legegyszerűbb módja, ha elküldi a linket saját magának Telegramon.

## Kód a weboldalhoz

Egyetlen sor, amelyet a záró `</body>` tag elé kell beilleszteni minden oldalon. A kezelőfelületen egy gombbal másolható.

Hova illessze be a népszerű platformokon:

| Platform | Hova illessze be |
| --- | --- |
| Tilda | „Webhelybeállítások” → „Továbbiak” → „HTML-kód a body-hoz” |
| Shopify | „Téma” → „Kód szerkesztése” → `theme.liquid`, a `</body>` elé |
| WordPress | „Megjelenés” → „Témaszerkesztő” → `footer.php`, vagy kódbeillesztő bővítmény |
| Wix | „Beállítások” → „Egyéni kód” → hozzáadás a Body end-hez |
| Saját webhely | Közvetlenül a sablonba a `</body>` elé |

Beillesztés után egy gomb jelenik meg a jobb alsó sarokban. A pozíció a beállításokban balra változtatható, a szín és a téma szintén ott állítható.

> [!tip] A widget aszinkron módon töltődik be, és nem lassítja az oldalt. Ha szigorú CSP-t használ, engedélyezze a `comag.vibevox.pro` domaint a `script-src` és `connect-src` beállításokban.

## Megjelenés

Beállítások, amelyeket a vásárló lát:

- **Bolt neve és az asszisztens neve.** Az utóbbi a beszélgetőpartner aláírása a chat fejlécében.
- **Üdvözlés.** Az első mondat. Egy jó üdvözlés hasznosságot ígér, nem csak köszön.
- **Tippek a párbeszéd elején.** Legfeljebb négy gomb kérdésekkel. Ha üres, automatikusan generálódnak a katalógus alapján.
- **Kommunikációs stílus.** Listából választható vagy saját: „meleg és tömör”, „szakértő, magázódó”.
- **Akcentusszín.** Egyetlen szín határozza meg a gombot, a linkeket és a kártyák kiemelését.
- **Logó.** Ez lesz az alkalmazás ikonja a telefonon.
- **Mikrofon gomb.** Beszédfelismerés a böngészőben. Ha a böngésző nem támogatja, a vásárló hangüzenetet rögzít, amit a Gemini átír.

Jobbra élő előnézet látható: gépelés közben változik. A „Mentés” gomb viszi át a változtatásokat a weboldalra.

## Világos és sötét téma

A chatnek két megjelenése van, és egyetlen beállítási mezőben kapcsolhatók át – a „Téma” alatt.

| Érték | Amit a vásárló lát |
| --- | --- |
| Mint a látogatóé | A téma alkalmazkodik a telefon vagy számítógép beállításaihoz: éjszaka sötét, nappal világos |
| Világos | Mindig világos ablak, eszköztől függetlenül |
| Sötét | Mindig sötét ablak |

Alapértelmezetten a „mint a látogatóé” van beállítva, és a legtöbb esetben ez a helyes választás: aki sötét témát használ a telefonján, nem kap fehér villanást az arcába, aki pedig a világoshoz szokott, az megszokott ablakot lát.

Rögzített téma akkor szükséges, ha maga a weboldal is egy adott stílusban készült. Egy sötét landing oldal világos chatablakkal a sarokban foltnak tűnik, és fordítva. Ilyen esetben állítsa be ugyanazt a témát, mint a weboldalé, és a widget beleolvad a designba.

Az akcentusszín mindkét téma felett működik: a gombok, linkek és kártyák kiemelése az Ön céges színét veszi fel, míg a háttér és a szöveg a témával együtt változik. Mindkét változatot a legegyszerűbben a jobb oldali előnézetben ellenőrizheti – azonnal újrarajzolódik, amint átkapcsolja az értéket.

## A termékkártyák az Ön weboldalára vezetnek

Az ügynök nem összefüggő szöveggel válaszol, hanem kártyákkal: fénykép, név, ár, gomb. A gomb mögött mindig egy cím áll – a termék oldala az Ön weboldalán, vagy az eredeti bejegyzés a közösségi médiában, ha a kártya onnan származik.

A weboldalon belüli widgetben az átirányítás ugyanabban az ablakban történik, hogy ne szaporodjanak a lapok. Az ügynök linkelt oldalán a kártya új lapon nyílik meg, hogy a párbeszéd ne vesszen el.

A Shopify és WooCommerce alapú boltok számára van egy kellemes részlet: a gomb nem csak megnyitja a terméket, hanem a platform saját mechanizmusával a bolt kosarába helyezi azt. Részletek a [Shopify](/wiki/hu/platform-shopify) és [WordPress](/wiki/hu/platform-wordpress) cikkekben.

És még valami: a widget beolvassa a termék jelölését azon az oldalon, ahol megnyílt, és átadja azt az ügynöknek. Ezért a „kékben is van?” kérdés a termékkártyán a kontextusban értelmeződik, anélkül, hogy pontosítani kellene, miről van szó.

## Alkalmazás a vásárló telefonján

Az ügynök oldala alkalmazásként telepíthető. A vásárló megnyitja a linket telefonról, látja a kezdőképernyőhöz adás lehetőségét, és kap egy ikont az Ön logójával.

- **Név az ikon alatt** — egy szó, legfeljebb 12 karakter. Ha üres, a bolt nevének első szavát vesszük.
- **Ikon** — feltöltött logó. Ha nincs logó, a Commerce Agents logója kerül felhasználásra.
- iPhone-on a telepítés a „Megosztás” → „Hozzáadás a főképernyőhöz” útvonalon történik, ez a Safari korlátozása, és az ügynök maga súgja a lépéseket.

Telepítés után a vásárlónak push értesítéseket küldhet a „Párbeszédek” szekcióból. Az engedélyt maga adja meg, a chat fejlécében lévő harang ikonra kattintva.

## Mellékletek a vásárlótól

A chatben van egy gemkapocs ikon: fotó, videó vagy hangfájl legfeljebb 20 megabájtig. Ha a böngészőben nincs beszédfelismerés, a mikrofon nyomva tartása hangüzenetet rögzít.

A fájlt a Gemini elemzi: mi látható, milyen szöveg van a képen, mi hangzott el. Az ügynök ezen elemzés alapján válaszol, Ön pedig látja a párbeszédben magát a fájlt és egy rövid leírást is. Ez hasznos olyan területeken, ahol könnyebb megmutatni, mint leírni: alkatrészek, javítás, fotó alapján történő kiválasztás.

## Vásárlási pixel kosárral rendelkező weboldalhoz

Ha a fizetés az Ön weboldalán történik, és nem a chatben, illesszen be egy rövid kódrészletet a kezelőfelületről a „Köszönjük a megrendelést” oldalra, behelyettesítve a rendelési számot és az összeget. A vásárlás hozzárendelődik a párbeszédhez, és a statisztikákban látható lesz, mely beszélgetések végződnek eladással.

## Ellenőrzés

Három perc, amit érdemes rászánni a beállítás után:

1. Nyissa meg a weboldalt inkognitó módban, és kattintson a widget gombjára. Tegyen fel egy kérdést egy termékkel kapcsolatban.
2. Nyissa meg az ügynök linkjét telefonról. Ellenőrizze, hogy felajánlja-e a telepítést.
3. Küldje el a linket magának egy üzenetküldőben, és nézze meg az előnézetet.
4. Nézzen be a „Beszélgetések” menüpontba: mindkét beszélgetésnek meg kell jelennie ott.

## Gyakori kérdések

### A weboldalon lévő widget és a link két külön ügynök?

Ugyanaz. A katalógus, a feltételek, a beszélgetések és a megkeresések közösek. Csak a megjelenés tér el: a weboldalon egy ablak jelenik meg a sarokban, a linken keresztül pedig egy teljes képernyős oldal, amit telefonra is telepíthet.

### Meg lehet változtatni a link címét?

A cím az üzlet nevéből generálódik a kirakat létrehozásakor. Ha másra van szüksége, írjon nekünk Telegramon — manuálisan módosítjuk, hogy ne törjük el a már kihelyezett linkeket.

### A widget lassítani fogja a weboldalt?

Nem. A szkript keveset nyom, és aszinkron módon töltődik be, a lap fő tartalma után. Maga a chatablak csak akkor töltődik be, amikor a vásárló megnyomja a gombot.

### Mit lát a vásárló, ha az ügynök ki van kapcsolva?

Semmit: a gomb nem jelenik meg, a linkre kattintva pedig az oldal azt mutatja, hogy az ügynök nem elérhető. A kapcsoló a „Widget és link” menüpontban található.

### Hogyan távolítható el a „Powered by Commerce Agents” felirat?

Egyelőre sehogy: a felirat minden díjcsomagban megmarad. Kattintható, és a weboldalunkra vezet — ez az ár része, aminek köszönhetően a szolgáltatás 29 €-ba kerül egy jelentősen nagyobb összeg helyett.