Microsoft Teams

​

Create the Entra app

1. Sign in to the Microsoft Entra admin center as an administrator.
2. If you have more than one tenant, use the Settings icon in the top menu and switch to the tenant for this bot.
3. Go to Entra ID → App registrations.
4. Click New registration.
5. Enter a name.
6. Set Supported account types to Single tenant only.
7. Leave the redirect URI empty. Click Register.
8. On the app Overview page, copy these two values:
   • Application (client) ID. This is the App ID you paste into Atonom.
   • Directory (tenant) ID. This is the Azure tenant ID you paste into Atonom.

​

Create the client secret

1. On the same app, open Certificates & secrets.
2. Click New client secret.
3. Enter a description and an expiry. Click Add.
4. Copy the secret Value immediately. Microsoft shows it only once. This is the client secret you paste into Atonom.

​

Expose an API

1. On the same app, open Expose an API.
2. Click Add next to Application ID URI.
3. Set the URI to api:// plus the Application (client) ID. For example, api://11111111-2222-3333-4444-555555555555.
4. Click Save.

​

Let the bot read the sender’s email

1. On the same app, open API permissions.
2. Click Add a permission → Microsoft Graph → Application permissions.
3. Add User.ReadBasic.All.
4. Click Grant admin consent for your organization.
5. Confirm the status for User.ReadBasic.All is Granted.
6. Click Add a permission → Microsoft Graph → Application permissions again.
7. Add TeamsAppInstallation.ReadWriteSelfForUser.All.
8. Click Grant admin consent for your organization.
9. Confirm the status for TeamsAppInstallation.ReadWriteSelfForUser.All is Granted.

​

Create the Azure Bot

​

Add an Azure subscription

1. Sign in to the Azure portal as an administrator of the same tenant as the Entra app.
2. Open Subscriptions, then click Add.
3. If Azure asks for a billing account, name the subscription and set the directory to this tenant. Choose Microsoft Azure Plan.
4. If there is no billing account, open Create an Azure account. Sign up with a work email in this tenant. A credit card is required for the identity check. The free account adds the subscription to this tenant.
5. Return to the Azure portal. The new subscription appears in the list.

​

Create the bot resource

1. Open Create an Azure Bot. Or open the Azure portal, type Azure Bot in the top search box, open Azure Bot, and click Create.
2. If the tenant is wrong, use the gear icon, open Directories + subscriptions, and switch to the same tenant as the Entra app.
3. If Subscription is empty, add one with the steps above, then return to this page.
4. On the first screen, set Plan to Azure Bot. This is the product name. The price is on the next page. Continue.
5. On Basics, enter the bot handle. Use the name people should see in the Teams chat.
6. Create a new resource group. Name it after the bot.
7. Set Pricing tier to Free. If the page shows Standard, click Change plan and choose Free.
8. Under Microsoft App ID, set the type to Single Tenant.
9. Set Creation type to Use existing app registration.
10. Paste the Application (client) ID into Microsoft App ID. Paste the Directory (tenant) ID into App tenant ID. Both values are on the Entra app Overview page.
11. Click Review + create, then Create.
12. When deployment finishes, click Go to resource. Open Settings → Configuration.
13. Set the messaging endpoint to:

https://app.getsignals.ai/api/chatinator/msteams-actions

14. Click Apply.
15. Open Settings → Channels. Under Add a featured channel, click Microsoft Teams. Agree to the terms. On the Messaging tab, select Microsoft Teams commercial (most common). Leave the Calling tab empty. Click Apply. The channel list then shows Teams as running.

​

Publish the app to your organization

​

Build the package

1. Click Apps → New app. Enter the bot name.
2. Open Configure → Basic information. Teams rejects the zip when these fields are empty:
   • Short name
   • Short description
   • Full description
   • Developer name
   • Website, privacy policy, and terms of use. Each value must start with https://. If you do not have a privacy page or a terms page, use https://getsignals.ai/privacy-policy.
   • Application (client) ID: the Entra app ID
3. Click Save.
4. Open Branding. Upload a color icon, 192×192 pixels, and an outline icon, 32×32 pixels.
5. Open App features → Bot.
6. In Enter a bot ID, paste the Application (client) ID. The page does not list your Azure Bots.
7. Select the Personal scope only.
8. Leave these boxes off: Upload and download files, Only send notification, Supports audio calls, and Supports video calls.
9. Click Save.
10. Open Single sign-on. Set the Application ID URI to the same api:// URI from Expose an API. Click Save.
11. Click Apps in the left pane to return to the list.
12. On that app’s row, click …, then Download app package.

​

Upload the zip

1. Open the Teams admin center as a Teams administrator.
2. Go to Teams apps → Manage apps.
3. At the top right, click Actions → Add new app. Select the zip.
4. Open the app. Open the About tab.
5. Copy App ID. This is the Catalog app ID you paste into Atonom.
6. Stay on this app. Open Users and groups.
7. Select Availability. Select Edit availability. In Available to, select Everyone. Select Apply.
8. Select Installs. Select Install app. Select Everyone. Select Apply. If Install app is not shown, select Edit installs, then Everyone, then Apply.

​

Link the bot to a Cloud Employee

1. In Atonom, open the Cloud Employee channel settings.
2. Open the external chat channel.
3. Choose Microsoft Teams.
4. Paste these four values and save:
   • Azure tenant ID: the Directory (tenant) ID
   • App ID: the Application (client) ID
   • Catalog app ID: the About tab App ID from the Teams admin center
   • Client secret: the secret value