Exemples de robots développés par Cisco en cours d’utilisation.

Robots dans l’application Webex

IMPORTANT : Cisco Webex annonce l’arrêt de l’intégration de Notion Bot avec l’application Webex. Ce robot ne sera plus supporté et aucune nouvelle installation ne sera possible au-delà du 31 mars 2024. Si vous avez ajouté le robot dans un espace ou si vous avez un 1 à 1 actif avec le robot Notion, il devrait continuer à fonctionner jusqu'au 30 juin 2024. Après ceci, le robot cessera de fonctionner. Si vous souhaitez créer une intégration similaire par vous-même, veuillez consulter notre documentation sur le robot Webex à l’adresse https://developer.webex.com/docs/bots.

Exemples de robots développés par Cisco en cours d’utilisation.

Les robots peuvent aider à étendre la fonctionnalité de l’application Webex pour inclure une application tierce. Vous pouvez ajouter des robots aux espaces de l’application Webex et interagir directement avec l’application tierce à partir de l’espace. Lorsque vous avez ajouté le robot à l’espace, vous pouvez envoyer un message d’aide au robot et la réponse inclut les commandes prises en charge par le robot.

Vous pouvez ajouter un robot à n’importe quel type d’espace ; ajouter un robot à votre espace de projet avec d’autres personnes et interagir directement avec l’application tierce à partir de votre espace. Ou vous pouvez créer un espace avec vous et le robot uniquement pour interagir avec l’application tierce.

Webex App Hub contient un catalogue de bots et d’applications développés par Cisco et des développeurs tiers.

Cartes dans l’application Webex

Les robots présentent des informations dans l’application Webex de différentes façons. Les cartes de robot facilitent pour les utilisateurs l’interaction directe avec la réponse du robot à une commande. Vous pouvez faire un choix dans les menus de la liste liste, utiliser des boutons et même utiliser les champs de texte pour mettre à jour et collecter des informations.

Voir Boutons et cartes pour vos applications Webex.

Signaler tout problème sur le robot avec cartes à chaque devsupport@webex.com.

Si votre administrateur a activé le robot pour les non-administrateurs de votre organisation, vous pouvez ajouter et interagir avec le robot ServiceNow dans un espace Webex App.

Ajouter le robot ServiceNow

Avant de commencer

Votre administrateur ServiceNow doit autoriser l’accès au robot, comme décrit dans l’onglet Admins , avant que vous puissez interagir avec le robot.

1

Dans la barre Webex App, sélectionnez > Envoyer un message direct.

2

Saisissez@ServiceNow pour rechercher le robot.

3

Choisissez Robot ServiceNow dans la liste pour ouvrir un espace.

Ce qu’il faut faire ensuite

Le robot crée un espace avec une carte de bienvenue et un bouton Lien ServiceNow Compte . Si vous êtes l’administrateur de ServiceNow, veuillez cliquer sur le bouton et terminer le processus d’installation du robot comme expliqué dans l’onglet Admins .

Si vous n’êtes pas un administrateur, veuillez demander à votre administrateur ServiceNow de terminer le processus d’installation du robot pour que les utilisateurs qui ne sont pas admins interagissent avec le robot.

Signaler un incident

Créez un incident dans ServiceNow à partir d’un espace.

1

Dans l'espace de robots ServiceNow, saisissez Aide et envoyez le message.

2

Sélectionnez Signaler l’incident et saisissez le nom de la personne qui a signalé le problème, puis cliquez sur Rechercher l’appelant.

3

Saisissez la description, l’état de l’incident et les notifications, puis sélectionnez Soumettre l’incident.

Rechercher un incident

Rechercher un incident avec le numéro d’incident ou la date de création.

1

Saisissez aide dans l'espace de robots ServiceNow et choisissez Obtenir un incident sur la carte.

  • Par récents–Choisissez Par récents pour voir la liste des incidents récemment ouverts.
  • Par numéro d’incident–Choisissez Incident de recherche pour saisir le numéro d’incident.
2

Sélectionnez Obtenir l’incident à nouveau pour afficher les détails de l’incident.

Mettre à jour et résoudre les incidents

Utilisez la carte du robot pour mettre à jour ou résoudre les incidents.

1

Dans l'espace de robots ServiceNow, saisissez Aide et envoyez le message.

2

Recherchez l’incident que vous souhaitez gérer.

3

À partir de la carte des détails de l’incident , choisissez :

  • Mise à jour––Pour changer la description et l’état de l’incident. Pour mettre à jour d’autres détails, cliquez sur Afficher dans ServiceNow.
  • Marquer comme résolue––Pour fournir le code de résolution et ajouter des notes de résolution.
Vos notes sont visibles dans l’application ServiceNow.

Connectez l’application Webex à ServiceNow, puis configurez les paramètres et les autorisations du robot pour autoriser l’accès au robot pour les utilisateurs non administrateurs.

Ajouter le robot

Tout d’abord, créez un espace avec le robot ServiceNow pour lier votre compte. Si vous utilisez un pare-feu ou si vous limitez l’accès à votre domaine, autorisez ces adressesIP.

1

Dans l’en-tête de l’application, > envoyer un message direct.

2

Saisissez le nom du robotServiceNow.bot@webex.bot et créez l’espace.

3

Saisissez Aide et envoyez le message.

4

Sélectionnez Associer le compte ServiceNow dans la carte du robot.

5

Dans la page Web d’installation, saisissez votre domaine ServiceNow (à l’exception de :.service-now.com).

6

Ouvrez une autre fenêtre de navigation pour terminer les étapes de l’installation admin dans Gestion des services.

Gardez les deux fenêtres ouvertes tout au long de l’installation.
Installation de l’administrateur

Créer un profil utilisateur d’intégration

Puis, créez un profil qui applique des permissions pour interagir avec le robot à tous les utilisateurs non admin de votre organisation.

  1. Connectez-vous à votre compte d'administrateur ServiceNow, puis recherchez des utilisateurs dans le navigateur de filtres.

  2. Sous Organisation , sélectionnez Utilisateurs > Nouveau.

  3. Ajoutez Integration_User dans le champ ID utilisateur, configurez un mot de passe, puis sélectionnez la case Utilisateur de l'intégration interne et Soumettre.

  4. Dans la liste des utilisateurs, sélectionnez le profilntegration_ Utilisateuret sélectionnez l’onglet Rôles en bas de la page.

  5. Cliquez sur Modifier et sélectionnez admin dans la liste des collectes, puis cliquez sur Ajouter et enregistrer.

  6. Sélectionnez Mettre à jour en haut de la page Profil d'utilisateur jour.

  7. Dans la page de configuration, au bas de la page Se connecter à ServiceNow , cliquez sur Valider.

Configurer le domaine

Enregistrez le profil utilisateurntegration_et appliquez les paramètres du robot.

  1. À partir de votre application ServiceNow, déconnectez-vous de votre compte administrateur et connectez-vous en tant quintegration_utilisateur avec le mot de passe que vous avez précédemment créé.

  2. Dans la page Web d’installation, sélectionnez Connecté(e) à l’intégration du compte utilisateur, puis Procédez à l’installation de l’administrateur.

  3. Avant d’ajouter l’ID et le secretdu client, copiez l’URL de redirection, puis retournez à votre application ServiceNow.

  4. Recherchez le Registre d'application dans la Navigation par filtre et sélectionnez Registre d'application.

  5. Cliquez sur Nouveau > créer un point de terminaison API OAuth pour les clients externes.

  6. Saisissez l’application du service Webex maintenant pour le nom de l’application, puis cliquez sur Déverrouiller pour coller l’URL de redirection copiée à partir de la fenêtre d’installation.

  7. Dans la page Web d’installation, cliquez sur Comment trouver l’ID du client ServiceNow, le code secret et l’URL de redirection, puis faites défiler jusqu’à l’étape 4 et copiez l’URL du logo.

  8. Dans votre application ServiceNow, cliquez sur Déverrouiller pour coller l’URL du logo, puis soumettre .

  9. Sélectionnez Service Webex Applicer maintenant dans la liste, copiez l’IDdu client, puis cliquez sur déverrouiller pour copier le secret du client.

  10. Ajoutez l’ID du client et le Secret du client dans la fenêtre d’installation, puis cliquez sur Continuer et Autoriser pour vous Service Webex maintenant App à votre compte.

  11. Choisissez les champs requis pour lever un incident, puis cliquez sur Continuer.

Configurer le robot et appliquer les permissions

Lier l’ID de l’adresse électronique et le nom de domaine pour autoriser l’accès pour tous les utilisateurs qui ne sont pas admin. Puis, configurez les paramètres de requête et de réponse du robot et appliquez les autorisations d’accès aux données.

  1. À partir de votre application ServiceNow, recherchez des API rest scriptées dans la navigation par filtre, puis sélectionnez API REST scriptées.

  2. Cliquez sur Nouveau, ajoutez l’API scriptée Webex comme nom, puis copiez-la et collez-la dans le champ ID API , puis cliquez sur Soumettre.

  3. Dans la liste API REST scripted , cliquez sur l'API scripted Webex et sélectionnez l'onglet Ressources au bas de la page.

  4. Cliquez sur Nouveau, ajoutez l’API scriptée Webex comme nom de la ressource et changez la méthode HTTP par POST.

  5. Copiez le script à partir de la liste Comment puis-je trouver l’ID du client ServiceNow, les instructions sur le secret et l’URL de redirection, faites défiler jusqu’à l’étape 6 et copiez et collez le script dans le champ Script .

    Assurez-vous de remplacer tout texte existant, puis cliquez sur Soumettre.

  6. Copiez le chemin de l’API de base dans le haut à gauche de l Profil d'utilisateur, puis cliquez sur Mettre à jour.

  7. Dans la page Web d’installation, ajoutez votre ID de messagerie électronique ServiceNow et collez le chemin de l’APIde base, puis cliquez sur Enregistrer et fermer la fenêtre.

Terminer l’installation

Lorsque vous avez terminé de configurer le profil integration_utilisateur , limitez l’accès au service Web uniquement pour empêcher toute modification de ses paramètres.

  1. Dans votre application ServiceNow, recherchez des utilisateurs dans le navigateur de filtre.

  2. À partir de la liste des utilisateurs, sélectionnez le nouveau Profil d'utilisateur puis cliquez sur Modifier.

  3. Sélectionnez la case Accès au service Web uniquement , puis cliquez sur Mettre à jour et déconnectez-vous de Gestion des services.

Dépannage

Message d’erreur : Impossible d’effectuer l’action demandée car l’ID de messagerie spécifié n’est pas enregistré en tant qu’utilisateur dans l’instance ServiceNow. Veuillez contacter l’administrateur de votre compte ServiceNow.

Correctif de l’administrateur ServiceNow : Ajoutez l’utilisateur recevant l’erreur à la liste des utilisateurs de l’instance.