Configuration du client de legacy workspace messagerie

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 15 minutes de lecture

    • Configurez pour Espace de travail inclure un client de messagerie qui permet aux agents d’envoyer des e-mails aux appelants directement à partir de la vue d’enregistrement.

    Client de messagerie de l’espace de travail

    Pour configurer le client de messagerie de l’espace de travail, procédez comme suit :

    Activer legacy workspace le client de messagerie pour une table

    Activez le client de messagerie pour une table afin que les utilisateurs puissent envoyer des e-mails directement à partir de l’enregistrement de table.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Le client de messagerie est activé par défaut sur la table Incident [incident]. Vous pouvez activer le client de messagerie pour une autre table en ajoutant l’attribut email_client dictionary à la table.
    Remarque :
    Cette aptitude n’est pas héritée par les tables qui étendent la table actuelle. Par exemple, l’activation du client de messagerie sur la table Tâche ne l’active pas pour les tables Incident ou Problème.

    Procédure

    1. Ouvrez un enregistrement dans la table pour laquelle vous souhaitez activer le client de messagerie.
      Par exemple, pour activer le client de messagerie pour la table Problème [problem], accédez à Problème > Ouvert, puis ouvrez n’importe quel enregistrement de problème.
    2. Sur le formulaire, cliquez sur l’icône de menu (icône Menu), puis sur Configurer > Dictionnaire.
    3. Dans la liste Entrées du dictionnaire, ouvrez le premier enregistrement.
      Le premier enregistrement a le type d’enregistrement Collection et n’a pas d’entrée pour le nom de colonne.
    4. Sur le formulaire, dans la section Liens connexes, cliquez sur Vue avancée.
    5. Dans le champ Attributs , entrez email_client=vrai.
      S’il existe d’autres valeurs dans le champ, séparez l’attribut par une virgule.
    6. Cliquez sur Mettre à jour.

    Définir les qualificateurs des destinataires pour le client de legacy workspace messagerie

    Créez une configuration qui contrôle la liste de saisie semi-automatique des destinataires affichée dans Client de messagerie.

    Avant de commencer

    Rôle requis : email_client_admin ou admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez spécifier des qualificateurs de destinataires qui affichent des champs supplémentaires (à partir d’une table sélectionnée ServiceNow ) dans la liste de saisie semi-automatique. Ces champs différencient les destinataires d’e-mail qui ont le même nom et prénom.
    Utilisez les onglets suivants du formulaire Qualificateur de destinataire de Client de messagerie pour définir une configuration de destinataire.
    • Configuration de l’affichage : configurez le comportement de saisie semi-automatique du destinataire de l’e-mail et sélectionnez éventuellement des champs supplémentaires pour différencier les destinataires portant le même nom. Les champs supplémentaires permettent aux utilisateurs de sélectionner le bon destinataire pour un e-mail.
    • Configuration de la requête : spécifiez une condition ou un script qui interroge la table sélectionnée et filtre les résultats retournés par les destinataires.
    Vous pouvez définir différentes configurations de destinataires, qui peuvent être utilisées dans une configuration de client de messagerie.

    Procédure

    1. Accédez à la Client de messagerie > Client de messagerie : qualificateur du destinataire et cliquez sur Nouveau.
    2. Renseignez les champs en haut du formulaire de qualificateur de destinataire.
      Champ Description
      Nom Nom unique pour cette configuration de destinataire d’Email Client.
      Demande Le type d’application incluse dans le périmètre.
      Table Table ServiceNow dans laquelle il faut rechercher les destinataires.
      Description Description brève de la configuration de ce destinataire.
    3. Renseignez les champs de l’onglet Configuration de l’affichage pour contrôler l’affichage de la saisie semi-automatique dans le client de messagerie.
      Champ Description
      Adresses e-mail Champ de la table qui contient l’adresse e-mail du destinataire.
      Nom d'affichage Champ de la table utilisé pour le nom du destinataire affiché.
      Commande Ordre des résultats renvoyés par rapport aux autres qualificateurs de destinataires définis.
      Champs d'affichage supplémentaires Liste de contenu permettant de choisir des champs supplémentaires dans la table à afficher dans la liste de saisie semi-automatique. Différencie les destinataires qui partagent le même nom.
      Champs de recherche supplémentaires Case à cocher permettant d’activer la recherche dans des champs supplémentaires. Développe les destinataires renvoyés dans la liste de saisie semi-automatique en interrogeant (en recherchant) les champs d’affichage supplémentaires.
    4. Renseignez les champs de l’onglet Configuration de la requête.
      Champ Description
      Recherche de préfixe Option permettant de trouver le destinataire souhaité à l’aide du préfixe.
      Remarque :
      La sélection de l’option de recherche de préfixe affiche le menu déroulant Champ de nom de famille avec des options permettant de filtrer le nom du destinataire.
      Type Sélectionnez la méthode de filtrage des destinataires renvoyés dans la liste de saisie semi-automatique :
      • Condition
      • Script
      Conditions Si vous avez sélectionné Condition pour le Type, utilisez le générateur de conditions pour spécifier les conditions qui doivent être remplies pour renvoyer les destinataires appropriés.
      Script Si vous avez choisi Script pour le Type, entrez un script qui utilise ces variables pour renvoyer les destinataires appropriés :
      • recipientQuery : GlideRecord pour la table interrogée.
      • targetRecord : GlideRecord pour l’enregistrement cible à partir duquel le client de messagerie a été ouvert.
      Par exemple, ce recipientQuery est un GlideRecord qui représente la table Contact client. La variable targetRecord est un ticket du service clientèle à partir duquel le client de messagerie a été ouvert. Cette requête limite les résultats de saisie semi-automatique du client de messagerie aux contacts qui appartiennent au même compte que le ticket du service clientèle.
      (function (recipientQuery, targetRecord) {
	
	 // Limit results to contacts belonging to the account for the case.
	 var account = targetRecord.getValue('account');
	 recipientQuery.addQuery('account', account);

})(recipientQuery, targetRecord);
    5. Cliquez sur Envoyer.
      La configuration du qualificateur de destinataire est ajoutée à la table Qualificateur de destinataire [sys_recipient_qualifier] et peut être utilisée dans une configuration de client de messagerie.

    Définir les adresses d’expédition pour le legacy workspace client de messagerie

    Définissez une adresse e-mail autorisée qui s’affiche dans l’adresse De d’un message envoyé à partir du client de messagerie.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Client de messagerie > Client de messagerie : adresse initiale et cliquez sur Nouveau.
    2. Dans Nom d’affichage, saisissez le nom à afficher dans le champ De du message du client de messagerie.
    3. Saisissez une adresse e-mail valide pour l’adresse De dans le client de messagerie.
    4. Cliquez sur Envoyer.
      L’adresse d’expédition est ajoutée à la table Adresse d’expédition [sys_email_client_from_address] de Client de messagerie.

    Créer une configuration de legacy workspace client de messagerie

    Définissez une configuration qui contrôle l’affichage et le comportement du client de messagerie basé sur une table sélectionnée ServiceNow .

    Avant de commencer

    Rôle requis : email_client_admin ou admin

    Pourquoi et quand exécuter cette tâche

    La configuration détermine les résultats de saisie semi-automatique des destinataires qui s’affichent, les adresses e-mail qui peuvent être saisies et un ensemble d’adresses d’expédition autorisées à utiliser lors de l’envoi d’un message avec le client.

    Vous pouvez créer une configuration de client de messagerie par ServiceNow table.

    Procédure

    1. Accédez à la Client de messagerie > Configuration de Client de messagerie et cliquez sur Nouveau.
    2. Renseignez les champs du formulaire.
      Champ Description
      Nom Nom unique de cette configuration de client de messagerie.
      Demande Type d’application incluse dans le périmètre.
      Actif Option qui indique que la configuration est active. La configuration est active par défaut.
      Table ServiceNow Table à laquelle cette configuration client s’applique. Sélectionnez une table dans la liste.
    3. Dans la section Configuration du destinataire, sélectionnez les qualificateurs de destinataires à utiliser pour cette configuration de client.
      1. Cliquez sur l’icône de verrouillage ( icône de verrouillage).
        Par défaut, deux types de destinataires sont disponibles : les utilisateurs actifs avec des comptes de messagerie et les groupes actifs avec des comptes de messagerie.
      2. Cliquez sur l’icône de recherche (icône de recherche), puis sélectionnez une configuration de destinataire dans la liste des configurations de destinataires disponibles.
      3. Cliquez sur l’icône de verrouillage (icône de verrouillage) pour la verrouiller.
    4. Dans la section Configuration de l’affichage :
      1. Sélectionnez l’option Afficher l’expéditeur pour afficher l’adresse e-mail de l’expéditeur dans le client de messagerie ou désactivez la case à cocher pour masquer l’adresse e-mail de l’expéditeur dans le client de messagerie.
      2. Sélectionnez l’option Afficher la réponse à pour afficher l’adresse de réponse dans le client de messagerie ou désactivez la case à cocher pour masquer l’adresse de messagerie Répondre dans le client de messagerie.
    5. Dans la section Gestion des pièces jointes, sélectionnez l’un des trois choix possibles pour le champ Action d’envoi de pièce jointe .
      OptionDescription
      Joindre à l'enregistrement de l'e-mail Conservez les pièces jointes du client de messagerie dans l’enregistrement d’e-mail [sys_email] lorsque vous envoyez un e-mail.
      Joindre à l'enregistrement cible Joignez les pièces jointes du client de messagerie à l’enregistrement cible lorsque vous envoyez un e-mail. Il s’agit de la valeur par défaut.
      Joindre avec conditions à l'enregistrement cible Définissez des conditions qui définissent les pièces jointes du client de messagerie à déplacer vers l’enregistrement cible lorsque vous envoyez un e-mail. Les pièces jointes qui ne remplissent pas les conditions restent dans l’enregistrement de l’e-mail lorsque vous envoyez un e-mail.
    6. Dans la section Configuration du filtre, sélectionnez Filtres d’adresse e-mail à appliquer au client de messagerie.
      1. Déverrouillez l’icône de verrouillage (icône de verrouillage).
      2. Cliquez sur l’icône de recherche (icône de recherche), puis sélectionnez un ou plusieurs filtres d’adresse e-mail.
      3. Cliquez sur l’icône de verrou (icône de verrouillage) pour verrouiller les filtres d’adresse e-mail.

      Chaque filtre que vous sélectionnez évalue une adresse e-mail donnée et détermine si l’adresse donnée est valide ou non pour être appliquée à un e-mail sortant.

    7. Cliquez sur Envoyer.
      La configuration est ajoutée à la table Configuration de Client de messagerie [sys_email_client_configuration].

    Créer un modèle de legacy workspace client de messagerie

    Vous pouvez créer un modèle différent pour chaque table qui utilise le client de messagerie.

    Avant de commencer

    Rôle requis : admin

    Pourquoi et quand exécuter cette tâche

    Le client de messagerie utilise ses propres modèles d’e-mail pour définir les valeurs par défaut des champs. Utilisez les sections suivantes dans le formulaire Modèle de client de messagerie pour créer un modèle client :
    • Contenu : corps du message.
    • Destinataires : adresses e-mail des utilisateurs qui reçoivent l’e-mail. Les adresses e-mail sont affichées dans les champs À, Cc et Cci du message.
    • Configuration de l’expéditeur : méthode utilisée pour générer l’expéditeur (adresse e-mail d’envoi) du message.

    Procédure

    1. Accédez à la Client de messagerie > Modèles de client de messagerie.
    2. Cliquez sur Nouveau.
    3. Renseignez les champs en haut du formulaire Modèle de client de messagerie.
      Section supérieure du formulaire Modèle de client de messagerie
      Champ Description
      Nom Nom de modèle unique.
      Table La table à laquelle le modèle s’applique. Activez le client de messagerie pour la même table.
      Conditions Conditions qui déterminent quand ce modèle client est utilisé. Utilisez le générateur de conditions pour identifier l’enregistrement cible qui doit correspondre avant que ce modèle ne soit appliqué au client de messagerie.
      Demande Le type d’application incluse dans le périmètre.
      Ordre d'exécution Nombre indiquant l'ordre dans lequel les conditions de modèle sont évaluées.
    4. Renseignez les champs de l’onglet Contenu .
      Onglet Contenu dans le formulaire Modèle de client de messagerie. Utilisée pour spécifier le contenu d’un message client de messagerie.
      Champ Description
      Objet Saisissez une description de l’e-mail.
      Remarque :
      Le champ Objet du client de messagerie autorise un nombre de caractères plus grand que le paramètre par défaut du champ Objet de la table E-mail [sys_email]. Si le texte de l’objet du client est tronqué, augmentez la valeur Longueur maximale du champ Objet dans la table E-mail.
      Type de contenu Sélectionnez le format du contenu du corps du message : HTML ou texte brut.
      HTML de corps

      Si vous avez sélectionné HTML pour le type Contenu, saisissez le contenu du corps du message à l’aide de la barre d’outils de l’éditeur HTML pour formater le code HTML.

      Pour référencer les valeurs des champs, sélectionnez des variables dans la liste des variables ou tapez manuellement des références de variables à l’aide de la syntaxe ${table_name.nom_variable}. Pour référencer l’utilisateur qui lance le client de messagerie, saisissez la variable ${current_user}.
      Remarque :
      Les sauts de ligne n’apparaissent pas pour les champs multi-lignes tels que ${description} et ${commentaires} dans le modèle de client de messagerie.

      Vous pouvez appeler un script de courrier en utilisant ${mail_script :nom du script} dans le champ HTML du corps .
      Corps de texte

      Si vous avez sélectionné le texte brut pour le type Contenu, entrez le texte ou le script de courrier que vous souhaitez voir apparaître dans le corps du message.

      Vous pouvez insérer un script d’e-mail dans le champ Corps de texte à l’aide de la syntaxe suivante :
      <mail_script> [code] </mail_script>
    5. Renseignez les champs de l’onglet Destinataires .
      Onglet Contenu dans le formulaire Modèle de client de messagerie. Utilisée pour spécifier le contenu d’un message client de messagerie.
      Champ Description
      Vers Entrez une liste séparée par des virgules des noms de champs qui contiennent des adresses e-mail d’utilisateurs ou des adresses e-mail spécifiques. Pour référencer une adresse e-mail à l’aide d’un script, créez un script include, puis appelez-le dans le champ À . Votre script doit commencer par le préfixe javascript : . Le script doit renvoyer les adresses e-mail dans une chaîne séparée par des virgules.
      Cc

      Entrez une liste séparée par des virgules des noms de champs qui contiennent des adresses e-mail d’utilisateurs ou des adresses e-mail spécifiques. Pour référencer une adresse e-mail à l’aide d’un script, créez un include de script, puis appelez l’include de script dans le champ Cc . Votre script doit commencer par le préfixe javascript : . Le script doit renvoyer les adresses e-mail dans une chaîne séparée par des virgules.

      Ce champ ne peut pas avoir les mêmes adresses que le champ À .
      Cci

      Entrez une liste séparée par des virgules des noms de champs qui contiennent des adresses e-mail d’utilisateurs ou des adresses e-mail spécifiques. Pour référencer une adresse e-mail à l’aide d’un script, créez un include de script, puis appelez-le dans le champ Cci . Votre script doit commencer par le préfixe javascript : . Le script doit renvoyer les adresses e-mail dans une chaîne séparée par des virgules.

      Ce champ ne peut pas avoir les mêmes adresses que les champs À ou Cc .
    6. Dans l’onglet Configuration de l’expéditeur , sélectionnez le type de génération de l’expéditeur pour déterminer comment l’expéditeur (adresse d’envoi) dans le message du client de messagerie est généré.
      Utilisez ce champ uniquement si vous souhaitez une adresse d’expédition différente de celle définie dans votre compte de messagerie SMTP.
      • Aucun : l’adresse de l’expéditeur n’est pas générée dans le message du client de messagerie.
      • Compte de messagerie SMTP : utilisez l’adresse d’expédition du compte de messagerie SMTP de l’instance en tant qu’expéditeur.
      • Sélectionner dans la liste : choisissez parmi une liste d’adresses d’expédition autorisées définies dans la table de l’adresse d’expédition [sys_email_client_from_address] de Client de messagerie.
      • Script : exécutez une requête GlideRecord sur la table Adresse d’expédition [sys_email_client_from_address] de Client de messagerie.
        Par exemple, le script suivant définit l’adresse De en fonction de l’emplacement de l’appelant de l’incident :
        (function (fromAddressQuery, targetRecord) {
    // targetRecord is incident for this template
    var location = targetRecord.caller_id.country;

    if (location == 'us')
        fromAddressQuery.addQuery('email_address', 'servicedesk.us@example.com');
    else if (location == 'japan')
        fromAddressQuery.addQuery('email_address', 'servicedesk.jp@example.com');
    else if (location == 'uk')
        fromAddressQuery.addQuery('email_address', 'servicedesk.uk@example.com');

})(fromAddressQuery, targetRecord);
      • Texte : Saisissez l’adresse e-mail à utiliser dans le client.
      Remarque :

      L’adresse e-mail de l’expéditeur n’apparaît pas dans le client de messagerie, sauf si vous configurez le client de messagerie pour afficher l’adresse De. Pour plus d’informations sur la gestion du comportement du client de messagerie, reportez-vous à la section Email client configurations.

      Si le domaine de l’adresse de départ n’est pas le domaine du serveur de comptes de messagerie SMTP, le propriétaire du domaine De doit configurer l’enregistrement SPF pour le domaine. Le propriétaire modifie les paramètres de domaine pour permettre à l’instance d’envoyer des e-mails comme s’il s’agissait de ce domaine. Pour plus de détails sur l’utilisation des enregistrements SPF, consultez ServiceNow KB0535456.

    7. Cliquez sur Envoyer.
      Le modèle est ajouté à la table Modèles de client de messagerie [sys_email_client_template].

    Définir un message rapide pour le client de legacy workspace messagerie

    Créez du contenu prédéfini à ajouter dans le client de messagerie afin que les utilisateurs puissent écrire des e-mails de manière cohérente et efficace.

    Avant de commencer

    Rôle requis : email_client_quick_message_author ou admin

    Pourquoi et quand exécuter cette tâche

    Les agents peuvent insérer des messages rapides dans les e-mails qu’ils rédigent dans l’espace de travail. Par défaut, le contenu du message rapide est inséré à la place du curseur. Pour que le contenu des messages rapides remplace tout le contenu existant dans un brouillon d’e-mail, définissez la glide.email_client.quick_message.insert propriété sur faux.

    Procédure

    1. Accédez à la Client de messagerie > Messages rapides.
    2. Cliquez sur Nouveau.
    3. Sur le formulaire, renseignez les champs.
      Champ Description
      Titre Nom apparaissant dans le sélecteur de message rapide.
      Actif Option permettant d’activer le message rapide. Lorsque cette option est sélectionnée, le message rapide peut être sélectionné dans le sélecteur de message rapide.
      Demande Type d’application incluse dans le périmètre.
      Utilisateur Utilisateur qui a accès à ce message rapide. La sélection d’un utilisateur restreint l’accès à cet utilisateur uniquement. Laissez le champ vide pour n’avoir aucune restriction basée sur l’utilisateur.
      Groupe Groupe dont les membres ont accès à ce message rapide. La sélection d’un groupe restreint l’accès aux seuls membres de ce groupe. Laissez le champ vide pour n’avoir aucune restriction basée sur le groupe.
      Table Table à laquelle le message rapide s’applique. Pour rendre le message rapide disponible pour toutes les tables, laissez vide.
      Conditions Enregistrement cible qui doit correspondre aux conditions avant que le message rapide n’apparaisse pour sélection dans le client de messagerie.
      Détails

      Contenu à insérer dans le champ Texte du message dans Client de messagerie. Par défaut, le champ prend en charge le format HTML.

      Pour référencer les valeurs des champs, sélectionnez des variables dans la liste des variables ou tapez manuellement des références de variables à l’aide de la syntaxe ${table_name.nom_variable}. Pour référencer l’utilisateur qui lance le client de messagerie, saisissez la variable ${current_user}. Pour référencer le titre de l’utilisateur qui lance le client de messagerie, saisissez la variable ${current_user.title}.

      Vous pouvez utiliser ces valeurs pour inclure une signature prédéfinie dans les réponses par e-mail des agents aux clients.

      Remarque :
      Les sauts de ligne n’apparaissent pas pour les champs multi-lignes tels que ${description} et ${commentaires} dans le modèle de client de messagerie.
    4. Cliquez sur Envoyer.