Microsoft Teams

Microsoft Teams is a Communicator Integration. Communicator Integrations allow Dropzone to ask questions of your employee base and use their responses to improve the quality of analysis.

Dropzone uses a Microsoft Teams Bot and an Azure AD Application to communicate directly with people in your organization.

Dropzone supports two configuration methods: automated and manual.

Automated Setup (Recommended)

For the most reliable setup experience, contact your Dropzone support representative to request our automated deployment script. This script handles all Azure and Teams configuration automatically, including:

Azure Bot creation and configuration
Azure AD App Registration with required permissions
Teams app creation and deployment
Automatic app installation policies

The script will provide you with the exact credentials needed for Dropzone configuration.

Automated Setup Results

When the automated script completes successfully, it will provide you with the following credentials:

MS Teams Bot App ID: Application (client) ID for your bot
MS Teams Bot App Secret: Client secret for your bot
MS Graph Tenant ID: Azure AD tenant ID

The script also creates a Teams app package (teams_app.zip) for you to upload to your organization's app catalog. Proceed to the "Publish the application in Teams Admin Center" section for instructions on how to do so.

Manual Setup

Manual setup is available if automated setup is not possible for your organization. This process involves several steps in Azure and Microsoft Teams. Follow the instructions below carefully.

Manual Setup Instructions

To enable the Microsoft Teams Communicator manually, you will perform the following actions:

Create an Azure Bot and configure it for Microsoft Teams
Configure your Azure AD App Registration with the required API permissions
Create a Teams App in the Developer Portal
Publish the Teams App to your organization's app catalog
Collect the necessary credentials for Dropzone configuration

Azure Portal & Azure AD Setup

Create the Azure Bot

Go to your Azure Portal
In the search bar, search "Bot Services" and click it

Click "Create"

Click "Azure Bot" or go directly to https://portal.azure.com/#create/Microsoft.AzureBot

Select your subscription
Click "Create"

Name the bot something memorable, such as "dropzone-ai-interviewer"
Select your Azure subscription
Add the bot to your desired resource group, or create a new one
Select your data residency

In the "Microsoft App ID" section, select "Single Tenant"
Click "Create new Microsoft App ID"

In the bottom left corner, click "Review + create"
Click "Create"

Configure the Bot Channels

Once the Azure Bot resource is deployed, navigate to it
Under "Next steps," click "Go to resource"

In the left sidebar, navigate to Settings > Channels

Under "Available Channels," click "Microsoft Teams"

Select your Microsoft Teams channel type
Click "Apply"

In the Channel page, it should be shown as Running or Healthy

In the left sidebar, navigate to Settings > Configuration
Under "Messaging endpoint, input your Dropzone webhook endpoint, e.g. https://mycompany.dropzone.app/interviewer/webhooks/ingest/msteams

Copy the Microsoft APP ID and Tenant ID for use later in the Dropzone UI where they are called "Microsoft APP ID" and "MS Graph Tenant ID," respectively
Next to Microsoft App ID, click "Manage Password"

You should now be on the "Certificates & Secrets" page for your new Azure AD App Registration

Click "+ New client secret"

Enter a description for the client secret, such as "Dropzone AI Bot Secret," and choose an appropriate expiration date. Click "Add"

Your Dropzone integration will stop working when the client secret expires. Consider setting a calendar reminder to update the key prior to expiration. For convenience's sake, we recommend picking a longer expiration date, to limit the number of times the client secret must be updated.

Under "Value," copy the Client Secret Value for use later in the Dropzone UI, where it is called "MS Teams Bot APP ID"

This value is not shown after you leave this page - be sure to record it immediately.

Configure the Application's API permissions

In the left sidebar of the App Registration, navigate to Manage > API permissions
In the API permissions page, click "Add a permission"

Under the Microsoft API header, select "Microsoft Graph"

Click "Application Permissions"

Add the following permissions:

Permission

Purpose

AppCatalog.Read.All

Allows the Chatbot to read apps in the app catalogs

Chat.Create

Allows the Chatbot to create chats

Chat.Read.All

Allows the Chatbot to read all 1-to-1 or group chat messages in Microsoft Teams

TeamsAppInstallation.ReadWriteForTeam.All

Allows the Chatbot to read, install, upgrade, and uninstall Teams apps in any team. Does not give the ability to read application-specific settings

TeamsAppInstallation.ReadWriteForUser.All

Allows the Chatbot to read, install, upgrade, and uninstall Teams apps for any user. Does not give the ability to read application-specific settings

TeamsAppInstallation.ReadWriteSelfForChat.All

Allows the Chatbot to read, install, upgrade, and uninstall itself for any chat

TeamsAppInstallation.ReadWriteSelfForTeam.All

Allows the Chatbot to read, install, upgrade, and uninstall itself in any team

TeamsAppInstallation.ReadWriteSelfForUser.All

Allows the Chatbot to read, install, upgrade, and uninstall itself to any user

User.Read.All

Allows the Chatbot to read user profiles

Once done selecting all the permissions, click "Add permissions"
Click "Grant admin consent for [mycompany.net]"

If you are not an Azure AD administrator, have one grant access for you.

Click "Yes"

Teams Developer Portal & Admin Center Setup

Create/Configure Teams App in Developer Portal

Go to the Teams Developer Portal
Click "Create a new app"

Name it something memorable, such as "Dropzone AI Interviewer," then click "Create"

In the Basic Information Page, configure the app as follows:

Short name: Dropzone AI Interviewer
Long name: Dropzone AI Interviewer for Microsoft Teams
Short description: Dropzone AI Interviewer — Security Tool
Long description: Dropzone AI is a vendor used by the company to perform security assessments. This app may send you messages to ask about incidents.

Version: The current version of Microsoft teams you're using
Developer information: You may input your own details or use Dropzone's (e.g. Dropzone AI and https://dropzone.ai)
APP URLs: Input links to your privacy policy and terms of use

Application (client) ID: Input the Application (client) ID you copied earlier
Click "Save"

If you wish, you can upload a logo for your application. We recommend using one of the following Dropzone logos:

https://go.dropzone.ai/img/logos/logomark-transparent-color-192px-96px.png
https://go.dropzone.ai/img/logos/logomark-transparent-color-32px.png

To do so, in the left sidebar, navigate to Branding, click "Color Icon" and upload your desired logo.

In the left sidebar, navigate to App Features
Click "Bot"

Select the existing Azure bot you created

You may use App validation to double-check that Teams will accept your app.

In the top right, click "Distribute"
Select either "Download the app package" or "Publish to your organization"

Publish the application in Teams Admin Center

Navigate to your Teams Admin Center - Manage Apps page as a Teams Administrator (or have an administrator perform these steps for you)
If you downloaded the app package, in the upper right click Actions > Upload new app
Upload the zip file you just downloaded

If you chose to publish to your organization, search for your app in the Developer Portal
Select the app from the list
Click "Publish," then "Confirm"

Enable Microsoft Teams Integration

To enable the communicator integration, you will need the following information:

Dropzone Field

Source

MS Teams Bot App ID

The Microsoft App ID value you copied earlier

MS Teams Bot App Secret

The Client Secret value you copied earlier

MS Graph Tenant ID

The Directory (tenant) ID value you copied earlier

If you used the automated script, it will provide these exact credentials at the end of the setup process. You can also locate your Directory (tenant) ID in the overview page of your application.

To enable the integration, do the following:

Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app
In the bottom left hand corner, navigate to Settings > Integrations

Click "Library"

If you have previously integrated this application, click "Configured"

In the Search bar, search Microsoft Teams, then click "Configure"

Input the Bot App ID, Bot App Secret, and MS Graph Tenant ID

Click "Test & Save" to finish

Enable Microsoft Teams in Interviewer Configuration

After successfully configuring and saving the Microsoft Teams communicator credentials, set it as the active interviewer for desired scenarios:

Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app
In the bottom left hand corner, navigate to Settings > AI Interviewer

In the right corner of the Interviewer Configuration page, select the dropdown
Select "Microsoft Teams"
Ensure the toggle switch next to Microsoft Teams is enabled (blue and toggled to the right)

This will activate Microsoft Teams as a communicator for initiating interviews based on your configured scenarios.

Troubleshooting

If you encounter any issues during setup or when configuring the integration in Dropzone:

Double-check all credentials and configuration steps above
Ensure all required permissions are granted and show as Granted for [Your Organization]
If you see errors in Teams or Azure, consult the Microsoft Teams documentation or Azure Bot Service documentation
For persistent issues, contact your Dropzone AI support representative
For manual setup issues, consider switching to the automated script for a more reliable experience

PreviousCommunicators

NextSlack Communicator

Last updated 1 month ago

Was this helpful?