Suite | Beliebiger Plan |
Messaging-Metadatenvariablen erhalten ihre Werte aus den signierten JSON Web Token (JWT) für die Messaging-Authentifizierung. Diese Daten kann ein AI Agent für Messaging in einer Konversation nutzen, um seine Antworten anzupassen, Informationen zum Kunden anzuzeigen oder den Konversationsfluss zu verzweigen.
Einen allgemeinen Überblick über AI Agent-Variablen und ihre Verwendung in Antworten finden Sie unter Verwenden von Variablen zur Personalisierung von AI Agent-Antworten.
Aktivieren von Messaging-Metadatenvariablen
Messaging-Metadatenvariablen sind standardmäßig nicht aktiviert. Um Messaging-Metadatenvariablen zu aktivieren, muss ein Administrator einen Signierschlüssel erstellen, mit dem JWTs für die Messaging-Authentifizierung generiert werden. Messaging-Authentifizierung und Messaging-Metadatenvariablen sind nur für den Web Widget- und den Mobile SDK-Kanal verfügbar.
Weitere Informationen zum Einrichten der Messaging-Authentifizierung finden Sie unter Authentifizieren von Endbenutzern in Messaging für das Web Widget und das Mobile SDK.
Unterstützte Messaging-Metadatenvariablen
Name der Messaging-Metadatenvariable | Beschreibung |
---|---|
Bereitgestellte E-Mail | E-Mail Adresse des Kunden. Diese E-Mail-Adresse wird aus dem für die Messaging-Authentifizierung verwendeten JWT übernommen. |
Bereitgestellter Name | Name des Kunden. Diese Name wird aus dem für die Messaging-Authentifizierung verwendeten JWT übernommen. |
Authentifizierte externe ID | Eindeutige alphanumerische Zeichenfolge zur Identifizierung des Kunden. Diese ID wird aus dem für die Messaging-Authentifizierung verwendeten JWT übernommen. |
Authentifizierter Status | „true“ bedeutet, dass der Kunde authentifiziert ist. Andernfalls weist die Variable den Wert „false“ auf. Diese Variable kann nicht leer sein, sondern weist immer den Wert „true“ oder „false“ auf.
Bei Verwendung der Variable Authentifizierter Status im Schritt Nach Bedingung verzweigen wird nur der Ist-Operator unterstützt. |
Nutzen der Variablen „Bereitgestellter Name“ und „Bereitgestellte E-Mail“
Beachten Sie bei Verwendung der Variablen Bereitgestellter Name und Bereitgestellte E-Mail folgende Punkte:
- Messaging-AI Agents überspringen die Erfassung der Variablen Name und E-Mail für authentifizierte Kunden im Schritt Details anfordern automatisch. Bei authentifizierten Kunden sind diese Variablen leer und werden in späteren Schritten der Konversation übersprungen. Nutzen Sie stattdessen die Variablen Bereitgestellter Name und Bereitgestellte E-Mail.
Übersprungene Erfassung der Variablen Name und E-Mail im Schritt Details anfordern Variablen Bereitgestellter Name und Bereitgestellte E-Mail - Die für die Messaging-Authentifizierung verwendeten JWTs müssen nicht unbedingt den Namen oder die E-Mail-Adresse eines Kunden enthalten. Wenn Ihre Organisation JWTs ohne Namen oder E-Mail-Adresse verwendet, werden die entsprechenden Variablen Bereitgestellter Name und Bereitgestellte E-Mail in einer Konversation übersprungen.
Für diesen Fall empfehlen wir, die JWTs zu aktualisieren und den Namen und die E-Mail-Adresse aufzunehmen.
- Bei nicht authentifizierten Kunden sind die Variablen Bereitgestellter Name und Bereitgestellte E-Mail leer. Wir empfehlen, diese Variablen in Antwortschritten für nicht authentifizierte Kunden nicht zu verwenden.
Verwenden von Messaging-Metadatenvariablen für nicht authentifizierte Kunden
Wenn ein Kunde nicht authentifiziert ist, weist die Variable Authentifizierter Status den Wert „false“ auf. Die übrigen Messaging-Metadatenvariablen sind bei nicht authentifizierten Kunden leer und werden in einer Konversation übersprungen.
Best Practices für die Verwendung von Messaging-Metadatenvariablen
Beachten Sie beim Erstellen einer Antwort mit Messaging-Metadatenvariablen die folgenden Best Practices:
- Wenn Sie den Namen oder die E-Mail-Adresse des Kunden nicht in die für die Messaging-Authentifizierung verwendeten JWTs aufnehmen, sollten Sie die Variablen Bereitgestellter Name und Bereitgestellte E-Mail nicht verwenden.
- Verwenden Sie beim Erstellen eines Antwortflusses, der sowohl für authentifizierte als auch für nicht authentifizierte Kunden verfügbar sein soll, den Schritt Nach Bedingung verzweigen, in dem die Variable Authentifizierter Status des Kunden geprüft wird. Nehmen Sie Messaging-Metadatenvariablen nur in Zweige auf, in denen die Variable Authentifizierter Status den Wert „true“ aufweist.
- Wenn Sie eine Antwort erstellen, die nur für authentifizierte Kunden verfügbar sein soll, und die JWTs Ihrer Organisation einen Namen und einen E-Mail-Adresse enthalten, verwenden Sie für den Namen und die E-Mail-Adresse des Kunden die Variablen Bereitgestellter Name und Bereitgestellte E-Mail. In diesem Fall brauchen Sie diese Informationen nicht noch einmal in einem Schritt Details anfordern zu erfassen.
8 Kommentare
Rositsa Pavlova
I have the same issue as Rafa D., where we use number of different brands and we wish the customers to be able to see conversations history only with the associated Brand.
I was wondering if anyone has any work around this?
I think the best approach would be creating some sort of Master_ID, which may include couple of External_ID, based on each brand and emails used by the customer.
Best regards,
Rose
0
Rupert Aranda
Hello, I am trying to enable authentication with our messenger chat. I am passing the jwt to `webWidget.authenticate.chat`, however Zendesk is still not recognizing the authorized user. I am using the `metadata` to check the status and external ID, but these come back as false and null. Any suggestions?
0
Maxime Wozny
Once you are authenticated (with JWT) within the messaging widget, are you considered authenticated on the Zendesk Guide Help Center too ?
My use case : Our bot answers to authenticated clients, displaying them restricted articles (only visible to users that are authenticated in Zendesk Guide). If the user does not find anything useful, we ask details to create a ticket. Currently we manage to have the ticket, but not display the restricted article (it redirects to the authentication page of Guide).
0
Hiedi Kysther
Hi 6943178919706
I've created a ticket on your behalf so our Support team can assist you further on your concern. Kindly check your email for more information. Thanks!
-1
Rafa D.
Hi,
We give support to various websites, some of them share users registered with the same email.
Each one has a different widget but we noticed that all of them show all the history conversations, whetever the website, if the user email it's the same.
How can filter the conversations by brand?
0
Maurice Baez
Hello,
I am a developer at a company that wants to integrate a zendesk bot into our application (we currently use another bot service provider and would like migrate away from them) - We need the ability to send an access token(to our api), along with other customer specific information (about 15-20 data points), in order to allow the bot to make api calls and respond with client specific information. The second paragraph of this document seems to indicate this may be possible here, however, it seems like Provided email, Provided name, Authenticated external ID, and Authenticated status are the only data points that can be sent, stored, and used, is that correct? I found the doc describing how to to use the identity function to send a jwt from our end, my assumption was that I'd be able to include which ever data points I needed on that jwt to be used by the bot, but maybe that's not the case? Thank you.
0
Afabio Junior
I've created a ticket on your behalf so we can investigate your issue further. Please check your email for more information. Thanks! And, speak soon!
-1
Ryan Nally
In our app we've implemented a JWT using signing key and the login method outline in the sdk doc. I can see this call returning with a 200 status. Yet in our chatbot flow the Authenticated Status is not equating to true. Any suggestions on why this might be the case?
0
Anmelden, um einen Kommentar zu hinterlassen.