Tom Talks Microsoft Teams and Microsoft 365 news and opinions

5 Enhancements coming for Microsoft Teams Direct Routing

Microsoft Just posted a roadmap update with 5 new Direct Routing enhancements due for release in November. Direct Routing is the scenario where you can bring your own SIP Trunk/Carrier/SBC and connect it to Microsoft Teams for User PSTN Telephony.

Media Relay Override –  “Allows customers to change their default Media Relay to match their public IP structure”.

Missed Call Message Suppression – “enables customers to route calls to a 3rd party PBX without generating a false missed call message in Teams”. This is interesting, I would assume it means you can setup a PBX or gateway to simultaneously ring or fork a call to both Teams (via direct routing) and a traditional PBX but not have a missed call notification in teams if you pickup on the PBX or the PBX’s voicemail picks up.

Ringback Bot – “enhances the ringing experience for the caller by have a setup audio ring and a second ring for when the call is established. I have no real idea of what this means, I am trying to find out more.

SIP Tester – a PowerShell script that can test the basic configuration of your SIP deployment in Direct Routing. I’ve had a sneak peek at this, it will be convenient I think.


PSTN Reporting – “brings new reporting capabilities for Direct Routing.”

This is an excellent enhancement for Direct Routing users. You can now get PSTN Call Detail Records (CDR) reports Directly in Microsoft Teams Admin Centre.

Documentation here: Microsoft Teams PSTN usage report

The report can be viewed for trends over the last 7 days, 28 days, or a custom date range that you set. The reports usually reflect a 24 to 48-hour latency from time of activity.


You can also export to excel.


It gives the following fields:

  • CorrelationId – Microsoft ID for the session. Can be used when calling Microsoft Support.
  • SIP Address – SIP address (UPN) of the Teams user who received or made the call.
  • Display Name  – Teams User Display Name
  • User country – Teams User Country
  • Invite time – the time when the call was initiated.
  • Start time – time the call connected.
  • Failure time – time the call failed (only if there was a failure). Worth checking out for the different SIP return codes and final SIP phrase
  • End time – is the time the call ended. (For successful calls only.)
  • Duration (seconds) – length of a call
  • Success – Yes/No field
  • Caller Number – caller PSTN number. Note last 4 digits obscured for privacy.
  • Callee Number – Callee PSTN number. Note last 4 digits obscured for privacy.


  • Call type
    • dr_in – the user received an inbound PSTN call
    • dr_out – the user placed an outbound PSTN call
    • dr_out_user_conf – the user added a PSTN participant to the call
    • user_out_transfer – the user transferred the call to a PSTN number
    • dr_out_user_forwarding – the user forwarded the call to a PSTN number
    • dr_out_user_transfer – the user transferred the call to a PSTN number
    • dr_emergency_out – the user makes an emergency call
    • dr_in_ucap – an inbound PSTN call to a Teams bot such as auto attendant or a call queue
    • dr_out_ucap – an outbound PSTN call from a Teams bot such as auto attendant or a call queue


  • Azure region for Media – Azure region code for media
  • Azure region for Signalling  – Azure region code for signalling
  • Final SIP code – is the SIP code with which the call ended.
  • Final Microsoft subcode – is a code that indicates specific actions that occurred.
    • Again, I am not aware of a resource to decode these codes
  • Final SIP Phrase – is the SIP code with which the call ended.
  • SBC FQDN – fully qualified domain name (FQDN) of the Session Border Controller (SBC).
  • Media bypass- indicates whether the trunk was enabled for media bypass
  • Shared correlation ID – I could not find a good definition of this, but it seems to relate to failed calls with routing errors such as “Getting user info by number from BVD failed”



Roadmap ID 56507

About the author

Tom Arbuthnot

A Microsoft MVP and Microsoft Certified Master, Tom Arbuthnot is Founder and Principal at Empowering.Cloud as well as a Solutions Director at Pure IP.

Tom stays up to date with industry developments and shares news and his opinions on his, UC Today Microsoft Teams Podcast and email list. He is a regular speaker at events around the world.


Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

  • Have you also noticed a few new parameters on OnlinePSTNGateway? Just appeared and some of them not yet documented. I appreciated PAI and History of call forward. Useful for more complex routing…

    InboundTeamsNumberTranslationRules : {}
    InboundPstnNumberTranslationRules : {}
    OutbundTeamsNumberTranslationRules : {}
    OutboundPstnNumberTranslationRules : {}

  • Tom, whilst the report is a nice thing to have in the GUI, is there an accompanying PowerShell command that produces the report as well, do you know?

    • No, no PowerShell or Graph today. Like you, I would really appreciate an API or PowerShell method to extract this data.

      I have asked but will nudge again and see if I get any response.


  • I’m curious about the Ringback Bot as well. We are setup on Direct Routing and our users placing outbound PSTN calls don’t hear ringback while the far end is ringing (goes quiet until call is answered). Anyone else have this issue? Maybe this is what the Ringback Bot will help with.

  • The same thing happens to my client with a Sonus 5400. As soon as we turn ringback on on the SBC then voicemail fails.

Tom Talks Microsoft Teams and Microsoft 365 news and opinions