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

Map rich controls to the channel in your custom chat integration

Create records for rich controls in the Custom Adapter Configurations [sys_cs_custom_adapter_config] table. If a rich control is missing an outbound transformer implementation, a response is not served to the end user and that user may get an unsatisfactory chat experience.

Before you begin

Create a channel identifier for your custom chat integration.

Role required: admin

About this task

You must create a mapping for any rich controls your conversations will use in the channel. For example, you may need a mapping for DefaultText, which supports input and output text response, along with file upload and image response. If your channel doesn't support a control, then you won't need to map it. For example, SMS doesn't support video responses. For a description of each default rich control, see Default input and output rich controls for a custom chat integration.

Procedure

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

  2. On the Custom Adapter Configurations page, click New.

  3. On the form, fill in the fields.

FieldDescription
ProviderProvider that you created.
Control typeDefault rich control type.For example, the DefaultPicker rich control type maps to File Picker, Topic Picker, and Boolean controls. For more information about the types of controls, see Default input and output rich controls for a custom chat integration.
Inbound transformer actionName of the inbound transformer action script for this rich control. For example: `sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer`
Outbound transformation actionName of the outbound transformer action script for this rich control. For example: `sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer`
  1. Click Submit.

What to do next

Create and configure a scripted REST API for your custom chat integration

Parent Topic:Create a Virtual Agent conversational custom chat integration