---
sourceDocument: Xanadu Conversational Interfaces
sourceDocumentLink: https://www.servicenow.com/docs/r/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Pre-link Virtual Agent requesters for integration with Microsoft Teams

# Pre-link Virtual Agent requesters for integration with Microsoft Teams {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Pre-link your Virtual Agent requesters to a ServiceNow instance before they run the Conversational Integration with Microsoft Teams. Batch pre-linking enables your Virtual Agent users to immediately chat with a virtual agent and receive
notifications without going through the initial authentication linking process.

## Before you begin

* [Install Conversational Integration with Microsoft Teams](https://www.servicenow.com/docs/mcTus9Or4jZim0xfPI6a3g "You can install the Microsoft Teams (sn_va_teams) application to integrate with Now Virtual Agent if you have the admin role."), with the Automatically Link ServiceNow user profiles option enabled.
* [Set up Microsoft
  Teams Graph spoke](https://www.servicenow.com/docs/access?context=set-up-msteams&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US).
* [Set up Microsoft Active Directory spoke](https://www.servicenow.com/docs/access?context=set-up-ad&version=xanadu&pubname=xanadu-integrate-applications&ft:locale=en-US).
{#prelink-va-users-integ-msteams__ul_yqz_yy5_mqb}  
Roles required:

* virtual_agent_admin
* external_app_install_admin
* One of the following Microsoft Teams administrator roles:
  * Global Administrator
  * Application Administrator
  * Cloud Application Administrator
  {#prelink-va-users-integ-msteams__ul_hvh_fkz_lqb}
* admin or schedule_admin to change the scheduled job script
{#prelink-va-users-integ-msteams__ul_qdv_zy5_mqb}

## About this task

When the Automatically Link ServiceNow user profiles option is
enabled on the Settings page of the Manage Microsoft Teams channel, a batch of up to
10,000 users is automatically pre-linked to a ServiceNow
instance. Your existing users are pre-linked during the initial run. Newly added
users are pre-linked during subsequent daily runs.

To prevent automatic batch pre-linking, disable the Automatically Link ServiceNow user profiles option on the Messaging Apps Integration UI
page.  
Batch pre-linking of your Virtual Agent users to a ServiceNow instance before integrating with Microsoft Teams includes the following benefits:

* Notifications are proactively sent by Virtual Agent to users when their identity in Microsoft Teams is associated with their identity in a ServiceNow instance. This is also true when the user is already linked with ServiceNow Virtual Agent.
* If a user is pre-linked, and when Microsoft Teams notifications are enabled in the app, notifications are pushed to the app even when a user is not logged into a Microsoft Teams account.
{#prelink-va-users-integ-msteams__ul_rmh_qxy_lqb}

Batch pre-linking happens automatically via the MS Teams Daily Pre Install Job scheduled job. This job runs by default daily at 1:00 a.m., but
you can change the time, if desired. To modify the default scheduled job run time or
time zone, access the MS Teams Daily Pre Install Job
Scheduled Script Execution form.

## Procedure

1. Navigate to AllSystem DefinitionScheduled Jobs.
2. Search for the MS Teams Daily Pre Install Job scheduled job and select to open the Scheduled Script Execution form for the selected record.
3. In the Run field, change the run time to your desired time.
4. For a description of the other fields that you can change in this form, including Time zone, see [Automatically run a
   script of your choosing](https://www.servicenow.com/docs/access?context=t_ScheduleAScriptExecution&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US).
5. Select Save.
{#prelink-va-users-integ-msteams__steps_vl4_bz5_mqb}

## What to do next

You can also customize the auto-linking process for Conversational Integration with Microsoft Teams. For more information, see [Customize auto-linking for Conversational Integration with Microsoft Teams](https://www.servicenow.com/docs/ZeFMI8mc1LJ9AbwTRopPtg "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.").

*[\>]: and then