Inscription de canaux botBot channels registration

Cet article explique comment inscrire un bot auprès du Azure bot service.This article shows how to register a bot with the Azure Bot Service. Si le robot est hébergé ailleurs, vous pouvez également le rendre disponible dans Azure et le connecter aux canaux pris en charge.If the bot is hosted elsewhere, you can also make it available in Azure and connect it to the supported channels. Il existe deux façons d’inscrire un bot auprès d’Azure :There are 2 ways to register a bot with Azure:

  1. En suivant les étapes de l’article créer un bot avec Azure bot service, le bot est créé sur et inscrit auprès d’Azure et une application Web est créée pour héberger le bot.Following the steps in the article Create a bot with Azure Bot Service, the bot is created on and registered with Azure and a Web application is created to host the bot. Vous utilisez cette approche si vous développez et hébergez un bot dans Azure.You use this approach if you develop and host a bot in Azure.
  2. Pour créer et développer votre bot localement, suivez les étapes décrites dans cet article.To create and develop your bot locally, follow the steps in this article. Lorsque vous inscrivez votre bot, vous fournissez l’adresse Web où votre robot est hébergé.When you register your bot, you supply the web address where your bot is hosted. Vous pouvez toujours l’héberger dans Azure.You can still host it in Azure.

Important

Vous devez uniquement inscrire un bot s’il n’est pas hébergé dans Azure.You only need to register a bot if it is not hosted in Azure. Les robots créés à l’aide du Portail Azure ou de l’interface de ligne de commande (CLI) sont déjà inscrits auprès du Azure Bot Service.Bots created using the Azure portal or the Command Line Interface (CLI) are already registered with the Azure Bot Service. Pour plus d’informations, consultez déployer votre robot et créer un robot avec Azure bot service.For more information, see Deploy your bot and Create a bot with Azure Bot Service.

Créer une application d’inscriptionCreate a registration application

  1. Dans votre navigateur, accédez au Portail Azure.In your browser, navigate to the Azure portal. Si vous n’avez pas d’abonnement, vous pouvez vous inscrire pour obtenir un compte gratuit.If you do not have a subscription, you can register for a free account.

  2. Dans le volet gauche, cliquez sur créer une ressource.In the left panel, click Create a resource.

  3. Dans la zone de sélection du volet droit, entrez bot.In the right panel selection box enter bot. Dans la liste déroulante, sélectionnez inscription des canaux de robots.From the drop-down list select Bot Channels Registration.

  4. Cliquez sur le bouton Créer.Click the Create button.

  5. Dans le formulaire d’inscription de canaux bot , fournissez les informations demandées sur votre robot, comme indiqué dans le tableau ci-dessous.In the Bot Channels Registration form, provide the requested information about your bot as specified in the table below.

    ParamètreSetting Valeur suggéréeSuggested value DescriptionDescription
    Nom du botBot name <Your bot display name> Attribuez le nom complet du bot qui apparaît dans les canaux et les répertoires.Assign the display name for the bot that appears in channels and directories. Vous pouvez modifier ce nom à tout moment.You can change this name at anytime.
    AbonnementSubscription <Your subscription> Sélectionnez l’abonnement Azure à utiliser.Select the Azure subscription you want to use.
    Groupe de ressourcesResource Group <Your resource group name> Créez un groupe de ressources ou sélectionnez un groupe existant.Create a new resource group or select an existing one.
    LieuLocation USA OuestWest US Choisissez l’emplacement géographique de votre groupe de ressources.Choose the geographic location for your resource group. Il est généralement préférable de choisir un emplacement proche de vous.It's usually best to choose a location close to you. L’emplacement ne peut pas être modifié une fois que le groupe de ressources est créé.The location cannot be changed once the resource group is created.
    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, consultez la page Tarification Azure Bot Service.For more information, see Bot Service pricing.
    Point de terminaison de messagerieMessaging endpoint https:// <your bot name> . azurewebsites.NET/API/messageshttps://<your bot name>.azurewebsites.net/api/messages Entrez l’URL du point de terminaison de messagerie de votre bot.Enter the URL for your bot's messaging endpoint. Vous pouvez conserver ce champ vide, car vous devez entrer l’URL requise après le déploiement du bot.You can leave this field empty since you will enter the required URL after deploying the bot.
    Application InsightsApplication Insights Il en vaOn Déterminez si vous souhaitez Activer ou Désactiver 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 passeApp ID and password Create Microsoft App ID and password (Créer l’ID et le mot de passe de l’application)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. Consultez la section suivante, Inscription manuelle de l’application.See the next section Manual app registration. Dans le cas contraire, un nouvel ID d’application Microsoft sera créé dans le processus d’inscription.Otherwise, a new Microsoft app ID will be created in the registration process.
  6. Laissez la zone point de terminaison de messagerie vide pour le moment.Leave the Messaging endpoint box empty for now. Vous devez entrer l’URL requise après le déploiement du bot.You'll enter the required URL after deploying the bot.

  7. Dans la capture d’écran ci-dessous, cliquez sur ID d’application et mot de passe Microsoft.Click Microsoft App ID and password, highlighted in the screenshot below. Les étapes suivantes vous permettent de créer le mot de passe d’application d’inscription et l’ID d’application à utiliser dans vos fichiers de configuration de robot appsettings.json (.net), .env (JavaScript) et config.py (Python).The next steps allow you to create the registration application password and application ID to be used in your bot configuration files appsettings.json (.NET), .env (Javascript) and config.py (Python).

    paramètres d’inscription de bot

  8. Cliquez sur Créer nouveau.Click Create New.

  9. Cliquez sur créer un ID d’application dans le lien du portail d’inscription des applications .Click the Create App ID in the App Registration Portal link.

  10. Dans la fenêtre inscription de l’application affichée, cliquez sur l’onglet nouvel enregistrement dans l’angle supérieur gauche.In the displayed App registration window, click the New registration tab in the upper left.

  11. Entrez le nom de l’application de bot que vous inscrivez.Enter the name of the bot application you are registering.

  12. Pour les types de comptes pris en charge, sélectionnez le type en fonction de vos besoins.For the supported account types, select the type based on your requirements. Consultez également utiliser les informations d’identification de bot.See also Use bot credentials.

  13. Cliquez sur le bouton inscrire .Click the Register button. Une fois l’opération terminée, Azure affiche la page vue d’ensemble de l’application.Once completed, Azure displays the overview page for the application.

  14. Copiez la valeur de l’ID de l' application (client) et enregistrez-la dans un fichier.Copy the Application (client) ID value and save it in a file.

  15. Dans le volet gauche, cliquez sur certificat et secrets.In the left panel, click Certificate and secrets.

  16. Sous Secrets client, cliquez + Nouveau secret client.Under Client secrets, click New client secret.

  17. Ajoutez une description pour différencier ce secret des autres secrets que vous devrez peut-être créer pour cette application.Add a description to identify this secret from others you might need to create for this app.

  18. La valeur attribuée à expire à votre choix.Set Expires to your choosing.

  19. Cliquez sur Add.Click Add.

  20. Copiez la clé secrète client et enregistrez-la dans un fichier.Copy the client secret and save it to a file. Veillez à conserver le fichier dans un emplacement sécurisé.Make sure to keep the file in a secure place.

  21. Revenez à la fenêtre Bot Channels Registration et copiez l’ID de l’application et le secret client dans les zones ID d’application Microsoft et Mot de passe, respectivement.Go back to the Bot Channel Registration window and copy the App ID and the Client secret in the Microsoft App ID and Password boxes, respectively.

  22. Cliquez sur OK.Click OK.

  23. Cliquez sur le bouton créer et attendez que la ressource soit créée.Click the Create button and wait for the resource to be created. La nouvelle ressource s’affiche dans votre liste de ressources.It will show in your resources list.

Notes

L’application d’inscription affiche la région globale, même si vous en avez sélectionné une autre.The registration application will show the Global region even though you selected a different one. Ceci est normal.This is expected.

Inscription manuelle de l’applicationManual app registration

Une inscription manuelle est nécessaire dans les situations suivantes :A manual registration is necessary for situations like:

  • Vous ne pouvez pas effectuer les inscriptions dans votre organisation et devez demander à une tierce personne de créer l’ID d’application pour le bot que vous créez.You are unable to make the registrations in your organization and need another party to create the App ID for the bot you're building.
  • Vous devez créer manuellement votre propre ID d’application et votre propre mot de passe.You need to manually create your own app ID and password.

Important

Dans la section prend en charge les types de comptes, choisissez l’un des deux types multi-locataires, les comptes dans n’importe quel annuaire d’organisation (n’importe quel Azure ad-locataire) ou des comptes dans n’importe quel annuaire d’organisation (Azure ad-mutualisée) et des comptes Microsoft personnels (par exemple, Xbox, Outlook.com) lors de la création de l’application.In the section Supports account types, choose one of the two multi-tenant types, Accounts in any organizational directory (Any Azure AD - Multitenant) or Accounts in any organizational directory (Any Azure AD - Multitenant) and personal Microsoft accounts (e.g. Xbox, Outlook.com), when creating the app. Si vous ne définissez pas correctement cette valeur, vous obtiendrez un bot non fonctionnel.Not setting this value correctly will result in a non-functional bot. Pour plus d’informations, consultez inscrire une nouvelle application à l’aide de la portail Azure et inscrire une application auprès de la plateforme Microsoft Identity.For more information, see Register a new application using the Azure portal and Register an application with the Microsoft identity platform.

Mettre à jour le botUpdate the bot

  1. Kit de développement logiciel (SDK) robot pour .NET.Bot Framework SDK for .NET. Définissez les valeurs de clé suivantes dans le appsettings.json fichier :Set the following key values in the appsettings.json file:

    • MicrosoftAppId = <appId>
    • MicrosoftAppPassword = <appSecret>
  2. Kit de développement logiciel (SDK) de robot Framework pour Node.js.Bot Framework SDK for Node.js. Définissez les variables d’environnement suivantes dans le .env fichier :Set the following environment variables in the .env file:

    • MICROSOFT_APP_ID = <appId>
    • MICROSOFT_APP_PASSWORD = <appSecret>
  3. Kit de développement logiciel (SDK) robot pour Python.Bot Framework SDK for Python. Définissez les variables d’environnement suivantes dans le config.py fichier :Set the following environment variables in the config.py file:

    • APP_ID = os.environ.get("MicrosoftAppId", <appId>)
    • APP_PASSWORD = os.environ.get("MicrosoftAppPassword", <appSecret>)

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.

É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.