Les variables du Créateur de bots vous 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, consultez Utilisation 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 doit cré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, consultez Authentification 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 authentifié | 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 variable Statut authentifié dans une étape Branche par condition, seul l’opérateur Is est 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 variables Nom fourni et E-mail fourni :
- Les bots de messagerie ignorent automatiquement le recueil des variables Nom et E-mail pour les clients authentifiés à l’étape Demander des détails. 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 variables Nom fourni et E-mail fourni.
Le bot ignore le recueil des variables Nom et E-mail à l’étape Demander des détails Variables Nom fourni et E-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 variables Nom fourni et E-mail fourni sont 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 variables Nom fourni et E-mail fourni sont 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 variable Statut authentifié 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 variables Nom fourni et E-mail fourni.
- Pour créer un workflow de réponse accessible aux clients authentifiés et non authentifiés, utilisez une étape Branche par condition pour vérifier les variables Statut authentifié du client. Incluez uniquement des variables de métadonnées de messagerie aux branches pour lesquelles Statut authentifié 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 variables Nom fourni et E-mail fourni pour le nom et l’adresse e-mail du client. Dans ce cas, il est inutile de recueillir à nouveau ces informations en utilisant une étape Demander des détails.