From VoIP.ms Wiki

[checked revision]

[checked revision]

Revision as of 21:32, 21 May 2024 (view source) RP (Talk | contribs) (→Valet (Call App) provisioning) ← Older edit		Revision as of 00:47, 23 May 2024 (view source) RP (Talk | contribs) Newer edit →
Line 70:		Line 70:
	: <h3> 5 - Set Up Direct Routing. </h3>		: <h3> 5 - Set Up Direct Routing. </h3>
-	:: '''5.1''' Make sure you have at least 1 available '''AND''' unassigned User license with the Phone System, or comparable, add-on that allows you to use Direct Routing.	+	:: '''5.1''' Make sure you have at least 1 available '''AND''' unassigned licensed user that also has the Phone System or Enterprise Premium License.
	::: [[File:004_Valet_Direct_Routing_1.png|border|300px]]		::: [[File:004_Valet_Direct_Routing_1.png|border|300px]]
-	:: '''5.2''' Select the desired Gateway, paste the invitation code from the email then click the Complete Direct Routing.	+	:: '''5.2''' Select the desired Gateway, paste the invitation code from the email you previously received and then click '''Complete Direct Routing'''.
-		+
-	:: '''5.3''' The "Verify Tenant" will pop up, this will verify the connection to the DNS Provider and will validate licenses. Click "Complete Direct Routing" as soon as it is done with the verification.	+
	::: [[File:004_Valet_Direct_Routing_2.png|border|300px]]		::: [[File:004_Valet_Direct_Routing_2.png|border|300px]]
		+
		+	:: '''5.3''' A popup stating "Verify Tenant" will appear. This will verify the connection to the DNS Provider and it will also validate licenses. Click "Complete Direct Routing" once more after the verification has been complete.
-	:: '''5.4''' Direct Routing provisioning will take a few minutes, refresh the dashboard page after 2-3 minutes to check progress.	+	:: '''5.4''' The provisioning of the Direct Routing takes a few minutes. You can refresh the dashboard page after 2-3 minutes to check the progress.
	::: [[File:004_Valet_Direct_Routing_3.png|border|300px]]		::: [[File:004_Valet_Direct_Routing_3.png|border|300px]]
-	: <h3> 6 - Configure PBX settings. </h3>	+	: <h3> 6 - Configure your PBX Settings </h3>
-	:: '''6.1''' Navigate to “PBX Settings” section to add a new PBX connection.	+	:: '''6.1''' Still in the [https://enterprise.connecttoteams.com/ ConnectToTeams Portal], navigate to the '''PBX''' section on the left menu and add a new PBX connection with the "Add PBX" button.
	::: [[File:006_Add_PBX_Connector.png|border|600px]]		::: [[File:006_Add_PBX_Connector.png|border|600px]]
Line 96:		Line 96:
	:: '''6.2''' Input the VoIP.ms parameters required for the PBX connector.		:: '''6.2''' Input the VoIP.ms parameters required for the PBX connector.
-	:::'''Note''' This task can be delegated to someone other than the Microsoft Global Administrator.
	:: '''6.3''' Necessary PBX information includes:		:: '''6.3''' Necessary PBX information includes:
Line 103:		Line 102:
	:::* '''Voicemail Feature Code''': *97		:::* '''Voicemail Feature Code''': *97
	:::* '''PBX SIP Domain Procy Port''': 5060		:::* '''PBX SIP Domain Procy Port''': 5060
-	:::* '''Codecs''': G722 Only (Be sure the sub-account is set with this codec)	+	:::* '''Codecs''': G711U Only (Be sure the sub-account is set with this codec)
	:::* '''Reg Expires''': 600		:::* '''Reg Expires''': 600
	:::* '''Caller ID on Forwarding''': '''User's Caller ID'''		:::* '''Caller ID on Forwarding''': '''User's Caller ID'''
Line 113:		Line 112:
	: <h3> 7 - Create/Configure Application Instance. </h3>		: <h3> 7 - Create/Configure Application Instance. </h3>
-	:: '''7.1''' The Global Administrator commences the process by clicking the Setup button in the Enterprise Admin Action Items. This step enables the Valet Application Service and the Application Instance for Enterprise.  This process automatically creates the "valetservice" user and assigns the Phone System Resource Account made available as part of the prerequisite.	+	:: '''7.1''' The Global Administrator can start the process by clicking '''Dashboard''' on the left menu and then clicking the '''Setup''' button next to '''Teams Valet App'''. This step enables the Valet Application Service and the Application Instance.
	::: [[File:005_Valet_Configure_App_1.png|border|600px]]		::: [[File:005_Valet_Configure_App_1.png|border|600px]]
-	:: '''7.2''' Once complete you will see the ‘valetservice’ in the users page.	+	:: '''7.2''' Next, configure the Valet Service Account by clicking the '''Configure''' button. This step assigns a Phone Number to the user created as part of the Setup.
-		+
-	::: [[File:005_Valet_Configure_App_2.png|border|600px]]	+
-		+
-		+
-	:: '''7.3''' Still under the Enterprise Admin Action Items, configure the Valet Service Account by clicking the Configure button. This will take you to the Configure Valet Service Account page where you can select the Application Instance user. This step assigns a Phone Number to the "valetservice" user created as part of the ‘Setup’.	+
	::: [[File:005_Valet_Configure_App_3.png|border|600px]]		::: [[File:005_Valet_Configure_App_3.png|border|600px]]
-	:: '''7.4''' Add the Application Instance user as you would add a regular Teams PBX user then click Save.	+	:: '''7.3''' Fill in the following information:
-		+	::* '''PBX Location''': The location previously created when configure your PBX Connector
		+	::* '''Available Voice Routes''': The Server your PBX Connector has been configured to.
		+	::* '''Teams User''': The user you wish to configure.
		+	::* '''Phone Number''': The phone number that this user will be passing for his outgoing calls.
		+	::* '''SIP User''': Your sub account userID. E.g: 111111_subaccount.
		+	::* '''SIP Authentication ID''': Your sub account userID. E.g: 111111_subaccount.
		+	::* '''SIP Password''': Your sub account password you entered while creating the sub account.
		+	::* '''Confirm SIP Password''': Confirm your sub account password.
		+
	::: [[File:005_Valet_Configure_App_4.png|border|600px]]		::: [[File:005_Valet_Configure_App_4.png|border|600px]]
-	:: '''7.5''' Grant the Consent for the Application to enable the Valet App Instance user.	+	:: '''7.4''' Press '''Save Valet Service Account''' and you will then need to grant the Consent for the Application to appear for the user.
	::: [[File:005_Valet_Configure_App_5.png|border|600px]]		::: [[File:005_Valet_Configure_App_5.png|border|600px]]
-	:: '''7.6''' A headset icon will represent the App Instance user in the dashboard	+	:: '''7.5''' Once you are done assigning the valet application to all your users, you can return to the '''Dashboard''' main menu by clicking it on the left, and deploy the Valet App by clicking the '''Sync Valet App''' button, then clicking '''Provision Application'''.
-		+
-	::: [[File:005_Valet_Configure_App_6.png|border|600px]]	+
		+	::: [[File:005_Valet_Configure_App_7.png|border|600px]]
-	:: '''7.7''' Deploy the Valet App by clicking the Sync Valet App button, then click Provision Application.	+	:: '''7.6''' Once complete, you can consult all the users with the application enabled by going into '''Users''' on the left menu. You will see the valet service enabled which is a green headset icon.
-	::: [[File:005_Valet_Configure_App_7.png|border|600px]]	+	::: [[File:005_Valet_Configure_App_2.png|border|600px]]
-	: <h3> 8 - Create/Configure Application Instance. </h3>	+	: <h3> 8 - Create/Configure the Application Instance. </h3>
-	:: '''8.1''' Click the Configure Valet App Users from the Users page.	+	:: '''8.1''' Head on '''USers'' on the left menu, and then click '''Configure Valet App Users'''.
	::: [[File:005_Valet_Configure_App_9.png|border|600px]]		::: [[File:005_Valet_Configure_App_9.png|border|600px]]
-	:: '''8.2''' Add a Valet user as you would add a regular Teams PBX user then click Save.	+	:: '''8.2''' Fill in the following information:
		+	::* '''PBX Location''': The location previously created when configure your PBX Connector
		+	::* '''Available Voice Routes''': The Server your PBX Connector has been configured to.
		+	::* '''Teams User''': The user you wish to configure.
		+	::* '''Phone Number''': The phone number that this user will be passing for his outgoing calls.
		+	::* '''SIP User''': Your sub account userID. E.g: 111111_subaccount.
		+	::* '''SIP Authentication ID''': Your sub account userID. E.g: 111111_subaccount.
		+	::* '''SIP Password''': Your sub account password you entered while creating the sub account.
		+	::* '''Confirm SIP Password''': Confirm your sub account password.
	::: [[File:005_Valet_Configure_App_10.png|border|600px]]		::: [[File:005_Valet_Configure_App_10.png|border|600px]]
-	:: '''8.3''' A fully configured Valet App User will show a telephone icon for Teams Registration.	+	:: '''8.3''' Once done, press '''Save Valet User'''. A fully configured Valet App User will show a telephone icon for Teams Registration.
	::: [[File:005_Valet_Configure_App_11.png|border|600px]]		::: [[File:005_Valet_Configure_App_11.png|border|600px]]
Line 167:		Line 176:
	: <h3> 9 - End user configuration. </h3>		: <h3> 9 - End user configuration. </h3>
-	:: '''9.1''' Each configured Valet user will need to add the Valet app.	+	:: '''9.1''' Each configured user will need to add the Valet application. In teams, press '''...''' and select '''Valet App QA'''
	::: [[File:005_Valet_Configure_App_12.png|border|300px]]		::: [[File:005_Valet_Configure_App_12.png|border|300px]]
-	:: '''9.2''' Add the app, and then pin it to the sidebar by right-clicking and selecting "Pin."	+	:: '''9.2''' Pin it to the sidebar by right-clicking the application on the left bar and selecting "Pin."
	::: [[File:005_Valet_Configure_App_13.png|border|300px]]		::: [[File:005_Valet_Configure_App_13.png|border|300px]]
-	:: '''9.3''' And that's it! Use the dialpad in the App to make calls.	+	:: '''9.3''' And that's it! You can now make use of the dialpad in the App to make and receive calls!
	::: [[File:005_Valet_Configure_App_14.png|border|300px]]		::: [[File:005_Valet_Configure_App_14.png|border|300px]]
		+
	= Related Articles=		= Related Articles=

---

Revision as of 00:47, 23 May 2024

Contents 1 What is Call Valet with VoIP.ms Teams Connector? 2 VoIP.ms Technical Requirements 3 Valet (Call App) provisioning 3.1 1 - Verify licenses 3.2 2 - Grant permissions. 3.3 3 - User Groups Sync. 3.4 4 - Save The App Template. 3.5 5 - Set Up Direct Routing. 3.6 6 - Configure your PBX Settings 3.7 7 - Create/Configure Application Instance. 3.8 8 - Create/Configure the Application Instance. 3.9 9 - End user configuration. 4 Related Articles 5 Useful Resources

What is Call Valet with VoIP.ms Teams Connector?

The VoIP.ms Teams connector lets you link your VoIP.ms account to Microsoft Teams, so you can make and receive calls via your Microsoft Teams application, whether it’s on mobile, tablet or desktop, while still taking advantage of VoIP.ms hosted features. This connector is powered by TeamMate Technology, a third-party solution enabling seamless integration with Teams. Practically speaking, your Microsoft Teams becomes your softphone with a separate softphone application to make or receive calls. You may also link your VoIP.ms account to Microsoft Teams to send and receive text messages directly within Teams. Please note that you will need a Microsoft E1 license at the very minimum to be able to leverage this connector. For more information on Microsoft licenses, please check here.

VoIP.ms Technical Requirements

You require a PBX Connector in order to have the CallApp / Valet. For more information, visit this article to get started.

Valet (Call App) provisioning

1 - Verify licenses

1.1 Make sure a Phone System Resource Account license is available. Phone System Resource Account licenses are only available if you have a subscription for a Phone System license. On how to acquire one, consult [| this article].

2 - Grant permissions.

2.1 Once our team processed your request, the global administrator will receive an email and will need to click the “Complete” button at the bottom of the e-mail.

2.4 The initial request when the Microsoft Enterprise Global Administrator is asked for permission looks like this:

3 - User Groups Sync.

3.1 Once the permission has been granted, the administrator of the ConnectToTeams Portal will need to login he will be redirected to the User Group Sync page. You must select whether Users will be synchronized by specifying one or more Groups.

• If no Group(s) are selected, then all Users of the enterprise will be synchronized.
• If any Group(s) are selected, then only Users that belong to the Group(s) will be synchronized.

The image below shows a case where two Microsoft Groups (Accounting and Billing) have been selected to be synchronized.

4 - Save The App Template.

You need to create a template for the Teams Application that will house the Valet App interface. This template will set your default settings for any applications that are deployed to your enterprises.

4.1 Head to App Template.

4.2 Fill the following information:

• Dev Name: VoIP.ms
• Short Description: Put a short description for your team to refer to when they will go on About screen of the application.
• Full Description: Set a full description for your team to refer to when they will go on About screen of the application.

4.3 Save the template by pressing Save Valet App Template".

5 - Set Up Direct Routing.

5.1 Make sure you have at least 1 available AND unassigned licensed user that also has the Phone System or Enterprise Premium License.

5.2 Select the desired Gateway, paste the invitation code from the email you previously received and then click Complete Direct Routing.

5.3 A popup stating "Verify Tenant" will appear. This will verify the connection to the DNS Provider and it will also validate licenses. Click "Complete Direct Routing" once more after the verification has been complete.

5.4 The provisioning of the Direct Routing takes a few minutes. You can refresh the dashboard page after 2-3 minutes to check the progress.

6 - Configure your PBX Settings

6.1 Still in the ConnectToTeams Portal, navigate to the PBX section on the left menu and add a new PBX connection with the "Add PBX" button.

6.2 Input the VoIP.ms parameters required for the PBX connector.

6.3 Necessary PBX information includes:

• PBX SIP Domain (required): VoIP.ms POP Server Hostname - See full list of servers
• PBX SIP Domain Proxy: VoIP.ms POP Server Hostname - See full list of servers
• Voicemail Feature Code: *97
• PBX SIP Domain Procy Port: 5060
• Codecs: G711U Only (Be sure the sub-account is set with this codec)
• Reg Expires: 600
• Caller ID on Forwarding: User's Caller ID

Important: The SIP Domain and Proxy must be the same server used Point of Presence for your DID number(s)

• Caller Name Policy: Other
• Custom Caller Name: See the requirements below.

7 - Create/Configure Application Instance.

7.1 The Global Administrator can start the process by clicking Dashboard on the left menu and then clicking the Setup button next to Teams Valet App. This step enables the Valet Application Service and the Application Instance.

7.2 Next, configure the Valet Service Account by clicking the Configure button. This step assigns a Phone Number to the user created as part of the Setup.

7.3 Fill in the following information:

• PBX Location: The location previously created when configure your PBX Connector
• Available Voice Routes: The Server your PBX Connector has been configured to.
• Teams User: The user you wish to configure.
• Phone Number: The phone number that this user will be passing for his outgoing calls.
• SIP User: Your sub account userID. E.g: 111111_subaccount.
• SIP Authentication ID: Your sub account userID. E.g: 111111_subaccount.
• SIP Password: Your sub account password you entered while creating the sub account.
• Confirm SIP Password: Confirm your sub account password.

7.4 Press Save Valet Service Account and you will then need to grant the Consent for the Application to appear for the user.

7.5 Once you are done assigning the valet application to all your users, you can return to the Dashboard main menu by clicking it on the left, and deploy the Valet App by clicking the Sync Valet App button, then clicking Provision Application.

7.6 Once complete, you can consult all the users with the application enabled by going into Users on the left menu. You will see the valet service enabled which is a green headset icon.

8 - Create/Configure the Application Instance.

8.1' Head on USers on the left menu, and then click Configure Valet App Users.

8.2 Fill in the following information:

• PBX Location: The location previously created when configure your PBX Connector
• Available Voice Routes: The Server your PBX Connector has been configured to.
• Teams User: The user you wish to configure.
• Phone Number: The phone number that this user will be passing for his outgoing calls.
• SIP User: Your sub account userID. E.g: 111111_subaccount.
• SIP Authentication ID: Your sub account userID. E.g: 111111_subaccount.
• SIP Password: Your sub account password you entered while creating the sub account.
• Confirm SIP Password: Confirm your sub account password.

8.3 Once done, press Save Valet User. A fully configured Valet App User will show a telephone icon for Teams Registration.

9 - End user configuration.

9.1 Each configured user will need to add the Valet application. In teams, press ... and select Valet App QA

9.2 Pin it to the sidebar by right-clicking the application on the left bar and selecting "Pin."

9.3 And that's it! You can now make use of the dialpad in the App to make and receive calls!

Related Articles

• VoIP.ms Teams Connector
• License requirement to use VoIP.ms Teams Connector

Useful Resources

• TeamMate FAQ
• Youtube - TeamMate PBX Connector - How it Works
• Connect to Teams knowledge base