Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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

  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