{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","partial"]},"type":"markdown"},"seo":{"title":"Microsoft 365 Copilot Chat Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Microsoft 365 Copilot uses OAuth 2.0 client credentials via the Microsoft Graph API. You will need to register an Azure application, generate a client secret, and grant the required Application permissions with admin consent."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"License Prerequisite"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The underlying ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/api/ai-services/interaction-export/aiinteractionhistory-getallenterpriseinteractions?view=graph-rest-1.0&pivots=graph-v1"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["getAllEnterpriseInteractions"]}]}," API requires a valid Microsoft 365 Copilot license with the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Microsoft Copilot with Graph-grounded chat"]}," service plan. Without this license, calls will fail regardless of how the app registration is configured."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-register-an-azure-application","__idx":0},"children":["1. Register an Azure Application"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://portal.azure.com"},"children":["Azure portal"]},", search for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App registrations"]}," and select it. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ New registration"]}," -> enter a name -> select the appropriate supported account types -> leave ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URI"]}," blank -> click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," page, copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application (client) ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]}," to a safe location."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-create-a-client-secret","__idx":1},"children":["2. Create a Client Secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates & secrets"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ New client secret"]},". Enter a description, choose an expiration period, and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy the secret ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}," immediately — it will not be shown again."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3-add-api-permissions","__idx":2},"children":["3. Add API Permissions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the app registration, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API permissions"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add a permission"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Microsoft Graph"]}," -> ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application permissions"]},". Add each of the following:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AiEnterpriseInteraction.Read.All"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read enterprise Copilot interaction history for users in the tenant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["User.Read.All"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List users in the tenant and resolve interaction owners."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All permissions must be ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application"]}," type, not ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Delegated"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once added, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Grant admin consent for [your tenant]"]}," and confirm. This requires a Global Administrator or Privileged Role Administrator and is a one-time action."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"4-configure-the-integration","__idx":3},"children":["4. Configure the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Tenant ID"]},": The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Directory (tenant) ID"]}," from step 1."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},": The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application (client) ID"]}," from step 1."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},": The secret ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Value"]}," from step 2."]}]},"headings":[{"value":"1. Register an Azure Application","id":"1-register-an-azure-application","depth":2},{"value":"2. Create a Client Secret","id":"2-create-a-client-secret","depth":2},{"value":"3. Add API Permissions","id":"3-add-api-permissions","depth":2},{"value":"4. Configure the Integration","id":"4-configure-the-integration","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/microsoft-copilot-chat-setup","seo":{"title":"Microsoft 365 Copilot Chat Provider Configuration Guide"}},"lastModified":"2026-05-18T22:20:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/microsoft-copilot-chat-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}