Connect Microsoft Teams Chat (external customers)

This channel is different from any Teams meetings integration you already use: here you connect 1:1 (or group) chat with external customers via Microsoft Graph, so those conversations show up in the Omnifox Inbox alongside your other channels.

Requirements

• An Azure AD / Microsoft 365 tenant with admin rights
• The "Manage channels" permission in Omnifox

Steps to connect

1. In Omnifox, go to Channels → Connect New Channel and pick Microsoft Teams Chat.
2. Click Connect with Microsoft — you're redirected to Azure AD login (v2.0 endpoint).
3. Sign in with an account that has admin rights in your tenant and accept the requested permissions (Chat.ReadWrite, ChatMessage.Send, User.Read, offline access).
4. Microsoft sends you back to Omnifox; the channel activates automatically.

Configuration

The connection is entirely OAuth — no tokens to paste by hand. Omnifox refreshes the access token automatically (it lasts about an hour) using the refresh token (valid for weeks), and also renews the Graph event subscription before it expires.

Example

An external customer with a Microsoft account messages you in a 1:1 Teams chat asking about a ticket's status. That message arrives in the Omnifox Inbox as a Teams conversation, with no need for the agent to open the Teams app.

Tips

• This channel handles chat messages (ChatMessage), not meetings or calls — those are separate products within Microsoft Graph.
• If your organization uses a restricted ("single tenant") setup, check with your IT admin that Omnifox's app is approved before connecting.

Troubleshooting

• Authorization fails with a permissions error: ask your Microsoft 365 admin to approve tenant-wide consent for the application.
• Messages stop arriving after a while: this can happen if the Graph subscription expired without renewing; reconnect the channel to force a fresh subscription.