Configuring the Device for Microsoft Teams Presence

The following procedure describes how to configure the device for notifying Teams of presence status of Teams users when making and receiving calls using third-party, endpoint devices. To help you understand the configuration, the following lists in chronological order the main processing steps:

The device receives an incoming call.

The device uses a Call Setup Rule to perform LDAP queries on Microsoft Entra ID to retrieve Teams usernames (Request URIs) for the corresponding calling (source) and/or called (destination) number. For SBC calls, the Call Setup Rule is associated with the classified source IP Group (in the IP Groups table). For Tel-to-IP Gateway calls, the Call Setup Rule is associated with the destination IP Group (in the Tel-to-IP Routing table).

The device routes the call to the required destination, according to the normal routing rules.

When the call is connected, the device sends a SIP PUBLISH message to Teams server, indicating that the users' presence status is now "On-the-Phone".

When the call ends, the device sends another SIP PUBLISH message to the Teams server, clearing the users' "On-the-Phone" status (the presence status changes to what it was before the call was connected).

➢

To configure device for Teams presence:

Configure a TLS Context (TLS certificate) for secured communication (mutual authentication) between the device and Teams (see Configuring TLS Certificate Contexts).

Configure a Proxy Set to define the address of the Teams (see Configuring Proxy Sets). Make sure you configure the following:

●

'TLS Context Name': Assign the TLS Context that you configured in Step 2 (above).

●

'Proxy Address': Configure the address (FQDN or IP address).

●

'Transport Type': TLS

Configure an IP Group to represent Teams server (see Configuring IP Groups). Make sure that you assign it with the Proxy Set that you configured in Step 3 (above).

Open the SIP Definitions General Settings page (Setup menu > Signaling & Media tab > SIP Definitions folder > SIP Definitions General Settings):

From the 'Presence Publish IP Group ID' drop-down list, select the IP Group of the Teams server that you configured (above) as the destination (presence gateway) to where the device sends the SIP PUBLISH messages.

Select the 'Microsoft Presence Status' check box to enable the Microsoft presence feature.

Configure the Teams' LDAP server (Entra ID) to query for the Teams users' SIP URIs (see Configuring LDAP Servers).

Configure Call Setup Rules to perform LDAP queries in Microsoft Entra ID for the SIP URI of the caller (source) and called (destination) parties (see Configuring Call Setup Rules). The device first needs to search Entra ID for the caller or called number of the third-party endpoint device. For example, to search for a called mobile number, the searched LDAP Attribute would be "mobile" set to the value of the destination number (e.g., 'mobile=+' + param.call.dst.user). If the entry exists, the query searches for the Attribute (e.g., ipPhone) where the SIP URI is defined for the corresponding mobile user. If found, the query returns the Attribute's value (i.e., URI) to the device (instructed using the special 'Condition' string "presence.dst" or "presence.src"). This is the URI that the device uses as the Request-URI in the PUBLISH message that it sends to the Teams server. The configuration of the example used in this step is shown below:

Parameter	Rule 1	Rule 2
'Request Type'	LDAP	LDAP
'Request Key'	'mobile=+' + param.call.dst.user	'mobile=+' + param.call.src.user
'Attributes To Get'	ipPhone	ipPhone
'Condition'	ldap.attr.ipPhone exists	ldap.attr.ipPhone exists
'Action Subject'	presence.dst	presence.src
'Action Type'	Add	Add
'Action Value'	ldap.attr.ipPhone	ldap.attr.ipPhone

Configure routing rules to route the calls in the network.

(SBC application) Configure IP Groups to represent your call party entities, and assign them the group of Call Setup Rules (Set ID) that you configured in Step 7 (above). For configuring IP Groups, see Configuring IP Groups.

(Gateway application) Assign the group of Call Setup Rules (Set ID) that you configured in Step 7 (above) to your Tel-to-IP Routing rules (see Configuring Tel-to-IP Routing Rules).