Microsoft Teams
Monitor Teams messages and mentions. Get notified when someone needs your attention — reply directly from the notification card without opening Teams.
Quick Setup
- In Phyllax → Settings → scroll to Microsoft OAuth
- Enter your Client ID, Client Secret, and Tenant ID from your Azure app registration
- Go to Integrations → Microsoft Teams → Connect
- A browser window opens — sign in with your Microsoft account and grant permissions
- Once authorized, you're connected
Azure App Registration
If you don't have an Azure app yet:
- Go to portal.azure.com → Azure Active Directory → App registrations → New registration
- Name it "Phyllax", set redirect URI to
http://localhost:4389/oauth/callback - Under API permissions, add
Chat.Read,Chat.ReadWrite,ChannelMessage.Read.All,ChannelMessage.Send,Team.ReadBasic.All,User.Read - Under Certificates & secrets, create a new client secret
- Copy the Application (client) ID, Directory (tenant) ID, and client secret value
Required Credentials
| Field | Where to find it |
|---|---|
| Client ID | Azure Portal → App registrations → Your app → Application (client) ID |
| Client Secret | Azure Portal → App registrations → Your app → Certificates & secrets |
| Tenant ID | Azure Portal → App registrations → Your app → Directory (tenant) ID |
What Phyllax Monitors
| Schedule | What it checks |
|---|---|
| Missed messages | Unread messages or mentions you missed — includes channel name and sender |
| Direct messages | Unread direct messages with sender name and summary |
Notification Actions
When Teams finds something important, the notification card shows:
- Send — reply directly without opening Teams (sends via bot)
- Reply via AI — open AI chat to draft a longer response
- Suggested replies — AI-generated tone options (Professional, Friendly, etc.)
Troubleshooting
"Insufficient privileges" error
Your Azure app needs Teams-specific permissions. Add Chat.Read, Chat.ReadWrite, ChannelMessage.Read.All, and Team.ReadBasic.All in Azure Portal → API permissions, then click Grant admin consent.
Can't send messages
Add the ChannelMessage.Send and Chat.ReadWrite permissions to your Azure app. Admin consent may be required for organization-level permissions.
Messages from private channels not showing
The app needs admin consent for ChannelMessage.Read.All to access messages in private channels. Ask your IT admin to grant this permission in the Azure Portal.