View source for Microsoft Teams - ICX-AlphaCom Integration

{{I}}
[[Image:Teams integration.png|right|600px|thumb|Integration Overview]]


==Introduction==
This article describes how you connect intercom audio calls to Microsoft Teams, by connecting ICX-Alphacom to the Microsoft Certified Audiocodes Mediant 800 SBC solution.

With this solution we offer the customers a way to simplify their communication, as they can handle i.e. door calls on their computer and mobile Teams client. 

Key functionality:
*Parallel and sequential ringing, which means multiple Teams users in the company can answer intercom calls from i.e. doors
*Teams users can answer calls in their Teams client on computer and mobile, which means they can answer calls anywhere and at any time
*Received calls can be transferred to other Teams users
*During a conversation you can open a door (activate relay/output) from the Teams client, using the dialpad ( (by default digit 6 in ICX-AlphaCom triggers the relay)


Limitation:
*This integration does not support video

==Licensing==
This integration requires licenses in the ICX-Alphacom, AudioCodes Mediant 800 SBC and Microsoft Teams.

===ICX-Alphacom===
ICX-Alphacom requires one of the following SIP trunking licenses to establish a connection between ICX-AlphaCom and the AudioCodes SBC. 

*ILI-SIP2: 1002602101 - SIP Trunking, 2 lines. 
*ILI-SIP4: 1002602102 - SIP Trunking, 4 lines.
*ILI-SIP8: 1002602103 - SIP Trunking, 8 lines.

===AudioCodes Mediant 800SBC===
For  implementing  Microsoft  Teams  Direct  Routing, AudioCodes SBC must be installed with a License Key that includes the following features: 
*MSFT (general Microsoft license)Note: By default, all AudioCodes media gateways and SBCs are shipped with this license (except MSBR products, Mediant 500 SBC, and Mediant 500 Media Gateway).
*SW/TEAMS (Microsoft Teams license) 
*Number of SBC sessions (based on requirements)  

{{note|For this test, the AudioCodes Mediant 800 SBC is connected to WAN using public IP address. Using NAT (Network address translation) to connect the AudioCodes Mediant 800 SBC is not tested.}}

===Microsoft Teams===
Users of Direct Routing must have the following licenses assigned in Microsoft 365 or Office 365(&#42;):
*Microsoft Phone System.
*Microsoft Teams + Skype for Business Plan 2, if included in licensing.
*Microsoft Audio Conferencing (please read the notes and the paragraph below for specific examples about when the license is required).

&#42;<span style="font-size: 0.875em;">Microsoft can change the license requirements</span>

==Prerequisites==

===ICX-AlphaCom===
Running ICX-AlphaCom with required licenses installed.

===AudioCodes Mediant 800SBC===
Microsoft has successfully conducted validation tests with AudioCodes' Mediant SBC Ver. 7.20A.258. Previous firmware versions may run successfully, however, Microsoft did not test such versions.

==Configuration==

===ICX-AlphaCom===
Create a SIP trunk node in the ICX/AlphaCom. Follow the instructions in this article: [[SIP trunk node - configuration|SIP trunk node]]

{{note|The Microsoft Teams users that will be called must be created as [[SIP trunk node - configuration#Global_number|Global numbers]]}}

[[image:Teams_global_numbers.png|600px|left|thumb|Global Numbers]]
<br clear=all/>


Using '''Global Number (feature 83)''' instead of '''SIP Trunk Station (feature 9)''' has some limitations that can be resolved in a way that is explained further in this article. 
{{note|'''Notes on using SIP Trunk Station (feature 9) versus Global Number (feature 83)''':
* '''''Features''': When a SIP User is related to a physical number in AlphaCom, it will get access to more station related features, such as [[Ringing Group Feature|Ringing Group]] membership, [[Call Setup Priority]], Call Forwarding, Call Restrictions and [[Event Handler]]''
* '''''Registration''': A SIP Trunk Station does not need to register towards AlphaCom. It will appear as registered in the "Stations" list in AlphaWeb''
* '''''OPC''': A SIP Trunk Station is supported by the [[OPC Server]]. The SIP user will appear in the OPC Item tree, showing status information and allowing call operations. When using a Global Number (feature 83), it will not appear in the OPC tree'' 
* '''''Licencing''': As from AlphaCom software v. 12.5.3.0 a SIP Trunk Station does not require any [[Licenses#SIP_station_license|SIP Station license]]. In software v. 11.x.x.x a SIP Station license is required.''
* '''''[[#Failover to redundant SIP server|Failover to redundant SIP server]]''' is not supported when using SIP Trunk Station. In that case one must use directory numbers with [[SIP_trunk_node_-_configuration#Create_access_numbers|feature number 81 and feature number 83]]'' }}

====Door Opening Feature====
During a conversation between a door station and Microsoft Teams account, the Microsoft Teams user can activate the [[Door opening|Door Opening feature]] in the ICX-AlphaCom by pressing digit 6. 

A SIP Trunk is automatically using Class of Service 15. This Class of Service group does not have the option for remote door opening enabled by default. In AlphaPro select the [[Class Of Service (AlphaPro)|Class of Service]] button, select number 15 (Outside Telephones), press change and locate feature number 58 in the "Not Valid" list. Highlight '''Feature 58''' and use the single arrow key to move it to the "valid" list.
[[File:COS15 DoorOpening.PNG|left|thumb|500px|Enable feature 58 (Door Opening) in Class of Service 15]]
<br style="clear:both;" />


The Door Opening feature is programmed in the Event Handler. When SIP trunk is involved, there are two separate events for the door opening feature, depending on who is the <u>calling</u> side.

'''Incoming call from Microsoft Teams to the ICX-AlphaCom door station:'''

The '''Standard''' door opening event is used:
[[Image:AlphaCom configuration.jpg|left|thumb|500px|Door Opening event when call is initated from the SIP Trunk]]
<br style="clear:both;" />

'''Outgoing call from the ICX-AlphaCom door station to a Microsoft Teams account via the SIP Trunk:'''

When the phone presses digit 6, the event type '''Event Trigger Feature''' (15) is reported, with the digit 6 as sub event. The calling AlphaCom station is Event Owner, and called SIP phone number and node number is Related To. The RCO pulse time is specified as an additional parameter in the RCO action string, i.e. RCO 3 ON 20 means pulse RCO 3 for 2 seconds.
[[Image:Calling from the door to the Telephone.jpg|left|thumb|500px|Door Opening event when call is initated from the door intercom station]]
<br style="clear:both;" />


===AudioCodes Mediant 800SBC===
For configuration of the AudioCodes Median 800 SBC, please follow the instruction provided in the following manual: [https://www.audiocodes.com/media/13161/connecting-audiocodes-sbc-to-microsoft-teams-direct-routing-hosting-model-configuration-note.pdf Connecting AudioCodes SBC to Microsoft Teams Direct Routing]

In order the integration to work properly, some changes need to be in the configuration of the AudioCodes SBC compared to what is recommended in the manual.

<ol>
<li>Section 2.11 and section 2.12 can be skipped if there is only one ICX-AlphaCom integrated towards Teams.</li>

<li>In section 2.14 Configura a Coder Group, the payload type for coders '''SILK-NB''' and '''SILK-WB''' should be set to 76 and 77, accordingly. Using the payload type in the description will cause a payload type missmatch and it won't be possible to make calls.</li>

[[image:Teams_SBC_coder.png|900px|left|thumb|Coder settings]]
<br clear=all/>

<li>In Section 2.15 Configure an IP Profile, for the SIP Trunk IP profile, under SBC Signaling section, in addition to what is in the manual, the following fields must be changed:
*'''SIP UPDATE Support''' set to '''Not Supported'''
*'''Remote re-INVITE''' set to '''Supported only with DSP'''
*'''Remote Delayed Offer Support''' set to '''Not Supported'''

[[image:Teams_SBC_IP_profiles.png|800px|left|thumb|IP Profiles]]
<br clear=all/>
</li>

<li>In Section 2.20 Configure IP-to-IP Call Routing Rules, in addition to the 3 rules described in this section, one more IP-to-IP Routing Rule must be added.
<br clear=all/>
<br clear=all/>
This rule will route calls from ICX-AlphaCom to Teams and should be configured as shown in the image bellow 
<br clear=all/>

[[image:Teams SBC IP-to-IP.png|800px|left|thumb|IP-to-IP Routing]]
<br clear=all/>
</li>

<li>To avoid transcoding, you can force the AudioCodes SBC to use G711 coder. To do this go to '''Setup''' > '''Signaling & Media''' > '''Coder & Profiles''' > '''Allowed Audio Coders Groups'''. 
<ul>
<li>Click New to create a new group. Then click Allowed Audio Coders bellow the Name
<br clear=all/>
[[image:Teams_SBC_allowed_coder.png|800px|left|thumb|Create allowed audio coder group]]
<br clear=all/>
</li>
<li>Then Click new to add a coder and select G.711 U-law from the list. Then click Apply and Save.
<br clear=all/>
[[image:Teams_SBC_allowed_coder1.png|600px|left|thumb|Add G.711 as allowed coder]]
<br clear=all/>
</li>

<li>The created Allowed Audio Coder Group needs to be assigned to the IP profiles. Go to '''Setup''' > '''Signaling & Media''' > '''Coder & Profiles''' > '''IP Profiles'''. Edit both profiles and in the SBC Media section for the Allowed Audio Coders field select Group 1. Apply and save the settings.
<br clear=all/>
[[image:Teams SBC allowed coder2.png|600px|left|thumb|Assign allowed coder group to IP Profiles]]
<br clear=all/>
</li>
</ul>
</li>
</ol>


===Microsoft Teams===
For configuration of the Microsoft Teams Direct Routing, please follow the instruction provided here: [https://docs.microsoft.com/en-us/microsoftteams/direct-routing-configure Microsoft Teams Direct Routing]

====Door Opening====
During a conversation you can open a door (activate relay/output) from Teams. To do this, press the keyboard icon (marked on the image) and then press the digit used for opening door (by default it is digit 6 in ICX-AlphaCom)

[[image:Teams_Teams_door_open.png|600px|left|thumb|Open keyboard for door opening]]
<br clear=all/>

====Parallel and sequential ringing====
Using options provided from Teams, a call can be made to ring on multiple Teams accounts, either in parallel or sequential after a timeout. To configure this, click on your image in the right top corner then select '''Settings''' > '''Calls'''. Select the <i>'''Calls ring me'''</i> option.
*'''Also Ring''' - when a user is added in this field, it will ring in parallel when you receive a call
*'''If unanswered''' - the call will be forwarded to the user defined in this field after the defined time expires. The time can be set to 10, 20, 30 ,40,50,60 seconds. 20 seconds is default.

[[image:Teams_Teams_settings.png|500px|left|thumb|Parallel and sequential ringing]]
<br clear=all/>


To be able to make parallel or sequential calls to multiple users, a call group must be used.

From the dropdown list next to '''Also Ring''' select '''Call Group'''.

[[image:Teams Teams callgroup1.png|500px|left|thumb|Parallel and sequential ringing]]
<br clear=all/>

In the call group, add the users you want to call. From the '''Ring Order''' selection at the bottom select one of the following:
*'''All at the same time''' - call all users in parallel
*'''In the order above''' - call them in sequence, in the order that you have them in your list.

[[image:Teams Teams callgroup2.png|500px|left|thumb|Parallel and sequential ringing]]
<br clear=all/>

====Call Forward====
Using options provided from Teams, a call can be forward to a different Teams account. To configure this, click on your image in the right top corner then select '''Settings''' > '''Calls'''. Select the <i>'''Forward my calls'''</i> option. In the '''Forward To''' field define the account to which the calls will be forwarded.

[[image:Teams_Teams_forward_calls.png|500px|left|thumb|Forward calls]]
<br clear=all/>

====Call Transfer====
During a call between a station from ICX-AlphaCom and Teams, calls can be transferred to a different Teams account. To make a transfer during conversation, click the 3 dots in the right top corner. There are transfer options:
*'''Transfer''' - Will do a blind transfer. The call will be transfered directly to the selected Teams user and after you press transfer, the call will end for you.
*'''Consult then transfer''' - Enables you to check in with the Teams user before you transfer a call to them. When you are ready to do the transfer click the '''Transfer''' button.

[[image:Teams_Teams_transfer_calls.png|600px|left|thumb|Transfer calls]]
<br clear=all/>

[[Category:3rd party integration]]