Lesvariables du Créateur de botsvous permettent de personnaliser les réponses d’un bot de messagerie en fonction des données associées à une conversation. Les variables de métadonnées de messagerie sont un type de variable utilisée dans le Créateur de bots qui contiennent des informations au sujet de l’identité et du statut d’authentification du client actuel.
Les variables de métadonnées de messagerie obtiennent leurs valeurs des tokens Web JSON (JWT) signés utilisés pour l’authentification de messagerie. Pendant une conversation, un bot de messagerie peut utiliser ces données pour personnaliser ses réponses, afficher des informations spécifiques au client ou faire bifurquer le workflow de la conversation.
Pour une présentation générale des variables de bot et de la façon dont vous pouvez les utiliser dans une réponse, consultezUtilisation des variables pour personnaliser les réponses du bot.
Activation des variables de métadonnées de messagerie
Les variables de métadonnées de messagerie ne sont pas activées par défaut. Pour activer les variables de métadonnées de messagerie, un administrateur doitcréer une clé de connexion, utilisée pour générer des JWT pour l’authentification de messagerie. Les variables de métadonnées de messagerie et d’authentification de messagerie sont uniquement disponibles pour les canaux Web Widget et Mobile SDK.
Pour en savoir plus sur la configuration de l’authentification de messagerie, consultezAuthentification des utilisateurs finaux dans la messagerie pour le Web Widget et le Mobile SDK.
Variables de métadonnées de messagerie prises en charge
Nom de la variable de métadonnées de messagerie | Description |
---|---|
E-mail fourni | Adresse e-mail du client. L’adresse e-mail est extraite du JWT utilisé pour l’authentification de messagerie. |
Nom fourni | Le nom du client. Ce nom est extrait du JWT utilisé pour l’authentification de messagerie. |
ID externe authentifié | Chaîne alphanumérique unique qui identifie le client. L’ID est extrait du JWT utilisé pour l’authentification de messagerie. |
Statut一uthentifié | Si true, le client est authentifié. Sinon, false. Cette variable a toujours la valeur true ou false et n’est jamais vide. Quand vous utilisez la variableStatut一uthentifiédans une étapeBranche par condition, seul l’opérateurIsest pris en charge. |
Utilisation des variables Nom fourni et E-mail fourni
N’oubliez pas de prendre en compte les points suivants quand vous utilisez les variablesNom fournietE-mail fourni:
- Les bots de messagerie ignorent automatiquement le recueil des variablesNometE-mailpour les clients authentifiés à l’étape要求者des细节. Pour les clients authentifiés, ces variables sont vides et elles sont ignorées dans les étapes ultérieures de la conversation. Utilisez plutôt les variablesNom fournietE-mail fourni.
Le bot ignore le recueil des variablesNometE-mailà l’étape要求者des细节 VariablesNom fournietE-mail fourni - Ni le nom ni l’adresse e-mail du client ne sont nécessaires pour les JWT utilisés pour l’authentification de messagerie. Si votre organisation n’inclut pas de nom ni d’adresse e-mail dans ses JWT, les variablesNom fournietE-mail fournisont vides et sont ignorées pendant une conversation.
Dans ce cas, nous vous conseillons de mettre vos JWT à jour pour qu’ils incluent un nom et une adresse e-mail.
- Les variablesNom fournietE-mail fournisont vides pour les utilisateurs non authentifiés. Évitez d’utiliser ces variables dans les étapes de réponse pour les clients non authentifiés.
Utilisation des variables de métadonnées de messagerie avec les clients non authentifiés
Si un client n’est pas authentifié, la valeur de la variableStatut一uthentifiéest false. Les autres variables de métadonnées de messagerie sont vides pour les clients non authentifiés et elles sont ignorées pendant les conversations.
Meilleures pratiques d’utilisation des variables de métadonnées de messagerie
Quand vous créez une réponse qui utilise des variables de métadonnées de messagerie, n’oubliez pas les meilleures pratiques suivantes :
- Si vous n’incluez pas le nom ou l’adresse e-mail du client aux JWT utilisés pour l’authentification de messagerie, n’utilisez pas les variablesNom fournietE-mail fourni.
- 倒认为联合国工作流de响应访问辅助clients authentifiés et non authentifiés, utilisez une étapeBranche par conditionpour vérifier les variablesStatut一uthentifiédu client. Incluez uniquement des variables de métadonnées de messagerie aux branches pour lesquellesStatut一uthentifiéa la valeur true.
- Si vous créez une réponse qui est uniquement disponible pour les clients authentifiés et que les JWT de votre organisation incluent un nom et une adresse e-mail, utilisez les variablesNom fournietE-mail fournipour le nom et l’adresse e-mail du client. Dans ce cas, il est inutile de recueillir à nouveau ces informations en utilisant une étape要求者des细节.
0 Commentaires
Vous devezvous connecterpour laisser un commentaire.