Problemen opsporen: de widget op je website doet het niet goed

Les 8 van 11 · Problemen opsporen. Je zoekt uit waarom de widget op je website het niet goed doet, met de Web Widget-inspector uit les 3.

Les 8 van 11 · Problemen opsporen. Je zoekt uit waarom de widget op je website het niet goed doet, met de Web Widget-inspector uit les 3.

Het scenario

Er staat een nieuwe versie van je website live, en de widget doet het niet meer zoals eerst. Een waarde die de pagina doorgeeft, zoals een producttype, komt niet meer in het ticket. Ingelogde klanten chatten als anonieme bezoekers. Helpartikelen in de antwoorden van je AI-agent openen in een nieuw tabblad. Je webdeveloper vraagt waar hij moet beginnen.

Doel: een lijst van wat de widget op de pagina weigert of negeert, met de reden, voor je developer.

Wat je nodig hebt

• De pagina met het probleem, open in Chrome.
• In dezelfde Chrome aangemeld bij je Zendesk-account: als Agent of Admin om de ticketvelden tegen het account te controleren en het ticket te openen, als Admin om de toegestane domeinen te zien.

Stappen

1. Staat de inspector nog niet open op de pagina, klik dan op het pictogram van de extensie en op Deze widget inspecteren. Sta de site toe als Chrome erom vraagt.
2. Toont de inspector Vastleggen begon later, klik dan op Pagina herladen. Hij ziet dan elk bericht en elk zE-commando vanaf het begin.

3. Lees op het tabblad Overzicht de Controles. Elke controle noemt het probleem, legt het uit en toont, als die er is, de zE-aanroep. Elke controle staat uitgelegd in De controles in de Web Widget-inspector.

   

4. Koppel de controles aan wat je op je site ziet:

   Controle	Wat hij je vertelt
   Gespreksveld, met de ID en naam van het veld	De widget negeert de waarde, bijvoorbeeld omdat een vervolgkeuzelijst alleen een van zijn optiewaarden accepteert, of omdat het veld niet bewerkbaar is voor eindgebruikers.
   Inloggen (JWT)	Het inloggen mislukte of kwam te laat. De tekst zegt waarom.
   Artikellinks openen in een nieuw tabblad	De links wijzen naar een Helpcenter op een eigen domein, zoals help.example.com. De widget opent alleen artikelen op het zendesk.com-adres van je account in zijn artikelweergave.
   De widget weigerde een zE-commando	Een aanroep die de widget niet accepteerde, met de argumenten erbij.
   Dit domein is niet toegestaan	Je merk staat in het Beheercentrum alleen vermelde domeinen toe, en het nieuwe domein staat niet op de lijst.

5. Open het tabblad Account. Onder Inloggen (JWT) zie je de loginUser-aanroepen, elke stap van het inloggen, en de claims van het token dat je site aan de widget geeft. De controles melden een verlopen token, een ontbrekende external_id, een andere scope dan user, een ontbrekende kid, of een token dat na meer dan 4 seconden komt. Werkt het inloggen, dan is de status Ingelogd.

   

6. Op hetzelfde tabblad controleert Ticketvelden en tags de conversationFields en conversationTags van je site zoals de widget dat doet: bestaat het veld, is het bewerkbaar voor eindgebruikers, en past de waarde bij het type. Beide onderdelen staan in De tabbladen Instellingen en Account van de Web Widget-inspector.
7. Wil je zien wat er in Zendesk aankwam, klik dan op de link bij Ticket op het tabblad Overzicht of Berichten.
8. Stuur de controles naar je developer. De kant van Zendesk staat in Hoe vind ik de code van de widget op mijn website. Herlaad na de oplossing de pagina: Controles meldt dan Geen problemen gevonden. Klik op Inspector uitzetten op deze site als je klaar bent.

Waarom dit belangrijk is

• De widget laat een veld of tag die hij niet kan gebruiken weg, zonder dat je bezoeker dat merkt. De controle noemt het veld en de reden, dus je developer weet waar hij moet zoeken.
• De inspector leest het token alleen in de pagina. Het token en de handtekening worden nooit getoond, opgeslagen of verstuurd.
• Dezelfde controles melden ook laag contrast, een launcher waar iets overheen ligt, en een widgettaal die afwijkt van de pagina.
• Voor de ruwe gegevens en tijden van de widget gebruik je het DevTools-paneel uit les 9.