Add GHES installation details to existing Teams integration docs (#60180)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Jon Leach <leachj@github.com>
Co-authored-by: John Clement <70238417+jclement136@users.noreply.github.com>

Author: 4 people

content/integrations/how-tos/teams/integrate-github-with-teams.md

@@ -54,15 +54,42 @@ If you use {% data variables.product.prodname_ghe_cloud %} with data residency o
 
 ## Installing the {% data variables.product.github %} integration for Teams on {% data variables.product.prodname_ghe_server %}
 
-1. In the management console for your {% data variables.product.prodname_ghe_server %} instance, open "Chat integrations" and enable {% data variables.product.github %} Chat Integration.
-1. Select the Microsoft Teams tab and follow the link to register an app in Microsoft Azure.
-1. Record the application (client) ID and tenant ID, then create a client secret.
-1. Back in the management console, choose **Deploy to Azure** and follow the prompts to provision the Teams bot.
-1. Enter the app ID, tenant ID, and client secret in the Teams configuration, then save the settings.
-1. Download the generated manifest and upload it to Teams. For more information, see [Upload your app to Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload).
-1. Install the app in Teams and run `@GitHub Notifications signin` to connect your {% data variables.product.github %} account.
-
->[!NOTE] If your {% data variables.product.prodname_ghe_server %} instance is not reachable from the public internet, provide the proxy URL when configuring the Teams bot in Azure.
+To integrate {% data variables.product.prodname_ghe_server %} with Microsoft Teams, you first need to configure the chat integration on your instance and register an app in Microsoft Azure.
+
+### Register the app and provision the Teams bot
+
+1. In the {% data variables.enterprise.management_console %} for your {% data variables.product.prodname_ghe_server %} instance, open the **Chat integration** page and select the **Enable {% data variables.product.github %} Chat integration** checkbox.
+1. Under "Select chat client", select **Microsoft Teams**, and follow the link to register an app in Microsoft Azure.
+1. In Azure, configure the details for your app registration:
+    * Enter your application registration **Name**.
+    * Set the supported account types to **Multiple Entra ID tenants** and **Allow all tenants**.
+1. Click **Register**.
+1. Record the application (client) ID and tenant ID displayed.
+1. Under **Certificates & secrets**, create a new client secret.
+1. Record the client secret value displayed.
+1. Return to the {% data variables.enterprise.management_console %} and **Chat integration** page on your {% data variables.product.prodname_ghe_server %} instance.
+1. Click **Deploy to Azure**, and follow the prompts to provision the Teams bot in Microsoft Azure.
+1. In Azure, select the **Subscription** and **Resource group** for the Azure bot to be deployed.
+1. Enter the application (client) ID and tenant ID you recorded earlier, in the Teams bot configuration.
+1. Depending on your network configuration for {% data variables.product.prodname_ghe_server %}:
+    * If your instance _is reachable_ on the public internet, select the **Append '_msteams' to path** checkbox.
+    * If your instance _is not reachable_ on the public internet and requires a proxy:
+        * Ensure the **Append '_msteams' to path** checkbox isn't selected.
+        * In the **GHES Instance Host Name** field, enter the URL that will forward the traffic to your instance.
+1. Click the **Review + create** tab, and then click **Create** to save the settings and begin provisioning the app.
+1. Wait for the Teams bot to be provisioned in Azure.
+
+### Configure {% data variables.product.prodname_ghe_server %} and install the app in Teams
+
+1. Return to the {% data variables.enterprise.management_console %}  and **Chat integration** page on your {% data variables.product.prodname_ghe_server %} instance.
+1. Enter the **Microsoft client ID**, **Microsoft client secret**, and **Microsoft tenant ID** using the application details you recorded earlier.
+1. Optionally, if your {% data variables.product.prodname_ghe_server %} instance _is not reachable_ on the public internet and requires a proxy, enter the URL that will forward the traffic to your instance in the **Public Endpoint URL** field.
+1. Click **Save client settings**.
+1. Click **Generate manifest** to download the integration manifest for later use.
+1. Click **Save settings** to apply the changes to your instance.
+1. Log in to your Teams client, and open the Teams admin center.
+1. Go to **Teams apps** > **Manage apps**, and click **Upload** to upload the integration manifest you downloaded in a previous step. For more information, see [Upload your app to Teams](https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/deploy-and-publish/apps-upload#upload-your-app).
+1. Install your app in Teams, and run `@GHE signin` to connect your {% data variables.product.github %} account.
 
 {% endif %}