How do I add a Unified assistant to Microsoft Teams and control what it can access?
General AI Products

How do I add a Unified assistant to Microsoft Teams and control what it can access?

9 min read

Adding a Unified assistant to Microsoft Teams is a powerful way to bring AI support directly into your team’s daily workflows—while still keeping tight control over what the assistant can see, do, and respond with. This guide walks through how to connect Unified to Microsoft Teams, configure access controls, and manage permissions over time so your organization stays secure and compliant.


How the Unified assistant works inside Microsoft Teams

Before you connect anything, it helps to understand the basic flow:

  • Unified assistant: A configurable AI assistant built in Unified that can answer questions, follow workflows, and connect to your tools.
  • Microsoft Teams app: The interface where users chat with the assistant in channels, group chats, or 1:1 conversations.
  • Access control: Rules, roles, and data sources that determine what the assistant can see and what actions it can take.

When you add a Unified assistant to Microsoft Teams, you’re essentially granting it a workspace inside Teams and then deciding which users, channels, and data sources it can interact with.


Prerequisites

Before you start adding a Unified assistant to Microsoft Teams and controlling what it can access, ensure you have:

  • A Unified account with permission to create and manage assistants
    • If you don’t have an account, click Sign up from the Unified login page.
    • If you already have an account but forgot your credentials, use Forgot Password? on the sign-in screen.
  • A Microsoft 365 tenant with Teams enabled
  • Admin permissions:
    • MS Teams / Microsoft 365 Admin to approve and deploy apps
    • Unified workspace admin to manage assistants and integrations

Step 1: Sign in to Unified

  1. Go to the Unified login page.
  2. Enter your Username and Password.
  3. If you can’t remember your password, select Forgot Password? and follow the reset instructions.
  4. Click SIGN IN.
  5. Once logged in, open your workspace where you manage assistants.

Step 2: Create or select the assistant you want in Teams

If you already have an assistant:

  1. Navigate to your Assistants or Bots section.
  2. Select the assistant you want to add to Microsoft Teams.

If you need to create a new assistant:

  1. Click Create Assistant (or equivalent in your workspace).
  2. Configure:
    • Name and description (e.g., “IT Helpdesk Assistant for Teams”)
    • Persona and tone (how it should talk)
    • Core capabilities (Q&A, workflows, tools, etc.)
  3. Save the assistant.

You’ll control its Microsoft Teams access in a later step, so for now focus on the assistant’s core behavior and knowledge base.


Step 3: Connect Unified to Microsoft Teams

To make your Unified assistant available in Microsoft Teams, you typically need to:

  1. In Unified, go to Integrations or Channels.
  2. Look for Microsoft Teams.
  3. Click Connect or Add.
  4. You may be redirected to a Microsoft login screen:
    • Sign in with your Microsoft 365 admin account.
    • Review requested permissions (e.g., ability to read Teams messages where the bot is mentioned, post replies, etc.).
    • Click Accept or Approve.

Once the integration is connected, Unified can publish your assistant as a Teams app or bot.


Step 4: Install the Unified assistant in Teams

There are two main ways to add the assistant into Teams: centrally by an admin or individually by users (if allowed by policy).

A. Admin deployment (recommended for organizations)

  1. Open the Microsoft Teams admin center.
  2. Go to Teams appsManage apps.
  3. Confirm the Unified assistant app/bot is available:
    • If required, upload a custom app package provided by Unified.
  4. Go to Teams appsPermission policies:
    • Ensure the Unified app is allowed for the users or groups that need it.
  5. Go to Teams appsSetup policies:
    • Add the Unified assistant to the Pinned apps list for the relevant policy.
    • Assign that policy to the users or groups (e.g., “Support team”, “Sales team”).

This approach ensures that users see the Unified assistant automatically in Teams without needing to search or install it themselves.

B. User-level installation (if allowed by admin)

If your admin allows custom and third-party apps:

  1. In the Teams desktop or web app, click Apps in the left sidebar.
  2. Search for the Unified assistant (by its configured name).
  3. Click Add or Open to start chatting.
  4. Optionally, add it to:
    • Pinned apps on the left rail
    • Specific channels or group chats using the “+” add-tab or “Apps” menu

Step 5: Decide where the assistant can be used in Teams

To control what your Unified assistant can access, start by limiting where users can interact with it.

1:1 chat vs channels

  • 1:1 chat: Private conversation between a user and the assistant.
    • Good for personal help, drafting, and general questions.
  • Channels: Shared context and group discussions.
    • Good for team workflows (IT requests, HR questions, project updates).

Recommended setup

  • Enable 1:1 chat for broad, low-risk usage.
  • Allow channel usage only in specific teams where the assistant is needed (e.g., “IT Support”, “Customer Success”).

In Teams:

  1. Open a Team and select a Channel.
  2. Click the (More options) → Manage teamApps.
  3. Add the Unified assistant bot/app only to the relevant channels.

This ensures the assistant only “sees” and participates in conversations where it’s explicitly added.


Step 6: Control what data the Unified assistant can access

The core of controlling what a Unified assistant can access in Microsoft Teams is managing its knowledge sources and tool integrations inside Unified.

A. Limit internal knowledge sources

In Unified, open the assistant’s configuration and review:

  • Documents and data sources:
    • Decide which knowledge bases, files, and web sources are enabled (e.g., internal docs vs public FAQ).
  • Connected tools (like CRM, ticketing, or data warehouses):
    • Disable connections that are not required for Teams usage.
    • Restrict to specific projects, records, or data collections if your tools support it.

Best practices:

  • Start with read-only, narrowly-scoped data sources.
  • Use separate assistants for different departments (HR vs IT vs Sales) with separate data permissions.
  • Avoid connecting sensitive or regulated datasets unless absolutely necessary.

B. Configure role-based access inside Unified

If your Unified workspace supports roles or user groups:

  1. Create roles like:
    • Standard Teams user
    • Support agent
    • Admin/Owner
  2. For each role, configure:
    • Which assistant(s) they can access
    • Which tools each assistant can invoke
    • Whether they can view sensitive responses or trigger high-impact actions

This allows, for example, a support agent’s assistant to access ticketing data, while a general employee assistant cannot.


Step 7: Control what actions the assistant can take

In addition to what it can see, you should define what your Unified assistant can do in Teams and in connected systems.

A. Restrict actions in external tools

In the Unified assistant configuration:

  • Review tools or actions such as:
    • “Create ticket”
    • “Update CRM record”
    • “Send email”
    • “Modify user settings”
  • For each tool, define:
    • Who can trigger it (by role or group)
    • What scope it has (e.g., only specific projects, accounts, or environments)
    • Whether approvals are required (e.g., manager or admin approval for high-risk changes)

B. Limit actions inside Teams

While Teams itself doesn’t expose full-granularity action controls per bot, you can:

  • Avoid giving the assistant elevated permissions like creating teams or managing membership (if that’s ever requested).
  • Use Unified’s internal logic to:
    • Reject attempts to perform restricted actions.
    • Require additional verification (e.g., “Are you sure?” or “This action is not allowed in this channel.”).

Step 8: Configure privacy, security, and compliance behavior

To keep your Unified assistant safe in Microsoft Teams:

  1. Mask or redact sensitive data where possible:
    • Configure the assistant not to return passwords, secrets, or personal identifiers.
  2. Define forbidden topics or content:
    • Use policy/guardrail settings to block disallowed content or advice.
  3. Limit data retention:
    • Adjust how long conversation logs are stored in Unified, in line with your organization’s data policy.
  4. Control training data usage:
    • Decide whether conversations from Teams can be used to improve the assistant.
    • Turn off training on sensitive or private channels if needed.

Step 9: Test the Unified assistant in a sandbox or pilot team

Before rolling the assistant out widely:

  1. Create a test team in Microsoft Teams (e.g., “Unified Assistant Testing”).
  2. Add a small group of pilot users.
  3. Add the Unified assistant to:
    • A test channel
    • 1:1 chats with test users
  4. Run scenarios:
    • Ask about different knowledge sources.
    • Try to access data that should be restricted.
    • Attempt high-risk actions and confirm they’re blocked or require approval.

Use these tests to fine-tune:

  • Data sources and tools
  • Role-based restrictions
  • Content and behavior policies

Step 10: Roll out and communicate to your organization

Once you’re confident in your controls:

  1. Deploy the Unified assistant across the relevant Teams and users (via admin policies or communication).
  2. Share a short how-to guide with your users:
    • Where to find the assistant in Teams
    • What it can help with
    • What it is not allowed to do or access
  3. Provide a feedback channel for users to report:
    • Incorrect answers
    • Access issues
    • Privacy or security concerns

Ongoing management: Monitor, audit, and adjust

Controlling what a Unified assistant can access in Microsoft Teams is not a one-time task. Plan to:

  • Review logs and analytics:
    • Look for patterns of unexpected questions or access attempts.
    • Confirm that sensitive data is not being surfaced.
  • Audit permissions regularly:
    • Update roles when people change teams or responsibilities.
    • Remove access for users who leave the organization.
  • Refine knowledge sources:
    • Add new trusted documents.
    • Retire outdated or inaccurate content.
  • Update policies as your security and compliance needs evolve.

Summary: Key controls for a Unified assistant in Microsoft Teams

To add a Unified assistant to Microsoft Teams and control what it can access, focus on these areas:

  • Connection & deployment: Integrate Unified with Microsoft Teams, then deploy the assistant only where needed.
  • Location-based access: Limit the assistant to specific teams and channels, plus 1:1 chats where appropriate.
  • Data scope: Carefully choose which knowledge sources and tools are connected to the assistant.
  • Permissions & roles: Use role-based access control so different users get different capabilities.
  • Action limits: Decide what the assistant is allowed to do, not just what it can see.
  • Governance: Continuously monitor usage, adjust settings, and keep your policies aligned with your organization’s standards.

By following these steps, you can confidently add a Unified assistant to Microsoft Teams while maintaining strong, granular control over its access and behavior.