Create a channel identifier for your custom chat integration

task brazil Updated Sep 10, 2026 1 min read create-channel-id-va-cccif.md

Create a channel identifier for your custom chat integration in the Provider Channel Identities [sys_cs_provider_application] table.

Before you begin

Set up message authentication for your custom chat configuration.

If you're using domain separation, change the scope to the domain you want to use before you create the channel identifier. The domain ID will be stored in the [sys_cs_provider_application] table and passed to the Virtual Agent server as a context parameter, which will set the domain for the user.

Role required: admin

Procedure

Navigate to All, and then enter sys_cs_provider_application.list in the filter.
On the Provider Channel Identities page, click New.

On the form, fill in the fields.


Name	Name of the channel identity. For example: `VA SMS Twilio Adapter`
Provider	Select the name of your provider application that you set up in a previous step. For example: `VA SMS Twilio Adapter Pro`.
Default Portal	Portal in which chat links to ServiceNow records are opened by default, including links in cards used for Virtual Agent notifications and AI Search results.
Message auth	Select message authentication for the channel identifier that you set up in a previous step.
Inbound ID	Identifier for your bot. For example, the phone number.
Short description	Description for your channel identifier.

Click Submit.
Follow these steps again to create additional channel identifiers.

What to do next

Map rich controls to the channel in your custom chat integration

53 lines · 2.7 KB Wrap lines

---
title: Create a channel identifier for your custom chat integration
description: Create a channel identifier for your custom chat integration in the Provider Channel Identities \[sys\_cs\_provider\_application\] table.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/conversational-interfaces/virtual-agent/create-channel-id-va-cccif.html
release: brazil
product: Virtual Agent
classification: virtual-agent
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Create conversational custom chat integration, Create custom chat integrations, Configure, Virtual Agent, Conversational Interfaces]
---

# Create a channel identifier for your custom chat integration

Create a channel identifier for your custom chat integration in the Provider Channel Identities \[sys\_cs\_provider\_application\] table.

## Before you begin

[Set up message authentication for your custom chat configuration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/set-up-msg-auth-va-cccif.md).

If you're using [domain separation](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/domain-separation-virtual-agent.md), change the scope to the domain you want to use before you create the channel identifier. The domain ID will be stored in the \[sys\_cs\_provider\_application\] table and passed to the Virtual Agent server as a context parameter, which will set the domain for the user.

Role required: admin

## Procedure

1.  Navigate to **All**, and then enter `sys_cs_provider_application.list` in the filter.

2.  On the Provider Channel Identities page, click **New**.

3.  On the form, fill in the fields.

    | | |
    |---|---|
    |Name|Name of the channel identity. For example: `VA SMS Twilio Adapter`|
    |Provider|Select the name of your provider application that you set up in a previous step. For example: `VA SMS Twilio Adapter Pro`.|
    |Default Portal|Portal in which chat links to ServiceNow records are opened by default, including links in cards used for Virtual Agent notifications and AI Search results.|
    |Message auth|Select message authentication for the channel identifier that you set up in a previous step.|
    |Inbound ID|Identifier for your bot. For example, the phone number.|
    |Short description|Description for your channel identifier.|

4.  Click **Submit**.

5.  Follow these steps again to create additional channel identifiers.


## What to do next

[Map rich controls to the channel in your custom chat integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/map-rich-controls-va-cccif.md)