How to set up a Teams bot?

This document describes the steps your IT team needs to follow to integrate the Workforce Hub Teams Bot into your Microsoft Teams environment.

1. Create Azure Bot Resource

• Go to Azure Portal
• Create a new Azure Bot resource (Pricing: S1 Standard)
• Note the Client ID and Client Secret (you will send these to Things Solver)

2. Configure Microsoft Teams Channel

• In your Azure Bot resource, go to Channels
• Add and configure the Microsoft Teams channel

3. Set Message Endpoint

• In the Azure Bot resource, go to Configuration
• Set the Messaging endpoint to:

https://workforce-eu.thingsolver.com/api/latest/teams-bot/{azure_directory_id}/api/messages

4. Configure OAuth Connection

• In the Azure Bot resource, go to Configuration > Add OAuth Connection Settings
• Enter the following:
• Name: keycloak
• Service Provider: Generic OAuth 2
• Client ID: (will be provided by Things Solver)
• Client Secret: (will be provided by Things Solver)
• Authorization URL: 
  https://workforce-eu.thingsolver.com/auth/realms/ts-wfh/protocol/openid-connect/auth
• Token URL: 
  https://workforce-eu.thingsolver.com/auth/realms/ts-wfh/protocol/openid-connect/token
• Refresh URL: 
  https://workforce-eu.thingsolver.com/auth/realms/ts-wfh/protocol/openid-connect/token
• OAuth Metadata Endpoint: 
  https://workforce-eu.thingsolver.com/auth/realms/ts-wfh/.well-known/openid-configuration
• PKCE Type: none
• Scopes: openid organization

5. Provide Credentials to Things Solver

Note: The Client ID is the Application (client) ID of the App Registration that was automatically created when you created your Azure Bot. This App Registration has the same name as your Azure Bot. You can find the Client ID and generate a Client Secret in the Azure Portal under App registrations > [Your Bot Name].

• Send the following to your Things Solver contact:
  • Client ID (Application (client) ID from App Registration)
  • Client Secret (from App Registration)
  • Tenant ID (Azure Directory ID)
  • Screenshot of the entire Azure Bot configuration (showing all relevant settings and values in the Azure Portal)

6. Receive and Import Teams App Manifest

• Things Solver will send you a ZIP file containing the Teams app manifest and icons
• In Microsoft Teams, go to Apps > Manage your apps > Upload a custom app
• Upload the ZIP file
• Next, your Microsoft Teams Organization admin must approve and publish the app for your organization.

For any questions or support, contact your Things Solver representative.