Actions

Microsoft Teams - ICX-AlphaCom Integration

From Zenitel Wiki

Icx icon.png
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)

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 icon 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(*):

  • 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).

*Microsoft can change the license requirements

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

Note icon The Microsoft Teams users that will be called must be created as Global numbers


Global Numbers



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 icon 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 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 SIP Station license. In software v. 11.x.x.x a SIP Station license is required.
  • Failover to redundant SIP server is not supported when using SIP Trunk Station. In that case one must use directory numbers with 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 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 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.

Enable feature 58 (Door Opening) in Class of Service 15



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 calling side.

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

The Standard door opening event is used:

Door Opening event when call is initated from the SIP Trunk


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.

Door Opening event when call is initated from the door intercom station



AudioCodes Mediant 800SBC

For configuration of the AudioCodes Median 800 SBC, please follow the instruction provided in the following manual: 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.

  1. Section 2.11 and section 2.12 can be skipped if there is only one ICX-AlphaCom integrated towards Teams.
  2. 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.
  3. Coder settings


  4. 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
    IP Profiles


  5. 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.

    This rule will route calls from ICX-AlphaCom to Teams and should be configured as shown in the image bellow
    IP-to-IP Routing


  6. 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.
    • Click New to create a new group. Then click Allowed Audio Coders bellow the Name
      Create allowed audio coder group


    • Then Click new to add a coder and select G.711 U-law from the list. Then click Apply and Save.
      Add G.711 as allowed coder


    • 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.
      Assign allowed coder group to IP Profiles



Microsoft Teams

For configuration of the Microsoft Teams Direct Routing, please follow the instruction provided here: 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)

Open keyboard for door opening


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 Calls ring me 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.
Parallel and sequential ringing



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.

Parallel and sequential ringing


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.
Parallel and sequential ringing


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 Forward my calls option. In the Forward To field define the account to which the calls will be forwarded.

Forward calls


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.
Transfer calls