Fullscreen AI Chatbot

Much like the AI Assistant on your Umbria-made documentation, this embeddable AI Chatbot uses information from your docs to answer your users questions. You can customize how it looks and how it is triggered by your user from within your product.

It displays as a modal and takes up the full screen in your product.

Image alt text
Image alt text

Installation Code

Insert the script below into the head of your product's index.html file.

Script to Insert

Inserted Script in index.html

Fullscreen AI Chatbot Script

html
                  

Mount Properties

These are the properties you pass in when mounting your Umbria component as shown above. They are used to initialize and stylize your Umbria component. 

Required Properties

Property

Description

Data Type

siteId

The id of the site you wish your chatbot to pull answers from; can be found in your Site Settings

string

hotkey

Key(s) to press to trigger chatbot

TKeyCombo

TKeyCombo

This data type specifies a hotkey combination. An example for the hotkey Ctrl + c is provided below.

      
Style Properties (Optional)

These optional properties allow you to customize the Fullscreen AI Chatbot including changes to theme colors, wording, and size.

Property

Description

Data Type

Default

zIndex

Control the stacking order of the chatbot on the webpage

number

9999

width

Width of the chatbot

number

500

height

Height of the chatbot

number

500

title

Title found at the top of the chatbot

string

'AI Documentation Assistant'

initialPrompt

The initial message from the chatbot to the user

string

'Hello, how can I help you?'

searchPlaceholder

The message that is a placeholder in the search bar

string

'What do you need?'

searchButtonIconColor

The color of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#FFFFFF'

searchButtonIconBackgroundColor

The color of the background of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#000000'

entryIconColor

The color of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

entryIconBorderColor

The color of the border of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

titleColor

The color of the title found at the top of the chatbot

string: can be entered as rgb or hex

'#000000'

Event Functions

You can use Event Functions to trigger restyle or control your chatbot from your code.

Open Chatbot

The open-chatbot event function can be invoked to make this chatbot appear.

For example, this function can be called when clicking an icon or button to trigger this chatbot.

file.tsx

java
 
Update Chatbot

The update-chatbot event function can be invoked to restyle the chatbot programmatically. This event function takes any subset of the style parameters above.

For example, this function can be called to restyle the chatbot for light-mode or dark-mode programmatically or to customize the title of the chatbot to use your user.

file.tsx

java
 

Full Example

In the example below, we mount the chatbot-fullscreen component to our site 6642969d49cf72081e666240, configure it to be opened with the hotkey ctrl + alt + 2, stylize the width to be 800, stylize the height to be 600, and set the title to be AI Docs Chatbot

Fullscreen AI Chatbot Script with Customization

java
                      
Last Updated On 2024-05-13
Was this page helpful?
Last Updated On 2024-05-13
Was this page helpful?

Fullscreen AI Chatbot

Much like the AI Assistant on your Umbria-made documentation, this embeddable AI Chatbot uses information from your docs to answer your users questions. You can customize how it looks and how it is triggered by your user from within your product.

It displays as a modal and takes up the full screen in your product.

Image alt text
Image alt text

Installation Code

Insert the script below into the head of your product's index.html file.

Script to Insert

Inserted Script in index.html

Fullscreen AI Chatbot Script

html
                  

Mount Properties

These are the properties you pass in when mounting your Umbria component as shown above. They are used to initialize and stylize your Umbria component. 

Required Properties

Property

Description

Data Type

siteId

The id of the site you wish your chatbot to pull answers from; can be found in your Site Settings

string

hotkey

Key(s) to press to trigger chatbot

TKeyCombo

TKeyCombo

This data type specifies a hotkey combination. An example for the hotkey Ctrl + c is provided below.

      
Style Properties (Optional)

These optional properties allow you to customize the Fullscreen AI Chatbot including changes to theme colors, wording, and size.

Property

Description

Data Type

Default

zIndex

Control the stacking order of the chatbot on the webpage

number

9999

width

Width of the chatbot

number

500

height

Height of the chatbot

number

500

title

Title found at the top of the chatbot

string

'AI Documentation Assistant'

initialPrompt

The initial message from the chatbot to the user

string

'Hello, how can I help you?'

searchPlaceholder

The message that is a placeholder in the search bar

string

'What do you need?'

searchButtonIconColor

The color of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#FFFFFF'

searchButtonIconBackgroundColor

The color of the background of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#000000'

entryIconColor

The color of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

entryIconBorderColor

The color of the border of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

titleColor

The color of the title found at the top of the chatbot

string: can be entered as rgb or hex

'#000000'

Event Functions

You can use Event Functions to trigger restyle or control your chatbot from your code.

Open Chatbot

The open-chatbot event function can be invoked to make this chatbot appear.

For example, this function can be called when clicking an icon or button to trigger this chatbot.

file.tsx

java
 
Update Chatbot

The update-chatbot event function can be invoked to restyle the chatbot programmatically. This event function takes any subset of the style parameters above.

For example, this function can be called to restyle the chatbot for light-mode or dark-mode programmatically or to customize the title of the chatbot to use your user.

file.tsx

java
 

Full Example

In the example below, we mount the chatbot-fullscreen component to our site 6642969d49cf72081e666240, configure it to be opened with the hotkey ctrl + alt + 2, stylize the width to be 800, stylize the height to be 600, and set the title to be AI Docs Chatbot

Fullscreen AI Chatbot Script with Customization

java
                      
Last Updated On 2024-05-13}
Was this page helpful?
Last Updated On 2024-05-13}
Was this page helpful?

Fullscreen AI Chatbot

Much like the AI Assistant on your Umbria-made documentation, this embeddable AI Chatbot uses information from your docs to answer your users questions. You can customize how it looks and how it is triggered by your user from within your product.

It displays as a modal and takes up the full screen in your product.

Image alt text
Image alt text

Installation Code

Insert the script below into the head of your product's index.html file.

Script to Insert

Inserted Script in index.html

Fullscreen AI Chatbot Script

html
                  

Mount Properties

These are the properties you pass in when mounting your Umbria component as shown above. They are used to initialize and stylize your Umbria component. 

Required Properties

Property

Description

Data Type

siteId

The id of the site you wish your chatbot to pull answers from; can be found in your Site Settings

string

hotkey

Key(s) to press to trigger chatbot

TKeyCombo

TKeyCombo

This data type specifies a hotkey combination. An example for the hotkey Ctrl + c is provided below.

      
Style Properties (Optional)

These optional properties allow you to customize the Fullscreen AI Chatbot including changes to theme colors, wording, and size.

Property

Description

Data Type

Default

zIndex

Control the stacking order of the chatbot on the webpage

number

9999

width

Width of the chatbot

number

500

height

Height of the chatbot

number

500

title

Title found at the top of the chatbot

string

'AI Documentation Assistant'

initialPrompt

The initial message from the chatbot to the user

string

'Hello, how can I help you?'

searchPlaceholder

The message that is a placeholder in the search bar

string

'What do you need?'

searchButtonIconColor

The color of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#FFFFFF'

searchButtonIconBackgroundColor

The color of the background of the magnifying glass icon found to the right of the search bar

string: can be entered as rgb or hex

'#000000'

entryIconColor

The color of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

entryIconBorderColor

The color of the border of the sparkle icon in the main section of the chatbot

string: can be entered as rgb or hex

'#000000'

titleColor

The color of the title found at the top of the chatbot

string: can be entered as rgb or hex

'#000000'

Event Functions

You can use Event Functions to trigger restyle or control your chatbot from your code.

Open Chatbot

The open-chatbot event function can be invoked to make this chatbot appear.

For example, this function can be called when clicking an icon or button to trigger this chatbot.

file.tsx

java
 
Update Chatbot

The update-chatbot event function can be invoked to restyle the chatbot programmatically. This event function takes any subset of the style parameters above.

For example, this function can be called to restyle the chatbot for light-mode or dark-mode programmatically or to customize the title of the chatbot to use your user.

file.tsx

java
 

Full Example

In the example below, we mount the chatbot-fullscreen component to our site 6642969d49cf72081e666240, configure it to be opened with the hotkey ctrl + alt + 2, stylize the width to be 800, stylize the height to be 600, and set the title to be AI Docs Chatbot

Fullscreen AI Chatbot Script with Customization

java
                      
Last Updated On 2024-05-13
Was this page helpful?
Last Updated On 2024-05-13
Was this page helpful?
ON THIS PAGE
Fullscreen AI Chatbot
Installation Code
Mount Properties
Required Properties
TKeyCombo
Style Properties (Optional)
Event Functions
Open Chatbot
Update Chatbot
Full Example
Back to top