Benodigde licentie
| App | pluscloud AI Agent Preview |
| Abonnement | Suite Team of hoger, Support Team of hoger |
| Toegang | Clientadmin, Clienteditor, Clientgebruiker |
De preview biedt elke gedocumenteerde optie van de aanpassingsaanroep van de messenger, zodat je ze eerst op het gesprek van je AI-agent ziet.
Het paneel met aanpassingen openen
Met de Web Widget als preview-kanaal klik je in de werkbalk op Preview-instellingen en daarna onderaan het paneel op Web Widget-aanpassingen. De preview volgt elke wijziging direct. Hoe je het kanaal kiest, staat in Het kanaal voor de preview kiezen.
Het paneel bevat alle 44 gedocumenteerde opties van zE('messenger:set', 'customization', ...), plus de instellingen zIndex, cookies en behavior. De groepen zijn Venster, Gesprek, Gesprekkenlijst, Positie, Themakleuren, Overige instellingen, Gedrag en Scherm vóór het gesprek, gevolgd door Proactief bericht (voorbeeld) en de insluitcode. Het Lab van de Web Widget-inspector gebruikt hetzelfde paneel op de echte widget van een website; zie Het Lab in de Web Widget-inspector.
Wat doet deze instelling?
Elke optie heeft een kleine i achter de naam. Beweeg erover, of ga erheen met de Tab-toets, en je ziet een korte animatie van wat de optie in de widget verandert. Staat je computer ingesteld op minder beweging, dan zie je een stilstaand beeld. Meer over deze animaties staat in Zien wat een instelling doet.
Venster
| Optie | Waarden | In de code |
|---|---|---|
| Koptekst verbergen | Aan of uit. Geldt op beide pagina's, tenzij een pagina een eigen instelling Koptekst heeft. | common.hideHeader |
| Verbergknop in de koptekst (Ongedocumenteerd) | Aan of uit. Verbergt de widget en de launcher, zoals zE('messenger', 'hide') doet; de preview biedt dan Weer tonen. |
common.isHideButtonVisible |
| Inhoudsschaal (%, 50–200) | 50 tot 200. De inhoud schaalt mee; het venster houdt zijn formaat, net als in de widget. | common.contentScale |
| Stijl | Standaard van account, Standaard (tekstballonnen) of Minimalistisch. Dezelfde optie als Stijl in de preview-instellingen. | common.stylingPreset |
Gesprek
| Optie | Waarden | In de code |
|---|---|---|
| Koptekst | Standaard, tonen of verbergen | messageLog.hideHeader |
| Avatar in koptekst verbergen | Aan of uit | messageLog.header.hideAvatar |
| Plaats van "Gesprek beëindigen" | Standaard (knop in koptekst), knop in koptekst of optiemenu | messageLog.endConversationOption.position |
| Avatar verbergen | Aan of uit | messageLog.avatar.hidden |
| Avatarpositie | Standaard, zijkant, boven, of boven en zijkant | messageLog.avatar.position |
| Avatargrootte (px, 16–64) | 16 tot 64 | messageLog.avatar.size |
| Berichten van AI agent en medewerker · Ballon, en · Max. breedte (%, 10–100) | Standaard, tonen of verbergen; 10 tot 100 | messageLog.businessMessage |
| Berichten van de klant · Ballon, en · Max. breedte (%, 10–100) | Standaard, tonen of verbergen; 10 tot 100 | messageLog.userMessage |
| Geciteerde bronnen | Knop "Bronnen", lijst met opsommingstekens of genummerde lijst | messageLog.citations.sources |
Een maximale breedte die je leeg laat, gebruikt de responsieve breedte van de widget. Gesprek beëindigen verschijnt alleen als Klanten kunnen gesprekken beëindigen aanstaat in de preview-instellingen, bij een lopend gesprek met een koptekst. Bevestigen beëindigt in de preview niets; zie De preview-instellingen.
Gesprekkenlijst
Voor widgets met meerdere gesprekken. De preview toont de lijst als Gesprekken in de preview-instellingen neerkomt op meerdere gesprekken.
| Optie | Waarden | In de code |
|---|---|---|
| Knop "Nieuw gesprek" verbergen | Aan of uit | conversationList.hideNewConversationButton |
| Koptekst | Standaard, tonen of verbergen | conversationList.hideHeader |
| Avatars | Standaard, tonen of verbergen | conversationList.avatar.hidden |
| Avatargrootte (px, 16–64) | 16 tot 64 | conversationList.avatar.size |
| Tijdstempels | Standaard, tonen of verbergen | conversationList.hideTimestamp |
| Berichtvoorbeeld | Standaard, tonen of verbergen | conversationList.hideMessagePreview |
| Scheidingslijnen | Standaard, tonen of verbergen | conversationList.hideDivider |
| Groeperen op datum | Standaard, uit of aan | conversationList.groupByTimestamp |
Standaard volgt de stijl. De minimalistische stijl verbergt avatars, tijdstempels, berichtvoorbeelden en scheidingslijnen en groepeert de lijst op datum; een keuze die je hier maakt, gaat daarvoor.
Positie
Alleen voor de zwevende widget. Een leeg veld gebruikt de instelling uit het Beheercentrum.
| Optie | Waarden | In de code |
|---|---|---|
| Kant | Standaard, links of rechts | position.side |
| Desktop · Horizontale afstand (px) en Verticale afstand (px) | 0 tot 400 in het paneel | position.offset.web |
| Mobiel · Horizontale afstand (px) en Verticale afstand (px) | 0 tot 400 in het paneel | position.offset.mobile |
De preview toont de desktopwidget, dus de afstanden voor mobiel komen alleen in de insluitcode.
Themakleuren
Alle 17 thema-eigenschappen van de messenger: primary, onPrimary, message, onMessage, action, onAction, businessMessage, onBusinessMessage, background, onBackground, conversationListBackground, onConversationListBackground, error, onError, notify, onNotify en onSecondaryAction. Beweeg over een kleur om te zien wat hij kleurt. error en onError kleuren fouten bij afbeeldingen en formulieren en de meldingen bij berichten die niet zijn afgeleverd; notify en onNotify kleuren het aantal ongelezen berichten in de gesprekkenlijst, de badge op de gesloten launcher en de scheidingslijn Nieuw in het gesprek. Een kleur die je leeg laat, toont auto en houdt de instelling uit het Beheercentrum of de standaard van de widget. Het kruisje naast een kleur wist hem.
Overige instellingen en Gedrag
| Optie | Waarden | In de code |
|---|---|---|
| Stapelvolgorde (zIndex) | Een getal | zE('messenger:set', 'zIndex', ...) |
| Cookies en opslag | Alle, Alleen functioneel (geen analyse) of Geen. Geen verbergt de widget en wist de opslag ervan. | zE('messenger:set', 'cookies', ...) |
| Berichtveld niet focussen bij nieuwe berichten | Aan of uit | behavior.composer.focus.suppressAutoFocus |
| Alt-tekst van het logo in de koptekst | Je eigen tekst, of Geen alt-tekst. Leeg gebruikt de eigen tekst van de widget, Bedrijfslogo, in de taal van de widget. | behavior.header.logo.altText |
De stapelvolgorde, de cookie-instelling en de focusinstelling komen alleen in de insluitcode; de preview toont ze niet.
Scherm vóór het gesprek
Het scherm dat de widget vóór het eerste bericht kan tonen, met een pictogram, een titel, een ondertitel en voorgestelde prompts. Het staat niet in de developer-documentatie van Zendesk en kan dus zonder aankondiging veranderen of verdwijnen. Het paneel markeert de groep als Ongedocumenteerd. Meer over zulke functies staat in Experimentele en ongedocumenteerde functies van de Web Widget.
| Optie | Waarden | In de code |
|---|---|---|
| Scherm tonen | Standaard, uit of aan | behavior.messageLog.preConversation.enabled |
| Titel en Ondertitel | Tekst. Leeg gebruikt de eigen tekst van de widget. |
behavior.messageLog.preConversation.settings.title, .subtitle
|
| Pictogram-URL | Een http(s)-adres. Leeg gebruikt het eigen pictogram van de widget. | behavior.messageLog.preConversation.settings.icon |
| Voorgestelde prompts | Eén per regel | behavior.messageLog.preConversation.settings.prompts |
Zodra er in deze groep iets anders is ingesteld, heeft de widget Scherm tonen nodig, op aan of uit. Een klik op een prompt verstuurt hem naar het testgesprek. Een prompt met [haakjes] komt in het berichtveld, met dat deel geselecteerd. De testwidget begint het gesprek meteen, dus de preview toont het scherm tot je eerste bericht.
Proactief bericht (voorbeeld)
Proactief bericht tonen laat zien hoe een proactief bericht boven de gesloten widget eruitziet, met een eigen Naam afzender, Avatar afzender en Bericht. Staat de widget open, klik dan op Sluit de widget om het te zien. Echte proactieve berichten zijn campagnes die je in het Beheercentrum instelt; de preview kan ze niet lezen. Deze groep verandert alleen het uiterlijk in de preview en komt niet in de insluitcode.
Waarden die de widget zou weigeren
Het paneel controleert elke waarde zoals de widget dat doet. Een waarde die de widget zou weigeren, wordt onder de optie gemarkeerd, met wat de widget dan overslaat:
- een ongeldige themakleur: de hele aanpassingsaanroep;
- een ongeldige waarde onder Venster, Gesprek, Gesprekkenlijst of Positie: die sectie en de secties erna;
- een ongeldige stapelvolgorde, cookie- of gedragswaarde: alleen die instelling;
- een ongeldige waarde in het scherm vóór het gesprek: het hele scherm.
Wat er in de code staat, lees je in De insluitcode van de Web Widget kopiëren.
Waar de aanpassingen bewaard worden
De aanpassingen worden per Zendesk-account opgeslagen, in deze browser. Aanpassingen herstellen wist ze, ook de stijl. Op je website en in het Beheercentrum verandert niets, totdat je de code zelf plaatst. Instellingen die je met de Web Widget-inspector van een website kopieert, vervangen de eigen aanpassingen van de preview voor dat account; zie Aan de slag met de Web Widget-inspector.
De aanpassingen gelden alleen voor de Web Widget-preview. De previews van de Zendesk SDK's voor iOS en Android gebruiken de kleuren uit het Beheercentrum.
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.