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

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

  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.

    FieldDescription
    NameName of the authentication token, such as TwilioSMSTestAppAuthToken.
    DescriptionDescription of the authentication token, such as "Twilio SMS Testing application Auth Token."
    SecretAuthentication 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.

    FieldDescription
    NameName of the message authentication, such as VA Twilio SMS Test App Message Authentication.
    ProviderProvider, such as Twilio.
    Group nameName of the group or team of the provider channel.
    Service PortalOption to redirect users to a service portal for authentication during account linking.
    Inbound message verificationHash message token that was created.
    Outbound message creationHash message token that was created.
    Outbound service tokenToken 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

Parent Topic:Create a Virtual Agent conversational custom chat integration