Experimentele en ongedocumenteerde functies van de Web Widget

Benodigde licentie

App pluscloud AI Agent Preview
Abonnement Suite Team of hoger, Support Team of hoger

Het Lab heeft ook tools voor delen van de Web Widget die Zendesk niet documenteert. Dit artikel zegt wat elke tool doet, wat Zendesk ondersteunt en wat kan breken. De tools staan in het Lab van de Web Widget-inspector; zie Het Lab in de Web Widget-inspector.

Gedocumenteerd, ongedocumenteerd en experimenteel

  • Gedocumenteerd betekent dat het in de documentatie van Zendesk voor ontwikkelaars van de Web Widget staat: de zE-commando's, de aanpassingsopties, de gebeurtenissen en embedded mode. Die ondersteunt Zendesk.
  • Ongedocumenteerd betekent dat de code van de widget het leest, maar dat de documentatie van Zendesk het niet beschrijft. Het werkt in de widgetbuild waartegen de extensie is gecontroleerd (fdbc813, oktober 2026). Zendesk ondersteunt het niet en kan het zonder aankondiging wijzigen of weghalen.
  • Experimenteel betekent dat de extensie gebruikmaakt van de interne router en status van de widget. Dat is helemaal geen interface. Zendesk ondersteunt het niet, en elke update van de widget kan het laten ophouden te werken. Is de widget veranderd, dan zegt het Lab dat in plaats van te gokken.

Het Lab markeert elk onderdeel met Ongedocumenteerd of Experimenteel. Alles daarin werkt alleen in je browser, tot je zelf code op de site zet.

Wat elke tool doet

Onderdeel van het Lab Gemarkeerd Wat het doet
Artikel openen in de widget Experimenteel Toont een openbaar Help Center-artikel van het account in de artikelweergave van de widget, zoals een klik op een artikellink in een antwoord. De test telt geen artikelweergave.
Verborgen schermen Experimenteel Opent schermen waar geen zE-commando bij kan: de lijst met ticketformulieren, een ticketformulier op ID, het contactformulier en de grote weergave van de widget. Er wordt niets verstuurd tot iemand een formulier verstuurt, en dat kan een ticket aanmaken.
Berichtveld vooraf invullen Experimenteel Zet tekst in het berichtveld zonder hem te versturen. Tekst tussen [haken] wordt geselecteerd, klaar om te overschrijven.
Voorbeeld van proactief bericht Experimenteel Toont een proactief bericht met jouw tekst naast de launcher, zonder campagne. Het gebruikt de eigen debughulp van Zendesk en zet ZD-debug aan. Het stuurt één analytics-gebeurtenis met een verzonnen campagne-ID naar Zendesk, en erop reageren werkt niet.
Zendesk-debugschakelaars Ongedocumenteerd Het debuglog (ZD-debug), het socketlog (ZD-debug-ws), het overschrijven van de feature flags van het account, en het vastzetten van een widgetversie. Ze werken na herladen.
Winkelknoppen en analytics Ongedocumenteerd Markeert de knoppen op de pagina die de commercesignalen van de widget zouden tellen als in winkelwagen of uit winkelwagen, en telt de analytics-aanroepen van de widget op deze pagina.
Widget overslaan op deze pagina Ongedocumenteerd Zet window.zESkipWebWidget, zodat de widget niet start op de pagina terwijl de snippet blijft staan.

De editor voor aanpassingen heeft nog twee ongedocumenteerde opties: het scherm vóór het gesprek, met een pictogram, een titel en voorgestelde prompts, en een verbergknop in de koptekst van de widget. Het tabblad Events toont ook gebeurtenissen die Zendesk niet documenteert, zoals preConversationShown, formShown en formSubmitted.

Het onderdeel Artikel openen in de widget van het Lab, gemarkeerd als Experimenteel. Het legt uit dat het de interne router van de widget gebruikt, die Zendesk niet ondersteunt. Onder het veld Artikel-URL of -ID met een URL op bluebirdbikes.zendesk.com en de knop Openen in widget staat het opengeklapte deel Code voor je website met openZendeskArticle().

Code voor je website

De experimentele onderdelen bieden Code voor je website, om hetzelfde op de eigen pagina's van de site te gebruiken: openZendeskArticle(url), openZendeskTicketForm(formId), openZendeskContactForm(), expandZendeskWidget(on) en prefillZendeskComposer(text). Elke functie heeft een uitweg als de widget veranderd is: het artikel opent in een nieuw tabblad, de widget gaat alleen open, of de functie geeft false terug en doet niets. Anders dan de test in het Lab telt de artikelcode een Help Center-weergave, zoals de widget dat doet.

Deze code leunt op de interne onderdelen van de widget. Test hem opnieuw na elke update van de widget. Het Overzicht van de inspector meldt een nieuwe widgetbuild, en met de debugschakelaars zet je de vorige build vast om te vergelijken.

Twee dingen werken ook zonder de interne onderdelen van de widget. Een artikel opent in de widget als een bezoeker klikt op een link naar een openbaar artikel op het eigen Help Center-adres van het account. En prompts met [haken] op het scherm vóór het gesprek vullen het berichtveld als de bezoeker erop klikt; dat is een instelling van de widget en niet zijn interne werking, maar ook die is ongedocumenteerd.

Voordat je de debugschakelaars gebruikt

Het onderdeel Zendesk-debugschakelaars van het Lab, gemarkeerd als Aan en Ongedocumenteerd, met de waarschuwing De console toont privégegevens, de schakelaars Debuglog ZD-debug, aan, en Socketlog ZD-debug-ws, uit, en het begin van het overschrijven van feature flags met Standaard, Aan en Uit per flag.

  • Met het debuglog aan toont de console van de browser het sessietoken van de widget en het gesprek. Deel geen console-uitvoer of screenshots daarvan.
  • Het overschrijven van flags werkt alleen als het debuglog aan staat. Commercesignalen sturen paginaadressen naar Zendesk; zet ze niet aan in een live winkel.
  • Een widgetversie vastzetten vraagt de volledige commit-ID van 40 tekens van een widgetbuild. Met een korte of verkeerde laadt de widget niet tot je hem weghaalt.
  • Toepassen en herladen zet de schakelaars in de opslag van deze site, in je browser. Alles verwijderen en herladen haalt weg wat de inspector zette, en dat doet het uitzetten van de inspector ook. Schakelaars die iemand anders zette, blijven staan.

Dezelfde experimentele tools staan in de zE-console van het DevTools-paneel, als pcw:-commando's; zie Het paneel AI Agent Inspector in Chrome DevTools.

Zie ook

Was dit artikel nuttig?

0

Kom je er niet uit?

Ons supportteam kijkt met je mee.

Opmerkingen

0 opmerkingen

U moet u aanmelden om een opmerking te plaatsen.