KocoroMicrosoft Teams Integration Guide
Connect a Kocoro agent to Microsoft Teams through a self-built Bot Framework app, so your team can talk to your agent directly in one-on-one or group chats. The whole flow takes about 10 minutes.
Before you begin
- A Microsoft Teams / Microsoft 365 account allowed to create apps and bots in the Teams Developer Portal.
- Kocoro installed and initialized, with at least one agent created.
- A Mac kept running to host Kocoro and answer incoming messages.
- 1
Create a bot
Open the Teams Developer Portal, go to Tools → Bot management, click "New bot", enter a name (e.g. "Kocoro"), and click "Add". Once created, note the Bot ID — you'll need it when registering in Kocoro.
- Teams Developer Portal: https://dev.teams.microsoft.com/
Fig. 1 — Create a bot under Tools → Bot management. - 2
Point the bot's endpoint to Kocoro
Open the bot you just created, go to Configure, set the Endpoint address to the Kocoro Teams endpoint below, then click "Save".
https://api.shannon.run/api/v1/channels/teams/eventsFig. 2 — Set the bot's messaging endpoint and save. - 3
Create a client secret
Go to the "Client secrets" tab, click "Add a secret", and copy the generated secret. You'll paste it into Kocoro as the App Password in the next step.
The secret is shown only once — copy it immediately and keep it safe. If you lose it, create a new one.Fig. 3 — Create and copy a client secret. - 4
Register the bot in Kocoro
Open Kocoro, go to Capabilities → Connectors, and click "Add Bot" under "Microsoft Teams". Paste the Bot ID as the App ID and the client secret as the App Password, optionally set a display name, then click "Register Bot".
- Once registered, Kocoro handles inbound and outbound Teams messages with these credentials.
- You can return to the Connectors page anytime to check the connection or remove the bot.
Fig. 4 — Paste the credentials and register the bot in Kocoro. - 5
Create an app
Back in the Teams Developer Portal, go to Apps, click "New app", enter an app name, keep the latest stable manifest version, and click "Add". This app is the package that lets people install your bot in Teams.
Fig. 5 — Create a new app under Apps. - 6
Fill in basic information
On the app's "Basic information" page, enter a short name and the short / long descriptions. The App ID here is generated by Microsoft and is unique to your org.
Fig. 6 — Fill in the app's basic information. - 7
Add developer info and URLs
Scroll down to "Developer information" and "App URLs". Enter your developer / company name, website, and the privacy policy and terms-of-use URLs, then click "Save".
- Privacy policy: https://kocoro.ai/en/privacy/
- Terms of use: https://kocoro.ai/en/terms/
Fig. 7 — Add developer information and app URLs, then save. - 8
Upload the app icons
Go to "Branding" and upload two icons: a color icon (192×192 px PNG, with a 96×96 symbol centered) and an outline icon (32×32 px, white or transparent). You can use the Kocoro icons below.
Fig. 8 — Upload the color and outline icons under Branding. - 9
Add the Bot feature
Open "App features", and under "Select a feature to add" choose "Bot".
Fig. 9 — Add the Bot feature to the app. - 10
Identify the bot and set the scopes
Under "Identify your bot", choose "Select an existing bot" and pick the bot you created in step 1. Then, under "Select the scopes where people can use your bot", check "Personal" and "Group Chat", and click "Save".
Fig. 10 — Select your existing bot, choose the scopes, then save. - 11
Preview in Teams
Click "Preview in Teams" in the top-right corner to install the app in your Teams client.
Fig. 11 — Click "Preview in Teams" to install and test.
Done — start using it in Teams
After the app is installed, members can message the bot in a one-on-one chat or @mention it in a group, and your Kocoro agent replies. To use it in a group or channel, add the bot there first.