Omnichannel platforms

icon picker
Edna Chat Center

is one of the omnichannel platforms for communicating with customers in text channels. You can use it as a channel to publish your
@Project
as a bot operator. You can view the user documentation using this
.
Important: The
@Bot
is connected to communication channels through Edna technical support.


Connection

1. Bot configuration on Edna side

First of all, you need to configure the Edna side.
Log in to Edna as an administrator.
Go to Settings → Chatbot.
image.png
Create a new
@Bot
and fill in the following fields:
Chatbot name — any convenient name.
URL of the chatbot backend for processing client messages — URL obtained when
URL of the chatbot backend for initiating a dialogue with the client — URL received when
Waiting timeout for a chatbot response — the time when there is no response from the
@Bot
, after which the request is distributed in accordance with the following rule specified in the routing.
image.png
Create a token using the +Token button and write it down. You will need it when . This button appears when you hover over the field with the name and settings of the desired application.
image.png
This completes the
@Bot
configuration in Edna.

2. Agent channel configuration in the Platform

You need to create and configure an
@Project Channel
with the “Edna Chat Center”
@Connector
.
Click on the agent settings button. ​
image.png
Click the Add channel button. ​
image.png
The
@End Channel
selection panel will open. ​
image.png
Select
@Edna Chat Center
.
The
@Project Channel
creation panel will open. ​
image.png
Optionally, enter a title for this
@Project Channel
in the Name field with the placeholder New channel. ​
image.png
Enter the address for your account in the Edna Chat Center webhook URL field as https://<some-name>.<edna-domen>/api/v1/chatbot, where <some-name> is the subdomain of your Edna account, and <edna-domen> is the Edna domain name (threads.im or edna.io). ​
image.png
Set the token obtained in the Edna Chat Center bot settings in the Edna Chat Center token field. ​
image.png
Copy the URL from the Chatbot webhook URL field by clicking the Copy this webhook button and paste it into the URL of the chatbot backend for processing client messages and URL of the chatbot backend for initiating a dialogue with the client fields in the bot settings in Edna Chat Center. ​
image.png
Optionally, enable receiving of service messages by switching the toggle switch. ​
image.png
To save the
@Project Channel
without activating it, click the CREATE button. ​
image.png
To save and activate the
@Project Channel
, click the CREATE & ACTIVATE button. ​
image.png
The
@Project Channel
will be saved and activated if:
The
@Agent
is trained;
The token in the Edna Chat Center token field is unique (there are no active channels of the same type with the same token);
The channel address is accessible;
The channel webhook is registered succesfully.
The
@Project Channel
will be saved but not activated if one or more conditions are not met.
To cancel
@Project Channel
creation, click the CANCEL button. ​
image.png

Editing and Deleting Agent Channel

To edit an
@Project Channel
, click on its icon on the
@Agent
card. ​
image.png
To edit any field, click the field and enter a new value.
To apply changes to an activated
@Project Channel
, click the APPLY button. ​
image.png
Changes will be applied if:
The
@Agent
is trained;
The token in the Edna Chat Center token field is unique (there are no active channels of the same type with the same token);
The channel address is accessible;
The channel webhook is registered succesfully.
Changes will not be applied if one or more conditions are not met.
To deactivate the
@Project Channel
, click the DEACTIVATE button. ​
image.png
To apply changes to a non-activated
@Project Channel
, click the SAVE button. ​
image.png
To apply changes and activate the
@Project Channel
, click the SAVE & ACTIVATE button. ​
image.png
Changes will be applied and the
@Project Channel
will be activated if:
The
@Agent
is trained;
The token in the Edna Chat Center token field is unique (there are no active channels of the same type with the same token);
The channel address is accessible;
The channel webhook can be registered.
Changes will be applied but the
@Project Channel
will not be activated if one or more conditions are not met.
To cancel making changes, click the CANCEL button. ​
image.png
To delete the
@Project Channel
, click the DELETE button. ​
image.png

Communication

Interaction with Edna occurs through the Edna external API and according to the settings of your Edna account.
@Agent
is a bot operator in Edna.
Important: Edna cannot guarantee the order of delivery of messages to the
@Bot User
: if the interval of their receipt from the
@Agent
is very small, in order to eliminate this negative behavior, a delay of 0.5 seconds has been introduced on the
@Connector
between sending messages.
Mapping of Channel variables from Edna chat center
18
Channel variable
End channel
Variable in the body of an incoming request from a channel
Peculiarities
1
channel_visitor_id
Edna Chat Center
threadsClientId
2
channel_conversation_id
Edna Chat Center
sessionId
3
channel_visitor_firstname
Edna Chat Center
client_data.name
4
channel_visitor_lastname
Edna Chat Center
No
5
channel_visitor_phone
Edna Chat Center
client_data.phone
After sending a mailing by
@Notification
, this variable contains the phone number to which the mailing was sent
6
channel_visitor_email
Edna Chat Center
client_data.email
7
channel_visitor_account
Edna Chat Center
channel_info.channelType
8
channel_visitor_auth
Edna Chat Center
No
9
channel_visitor_source
Edna Chat Center
No
10
channel_reply_to
Edna Chat Center
no
No results from filter
Communication in Edna chat center
20
Functionality
Channel
Availability
Description
1
Buttons
Edna Chat Center
Yes
The maximum length of button text is 20 characters. If the length exceeds 20 characters, the
@Script
freezes. You can increase the limit through Edna technical support.
2
Transfer to operator
Edna Chat Center
Yes
To transfer the dialogue to the operator, use the
@Change Chat Mode
slot.
3
Transferring files as files from the Agent
Edna Chat Center
No
4
Transferring files as links from the Agent
Edna Chat Center
Yes
5
Receiving a file from the Bot User into a script
Edna Chat Center
Partially
Depends on the channel, the Edna widget does not accept files. File metadata (type, link) is written to client_message, the file is not uploaded to the platform
6
Receiving geolocation from an Bot User in a Script
Edna Chat Center
No
7
Delivery of messages over 1000 characters from Agent to Bot User
Edna Chat Center
Yes
Delivery of messages up to 4000 characters
8
Markdown usage
Edna Chat Center
Partially
Supported in widget. Displaying
@Markdown
text in other channels is not supported.
The following markup types are supported:
*italics*
_italics_
__bold font__
*__bold italics__*
[link](http://www.example.com/)
`inline code`
9
Mailing with Notification
Edna Chat Center
No
No results from filter
Service messages from Edna chat center
5
Message
End channel
Format in client_message
Description
Cases
1
Opening the Edna Chat Center widget
Edna Chat Center
String: edna: chat initialized
When the Edna widget is opened on a web page, the message ‘edna: chat initialized’ is sent to the
@client_message
variable.
The bot can respond to opening a widget on a web page with a welcome message
No results from filter
About service messages and how to activate their transmission from the
@End Channel
:

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.