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

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Add the Direct Line secret key to your Virtual Agent Bot Interconnect instance

# Add the Direct Line secret key to your Virtual Agent
Bot Interconnect instance {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

To use Power Virtual Agents with Virtual Agent
Bot Interconnect, you must add the Direct Line security key as a credential
in your Bot Interconnect instance.

## Before you begin

[Locate and copy the Direct Line secret key in Microsoft Power Virtual Agents](https://www.servicenow.com/docs/zP8bE2bMghQngLuQna_rfA "To use Power Virtual Agents with Virtual Agent Bot Interconnect, you must locate and copy the Direct Line security key in your Power Virtual Agents account.").

Role required: admin

## Procedure

1. Navigate to AllConnections \& CredentialsConnection \& Credential Aliases.
2. Click the Bot Interconnect DirectLine Credentials record to open it.
3. On the Credentials related list, click New.
4. When prompted for the type of credential to create, click Bot Interconnect Static Token Credential.
5. On the form, fill in the fields as follows:  
   {#add-dl-secret-key-sn-instance__table_z5c_3y2_lsb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Any unique name for the credential, such as <kbd class="ph userinput">Power VA Direct Line key</kbd>. |
   | Header | Leave as Authorization. |
   | Static Token | Enter <kbd class="ph userinput">Bearer </kbd>, with a white space, followed by the Direct Line secret key from Power Virtual Agents. For example, enter: Bearer 4km3D8s_6lY.rDVmxVm3k123nWibx3ciJeed2AKled9_ADuwsaN5uCA |
   [ ]

   {#add-dl-secret-key-sn-instance__table_z5c_3y2_lsb}
6. Click Submit.
7. Return to AllConnections \& CredentialsConnection \& Credential Aliases.
8. Click the Bot Interconnect DirectLine Fetch Msgs record to open it.
9. Under Related Links, click Create New Connection \& Credential.
10. In the dialog box, fill in the form.  
    {#add-dl-secret-key-sn-instance__table_zcp_fpd_nsb__entry__2}

    | Field | Description |
    |-|-|
    | Secondary Bot Name | Any unique name that refers to the Power Virtual Agents bot. |
    | Secondary Bot Endpoint | The Azure function URL that you copied in a previous step. For example, enter <kbd class="ph userinput">https://demoazurefunctionreceivemsgapp.azurewebsites.net</kbd>. |
    | Header | Enter: <kbd class="ph userinput">dlsecret</kbd> |
    | Static Token | The Direct Line key that you copied from Power Virtual Agents in the previous step. |
    [ ]

    {#add-dl-secret-key-sn-instance__table_zcp_fpd_nsb}
11. Click Create.
**Previous topic:** [Locate and copy the Direct Line secret key in Microsoft Power Virtual Agents](https://www.servicenow.com/docs/zP8bE2bMghQngLuQna_rfA "To use Power Virtual Agents with Virtual Agent Bot Interconnect, you must locate and copy the Direct Line security key in your Power Virtual Agents account.")  
**Next topic:** [Create a Virtual Agent Bot Interconnect shell topic to call Microsoft Power Virtual Agents topics](https://www.servicenow.com/docs/yoexQ2jWl6WaugX4~6POBA "To access topics in the Power Virtual Agents secondary bot, you must create at least one Virtual Agent Bot Interconnect topic.")

*[\>]: and then