About Pexip's Microsoft Teams CVI integration

Pexip's Cloud Video Interoperability (CVI) Service enables professional SIP and H.323 video conferencing systems to join Microsoft Teams as if they were native Microsoft clients.

  • Pexip natively integrates with the Microsoft Teams workflow — scheduling meetings from Teams or Outlook automatically inserts video conferencing dial-in details.
  • When joining a Teams meeting from a third-party endpoint, everyone benefits from the full Teams experience with HD video, audio, and content sharing.
  • You can also order an add-on package that provides Full HD (1080p) video and content.
  • If you have Microsoft Teams Room devices with Pro licensing you can make and receive 1:1 (also referred to as point-to-point) SIP/H.323 video calls with VTCs.
  • You can also join Microsoft Teams meetings where that meeting is being hosted by an external third-party organization (even if the host’s organization has not enabled Pexip interoperability themselves) — this is referred to as "SIP Guest Join".

This article covers:

Domain hosting and dial strings / Virtual Reception (IVR)

Domain hosting, or a custom *.onpexip.com subdomain, is mandatory for the Teams gateway service to be set up. (This is how the Pexip Service distinguishes between each customer's Teams gateway service on the multitenant Cloud Service.)

For example, if customdomain.com is the video domain chosen, the Microsoft Teams Virtual Receptionist for 2-stage dialing is at teams@customdomain.com and direct dialing into the Teams meeting is via <ConferenceID>@customdomain.com.

If you also have Google Meet integration you must use a different domain for your Teams CVI integration.

Note that the Pexip apps cannot join meetings via the Virtual Reception (but they can be used to call directly into the meeting).

Trusted devices for lobby bypass

Soft clients and video endpoints can be considered "trusted parties" and can enter a Teams meeting without the need for a meeting manager to manually admit/deny entry through the Teams lobby if:

  • They are registered on the Pexip Service under the same company as the CVI Service for MS Teams, or
  • They are configured as Trusted Devices on the Pexip Service.

One company, multiple Teams tenants

The Pexip Service also supports multiple Teams tenants under one company. This means that...

  • all registered VTCs (with Pexip's Endpoint subscription), or
  • any VTCs that are not registered, but supported by the Trusted Devices feature

...under one company can bypass the lobby into multiple Teams tenants. Each Teams tenant must be set up according to the instructions described here.

Note that all tenants require separate domains, i.e. one Teams tenant per single custom domain.

Join workflow, layouts and notifications for Teams meetings

Participants using a Teams client join a Teams meeting as usual, and any gatewayed third-party participants can be seen and heard in the same way as any other directly-connected Teams clients in that meeting.

Authenticated, trusted VTCs that are located within the organization can join the conference directly, without any additional user interaction, whereas unauthenticated, untrusted external VTCs are admitted via the Teams lobby.


The Teams-like layout is the default layout for VTCs connecting to Teams meetings for all new ERC Premium customers.

However, you can choose to use any one of the following layouts as your default layout:

  • Teams-like (similar to the meeting experience seen by native Teams clients — see below)
  • 1+7 (1 large main speaker and up to 7 other participants)
  • 1+0 (full-screen main speaker only)
  • Equal 2x2 (4 speakers)
  • Equal 3x3 (9 speakers)

Dynamic meeting controls

Also see Using endpoints to control the layout and manage meetings for information about dynamically changing the layout during a meeting.

Note that:

  • Teams-like and the 1+0 layout are not included in the dynamic layout cycling feature, even if it is configured as the initial/default layout.
  • Teams-like is not available in the Meeting Controls macro as a layout option, even if it is configured as the initial/default layout.

In addition to cycling through Pexip's layouts you can also switch to Microsoft's Large Gallery view.

Teams-like layout

Pexip offers a Teams-like layout for VTC systems that looks and operates in a similar manner to the meeting experience seen by native Teams clients. In this layout, spotlighting, use of avatars for audio-only participants, active speaker indication and raised hand indicators all have a similar look and feel to the native Teams layout.

The Teams-like layout also supports multiscreen participant display, and receiving the presentation stream as part of the layout mix.

A comparison of the user experience between the 1+7 layout and the Teams-like layout is shown below.

CVI meeting with the 1+7 layout

CVI meeting with the Teams-like layout

Teams-like with two video participants

Teams-like with spotlighting and raised hand

Teams-like with presentation

Teams-like with dual screen

Teams-like with dual screen and presentation

Example notifications with the Teams-like layout

Guests waiting in the lobby notification

Lobby empty notification

Microsoft's Large Gallery view

Host VTC participants can toggle between their current layout and Microsoft's Large Gallery view by entering *3 via their keypad. Note that:

  • There can sometimes be a short delay before the Large Gallery view takes effect.
  • While in Large Gallery view, using *8 to cycle layouts has no visible effect but you will see the effect if you toggle back out of Large Gallery view.

Additional information on other layouts

Here's a demonstration video showing some of the layouts in use:

Please contact your account manager at your local certified Pexip Partner if you would like to request a different default layout.

1+7 layout

1+0 layout: full-screen main video

Equal 2x2

Equal 3x3

Admitting guest participants from the lobby

When an untrusted guest enters the MS Teams lobby, VTC users hear the usual Teams lobby notification and see an onscreen message with an indication of how many guests are waiting in the lobby. They can then go to the Teams client and admit the waiting guests. If only some guests are admitted, the endpoint's display refreshes the count of waiting users.

If all guests are admitted, the endpoint's display briefly shows a confirmation message.

Mute/unmute control and status for VTCs

An indicator is displayed to an individual participant as a conference overlay when the endpoint has been administratively muted from the Teams conference.

The VTC can unmute itself by sending a DTMF command (*6) to the conference.

Raised hand indicators

A notification is shown to any VTC participants if a Teams participant raises their hand.

Recording or transcribing notifications

If a Microsoft Teams conference is recorded or transcribed, relevant audio prompts indicating that recording/transcription has been started/stopped are played to VTC participants, and recording or transcribing indicators are included in the video stream sent to those VTC participants.

Localization of welcome screens and audio messages

Pexip can enable some localized welcome screens and audio messages for CVI participants joining a Teams conference, for example:

English and French Canadian dual language Virtual Reception screen

Latin American Spanish welcome screen

The following language options are available:

  • English and French Canadian dual language
  • French
  • Japanese
  • Spanish (Castilian)
  • Spanish (Latin American)

To request a localized override please contact your account manager at your local certified Pexip Partner.

Note that you cannot currently combine localized screens with any other customized branding.

Integration features (including content sharing, display names and audio participants)

When using Pexip's integration with Teams:

  • Bi-directional content sharing is supported between VTCs and Teams clients via VbSS:

    • A Teams client can only share its screen or a window with a VTC system. However, VTC endpoints do see a splash screen if a Teams client starts PowerPoint Live sharing, or uses any other non-supported content share sources, such as Excel or Whiteboard:

    • If a VTC starts sharing content while it is held in the Teams lobby, when the VTC is admitted to the meeting the presentation will not be visible to the other participants in the meeting. The VTC participant would need to restart content sharing after being admitted into the meeting.
  • A CVI participant's ability to share content in a Teams meeting depends on their role (Presenter or Attendee) in the meeting, and the "Who can present" setting in the meeting options:

    • A trusted CVI participant is always given a Presenter role in the Teams meeting (and thus can present). However, you can subsequently change that specific participant's role if required.
    • An untrusted CVI participant joins the meeting with the Presenter role only if the "Who can present" meeting setting is Everyone, otherwise it joins as an Attendee and cannot present.
    • If a CVI participant is an Attendee and attempts to share content from their endpoint, the sharing request is denied and the attendee is informed via a message on their endpoint such as "Sharing failed" (the exact message depends on the endpoint, and some endpoints may not display a message at all).
  • If the Teams meeting is watermarked then any CVI participants join as audio-only i.e. they cannot contribute or consume video or presentation. Pexip intends to support watermarked meetings by the end of 2024.
  • Pexip provides the participant's display name if it is provided by the participant's device. This is independent of whether the device is trusted or not. If a display name is not provided, Pexip uses the device's SIP URI. Note that many devices use the system name as its display name. However, some older systems might choose, for example, to only provide the first part of the SIP URI (the part before the '@') as the display name.
  • If a participant in a Teams meeting is spotlighted by a Teams client, that participant is also spotlighted in the layout presented to any gatewayed VTC system.
  • VTC endpoints that are gatewayed into a Teams meeting may sometimes be asked to send lower quality video (such as 180p). In these scenarios, even though the Pexip Service can support higher resolutions (and offers the higher resolutions to Teams), the video resolution requested by Teams can be lower — hence the Pexip Service sends the video format that Teams has requested. This is an operational behavior aspect of Teams and is beyond the control of Pexip software.
  • H.323 calls are limited to a maximum resolution of 720p.
  • Teams users who are logged in and have joined via audio-only are represented by an avatar (supplied by Exchange Online) within the VTC's conference layout. If no avatar is available, or it is a guest user from another organization, a substitute graphic is generated based on the participant’s initials.

  • Teams users joining with PSTN audio (callback and manual dial-in):

    • If a Teams user chooses to get a callback from the meeting to their PSTN device (instead of using computer audio) the user appears in the Pexip layout as a video participant and also as an audio-only participant with the avatar of that user. However, the video participant does not get voice-switched into main view when they speak.
    • If a Teams user selects "manual dial-in" they appear in the Pexip layout as an audio-only participant without that user's avatar as that audio participant has no association with the Teams user (and is also separate from any video connection).

More information

For more information on setting up your integration, see:

For more information about joining Microsoft Teams meetings, see: