Mon édition
Suite Toutes les éditions
Cet article décrit une fonctionnalité réservée aux clients qui avaient créé ou publié des agents IA avant le 2 février 2025. Pour en savoir plus sur la fonctionnalité équivalente dans le module supplémentaire Agents IA - Avancé, consultez Création de dialogues pour les agents IA - Avancé.
Les variables du créateur de bots vous permettent de personnaliser les réponses d’un agent IA pour la 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 agent IA pour la 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.

Cet article aborde les sujets suivants :
  • Activation des variables de métadonnées de messagerie
  • Variables de métadonnées de messagerie prises en charge
  • Meilleures pratiques d’utilisation des variables de métadonnées de messagerie

Pour une présentation générale des variables d’agent IA et de la façon dont vous pouvez les utiliser dans les réponses, consultez Utilisation des variables pour personnaliser les réponses de l’agent IA.

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

Contrairement aux autres types de variables d’agent IA, les variables de métadonnées de messagerie ont des noms prédéfinis. Vous ne pouvez pas modifier le nom ou la valeur d’une variable de métadonnées de messagerie dans un workflow de réponse.
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 agents IA pour la 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.
    L’agent IA 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.
Réalisé par Zendesk