Omnichannel platforms

icon picker
Bitrix24

Bitrix24 is one of the omnichannel platforms for communicating with customers in text channels. Using the Bitrix24 omnichannel platform, you can place your
@Bot
⁠
in one or more communication channels.

Connection

1. Bot configuration on Bitrix24 side

First of all, you need to connect communication channels to Bitrix24.
Log in to Bitrix24 in your work space.
Provide Graphlogic.ai support with the domain name of your work space in which you want to display a
@Bot
⁠
. In order to find out the domain name, open the page in Bitrix24 where your space is located, select and copy part of the URL as indicated below. ​
image.png
⁠
⁠
Receive a generated link from Graphlogic.ai support to install the application.
Follow the link and install the application. ​
image.png
⁠
⁠
Configure the agent channel on the platform so that it begins to appear in the line settings.
After activating the agent channel on the platform, go to the Contact Center section. ​
image.png
⁠
⁠
Create an open line in the channel you need (for example, Telegram). ​
image.png
⁠
​
image.png
⁠
⁠
Go to the settings of the created line. ​
image.png
⁠
⁠
Go to the Chatbots section. ​
image.png
⁠
⁠
Assign the
@Bot
⁠
to be responsible when a client contacts you. ​
image.png
⁠
​
image.png
⁠
⁠
Save your settings. ​
image.png
⁠
⁠

2. Agent channel configuration in the Platform

The
@Agent
⁠
needs to create and configure an
@Project Channel
⁠
with the “Bitrix 24” 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
@Bitrix24
⁠
.
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
⁠
⁠
Paste the into the Bitrix24 workspace domain field. ​
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 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 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 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

Mapping of Channel variables from Bitrix24
18
Channel variable
End channel
Variable in the body of an incoming request from a channel
Peculiarities
1
channel_visitor_id
Bitrix24
no
​
2
channel_conversation_id
Bitrix24
no
​
3
channel_visitor_firstname
Bitrix24
visitor_first_name
​
4
channel_visitor_lastname
Bitrix24
visitor_last_name
​
5
channel_visitor_account
Bitrix24
no
​
6
channel_visitor_phone
Bitrix24
no
​
7
channel_visitor_email
Bitrix24
no
​
8
channel_visitor_source
Bitrix24
no
​
9
channel_visitor_auth
Bitrix24
no
​
10
channel_visitor_location
Bitrix24
no
​
11
channel_message_id
Bitrix24
no
​
12
channel_message_recipient
Bitrix24
no
​
13
channel_reply_to
Bitrix24
no
​
No results from filter
⁠
Communication in Bitrix24
20
Functionality
Channel
Availability
Description
1
channel_chat_id
Bitrix24
Yes
Format: <workspace-name>.bitrix24.ru:128:chat106|bitrix24-open-channels
2
Messages will reach the Bot User if the Agent writes first in an existing chat
Bitrix24
Yes
​
3
Buttons
Bitrix24
No
Buttons are displayed as a list:
Type a button value:
1: Button 1
2: Button 2
4
Transfer to operator
Bitrix24
Yes
Via
@External Request
⁠
5
Transferring files as files from the Agent
Bitrix24
Yes
​
6
Transferring files as links from the Agent
Bitrix24
Yes
​
7
Receiving a file from the Bot User into a script
Bitrix24
Yes
​
8
Receiving geolocation from an Bot User in a Script
Bitrix24
No
​
9
Delivery of messages over 1000 characters from Agent to Bot User
Bitrix24
Yes
​
10
Get a link to the lead source
Bitrix24
No
​
11
Markdown usage
Bitrix24
No
​
12
Mailing with Notification
Bitrix24
No
​
No results from filter
⁠

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.