Set up the Ringback bot for Direct Routing

This article describes the Ringback bot, which you can use to help avoid unexpected silences that can occur when it takes a longer time for calls to be established. The Ringback bot is available for Direct Routing in non-media bypass mode.

Sometimes inbound calls from the public switched telephone network (PSTN) to Teams clients can take longer than expected to be established. This can occur for various reasons. When this happens, the caller might not hear anything, the Teams client doesn't ring, and the call might be canceled by some telecommunications providers.

The Ringback bot helps to avoid unexpected silences that can occur in this scenario. For inbound calls from the PSTN to Teams clients, the Ringback bot plays a distinctive audio signal to the caller to indicate that Teams is in the process of establishing the call.

Note

The Ringback bot generates early media from the Teams backend. In some countries and regions, you might be charged for the call when the media starts flowing.

Configure the Ringback bot

Use the Set-CsOnlinePSTNGateway and New-CsOnlinePSTNGateway cmdlets together with the GenerateRingingWhileLocatingUser parameter to configure the Ringback bot.

To turn on the Ringback bot, set the GenerateRingingWhileLocatingUser parameter to $True. This is the default value.

To turn off the Ringback bot, set the GenerateRingingWhileLocatingUser parameter to $False.