Vonage Contact Center and Microsoft Teams integration

If enabled for your account, you can integrate your Vonage Contact Center account with a Microsoft Teams organization. After linking your VCC account with Microsoft Team, agents can link their account in VCC with their Microsoft Teams user. When an agent is linked with a Teams user, their presences in VCC and Team are synchronized. When synchronized other agents can see the Team users' availability in ContactPad's address book. For information about ContactPad's address book, see ContactPad address book.

Teams users and their presences in ContactPad

When the VCC and Microsoft accounts are linked, and an agent is linked with a Teams user, the agent can see and search other Teams users — who have a phone number (direct dial-in (DDI) or dialing (DID)) — in ContactPad. The address book contains Teams users both when making a new outbound call and when starting a consult during an existing call.

Microsoft Teams presence in ContactPad

The icon alongside the Teams user's name reflects their presence.

IconTeams presence


Available Idle


Busy Idle


Do not disturb

Be right back


ContactPad only refreshes Teams users' presences when the agent opens the address book. Therefore, if a user's presence changes, the change does not appear unless the agent closes and reopens the address book.

For information about Teams user's presence, see User presence in Teams (Microsoft help).

Presence mappings

When a VCC agent has linked their account with a Teams user, their presences are synchronized:

  • If the agent's presence changes in VCC, their linked Teams user's presence in Teams is updated.

    When the agent's VCC presence changes, their Microsoft presence is updated right away. The updated presence is visible to other users who may want to interact with the agent. However, there is currently a delay in displaying the updated presence in the linked user's Teams user interface. Microsoft expects this delay to be an average of 10 seconds, but can be up to 1 minute. For more information, see the Latency section in Set up notifications for changes in resource data (Microsoft help). A potential workaround is to click on your agent icon in Microsoft Teams or refresh the Microsoft Teams page.

  • If the Team's user's presence changes in Teams, the agent's presence is updated in VCC.

Default VCC agent to Teams presence mapping

VCC agent stateTeams availability/activity
Extended AwayAway/Away
Not AvailableBusy/Busy
Logged out

Default Teams to VCC agent presence mapping

Teams availabilityVCC agent state
BusyExtended Away/Extended Away
Do not disturbAway/Away
Be right backAway/Away
Presence unknown

Call handling

When a Teams user has an active call or meeting in the Microsoft Teams application and is in either On a call or Presenting state, Microsoft informs VCC that the user is busy. VCC then updates the linked VCC agent's status and creates an interaction in VCC. Microsoft does not inform VCC about the direction (inbound or outbound) of the conversation, therefore the VCC interaction is always recorded as inbound.

Busy inbound interaction representing call or meeting in Teams

When a VCC agent finishes an interaction that they initiated from VCC, they go into a wrap state. VCC does not inform Microsoft Teams that the interaction is finished so the Teams user remains busy until the wrap phase is complete.

VCC wrap phase in ContactPad and Teams

Support and documentation feedback

For general assistance, please contact Customer Support.

For help using this documentation, please send an email to docs_feedback@vonage.com. We're happy to hear from you. Your contribution helps everyone at Vonage! Please include the name of the page in your email.