Connect Microsoft Teams to Dchat

Before you start

• Difficulty: Hard
• Time: 45 minutes
• You need: An Azure subscription where you can create an Azure Bot
• You need: Permission to install apps in your Teams tenant
• You need: Admin or owner access to your Dchat workspace

Steps

1. Create an Azure Bot

   In the Azure portal, create an Azure Bot as a multi-tenant app. Copy its Microsoft App ID, then create a client secret for the app and copy the secret's value.

2. Add the channel in Dchat

   In Dchat, open Settings → Channels and choose + Add channel. Pick "Teams", leave the identifier empty (Dchat fills in the App ID), and paste the credentials. Saving shows your messaging endpoint.

   { "MicrosoftAppId": "00000000-0000-0000-0000-000000000000", "MicrosoftAppPassword": "..." }

3. Set the messaging endpoint in Azure

   Paste the endpoint Dchat shows into the Azure Bot's configuration. It has this form, with your channel's number at the end:

   https://api.dchat.com/api/inbound/teams/{channel id}

4. Add the Teams channel and install the bot

   In the Azure Bot's channels, add Microsoft Teams, then install the bot in Teams for the people who should reach it. Send it a message to test.

What goes in each field

• MicrosoftAppId: The Azure Bot's Microsoft App ID (a GUID).
• MicrosoftAppPassword: The value of a client secret for that app.

Good to know

• Set the bot up as multi-tenant; Dchat signs in to the Bot Framework the multi-tenant way.
• Messages are handled; @mentions of the bot are removed from the text. Replies can carry up to 6 buttons.
• Your workspace needs at least one enabled site; new workspaces have one already. Messages are dropped while every site is switched off.
• Credentials are encrypted when you save them and are never shown again. To change one, paste the full credentials again.