1. Home
  2. Docs
  3. Voice Elements Teams Calling Plans
  4. How To Set Up Your DNS Entry

How To Set Up Your DNS Entry

Quick Reference

    • Create an “A” record for the FQDN that will be added as an SBC to the Voice / Direct Routing section of admin.teams.microsoft.com (i.e. your FQDN can be something like ‘sbc1.yourdomain.com’, or ‘voiceelements.yourdomain.com’). What you chose is up to you.
    • Be aware that most DNS registrars and programs only want you to key in the qualifying potion of the FQDN when you enter the “A” record.  So the correct entry would just be ‘sbc’, ‘sbc1’ or ‘voiceelements’ in the value portion of your “A” record.
    • The IP Address should be set to the IP displayed from our Customer Portal as you worked through the Setup step-by-step
    • It usually takes a few hours or more for a new “A” record to become visible on the internet.  But it can also turn up in minutes.
    • You can test the FQDN by opening a command prompt and ‘ping’ the FQDN. (i.e. ping sbc.yourdomain.com). If all is working correctly it will resolve to the IP address you set it to.


Microsoft Teams requires that you create a fully qualified domain name (FQDN) that resolves to the location of the equipment that will be handling your phone calls (commonly known as the SBC or session border controller).  The needed entry is known as a DNS ‘A’ Record and when setup it simply resolves to an IP address.  If you are not familiar with creating an ‘A’ record for your domain, please coordinate with your organization’s networking team to add an entry for your domain.

Microsoft requires that you create a new unique name that is based on one of the domains that is part of your TEAM’s tenant.  Lets assume that you have a tenant in TEAMS that includes ‘yourdomain.com’.  You could then create an FQDN such as ‘sbc.yourdomain.com’ or ‘teams.yourdomain.com’.  Basically anything that is like ‘*.yourdomain.com’ is acceptable.  Be aware that you cannot use ‘aaa.bbb.yourdomain.com’ unless you also have ‘bbb.yourdomain.com’ as a valid tenant inside teams.

Here is a short description from Microsoft from their documentation (see: https://docs.microsoft.com/en-us/microsoftteams/direct-routing-connect-the-sbc#using-the-microsoft-teams-admin-center)

“You can only connect the SBC if the domain portion of its FQDN matches one of the domains registered in your tenant, except *.onmicrosoft.com. Using *.onmicrosoft.com domain names is not supported for the SBC FQDN name. For example, if you have two domain names, contoso.com and contoso.onmicrosoft.com, you can use sbc.contoso.con for the SBC name. If you try to connect the SBC with a name such as sbc.contoso.abc, the system won’t let you, as the domain is not owned by this tenant.

In addition to the domain registered in your tenant, it’s important that there’s a user with that domain and an assigned E1, E3 or E5 license. If not, you’ll receive the following error:

Can not use the “sbc.contoso.com” domain as it was not configured for this tenant.”

The IP address that you need to point the ‘A’ record was given to you from the customer portal as you worked through the Setup Step-by-Step.  If you don’t have this IP address, please send an email to support@inventivelabs.com.

After you setup the ‘A’ record, you can test the validity of your record by either logging into our web site (customer.voiceelements.com) or simply trying to ping your newly created FQDN.  Note:  You may not get a reply from the ping but when setup correctly you will see that it resolves to the IP address you specified when you created the ‘A’ record.  Also note that after creating the ‘A’ record it often takes up to an hour for it to replicate across the internet depending on your setup.


Was this article helpful to you? Yes No