Inscrire un bot auprès de Bot ServiceRegister a bot with Bot Service

Si votre bot est hébergé ailleurs et que vous souhaitez utiliser Bot Service pour le connecter à d’autres canaux, vous devez l’inscrire auprès de Bot Service.If you already have a bot hosted elsewhere and you would like to use the Bot Service to connect it to other channels, you will need to register your bot with the Bot Service. Dans cette rubrique, découvrez comment inscrire votre bot auprès de Bot Service en créant un service de bot Bot Channels Registration.In this topic, learn how to register your bot with the Bot Service by creating a Bot Channels Registration bot service.

Important

L’inscription du bot n’est nécessaire que s’il n’est pas hébergé dans Azure.You only need to register your bot if it is not hosted in Azure. S’il a été créé avec le Portail Azure, il est déjà inscrit auprès de Bot Service.If you created a bot through the Azure portal then your bot is already registered with the Bot Service.

Connexion à AzureLog in to Azure

Connectez-vous au portail Azure.Log in to the Azure portal.

Conseil

Si vous n’avez pas encore d’abonnement, vous pouvez vous inscrire pour un compte gratuit.If you do not already have a subscription, you can register for a free account.

Créer une inscription Bot Channels RegistrationCreate a Bot Channels Registration

Le service de bot Bot Channels Registration est nécessaire pour pouvoir utiliser la fonctionnalité Bot Service.You need a Bot Channels Registration bot service to be able to use Bot Service functionality. Un bot d’inscription permet de connecter le bot à des canaux.A registration bot lets you connect your bot to channels.

Pour créer une inscription Bot Channels Registration, effectuez les actions suivantes :To create a Bot Channels Registration, do the following:

  1. Cliquez sur le bouton Nouveau en haut à gauche du Portail Azure, puis sélectionnez IA + Cognitive Services > Bot Channels Registration.Click the New button found on the upper left-hand corner of the Azure portal, then select AI + Cognitive Services > Bot Channels Registration.

  2. Un nouveau panneau affiche des informations sur Bot Channels Registration.A new blade will open with information about the Bot Channels Registration. Cliquez sur le bouton Créer pour lancer le processus de création.Click the Create button to start the creation process.

  3. Dans le panneau Bot Service, indiquez les informations demandées sur votre bot (voir le tableau sous l’image).In the Bot Service blade, provide the requested information about your bot as specified in the table below the image.
    Panneau Créer un bot d’inscriptionCreate registration bot blade

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Nom du botBot name Nom d’affichage du botYour bot's display name Nom complet du bot qui s’affiche dans les canaux et les répertoires.The display name for the bot that appears in channels and directories. Ce nom est modifiable à tout moment.This name can be changed at anytime.
    AbonnementSubscription Votre abonnementYour subscription Sélectionnez l’abonnement Azure à utiliser.Select the Azure subscription you want to use.
    Groupe de ressourcesResource Group myResourceGroupmyResourceGroup Vous pouvez créer un groupe de ressources ou en choisir un.You can create a new resource group or choose from an existing one.
    LieuLocation USA OuestWest US Choisissez un emplacement proche de celui où est déployé votre bot ou proche d’autres services auxquels il accédera.Choose a location near where your bot is deployed or near other services your bot will access.
    Niveau tarifairePricing tier F0F0 Sélectionnez un niveau tarifaire.Select a pricing tier. Vous pourrez mettre à jour le niveau tarifaire à tout moment.You may update the pricing tier at any time. Pour plus d’informations, voir Prix de Bot Service.For more information, see Bot Service pricing.
    Point de terminaison de messagerieMessaging endpoint URLURL Entrez l’URL du point de terminaison de messagerie de votre bot.Enter the URL for your bot's messaging endpoint.
    Application InsightsApplication Insights Il en vaOn Activez ou désactivez Application Insights.Decide if you want to turn Application Insights On or Off. Si vous sélectionnez Activé, spécifiez également un emplacement régional.If you select On, you must also specify a regional location.
    ID d'application et mot de passe MicrosoftMicrosoft App ID and password Création automatique de l’ID d’application et du mot de passeAuto create App ID and password Utilisez cette option si vous voulez entrer manuellement un ID d’application et un mot de passe Microsoft.Use this option if you need to manually enter a Microsoft App ID and password. Sinon, ils seront créés automatiquement au cours du processus de création du bot.Otherwise, a new Microsoft App ID and password will be created for you in the bot creation process.
  4. Cliquez sur Créer pour créer le service et inscrire le point de terminaison de messagerie de votre bot.Click Create to create the service and register your bot's messaging end point.

Vérifiez que l’inscription a été créée en consultant les Notifications.Confirm that the registration has been created by checking the Notifications. La notification passera de Déploiement en cours… à Déploiement réussi.The notifications will change from Deployment in progress... to Deployment succeeded. Cliquez sur le bouton Accéder à la ressource pour ouvrir le panneau des ressources du bot.Click Go to resource button to open the bot's resources blade.

Mot de passe Bot Channels RegistrationBot Channels Registration password

Le service de bot Bot Channels Registration n’est pas associé à un service d’application.Bot Channels Registration bot service does not have an app service associated with it. C’est pourquoi il a juste un ID MicrosoftAppID.Because of that, this bot service only has a MicrosoftAppID. Le mot de passe doit être généré et enregistré manuellement.You need to generate the password manually and save it yourself. Vous en aurez besoin pour tester votre bot avec l’émulateur.You will need this password if you want to test your bot using the emulator.

Pour générer un mot de passe MicrosoftAppPassword, effectuez les étapes suivantes :To generate a MicrosoftAppPassword, do the following:

  1. Dans le panneau Paramètres, cliquez sur Gérer.From the Settings blade, click Manage. Ce lien apparaît à côté d’ID d’application Microsoft.This is the link appearing by the Microsoft App ID. Il ouvre une fenêtre permettant de générer un nouveau mot de passe.This link will open a window where you can generate a new password.
    Lien Gérer dans le panneau ParamètresManage link in Settings blade

  2. Cliquez sur Générer un nouveau mot de passeClick Generate New Password. pour générer un nouveau mot de passe pour votre bot.This will generate a new password for your bot. Copiez-le et enregistrez-le dans un fichier.Copy this password and save it to a file. C’est la seule fois où vous verrez ce mot de passe.This is the only time you will see this password. Si vous n’enregistrez pas le mot de passe complet, vous devrez répéter le processus de création d’un mot de passe pour la suite.If you do not have the full password saved, you will need to repeat the process to create a new password should you need it later.
    Générer un mot de passe d’application MicrosoftGenerate Microsoft App Password

Mettre à jour le botUpdate the bot

Si vous utilisez le kit SDK Bot Framework pour Node.js, définissez les variables d’environnement suivantes :If you're using the Bot Framework SDK for Node.js, set the following environment variables:

  • MICROSOFT_APP_IDMICROSOFT_APP_ID
  • MICROSOFT_APP_PASSWORDMICROSOFT_APP_PASSWORD

Si vous utilisez le kit SDK Bot Framework pour .NET, définissez les valeurs de clé suivantes dans le fichier web.config :If you're using the Bot Framework SDK for .NET, set the following key values in the web.config file:

  • MicrosoftAppIdMicrosoftAppId
  • MicrosoftAppPasswordMicrosoftAppPassword

Tester le botTest the bot

Maintenant que votre service de bot est créé, testez-le dans la Discussion Web.Now that your bot service is created, test it in Web Chat. Entrez un message ; votre bot devrait répondre.Enter a message and your bot should respond.

Étapes suivantesNext steps

Dans cette rubrique, vous avez inscrit votre bot hébergé auprès de Bot Service.In this topic, you learned how to register your hosted bot with the Bot Service. L’étape suivante consiste à apprendre à gérer votre Bot Service.The next step is to learn how to manage your Bot Service.