Ticketfelder in einer Host-App vorausfüllen
Fülle benutzerdefinierte Ticketfelder im Widget-Kontaktformular vor, indem du Feldschlüssel und Werte über ein signiertes Benutzertoken bereitstellst.
Deine Host-App kann benutzerdefinierte Ticketfelder im Kontaktformular des Widgets und auf der Kontaktkarte bei der Chat-Übergabe vorausfüllen. Die Werte stammen entweder aus einem verifizierten signierten Benutzertoken oder aus dem Seitenkontext. Sie werden direkt anhand des Feldschlüssels zugeordnet, ohne dass ein Mapping erforderlich ist.
Vorausfüllwerte bereitstellen
-
Schlüssel der benutzerdefinierten Ticketfelder ermitteln
Verwende dieselben Schlüssel, die für die benutzerdefinierten Ticketfelder in deinem Help Center festgelegt sind. Jeder von dir bereitgestellte Wert muss genau einem Feldschlüssel entsprechen. -
Werte über ein signiertes Benutzertoken bereitstellen
Füge die Feldschlüssel und ihre Werte in ein verifiziertes signiertes Benutzertoken ein. Diese Werte haben Vorrang vor Werten aus dem Seitenkontext. Sie sind für Besucher verborgen und können von ihnen nicht geändert werden. -
Werte über den Seitenkontext bereitstellen
Stelle Feldschlüssel und Werte über die Widget-Konfiguration bereit oder aktualisiere den Widget-Kontext. Diese Werte werden Besuchern im Formular angezeigt und können von ihnen bearbeitet werden.
Wenn derselbe Feldschlüssel in beiden Quellen vorkommt, hat der Wert aus dem signierten Token Vorrang. Die Werte werden anhand des Feldtyps und der verfügbaren Optionen geprüft. Nicht zugeordnete oder ungültige Werte werden nicht übernommen. Das gilt auch für Felder, die Besuchern nicht angezeigt werden: Sie können trotzdem gültige Vorausfüllwerte aus beiden Quellen erhalten.
Vorausfüllwerte im Kontaktformular prüfen
-
Widget öffnen und Kontaktformular auswählen
Öffne das Support-Widget deiner Host-App und wähle „Contact", um eine Anfrage über das Formular zu senden. Das Kontaktformular wird mit den benutzerdefinierten Ticketfeldern oberhalb des Nachrichtenfelds angezeigt. -
Werte aus dem Seitenkontext prüfen
Ein über die Seite bereitgestellter Wert erscheint im entsprechenden Feld und kann vom Besucher bearbeitet werden. Gibt es für ein Feld keinen verwendbaren Vorausfüllwert, trägt der Besucher den Wert selbst ein. -
Bestätigen, dass Werte aus signierten Tokens verborgen sind
Felder, die über ein verifiziertes signiertes Token ausgefüllt wurden, erscheinen nicht im Formular. Der Besucher kann sie weder sehen noch bearbeiten. -
Formular ausfüllen und absenden
Gib eine Nachricht ein und fülle alle sichtbaren benutzerdefinierten Felder aus. Pflichtfelder sind mit einem Sternchen gekennzeichnet. Wenn ein Pflichtfeld leer ist, wird „Please fill in this field." angezeigt und das Absenden verhindert. Bei Zahlenfeldern wird für eine ungültige Eingabe „Please enter a number." angezeigt.Wähle „Next", um mit dem Schritt zur Eingabe der Kontaktdaten fortzufahren, wenn noch keine gültige E-Mail-Adresse vorhanden ist. Ist bereits eine gültige Adresse vorhanden, wird dieser Schritt übersprungen und direkt die Option zum Senden angezeigt. Gib im Schritt mit den Kontaktdaten deinen Namen und deine E-Mail-Adresse ein oder bestätige sie. Eine gültige E-Mail-Adresse ist erforderlich.
-
Anfrage senden
Wähle die Schaltfläche zum Senden, um die Anfrage abzuschicken. Gültige Vorausfüllwerte werden mit dem Ticket gespeichert. Der Server prüft alle Werte erneut. Werte, die er nicht akzeptiert, werden nicht gespeichert. Nach erfolgreichem Versand wird die Bestätigung „Message sent" angezeigt. Wenn du eine weitere Nachricht senden möchtest, werden geleerte benutzerdefinierte Felder wieder mit den über die Seite bereitgestellten Werten ausgefüllt.
Vorausfüllwerte auf der Kontaktkarte bei der Chat-Übergabe prüfen
-
Chat starten und zur Übergabe gelangen
Wähle im Widget „Ask" und beschreibe dein Problem. Wenn im Chat menschlicher Support angeboten wird und eine Übergabe möglich ist, fahre mit der Kontaktkarte fort. -
Felder auf der Übergabekarte prüfen
Die Karte zeigt nur Pflichtfelder an. Über die Seite bereitgestellte Werte werden angezeigt und können bearbeitet werden. Felder, die durch signierte Angaben ausgefüllt wurden, bleiben verborgen. Während die Felder vorbereitet werden, wird auf der Karte möglicherweise kurz „Getting the details ready…" angezeigt. Wenn die Vorbereitung länger als zehn Sekunden dauert oder fehlschlägt, werden stattdessen alle erforderlichen Formularfelder abgefragt. -
Übergabe ausfüllen und senden
Fülle alle noch fehlenden Pflichtfelder aus, gib „Your email" ein oder bestätige die Adresse und füge optional eine „Message for the support team." hinzu. Wähle „Send to support", um die Übergabe abzuschicken. Wenn ein Pflichtfeld leer oder ungültig ist, wird es auf der Karte zur Korrektur markiert. Das Formular kann erst gesendet werden, wenn der Fehler behoben ist. Pflichtfelder, die durch eine gültige signierte Angabe ausgefüllt wurden, gelten als vollständig, auch wenn sie nicht angezeigt werden.
Was mit vorausgefüllten Werten geschieht
Übereinstimmende und gültige Werte werden beim Absenden mit dem Ticket gespeichert. Wenn ein Besucher einen über die Seite bereitgestellten Wert geändert hat, wird die Auswahl des Besuchers gespeichert. Signierte Tokenwerte, die die Validierung nicht bestehen, bleiben leer. Sie werden nicht durch den Wert aus dem Seitenkontext für das betreffende Feld ersetzt.
Wenn die Host-App den Seitenkontext aktualisiert, ersetzt der neue Wertesatz den vorherigen. Auch eine signierte Angabe kann ablaufen: Ist sie beim Abruf der Felder durch das Widget nicht mehr gültig, wird ihr Wert nicht vorausgefüllt und der Besucher wird möglicherweise stattdessen nach diesem Feld gefragt.
Nachdem ein Ticket erstellt wurde, kannst du anhand der Indikatoren zur Herkunft von Ticketfeldwerten im Posteingang prüfen, woher der Wert jedes Felds stammt.
