For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Logo
DeveloperAcademyCommunityStatus
  • Getting Started
    • Welcome to Moveworks
    • Roadmap & Release Notes
    • Moveworks Best Practices
    • Labs
    • Professional Services
    • Support
  • AI Assistant
    • AI Assistant Overview
    • Capabilities
    • Web Experiences
      • Overview
      • Microsoft Teams
        • AI Assistant in Microsoft 365 (MS Teams + MS Graph) Access Requirements & Setup Guide
        • AI Assistant in Microsoft Teams (GCCH) Setup Guide
        • AI Assistant in Microsoft Teams (Non-App Store) Setup Guide
        • Customizing your Teams Appstore Bot
        • Microsoft Teams Secret Rotation Guide
        • Single Tenant Microsoft Teams Moveworks Setup Guide
        • Multi-Tenant Microsoft Teams Moveworks Setup Guide
      • Slack
      • Google Chat
      • Webex Teams
      • Zoom Chat
    • Analytics & Performance
  • Enterprise Search
    • Overview
    • Search Connectors
    • Agentic RAG Overview
    • Content Ingestion Platform
    • How Search Works
    • Monitor Indexed Content
    • Vetted Content
    • Permissions
  • Productivity Boost
    • Overview
    • Configure Productivity Boost
    • Quick GPT
    • Calendar Management
    • Brief Me
DeveloperAcademyCommunityStatus
On this page
  • Implementation Steps
  • Step 1: Create MS Teams Connector
  • Step 2: Create MS Graph Connector
  • Step 3: Add MS Graph Connector to Identity Configuration
  • Step 4: Create Chatbot Config
  • Step 5: Validate User Identity
  • Step 6: Configure Notification Routes
AI AssistantChat Platform ExperiencesMicrosoft Teams

Single Tenant Microsoft Teams Moveworks Setup Guide

||View as Markdown|
Was this page helpful?
Edit this page
Previous

Multi-Tenant Microsoft Teams Moveworks Setup Guide

Next
Built with

This guide explains how to set up a single Microsoft Teams chatbot in Moveworks. It covers connector creation, identity ingestion, service account configuration, chatbot setup, roster validation, and notification routing.

Implementation Steps

Step 1: Create MS Teams Connector

  1. Navigate to Moveworks Setup Portal. Go to Core Platform > Connectors > Built-in Connectors and select Microsoft Teams.

    Built-in Connectors page with Microsoft Teams selected

  2. Click on NEXT: ADD CREDS

    Microsoft Teams connector page with NEXT: ADD CREDS button highlighted

  3. Name the connector “msteams” and for the Authentication Type select Microsoft Bot App Store Auth if you are leveraging the Microsoft Teams App Store, then Click Save.

    Credential Details with Microsoft Bot App Store Auth authentication type selected

    If you are configuring a Non-App Store based installation for a Moveworks sandbox, EU, GovCloud, AU, or CAC based installation you should use OAuth2 Client Credentials Grant.

    Credential Details with OAuth2 Client Credentials Grant authentication type selected

Step 2: Create MS Graph Connector

Similarly, add an MS Graph connector named msgraph. This connector handles identity/user data ingestion from your Microsoft / Entra tenant.

Step 3: Add MS Graph Connector to Identity Configuration

Navigate to Core Platform → User Identity → Import Users, click Add Identity Source, and select the msgraph connector as the source. Add the user_id_info.channel_id_info for the msteams connector so Moveworks identity user records carry the Teams Channel ID.

Note: If your Moveworks org was created after May 2026, you will need to navigate to Core Platform → User Identity → Identity Configuration to add ms_graph as a connector leveraged in Identity Ingestion.

Note: MS Graph does not need to be added as the primary source connector.

Step 4: Create Chatbot Config

Navigate to Setup → Manage Chatbots → Chatbots, click Add New Chatbot, configure it for the Teams tenant, and select the msteams connector created in Step 1. Note the integration_id for use in later steps.

Navigate to Chat Platforms > Manage Chatbots and configure your Chatbot with the following settings. Be sure to replace:

  1. Bot Name
  2. Bot Friendly Name
  3. Microsoft Teams Tenant ID

Chatbot configuration page with Bot Name, Bot Friendly Name, and Microsoft Teams Tenant ID fields

NOTE: For a Microsoft Teams App Store Installation, all other configurations should match the screenshot above exactly.

If you are configuring a Non-Appstore based Installation, be sure to update the Microsoft Teams App Id, and Microsoft Teams App GUID accordingly.

Step 5: Validate User Identity

Once 4 hours have passed, and Moveworks User Import has ran successfuly, navigate to Setup → User Identity → View Users and search for test users. Verify that expected users have a valid channel_id for the msteams integration and that the integration_id appears in user records.

Step 6: Configure Notification Routes

Navigate to Setup → AI Assistant → Notification Routes and confirm msteams is set as the bot channel for outbound notifications.