Verwenden von Authentifizierungsmetadaten in einer Bot-Antwort

Bot Builder-Variablen ermöglichen Ihnen, die Antworten eines Messaging-Bots anhand der Daten zu einer Konversation anzupassen. Messaging-Metadatenvariablen sind im Bot Builder verwendete Variablen, die Informationen zur Identität und zum Authentifizierungsstatus des aktuellen Kunden enthalten.

Messaging-Metadatenvariablen erhalten ihre Werte aus den signierten JSON Web Token (JWT) für die Messaging-Authentifizierung. Diese Daten kann ein Messaging-Bot in einer Konversation nutzen, um seine Antworten anzupassen, Informationen zum Kunden anzuzeigen oder den Konversationsfluss zu verzweigen.

Dieser Beitrag enthält die folgenden Themen:

• Aktivieren von Messaging-Metadatenvariablen
• Unterstützte Messaging-Metadatenvariablen
• Best Practices für die Verwendung von Messaging-Metadatenvariablen

Einen allgemeinen Überblick über Bot-Variablen und ihre Verwendung in einer Antwort finden Sie unter Personalisieren von Bot-Antworten mit Variablen.

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

Im Gegensatz zu anderen Arten von Bot-Variablen weisen Messaging-Metadatenvariablen vordefinierte Namen auf. Sie können den Namen oder den Wert einer Messaging-Metadatenvariable in einem Antwort-Konversationsfluss nicht festlegen oder ändern.

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 in einem 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-Bots überspringen die Erfassung der Variablen Name und E-Mail für authentifizierte Kunden in einem 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 Antwort-Konversationsflusses, der sowohl für authentifizierte als auch für nicht authentifizierte Kunden verfügbar sein soll, einen 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 Ihre Organisation JWTs mit Namen und E-Mail-Adresse verwendet, 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.