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

Configure a provider for your custom chat integration

Create a new provider for your custom chat integration. Providers are defined in the Connections [sys_cs_provider] table.

Before you begin

Create a new channel for your custom chat integration.

Role required: admin

About this task

Configure a new provider for each integration that you set up.

Procedure

  1. Navigate to All, and then enter sys_cs_provider.list in the filter.

  2. On the Connections page, select New Custom.

  3. On the form, fill in the fields.

FieldDescription
NameName of your provider application. For example: `VA SMS Twilio Adapter`
Provider attributes actionName of the provider attributes action script. The provider attributes action script can return a Provider auth token, a user identifier, user input, and context variables.
Response processor actionName of the response processor action script. The Response processor action script performs platform actions. For example, updating a message status based on the response received for an outbound message.
VersionThe version of the provider. The framework is able to send the expected inputs to actions and subflows and handle the expected outputs. There are 2 versions:- 1.0.0: The assumed version unless explicitly defined on the provider. - 1.1.0: The outbound_token input parameter (from the provider channel identity) was added to invocations of the sender subflow/action.
HTML to Image conversion requiredOption to convert an HTML bot response into an image and link. Used for chat interfaces that do not support HTML rendering.
Allow account linkingOption to link your account to an existing ServiceNow® profile.
ChannelChannel that this provider supports and the one to which the integration is being built.
Sender actionThe sender action script. The sender action script bundles the request and then sends the response via Workflow Studio or Integration Hub asynchronously.
Sender subflowThe sender subflow bundles the request and sends the response via Workflow Studio \(FD\) or Integration Hub \(IH\) asynchronously. ​
Contextual actionName of the contextual action script. The contextual action script supports custom contextual actions.
  1. Click Submit.
Image omitted: custom-chat-int.png
Custom chat integration.

What to do next

Set up message authentication for your custom chat configuration

Parent Topic:Create a Virtual Agent conversational custom chat integration