Skip to main content

​
Prerequisites

  • A Microsoft 365 account with admin access
  • An Azure subscription (for bot registration)
  • A running Suji instance

​
Create an Azure Bot

1

Go to the Azure Portal

Navigate to portal.azure.com and sign in.
2

Create a Bot Channels Registration

Search for Azure Bot and click Create. Fill in:
  • Bot handle: A unique identifier for your bot
  • Subscription: Your Azure subscription
  • Resource group: Create or select one
  • Type of App: Multi Tenant
3

Get credentials

After creation, go to Configuration and note:
  • Microsoft App ID (also called Client ID)
  • Click Manage Password to create a new Client Secret (App Password)
  • Note your Tenant ID from Azure Active Directory
4

Enable Teams channel

In your Azure Bot resource, go to Channels and add the Microsoft Teams channel.
5

Configure messaging endpoint

Set the messaging endpoint to your Suji instance’s webhook URL:
https://your-subdomain.suji.fr/webhook/ms-teams

​
Connect to Suji

1

Go to your instance

Open your instance in the Suji dashboard and click the Connectors tab.
2

Add MS Teams connector

Click Add Connector and select MS Teams.
3

Enter credentials

  • appId: Your Microsoft App ID
  • appPassword: Your Client Secret
  • tenantId: Your Azure AD Tenant ID
4

Save

Click Save. The connector will be configured on your instance.

​
Install the Bot in Teams

To use the bot in Microsoft Teams, you’ll need to create a Teams app package and install it:
  1. Create a Teams app manifest with your bot’s App ID
  2. Upload the app package to your Teams organization
  3. Add the bot to the desired channels or chats

​
Troubleshooting

  • Verify the messaging endpoint URL is correct in Azure
  • Check that the App ID, password, and tenant ID are correct
  • Ensure the Teams channel is enabled in Azure Bot settings
  • The client secret may have expired — create a new one in Azure
  • Verify the tenant ID matches your Azure AD tenant
  • Check the instance logs for authentication-related errors
  • Make sure the Teams app package is installed in your organization
  • Check that the bot is added to the channel or chat where you’re testing