Create a connection and credential in Virtual Agent Bot Interconnect
To use ServiceNow® Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect, configure the connection and credential records in the Bot Interconnect (primary) instance.
Before you begin
Role required: admin
Procedure
-
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
-
Click the Bot Interconnect VA API Integration record to open it.
-
In the Connections related list, click New.
-
On the form, fill in the fields.
Field Description Name Enter a unique name, such as SNow Secondary Bot.Credential Leave this blank for now. Connection alias Use the default value. Connection URL Enter the URL for Virtual Agent API on your secondary instance. For example, enter https://secondary-instance-name.service-now.com/api/sn_va_as_service/bot/integration. -
Click Submit.
-
Navigate to All > Connections & Credentials > Credentials.
-
On the Credentials page, click New.
-
Click either Bot Interconnect Hash Token Credential or Bot Interconnect Static Token Credential as the type.
-
On the form, fill in the fields.
Field Description Name Enter a unique name for the credential. For example, SNowSecondaryBotToken.Static token Header Enter Token.Static Token Enter a password. Hash token Header Enter x-b2b-signature.Algorithm Select HmacSHA1. Hash Secret Enter the hash secret. Authorization Algorithm Select the algorithm to use. For example, Secondary Bot Hash Token Auth. -
Click Submit.
-
Navigate to All > Connections & Credentials > Connection & Credential Aliases.
-
Click the Bot Interconnect VA API Integration record to open it.
-
In the Connections related list, open the new connection record you created in an earlier step.
-
In the Credential field, enter the name of the record that contains the static token or hash token.
For example,
SNowSecondaryBotToken.[Omitted image "api-secondary-bot-connection-credential.png"] Alt text: ServiceNow Secondary Bot HTTPS connection view. Credential and Connection URL fields are highlighted as newly created credential record and VA API installation on the secondary bot instance.
-
Click Update.
---
title: Create a connection and credential in Virtual Agent Bot Interconnect
description: To use ServiceNow Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect, configure the connection and credential records in the Bot Interconnect \(primary\) instance.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/conversational-interfaces/create-connection-credential-two-sn-instances.html
release: brazil
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Using ServiceNow Virtual Agent as a secondary bot, Virtual Agent Bot Interconnect, Conversational Interfaces]
---
# Create a connection and credential in Virtual Agent Bot Interconnect
To use ServiceNow® Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect, configure the connection and credential records in the Bot Interconnect \(primary\) instance.
## Before you begin
Role required: admin
## Procedure
1. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**.
2. Click the **Bot Interconnect VA API Integration** record to open it.
3. In the Connections related list, click **New**.
4. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Enter a unique name, such as `SNow Secondary Bot`.|
|Credential|Leave this blank for now.|
|Connection alias|Use the default value.|
|Connection URL|Enter the URL for Virtual Agent API on your secondary instance. For example, enter `https://secondary-instance-name.service-now.com/api/sn_va_as_service/bot/integration`.|
5. Click **Submit**.
6. Navigate to **All** > **Connections & Credentials** > **Credentials**.
7. On the Credentials page, click **New**.
8. Click either **Bot Interconnect Hash Token Credential** or **Bot Interconnect Static Token Credential** as the type.
9. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Enter a unique name for the credential. For example, `SNowSecondaryBotToken`.|
|Static token|
|Header|Enter `Token`.|
|Static Token|Enter a password.|
|Hash token|
|Header|Enter `x-b2b-signature`.|
|Algorithm|Select **HmacSHA1**.|
|Hash Secret|Enter the hash secret.|
|Authorization Algorithm|Select the algorithm to use. For example, **Secondary Bot Hash Token Auth**.|
10. Click **Submit**.
11. Navigate to **All** > **Connections & Credentials** > **Connection & Credential Aliases**.
12. Click the **Bot Interconnect VA API Integration** record to open it.
13. In the Connections related list, open the new connection record you created in an earlier step.
14. In the **Credential** field, enter the name of the record that contains the static token or hash token.
For example, `SNowSecondaryBotToken`.
\[Omitted image "api-secondary-bot-connection-credential.png"\] Alt text: ServiceNow Secondary Bot HTTPS connection view. Credential and Connection URL fields are highlighted as newly created credential record and VA API installation on the secondary bot instance.
15. Click **Update**.
| title | Create a connection and credential in Virtual Agent Bot Interconnect |
| description | To use ServiceNow Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect, configure the connection and credential records in the Bot Interconnect \(primary\) instance. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/conversational-interfaces/create-connection-credential-two-sn-instances.html |
| release | brazil |
| topic_type | task |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Using ServiceNow Virtual Agent as a secondary botVirtual Agent Bot InterconnectConversational Interfaces |