---
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


---

# Configure a provider for your custom chat integration

# Configure a provider for your custom chat integration {#ariaid-title1}

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

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](https://www.servicenow.com/docs/Gkpkkp7Sarb_wcVdZg3rjg "Create a new channel or update an existing channel for your custom chat integration. Channels are defined in the Messaging Channels [sys_cs_channel] table.").

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 <kbd class="ph userinput">sys_cs_provider.list</kbd> in the filter.
2. On the Connections page, select New Custom.
3. On the form, fill in the fields.  
   {#create-provider-va-cccif__table_lpr_zvq_ktb__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of your provider application. For example: <kbd class="ph userinput">VA SMS Twilio Adapter</kbd> |
   | Provider attributes action | Name 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 action | Name 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. |
   | Version | The 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. {#create-provider-va-cccif__ul_mpr_zvq_ktb} |
   | HTML to Image conversion required | Option to convert an HTML bot response into an image and link. Used for chat interfaces that do not support HTML rendering. |
   | Allow account linking | Option to link your account to an existing ServiceNow® profile. |
   | Channel | Channel that this provider supports and the one to which the integration is being built. |
   | Sender action | The sender action script. The sender action script bundles the request and then sends the response via Workflow Studio or Integration Hub asynchronously. |
   | Sender subflow | The sender subflow bundles the request and sends the response via Workflow Studio (FD) or Integration Hub (IH) asynchronously. ​ |
   | Contextual action | Name of the contextual action script. The contextual action script supports custom contextual actions. |
   [ ]

   {#create-provider-va-cccif__table_lpr_zvq_ktb}
4. Click Submit.  

## What to do next

[Set up message authentication for your custom chat configuration](https://www.servicenow.com/docs/ev7we8aR~dPbysUbpiTutQ "Create a Hash Message Verification record and Message Auth record to set up message authentication for your custom chat integration. This is configured in the Hash Message Verifications [hash_message_verification] table.")

