Microsoft Teams Integration
Connect Microsoft Teams to receive notifications and respond to Q&A questions directly in Teams.
Integration settings are only visible to users with the Admin role. Regular users cannot access or modify integration configuration.
What Microsoft Teams Enables
With Microsoft Teams connected:
- Q&A notifications - when the AI agent has clarifying questions during story analysis, they're delivered as Teams direct messages; you can respond directly in Teams
- Status updates - receive notifications about story progress, PR creation, and other key events
- Channel posts - post to channels of the teams the Zero0 app has been added to
One Platform per Account
Zero0 messages people through one platform: Slack or Microsoft Teams, never both. Choose it in Settings → General, under Messaging Platform. A platform that isn't connected can't be chosen, so connect Microsoft Teams first, then switch to it.
Prerequisites
- A Microsoft 365 work or school tenant. The free consumer version of Teams doesn't work.
- A Global Administrator or Privileged Role Administrator of the tenant to connect it.
- Each person's email in Zero0 must be their Microsoft 365 sign-in address. Zero0 finds people in Teams by that address.
Step 1: Connect and Grant Consent
- Navigate to Settings → Integrations → Teams
- Click Connect Microsoft Teams
- A Microsoft popup opens. Grant Zero0 admin consent for your organization, then sign in to that tenant as a Global Administrator or Privileged Role Administrator
- Keep the popup open: it closes itself when it's done, and the connection status updates
If you're signed in to more than one Microsoft tenant, connect from a private browser window. Otherwise Microsoft can reuse your other session and pick the wrong tenant.
A Microsoft tenant can be connected to one Zero0 account only, and a Zero0 account to one tenant.
Once connected, the card shows your tenant and Proactive app install consent. It should say Granted; right after connecting it can say Checking permissions… for a few seconds first. If it stays Not granted, Zero0 can't message people who haven't added the Zero0 app in Teams: reconnect (Disconnect, then Connect Microsoft Teams) and grant the consent again.
Step 2: Install the App
- Click Download Teams app to download the Zero0 app package (a zip file)
- A Teams admin uploads the zip to your organization's app catalog: Teams admin center → Teams apps → Manage apps → Upload new app. In the Teams client, the same is Apps → Manage your apps → Upload an app → Upload an app to your org's app catalog
Use the org app catalog, not a personal Upload a custom app: Zero0 installs the app for each person automatically only when it is in the org catalog. Upload the package once; a second upload creates a second "Zero0" entry. If you see two, remove the extra one in the Teams admin center.
Your tenant's policy must allow custom app upload. On a new tenant, the Teams admin center can take a while to finish setting up app management before the upload works.
For channel posts, add the app to each team as a separate install: in Teams, open the team → Manage team → Apps, then upload the app or add Zero0 to the team. The "choose a channel" dialog that appears after adding the app doesn't add it to the team; use the team's Apps tab.
Step 3: Send a Test Message
Once connected, the Teams page lists the people in your tenant. Click Send Test next to a person to send them a test message.
Send me a test message sends one to your own Zero0 email, so it only works if that address is a user in the connected tenant.
A person who never added the app still receives the message: Zero0 installs the app for them first, so the first message can take a few seconds. They also receive a welcome message from Zero0.
Troubleshooting
| Message | What to do |
|---|---|
| This Microsoft tenant is connected to another Zero0 account. | A tenant belongs to one Zero0 account. Disconnect it in the other Zero0 account first. |
| This Zero0 account is already connected to another Microsoft tenant. Disconnect it in Zero0 first, then connect again. | Disconnect the current tenant, then connect again. |
| Admin consent was not granted, so Microsoft Teams was not connected. | Connect again and accept the consent screen. If you're signed in to more than one tenant, use a private window. |
| Microsoft did not confirm that you are a Global Administrator or Privileged Role Administrator of this Microsoft tenant, so Microsoft Teams was not connected. | Ask a Global Administrator or Privileged Role Administrator to connect. |
| The Microsoft sign-in popup was blocked. Allow popups for this site and try again. | Allow popups for Zero0 in your browser and click Connect Microsoft Teams again. |
| Failed to send test message: app_not_installed | The app isn't in your org app catalog (see Step 2), or Proactive app install consent isn't Granted (see Step 1). |
| Failed to send test message: User not found: email | That email isn't a user in the connected tenant. Make sure the person's email in Zero0 is their Microsoft 365 sign-in address. |
Removing the App from a Person
If a person removes the Zero0 app in Teams, Zero0 only stops messaging that person; the tenant stays connected. The next message to them installs the app again.
Disconnecting
Click Disconnect and confirm. Disconnecting moves this account's messaging back to Slack. If Slack isn't connected, Zero0 stops messaging people until a messaging platform is connected.