A Yaplet telepítése után szánj két percet annak ellenőrzésére, hogy minden rendben működik-e, mielőtt élesbe küldöd. Ez a cikk végigvezet egy gyors böngészős ellenőrzésen, és bemutatja a leggyakoribb okokat, amelyek miatt a widget nem jelenik meg.
Gyors vizuális ellenőrzés
Nyisd meg azt az oldalt, ahová a Yapletet telepítetted. Keresd az indítógombot a jobb alsó sarokban. Kattints rá — a widgetnek meg kell nyílnia, és meg kell jelenítenie a főképernyőt, az inboxot vagy a súgóközpontot, a widgeted konfigurációjától függően.
Ha az indítógomb megjelenik és a widget megnyílik, a telepítés kész. Lépj tovább a Bejelentkezett felhasználók azonosítása következő lépésre.
Fejlesztői eszközökkel való ellenőrzés
Ha az indítógomb nem jelenik meg, nyisd meg a böngésző fejlesztői eszközeit (F12 lenyomásával, vagy jobb kattintás → Vizsgálat), és ellenőrizd a következőket:
Hálózat fül — erősítsd meg, hogy a script betöltődött
- Menj a Hálózat fülre.
- Töltsd újra az oldalt.
- Szűrj a
yapletkeresési kifejezésre. - Egy
yaplet.com/api/sdk/loader-re irányuló kérelemnek kell megjelennie 200 vagy 302 állapotkóddal. Ha a kérelem teljesen hiányzik, a kódrészlet nem került hozzáadásra az oldalhoz.
Konzol fül — ellenőrizd a hibákat
Váltj a Konzol fülre, és keress piros hibaüzeneteket, amelyek yaplet-et, embed.yaplet.com-ot vagy Content Security Policy-t említenek. A leggyakoribb hibák és megoldásaik alább találhatók.
Elemek fül — erősítsd meg, hogy a kódrészlet megvan az oldalon
Nyomd meg a Ctrl+F (Mac-en Cmd+F) billentyűkombinációt az Elemek panelen, és keress a Yaplet.initialize kifejezésre. Ha semmit nem talál, a kódrészlet nem lett beillesztve az oldal HTML-jébe.
Gyakori problémák és megoldásaik
A loader kérelem 404-et ad vissza
A Widget ID érvénytelen, vagy a widget törölve lett. A Yaplet irányítópulton kattints a Widgetek menüpontra az oldalsávon, válaszd ki a widgetedet, és győződj meg arról, hogy az oldal tetején látható azonosító megegyezik a kódrészletben szereplővel.
Egyáltalán nincs hálózati kérelem a yaplet.com felé
A kódrészlet nincs az oldalon. Menj vissza a platform telepítési útmutatójához, és ellenőrizd, hogy a script helyesen lett-e mentve:
Content Security Policy (CSP) hiba
Az oldalad CSP-je blokkolja a Yaplet scriptjeit. Add hozzá a következő doméneket a CSP script-src és frame-src direktíváihoz:
script-src 'self' https://yaplet.com https://sdk.yaplet.com;
frame-src 'self' https://embed.yaplet.com;A widget betöltődik, de üres vagy törött képernyőt mutat
Ez általában azt jelenti, hogy a widget frame-re irányuló hálózati kérelem blokkolva van. Ellenőrizd a Hálózat fülön az embed.yaplet.com-ra irányuló sikertelen kérelmeket, és győződj meg arról, hogy azok a domének elérhetők a felhasználó böngészőjéből.
A widget megjelenik fejlesztői környezetben, de élesben nem
Egyes deployment folyamatok eltávolítják az egyéni scripteket, vagy szigorúbb CSP-t érvényesítenek éles környezetben. Ellenőrizd a CDN-t, a fordított proxyt vagy a meta-tag CSP fejléceket az éles környezetben.
Az indítógomb rejtett
Ha a widget sikeresen betöltődött, de az indítógomb nem látható, lehet, hogy programmatikusan elrejtették. Ellenőrizd, hogy a Yaplet.hide() hívásra kerül-e valahol a kódodban. Újra megjeleníteni a Yaplet.showFeedbackButton(true) hívásával lehet (true a megjelenítéshez, false az elrejtéshez).
Még mindig nem működik?
Ha a fentiek egyike sem oldja meg a problémát, indíts egy beszélgetést a Yaplet ügyfélszolgálatával közvetlenül ezen az oldalon lévő widgeten keresztül. Csatolj URL-t, ahol a widgetnek meg kellene jelennie, és a konzolon látható hibákat.