Skip to main content

AVA Customization - Configure Deployments, Layout, and Security in ConvyAI

Overview​

Customization defines how AVA is deployed and presented to end users. Each connector links AVA to a specific bot, applies visual branding, configures security restrictions, and generates the HTML snippet used to embed or access the instance.

Navigate to AVA → Customization.

Create a connector​

Click the + button. A form appears with three sections: base configuration, Layout, and Security.

Create connector form

Base configuration​

FieldDescription
NameA unique name for this connector.
BotThe ConvyAI bot to use for this AVA instance.
AVA interfaceThe AVA interface template to apply.
Custom URLAn optional custom URL path for accessing this AVA deployment.

Layout​

The Layout section controls the visual presentation and interaction options of this connector.

FieldDescription
Display nameThe name shown to users in the AVA interface.
Logo headerThe logo displayed in the AVA header.
Logo URLA URL pointing to the logo image to use.
Show text inputWhether to display the text input field for typed messages.
Show footerWhether to display the footer in the AVA interface.
TranslationsLanguage-specific overrides for interface labels, supporting multilingual deployments.

Quick actions​

Quick actions are preconfigured buttons that allow users to immediately trigger a specific flow, bypassing the conversational path. They are displayed both on the AVA entry page and on the side of the chat once the conversation has started.

FieldDescription
NameThe label displayed on the quick action button.
IconThe icon associated with the quick action.
FlowThe bot flow triggered when the user clicks the button.
VersionThe flow version to use.
HookThe entry hook within the flow where execution starts.

Security​

The Security section controls who can access this AVA deployment.

FieldDescription
Domain listA list of allowed domains from which AVA can be accessed. Restricts cross-origin access.
IP WhitelistingEnable to restrict access to AVA to specific IP addresses or ranges.

Generate the HTML snippet​

After saving the connector, click Generate HTML snippet to get the integration code for this AVA deployment.

A dialog appears with two options:

FieldOptionsDescription
LanguageItalian, English, CustomThe default language for the AVA interface. Select Custom to define a language code manually.
Inclusion modeURL, ScriptHow AVA is accessed or embedded.

URL mode generates a direct link to an AVA page hosted by ConvyAI. Share or link to this URL to give users access to AVA without embedding it.

Script mode generates a JavaScript snippet to include AVA on any web page. Add the snippet to your HTML before the closing </body> tag:

<script type="text/javascript"
src="https://<domain>/ava/static/ava/includeAVA_v1.js?rnd=<token>&connectorId=<id>&lang=<lang>">
</script>
ParameterDescription
rndRandom token for cache-busting.
connectorIdUnique identifier of the connector.
langLanguage code for the AVA interface (e.g., en, it).