---
title: Microsoft Teams | Lightfield
description: Sync Teams channels to accounts and opportunities for shared record context.
---

Connect a Microsoft Teams channel to an account or opportunity, and its messages appear in the record’s **Activity log**, where the Lightfield agent also uses them to keep summaries current and answer questions.

## Who can use it

Teams sync is on Pro, Growth and Enterprise. If you use Slack too, Starter includes [Slack channel sync](/help/settings/integrations/slack/index.md). That connection imports Slack messages, not Teams history. To get Teams sync, an admin changes your plan in [Billing](/help/settings/billing/index.md). On plans without it, Microsoft Teams doesn’t appear in Settings → Integrations or Settings → External apps.

An owner or admin connects the workspace, then each person connects their own account. Your Microsoft organization may need a Microsoft 365 admin to approve the Lightfield app.

Earlier plans can differ. [Check your workspace’s available features](/help/missing-feature/index.md).

## Connect Teams for your workspace

An owner or admin does this once.

1. Go to [Settings → Integrations](https://crm.lightfield.app/crm/settings/integrations/) and find **Microsoft Teams**.
2. Decide on **Back sync channel history**. It’s on by default, and we recommend leaving it on so a newly linked channel arrives with its history. Off, syncing starts from the moment a channel is linked.
3. Click **Connect** and approve the permissions in Microsoft.
4. Under **Choose a team to sync channels from**, pick the team. Only that team’s channels are available in Lightfield, and none sync until a team is selected.
5. Click **Confirm**.

Microsoft Teams shows as **Connected**, with your team under **Selected team**. Until this is done, nobody can connect their own account.

## Connect your own Teams account

1. Go to [Settings → External apps](https://crm.lightfield.app/crm/settings/external-apps/), find **Microsoft Teams**, and click **Connect**.
2. Approve in Microsoft, signing in with an account in the same Microsoft organization as your workspace.

Teams shows as **Connected**. This tells Lightfield which private channels you’re in, so it shows you only messages you can access.

## Sync a channel to a record

Private-channel messages are visible only to members of that channel and are never used by the agent.

1. Open the account or opportunity.
2. In its **Teams channel** field, click **Connect channel** and pick a channel from the selected team.

Messages, reactions, images and attachments appear in the record’s **Activity log**.

![Teams channel messages in a Lightfield activity log](/_astro/activity-log.D4KshjtV_751IS.webp)

Linked Teams channels work like Slack channels:

- Members match to contacts by email. Change the match in the contact’s **Teams users** field.
- The agent uses public channels for summaries, record updates and answers.
- Only channel members can see private-channel messages, and the agent never uses them.
- Unlinking a channel removes its messages from that record. See [How synced messages are used](/help/settings/integrations/slack/#how-synced-messages-are-used/index.md).

If an edit or deletion happens more than two months after a message was sent, Lightfield may not reflect it.

## Disconnect Teams

- **Disconnect your account:** in Settings → External apps, disconnect Microsoft Teams.
- **Disconnect the workspace:** an admin disconnects it in Settings → Integrations.

## Troubleshooting

### ”Admin consent is required to connect Microsoft Teams.”

Your Microsoft organization requires an administrator to approve the Lightfield app. Ask your Microsoft 365 admin to approve it, or to connect Teams in Lightfield themselves, then try again.

### ”Your workspace admin needs to connect Microsoft Teams before you can connect your account.”

The workspace connection isn’t done yet. Ask a Lightfield admin to [connect Teams for your workspace](#connect-teams-for-your-workspace), then connect your account.

### ”Your Microsoft Teams account is already linked to a contact.”

Your Teams account is set on a contact record. Open that contact, remove your account from its **Teams users** field, then connect again in Settings → External apps.

### ”This Microsoft Teams team is already connected to another workspace.”

Each team syncs to one Lightfield workspace. Disconnect it in the other workspace, or pick a different team.

## Common questions

**How do I change which team Lightfield syncs from?** Reconnect Microsoft Teams. An admin disconnects it in Settings → Integrations, connects again, and picks the new team.

**What happens if I turn off back sync later?** It applies only to channels linked from then on, which start syncing from the moment they’re linked. Messages already synced stay.

**Is Teams context available through the API and MCP?** Yes. Synced Teams messages are available like other CRM data.

**Which plans include Teams sync?** Pro, Growth and Enterprise. On Starter, you can sync Slack channels instead.