Customize auto-linking for Conversational Integration with Microsoft Teams

task brazil Updated Sep 10, 2026 1 min read customize-autolink-msteams.md

Customize auto-linking for user profiles by defining the email Id of the user in any custom table rather than just the User [sys_user] table.

Before you begin

Make the User [sys_user] table extensible.
Create a custom table with custom email fields extending the User [sys_user] table.
Ensure that the scope of the custom table is Microsoft Teams, or else, create a cross scope privilege.
Populate the system property in the table_name.column_name format.

Role required: admin

About this task

The auto-linking process searches the user table for the email ID and if found, links the user to the profile automatically. You can also customize the auto-linking process by defining the email Id for auto/pre-linking in any custom table rather than the current User [sys_user] table. You can customize the auto-linking process of user profiles by using the sn_va_teams.auto_link_email_attribute system property that defines the column from which the email ID of the user must be read for auto-linking.

Note:

By default, the value of the system property is empty. If it is set to <empty>, then the email Id for the user is fetched from the [sys_user] table.
If the value of the system property is specified in the format of table_name.column_name (both table_name and column_name must be the physical names from their respective name fields), then the value is read from the column name specified. For example, sn_va_teams_extendeduser.u_custom_mail.

Procedure

In the navigation filter, enter sys_properties.list.

The entire list of properties in the System Properties [sys_properties] table is displayed.
Search and open the sn_va_teams.auto_link_email_attribute system property.
Provide a value in the format of table_name.column_name and save the record.

Once the record is saved, you can initiate the conversation with the bot.

Parent Topic:Configure Virtual Agent for Microsoft Teams

52 lines · 2.9 KB Wrap lines

---
title: Customize auto-linking for Conversational Integration with Microsoft Teams
description: Customize auto-linking for user profiles by defining the email Id of the user in any custom table rather than just the User \[sys\_user\] table.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/conversational-interfaces/virtual-agent/customize-autolink-msteams.html
release: brazil
product: Virtual Agent
classification: virtual-agent
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Configure VA for Teams, Microsoft Teams, Integrate VA with messaging apps, Conversational Integration apps for Virtual Agent, Conversational Interfaces]
---

# Customize auto-linking for Conversational Integration with Microsoft Teams

Customize auto-linking for user profiles by defining the email Id of the user in any custom table rather than just the User \[sys\_user\] table.

## Before you begin

- Make the User \[sys\_user\] table extensible.
- Create a custom table with custom email fields extending the User \[sys\_user\] table.
- Ensure that the scope of the custom table is Microsoft Teams, or else, create a cross scope privilege.
- Populate the system property in the **table\_name.column\_name** format.

Role required: admin

## About this task

The auto-linking process searches the user table for the email ID and if found, links the user to the profile automatically. You can also customize the auto-linking process by defining the email Id for auto/pre-linking in any custom table rather than the current User \[sys\_user\] table. You can customize the auto-linking process of user profiles by using the **sn\_va\_teams.auto\_link\_email\_attribute** system property that defines the column from which the email ID of the user must be read for auto-linking.

**Note:**

- By default, the value of the system property is empty. If it is set to &lt;empty&gt;, then the email Id for the user is fetched from the \[sys\_user\] table.
- If the value of the system property is specified in the format of **table\_name.column\_name** \(both table\_name and column\_name must be the physical names from their respective name fields\), then the value is read from the column name specified. For example, **sn\_va\_teams\_extendeduser.u\_custom\_mail**.

## Procedure

1. In the navigation filter, enter `sys_properties.list`.

The entire list of properties in the System Properties \[sys\_properties\] table is displayed.

2. Search and open the **sn\_va\_teams.auto\_link\_email\_attribute** system property.

3. Provide a value in the format of **table\_name.column\_name** and save the record.

Once the record is saved, you can initiate the conversation with the bot.

**Parent Topic:**[Configure Virtual Agent for Microsoft Teams](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/configure-va-msteams-settings.md)