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.