✨ Software.com is now Antenna. Read more →
Skip to Content
IntegrationsAIMicrosoft 365 Copilot

Microsoft 365 Copilot

Connect your Microsoft 365 tenant to Antenna to analyze Microsoft 365 Copilot adoption, usage, and seats across your organization, alongside your other AI tools.

A Microsoft Entra administrator grants tenant-wide admin consent to Antenna’s Microsoft Entra application, and Antenna reads your data on a recurring schedule from then on. No credentials are created, entered, or stored.

This one connection covers Microsoft 365 Copilot, Copilot Studio, and Power Platform (Power Apps and Power Automate). There’s no separate source to add for Copilot Studio or Power Platform. Their activity is reported under Low-Code Tools.

Prerequisites

Before you begin, ensure you have the following:

  • A Microsoft Entra administrator account — Global Administrator or Privileged Role Administrator. Only these roles can grant tenant-wide admin consent.
  • Auditing turned on in Microsoft Purview . It’s on by default for most tenants. If Purview shows a Start recording user and admin activity banner, click it.
  • For Copilot Studio and Power Platform, auditing turned on in each environment. In the Power Platform admin center , go to Manage > Environments, select the environment, then Settings > Audit and logs > Audit settings. Repeat for each environment that hosts agents, apps, or flows you want to report on.
  • An Antenna Admin role in the enterprise you’re connecting.

How data is collected

Antenna combines three Microsoft sources:

SourceWhat it provides
Copilot usage report  (Microsoft Graph)Per-user active days, prompt counts, and the last activity date in each Microsoft 365 app, for users who hold a Copilot license.
Microsoft Purview audit log  (Office 365 Management Activity API)One record per Copilot interaction, for licensed and unlicensed users, including which app or agent was used. It also covers Copilot Studio and Power Platform.
Subscribed SKUs  (Microsoft Graph)Purchased and assigned Microsoft 365 Copilot seats, read once a day.

Because the audit log covers every Copilot interaction, Antenna also reports free Copilot Chat use by people without a Copilot license. Microsoft marks these interactions with a Starter license type, and Antenna shows these users as Unlicensed.

Setup

Show user names in reports

Microsoft 365 conceals user names in usage reports by default. While names are concealed, the usage report identifies each user by an opaque ID instead of a user principal name, so Copilot users appear in Antenna as hashed IDs that can’t be matched to people, teams, or managers.

To show names, a Microsoft 365 administrator:

  1. Opens Settings > Org settings > Reports in the Microsoft 365 admin center.
  2. Clears Display concealed user, group, and site names in all reports.
  3. Saves the change.

Names appear once Microsoft rebuilds the report, usually within about 48 hours. Rows Antenna has already collected stay hashed. While Microsoft rebuilds the report, it can briefly return an empty report. Antenna skips empty reports, so licensed users are not removed in the meantime.

There is no API that works around this setting, and it applies tenant-wide to all Microsoft 365 usage reports, not only Copilot. While names are concealed, Antenna also stores audit log users as hashed IDs so concealed names stay concealed. Those users still count toward organization-wide totals and seats, but not toward per-person, team, manager, or VP views.

Connect in Antenna

  1. Navigate to Settings > Sources > Add source in your app.antenna.dev  account.
  2. Click Connect next to Microsoft 365 Copilot.
  3. Review the permissions listed, then click Grant Admin Consent. Antenna redirects you to Microsoft.
  4. Sign in as a Microsoft Entra administrator and accept the consent prompt. Microsoft returns you to Antenna, and the source is connected.

Antenna requests five read-only application permissions:

PermissionAPIWhy it’s needed
Reports.Read.AllMicrosoft GraphReads the Microsoft 365 Copilot usage report. Required.
ReportSettings.Read.AllMicrosoft GraphChecks whether user names are concealed, so concealed names stay concealed and Antenna can tell you when usage can’t be attributed to people.
LicenseAssignment.Read.AllMicrosoft GraphReads purchased and assigned Copilot seats. Optional: without it, seat counts use the licensed users in the usage report.
ActivityFeed.ReadOffice 365 Management APIsReads the Microsoft Purview audit log for Copilot, Copilot Studio, and Power Platform activity.
AuditLogsQuery.Read.AllMicrosoft GraphSearches the Microsoft Purview audit log for activity from before you connect. Tenant-wide and read-only. Antenna only queries Copilot, Copilot Studio, and Power Platform records.

If you sign in with a non-administrator account, Microsoft shows Need admin approval and does not return you to Antenna. Choose Sign in with that account there to continue with an administrator account.

What the audit log permissions can read

ActivityFeed.Read and AuditLogsQuery.Read.All are tenant-wide: both can read audit records from every Microsoft 365 service, not just Copilot and Power Platform. Microsoft offers narrower audit permissions only for Exchange, SharePoint, OneDrive, Entra, Endpoint, and Dynamics 365, and none of them covers Copilot or Power Platform. Antenna limits what it reads in its own requests: it subscribes only to the general audit feed and queries only Copilot, Copilot Studio, Power Apps, and Power Automate records.

Audit records describe activity, not content:

What’s in a recordExamples
WhoUser principal name and user type
What and whenOperation, timestamp, and result
WhereApp, agent, environment, client IP address, and user agent
ResourcesFile names and site URLs. Copilot records list the files, emails, and sites Copilot used to answer.

Is any of it sensitive? Records don’t include file contents or email bodies, and Copilot records don’t include prompt or response text, only message IDs. User names, IP addresses, and file and site names can still be sensitive, so Antenna drops what it doesn’t need before storing anything:

  • Kept: operation, timestamp, app, agent, environment, model, user agent, and prompt and response counts.
  • Dropped: client IP addresses, accessed resources, and message text.
  • Used for matching only: user principal names match activity to people in Antenna and aren’t stored in the data warehouse.

Timing and history

  • Usage report: Microsoft publishes it as a rolling 7-day snapshot, refreshed about once a day with a lag of roughly 48 hours. Antenna stores each snapshot as a point-in-time reading and never adds overlapping snapshots together.
  • Audit log: Antenna reads up to 180 days of history when you connect, or as far back as your tenant keeps audit records, and then stays current. Microsoft keeps audit records for 180 days on Audit (Standard), and longer with Audit (Premium). Microsoft can take up to 12 hours to deliver the first audit data for a new connection.
  • Audit sync starts after the name check. Antenna reads the audit log only after it has confirmed whether your tenant conceals names, so concealed names are never stored.
  • Seat counts: read once a day.

Connection status

Open the source from Settings > Sources to see the status of the audit log and seat counts.

StatusWhat it meansWhat to do
Collecting Microsoft Purview audit recordsAudit sync is running.Nothing. If no content has arrived yet, Microsoft can take up to 12 hours to deliver it.
Waiting for the first audit syncAntenna hasn’t read the audit log yet.Make sure ActivityFeed.Read is granted.
Antenna can’t read the audit logActivityFeed.Read isn’t granted.Reconnect the source as a Microsoft Entra administrator to grant consent again. Usage reports keep syncing in the meantime.
Audit records couldn’t be readMicrosoft returned an error, shown on the card.If the error says auditing is off, turn it on in Microsoft Purview .
Audit sync starts after Antenna reads whether your tenant hides user namesAntenna can’t read the name-concealment setting yet.Grant ReportSettings.Read.All by reconnecting the source.
Antenna can’t read purchased Copilot licensesLicenseAssignment.Read.All isn’t granted.Reconnect the source to grant it. Until then, seat counts use the licensed users in the usage report.

Revoking access

Deleting the source in Antenna stops all data collection. Because the consent was granted in your own tenant, revoking the consent itself is done in Microsoft Entra: go to Enterprise applications, select the Antenna application, and delete it.

Data collected

From the v2 Copilot usage report:

MetricDescription
Active usage daysDays in the period on which the user used Copilot.
Total promptsPrompts the user sent across all Copilot experiences.
Copilot Chat promptsPrompts sent in Copilot Chat, split into work and web.
Last activity dateThe user’s most recent Copilot activity, overall and per Microsoft 365 app.

From the audit log:

DataDescription
InteractionsOne record per Copilot interaction, with its time, for licensed and free Copilot Chat users.
Copilot surfaceThe Microsoft 365 app the interaction happened in, such as Teams, Word, Outlook, or Copilot Chat.
AgentThe agent the user chatted with, if any, by name and ID.
License typeWhether the interaction used a Copilot license or free Copilot Chat.

From subscribed SKUs: purchased and assigned Microsoft 365 Copilot seats.

Antenna does not collect prompts, responses, documents, or any content of user interactions.

Cost

Microsoft does not expose your negotiated Copilot seat price through any API, so cost cannot be fetched automatically. To report spend and cost per active user, set a seat price in Antenna: go to AI Budgets > Configure Budgets and set Avg seat cost for Microsoft 365 Copilot in Tool Defaults. The seat price applies to licensed users only. Free Copilot Chat use carries no cost.

What’s not included

  • Audit activity older than your tenant’s audit retention. Microsoft deletes audit records after the retention period, which is 180 days on Audit (Standard). Activity from before auditing was turned on isn’t available either.
  • Power BI and Microsoft Fabric Copilot. Reported separately by Microsoft and billed against Fabric capacity, not Copilot seats.
  • Copilot Studio chats by users without a Microsoft 365 license. Microsoft only logs Copilot Studio interactions for users with a Microsoft 365 license.
  • Copilot Credits. Copilot Studio usage is billed in Copilot Credits, which Antenna does not read. See Copilot Studio.

Privacy and security

  • Access is read-only. None of the permissions Antenna requests can modify anything in your tenant.
  • Antenna reads usage metadata only — counts, dates, identifiers, app and agent names, and the client user agent. Message text, accessed resources, and client IP addresses in audit records are dropped before anything is stored.
  • User principal names and display names are used to match usage to people in Antenna and are not stored in the data warehouse. Analytics are keyed to the contributor record instead.
  • Reporting is designed for group-level rollups — team, manager, and executive views are built from your existing identity and hierarchy data in Antenna, not from Microsoft Graph. Antenna does not request directory read permissions.

Resources

Last updated on