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

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

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.

Role required: admin

Procedure

  1. Navigate to All > Connections & Credentials > Connection & 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:

FieldDescription
NameAny unique name for the credential, such as `Power VA Direct Line key`.
HeaderLeave as Authorization.
Static TokenEnter `Bearer`, with a white space, followed by the Direct Line secret key from Power Virtual Agents.For example, enter:
Bearer 4km3D8s_6lY.rDVmxVm3k123nWibx3ciJeed2AKled9_ADuwsaN5uCA
  1. Click Submit.

  2. Return to All > Connections & Credentials > Connection & Credential Aliases.

  3. Click the Bot Interconnect DirectLine Fetch Msgs record to open it.

  4. Under Related Links, click Create New Connection & Credential.

  5. In the dialog box, fill in the form.

FieldDescription
Secondary Bot NameAny unique name that refers to the Power Virtual Agents bot.
Secondary Bot EndpointThe Azure function URL that you copied in a previous step.For example, enter `https://demoazurefunctionreceivemsgapp.azurewebsites.net`.
HeaderEnter: `dlsecret`
Static TokenThe Direct Line key that you copied from Power Virtual Agents in the previous step.
  1. Click Create.

Parent Topic:Using Microsoft Power Virtual Agents as a secondary bot with Virtual Agent Bot Interconnect

Previous topic:Locate and copy the Direct Line secret key in Microsoft Power Virtual Agents

Next topic:Create a Virtual Agent Bot Interconnect shell topic to call Microsoft Power Virtual Agents topics