Microsoft Teams

GNETiX integrates with Microsoft Teams using the Bot Framework. The bot receives messages through the Teams channel and responds directly in the conversation.

Features

Setup

Step

Register an Azure AD Application

1. Go to the Azure Portal > App registrations > New registration
2. Name the application (e.g., "GNETiX Bot")
3. Set the supported account type to Accounts in any organizational directory (Multitenant)
4. Click Register
5. Copy the Application (client) ID and Directory (tenant) ID

Step

Create a Client Secret

1. In the app registration, go to Certificates & secrets > Client secrets
2. Click New client secret
3. Set a description and expiry period
4. Copy the secret value immediately -- it is only shown once

Step

Create a Bot Channel Registration

1. Go to Azure Portal > Azure Bot > Create
2. Link it to the app registration created above
3. Under Channels, enable the Microsoft Teams channel
4. Set the messaging endpoint to your GNETiX backend URL:

   https://api.gnetix.ai/api/teams/messages

Step

Configure in GNETiX

1. Navigate to System Settings > Integrations > Teams
2. Enter the App ID (client ID from Azure AD)
3. Enter the App Secret (client secret)
4. Enter the Tenant ID
5. Click Save

Step

Install the Bot in Teams

Create a Teams app manifest (or use the one generated by GNETiX) and upload it to your Teams admin center or sideload it into a team for testing.

User Matching

GNETiX matches Teams users by their email address (UPN). The Azure AD email must match the email configured for the user in GNETiX.

Users must have the Teams platform toggle enabled in their profile.

Manifest Configuration

The Teams app manifest defines the bot's identity, permissions, and capabilities. The key fields are:

{
  "bots": [
    {
      "botId": "<your-app-id>",
      "scopes": ["personal", "team"],
      "supportsFiles": false
    }
  ]
}

Upload the manifest as a .zip file containing manifest.json, a color icon (192x192), and an outline icon (32x32).