Set up message authentication for your custom chat configuration
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.
Before you begin
Configure a provider for your custom chat integration.
Role required: admin
About this task
You can create a Hash Message Verification record and Message Auth record to set up message authentication.
Procedure
-
Navigate to All, and then enter
hash_message_verification.listin the filter. -
On the Hash Message Verifications page, click New.
-
On the form, fill in the fields.
Field Description Name Name of the authentication token, such as TwilioSMSTestAppAuthToken. Description Description of the authentication token, such as "Twilio SMS Testing application Auth Token." Secret Authentication token (random string). -
Click Submit.
-
Navigate to All, and then enter
message_auth.listin the filter. -
On the Message Auths page, click New.
-
On the form, fill in the fields.
Field Description Name Name of the message authentication, such as VA Twilio SMS Test App Message Authentication. Provider Provider, such as Twilio. Group name Name of the group or team of the provider channel. Service Portal Option to redirect users to a service portal for authentication during account linking. Inbound message verification Hash message token that was created. Outbound message creation Hash message token that was created. Outbound service token Token passed to the sender subflow that is used to invoke REST endpoint for the chat client. Use the outbound token to send a message using the REST API. -
Click Submit.
What to do next
Create a channel identifier for your custom chat integration
---
title: Set up message authentication for your custom chat configuration
description: 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.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/conversational-interfaces/virtual-agent/set-up-msg-auth-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]
---
# Set up message authentication for your custom chat configuration
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.
## Before you begin
[Configure a provider for your custom chat integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/create-provider-va-cccif.md).
Role required: admin
## About this task
You can create a Hash Message Verification record and Message Auth record to set up message authentication.
## Procedure
1. Navigate to **All**, and then enter `hash_message_verification.list` in the filter.
2. On the Hash Message Verifications page, click **New**.
3. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Name of the authentication token, such as TwilioSMSTestAppAuthToken.|
|Description|Description of the authentication token, such as "Twilio SMS Testing application Auth Token."|
|Secret|Authentication token \(random string\).|
4. Click **Submit**.
5. Navigate to **All**, and then enter `message_auth.list` in the filter.
6. On the Message Auths page, click **New**.
7. On the form, fill in the fields.
|Field|Description|
|-----|-----------|
|Name|Name of the message authentication, such as VA Twilio SMS Test App Message Authentication.|
|Provider|Provider, such as Twilio.|
|Group name|Name of the group or team of the provider channel.|
|Service Portal|Option to redirect users to a service portal for authentication during account linking.|
|Inbound message verification|Hash message token that was created.|
|Outbound message creation|Hash message token that was created.|
|Outbound service token|Token passed to the sender subflow that is used to invoke REST endpoint for the chat client. Use the outbound token to send a message using the REST API.|
8. Click **Submit**.
## What to do next
[Create a channel identifier for your custom chat integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/conversational-interfaces/virtual-agent/create-channel-id-va-cccif.md)
| title | Set up message authentication for your custom chat configuration |
| description | 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. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/conversational-interfaces/virtual-agent/set-up-msg-auth-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 integrationCreate custom chat integrationsConfigureVirtual AgentConversational Interfaces |