Graphlogic.ai documentation

Messengers

Widget

The

@Platform⁠

has the ability to connect the

@Bot⁠

to a customized widget and display it on your website. The widget is created similarly to other

@Project Channel⁠

Connection

Widget Configuration on the Platform

You need to create and configure a

@End Channel⁠

with a

@Widget⁠

connector.

Click on the agent settings button.

⁠

Click the Add channel button.

⁠

The

@End Channel⁠

selection panel will open. Select

@Widget⁠

⁠

The

@Project Channel⁠

creation panel will open.

⁠

On the Settings tab:

Optionally, enter a title for this

@Project Channel⁠

in the Name field with the placeholder New channel.

⁠

Optionally, add domains where the widget will be available in the Domain field.

⁠

If you specify a domain, the widget will not work on other domains. This will save you from theft of the widget if the site data is compromised.

You can specify either the domain itself or the pattern in the format *.domain.com. In this case, the widget will work on all subdomains of domain.com.

You will need the snippet in the Snippet field to

install the widget on your website⁠

. You can copy it by pressing the COPY WIDGET CODE button.

⁠

Go to the Design tab.

⁠

Enter a name for your

@Bot⁠

in the Bot name field

⁠

Enter a title for the widget in the Widget title field

⁠

Specify the widget color in the Widget color field. Widget color can be set in two ways:

HEX-code, for example #ADFF2F;

⁠

the name of the color.

⁠

Optionally, add a picture for the widget in the Company Logo field. If you don’t add a picture the widget will be displayed with a default image.

⁠

If necessary, specify a placeholder hint in the Placeholder in the expanded widget field. If you do not specify a hint, the text “Type a message” will be automatically inserted in the input field.

⁠

If necessary, add a welcome message from the

@Bot⁠

. To do this, toggle the Send welcome message on widget expanded switch and enter the message in the Bot's welcome message field.

⁠

To save the

@Project Channel⁠

without activating it, click the CREATE button.

⁠

To save and activate the

@Project Channel⁠

, click the CREATE & ACTIVATE button.

⁠

The

@Project Channel⁠

will be saved and activated if the

@Agent⁠

is trained;

If the

@Agent⁠

is not trained the

@Project Channel⁠

will be saved but not activated.

To cancel

@Project Channel⁠

creation, click the CANCEL button.

⁠

Installing the Widget on Your Website

To install the widget on your website,

copy the snippet⁠

and paste it into the <body> in your code.

⁠

Activate⁠

the

@Project Channel⁠

if it is not already activated.

After that, the widget will appear on your website.

⁠

Editing and Deleting Agent Channel

To edit an

@Project Channel⁠

, click on its icon on the

@Agent⁠

card.

⁠

To edit any field, click the field and enter a new value.

To apply changes to an activated

@Project Channel⁠

, click the APPLY button.

⁠

To deactivate the

@Project Channel⁠

, click the DEACTIVATE button.

⁠

To apply changes to a non-activated

@Project Channel⁠

, click the SAVE button.

⁠

To apply changes and activate the

@Project Channel⁠

, click the SAVE & ACTIVATE button.

⁠

Changes will be applied and the

@Project Channel⁠

will be activated if the

@Agent⁠

is trained;

If the

@Agent⁠

is not trained the

@Project Channel⁠

will be saved but not activated.

To cancel making changes, click the CANCEL button.

⁠

To delete the

@Project Channel⁠

, click the DELETE button.

⁠

Communication

Mapping of Channel variables from widget

Mapping  of Channel variables from widget

Channel variable

End channel

Variable in the body of an incoming request from a channel

Peculiarities

channel_visitor_id

Widget

a string generated by

@Platform

⁠

@channel_visitor_id

⁠

equals

@channel_chat_id

⁠

channel_visitor_firstname

Widget

channel_visitor_lastname

Widget

channel_visitor_phone

Widget

channel_visitor_email

Widget

channel_visitor_account

Widget

channel_visitor_auth

Widget

channel_visitor_source

Widget

a link to the page where the widget is embedded

channel_reply_to

Widget

No results from filter

⁠

Communication in widget

Communication in widget

Functionality

Channel

Availability

Description

channel_chat_id

Widget

Yes

a string generated by

@Platform

⁠

@channel_visitor_id

⁠

equals

@channel_chat_id

⁠

Messages will reach the Bot User if the Agent writes first in an existing chat

Widget

Yes

Buttons

Widget

Yes

Transfer to operator

Widget

Transferring files as files from the Agent

Widget

Transferring files as links from the Agent

Widget

Yes

Receiving a file from the Bot User into a script

Widget

Receiving geolocation from an Bot User in a Script

Widget

Delivery of messages over 1000 characters from Agent to Bot User

Widget

Yes

Markdown usage

Widget

Mailing with Notification

Widget

Get a link to the lead source

Widget

Yes

⁠

@channel_visitor_source

⁠

contains a link to the page where the widget is embedded

No results from filter

⁠

Connection

Widget Configuration on the Platform

Installing the Widget on Your Website

Editing and Deleting Agent Channel

Communication

Mapping of Channel variables from widget

Communication in widget

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.