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

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.

    FieldDescription
    NameEnter a unique name, such as SNow Secondary Bot.
    CredentialLeave this blank for now.
    Connection aliasUse the default value.
    Connection URLEnter 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.

    FieldDescription
    NameEnter a unique name for the credential. For example, SNowSecondaryBotToken.
    Static token
    HeaderEnter Token.
    Static TokenEnter a password.
    Hash token
    HeaderEnter x-b2b-signature.
    AlgorithmSelect HmacSHA1.
    Hash SecretEnter the hash secret.
    Authorization AlgorithmSelect 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.

Image omitted: api-secondary-bot-connection-credential.png
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.
  1. Click Update.

  2. Create a connection and credential in Virtual Agent Bot Interconnect
    Create a connection and credential in Virtual Agent Bot Interconnect (primary instance) to enable uploading of attachments in the secondary bot.

Parent Topic:Using ServiceNow Virtual Agent as a secondary bot with Virtual Agent Bot Interconnect

Previous topic:Enable asynchronous mode on the secondary ServiceNow Virtual Agent instance

Next topic:Create a connection and credential in Virtual Agent Bot Interconnect