Het tabblad Overzicht van de Web Widget-inspector toont wat er mis kan gaan met de widget op een website, van geweigerde zE-commando's tot contrast en inloggen.
Benodigde licentie
| App |
pluscloud AI Agent Preview |
| Abonnement |
Suite Team of hoger, Support Team of hoger |
Het tabblad Overzicht van de Web Widget-inspector toont wat er mis kan gaan met de widget op een website, van geweigerde zE-commando's tot contrast en inloggen. Dit zijn alle controles en wat ze betekenen.
De controles lezen
De controles staan onder Controles op het tabblad Overzicht, en het aantal staat op de geminimaliseerde inspector. Geen problemen gevonden. betekent dat er geen geldt. Elke controle heeft een niveau: rood is een fout waar de widget op reageert, oranje een waarschuwing, blauw informatie. Veel controles tonen de aanroep of waarde waar ze over gaan in een coderegel. Sommige hebben een knop: Pagina herladen, Tonen in het lab, Test stoppen, Widget weer tonen of Voorbeeld verwijderen.
De controles volgen de regels van de widget zelf, zoals de inspector ze in de code van de widget leest (build fdbc813, oktober 2026). Hoe je de inspector aanzet, staat in Aan de slag met de Web Widget-inspector.
De widget op de pagina
| Controle |
Wat het betekent |
| Geen Zendesk-snippet gevonden |
De pagina heeft geen ze-snippet-script, of laadt de widget op een andere manier. De inspector blijft een halve minuut zoeken. |
| Widgetconfiguratie niet beschikbaar |
De openbare configuratie van de widget kon niet worden geladen voor de sleutel in de snippet. |
| Geen messaging-Web Widget |
De sleutel hoort bij de Web Widget (Classic), die de inspector niet ondersteunt. |
| Zendesk-snippets op deze pagina |
De snippet laadt meer dan één keer, wat het verkeerde merk of een tweede widget kan laden. |
| De widget is niet zichtbaar |
Geen launcher of berichtenvenster, en de site heeft hem niet met zE verborgen. |
| Er ligt iets over de launcher |
Een element van de site ligt boven op de launcher. De coderegel noemt het. |
| Taal van de widget wijkt af van de pagina |
De site zet met zE een locale die afwijkt van de taal van de pagina. |
| Dit domein is niet toegestaan |
Voor beheerders: het merk staat in het Beheercentrum alleen vermelde domeinen toe, en dit domein staat niet op de lijst. |
zE-commando's en de meldingen van de widget
| Controle |
Wat het betekent |
| De widget weigerde een zE-commando |
Het commando bestaat niet in deze widget, met de fout en de aanroep. |
| Fout van de widget, Waarschuwing van de widget |
Wat de widget in de console schreef. |
| Customization die de widget niet toepast |
Een waarde in de aanpassingen van de site die de widget weigert. Een ongeldige kleur laat hem de hele aanroep negeren. |
| Oude vorm van een zE-aanroep, Commando van de Classic-widget |
zE({…}) en webWidget-commando's horen bij de Classic-widget. De messaging-widget geeft een fout en doet niets. |
| Er is geen ready-event |
messenger:on 'ready' bestaat niet, al noemt de handleiding van Zendesk voor de embedded mode er een. Gebruik zE(function () { … }). |
| updateUser: aanroepen, alleen de laatste wordt verstuurd |
Aanroepen binnen 500 ms vervangen elkaar in plaats van samen te voegen. Zet alle velden in één aanroep. |
| Locale instellen wijzigt ook de gebruiker |
Informatie: de locale wordt ook bij de gebruiker van de bezoeker in Zendesk opgeslagen, zodra die gebruiker bestaat. |
| newConversation opent de widget niet, navigation opent de widget niet |
Roep ook zE('messenger', 'open') aan. |
| navigation kan een gebruiker en een gesprek maken |
Naar de gesprekkenlijst navigeren maakt die in Zendesk aan, ook voor bezoekers die nooit iets schrijven. |
| unreadMessages vuurt meteen en kan niet worden afgemeld |
De callback draait meteen met het huidige aantal, en er is geen functie om te stoppen met luisteren. |
| fetchConversations werkt ook met één gesprek |
Informatie: gebruik zE('messenger:get', 'config') om de twee modi te onderscheiden. |
Kleuren, velden, tags en inloggen
| Controle |
Wat het betekent |
| Laag contrast |
Een combinatie van tekst en achtergrond in de widget onder 4,5:1, het niveau WCAG AA voor gewone tekst. Onder 3:1 is het een fout. De coderegel zegt waar elke kleur vandaan komt: het Beheercentrum, de site, het Lab of de standaard. |
| Gespreksveld |
Een waarde die de site met conversationFields zet en die de widget negeert: een onbekende ID, een systeemveld of inactief veld, een veld dat klanten niet mogen bewerken, of een waarde die niet bij het soort veld past. |
| Gespreksvelden niet gecontroleerd |
Log in op het account als agent of beheerder om de veld-ID's en waarden te controleren. |
| Gesprekstag |
Een tag uit conversationTags die de widget wijzigt of weglaat: spaties worden liggende streepjes, tags met speciale tekens of langer dan 255 tekens vallen weg, en alleen de eerste 20 tags blijven. |
| Inloggen (JWT) |
Problemen met het token dat de site aan loginUser geeft: geen JWT binnen 4 seconden, een mislukte login, een ontbrekende kid of external_id, een andere scope dan user, een ander algoritme dan HS256, een verlopen token of een token dat binnen 5 minuten verloopt. |
| Cookies uitgezet |
De site zet de messenger-cookies op none: de widget is verborgen of kan het gesprek niet bewaren. |
| Gesprekken worden vergeten |
Informatie: de gespreksgeschiedenis staat op vergeten, dus een nieuwe browsersessie begint een nieuw gesprek. |
| Artikellinks openen in een nieuw tabblad |
Links naar Help Center-artikelen in antwoorden die de widget niet in zijn artikelweergave opent: een Help Center op een eigen domein, een link zonder taalcode, of een artikel waarvoor je moet inloggen. |
| Artikelweergave uit |
Het account heeft de artikelweergave van de widget niet. |
Hoe de inspector velden, tags en het inlogtoken controleert, staat in De tabbladen Instellingen en Account van de Web Widget-inspector.
Toegankelijkheid
| Controle |
Wat het betekent |
| Widget verborgen voor schermlezers |
Een element rond de widget heeft aria-hidden of inert, vaak achtergelaten door een modal of cookiebanner. |
| Launcher niet bereikbaar met het toetsenbord |
De launcherknop heeft tabindex="-1" of is uitgeschakeld. |
| Launcher zonder naam voor schermlezers |
De launcherknop heeft geen label, dus een schermlezer zegt alleen "knop". |
| Launcherframe zonder titel |
Het frame van de launcher heeft geen title-attribuut. |
Wijzigingen en de inspector zelf
| Controle |
Wat het betekent |
| Nieuwe widgetbuild, Feature flags gewijzigd |
Zendesk heeft de widget of de widgetflags van het account bijgewerkt sinds deze browser dit account voor het laatst zag. Controleer of de instellingen van de site nog werken. |
| Vastleggen begon later |
De inspector startte na het laden van de pagina. Herlaad om alles vanaf het begin te zien. |
| AI agent niet zichtbaar voor jou |
Log in op het account of het AI agents-dashboard ervan om de AI-agent en het gesprekslogboek te zien. |
| Lab staat aan, Labinstelling die de widget niet toepast |
Je ziet de widget met je aanpassingen uit het Lab, en een waarde daarin die de widget weigert. |
| Test embedded mode, Zendesk-debugschakelaars staan aan, Het lab slaat de widget over op deze pagina, Voorbeeld van proactief bericht staat aan |
Er loopt een test uit het Lab in deze browser. Zie Het Lab in de Web Widget-inspector en Experimentele en ongedocumenteerde functies van de Web Widget. |
| Deze pagina slaat de widget over |
De site zet window.zESkipWebWidget, dus de widget start niet op deze pagina. |
Zie ook
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.