Messengers

line
Line messenger

⁠
⁠
is an application for smartphones and PCs, that supports text messaging, audio and video calls, file transfer.

Connection

1. Creating a bot on the Line side

Set up a channel on the Line side and get a token using the instructions: ⁠

2. Agent Channel Configuration on the Platform

You need to create and configure a
@End Channel
⁠
with a Line 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 Line Messenger.
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 Line channel token field. ​
image.png
⁠
⁠
Paste the webhook from the Chatbot webhook URL field in the Line settings.
You can copy the webhook by clicking the Copy this webhook button. ​
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 Line channel 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 Line channel 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 Line channel 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

To start communicating with the bot, you need to add it as a friend.
It is possible to add the bot to groups/rooms.
Service messages in Line
5
Message
End channel
Format in client_message
1
User added Bot as a friend
Line messenger
line_user_followed: used_id
2
User deleted Bot
Line messenger
line_user_unfollowed: used_id
3
Bot was added in a group
Line messenger
line_group_joined: used_id
4
Bot was deleted from a group
Line messenger
line_group_left: used_id
5
Bot was added in a room
Line messenger
line_room_joined: used_id
6
Bot was deleted from a room
Line messenger
line_room_left: used_id
7
User joined a group
Line messenger
line_member_joined: used_id
8
User left a group
Line messenger
line_member_left: used_id
No results from filter
⁠
More information about service messages and how to activate their transmission from the
@End Channel
⁠
:
Mapping of Channel variables from Line
18
Channel variable
End channel
Variable in the body of an incoming request from a channel
Peculiarities
1
channel_visitor_id
Line messenger
user_id
​
2
channel_conversation_id
Line messenger
user_id / room_id / group_id
​
3
channel_visitor_firstname
Line messenger
No
​
4
channel_visitor_lastname
Line messenger
No
​
5
channel_visitor_account
Line messenger
No
​
6
channel_visitor_phone
Line messenger
No
​
7
channel_visitor_email
Line messenger
No
​
8
channel_visitor_source
Line messenger
No
​
9
channel_visitor_auth
Line messenger
No
​
10
channel_visitor_location
Line messenger
No
​
11
channel_message_id
Line messenger
No
​
12
channel_message_recipient
Line messenger
No
​
13
channel_webhook_url
Line messenger
No
​
14
channel_webhook_token
Line messenger
No
​
15
channel_service_data
Line messenger
No
​
16
channel_reply_to
Line messenger
no
​
No results from filter
⁠

Communication in Line
20
Functionality
Channel
Availability
Description
1
channel_chat_id
Line messenger
Yes
Format: chat_type::{user_id / room_id / group_id}
2
Messages will reach the Bot User if the Agent writes first in an existing chat
Line messenger
Yes
​
3
Buttons
Line messenger
Yes
​
4
Transfer to operator
Line messenger
No
​
5
Transferring files as files from the Agent
Line messenger
No
​
6
Transferring files as links from the Agent
Line messenger
Yes
​
7
Receiving a file from the Bot User into a script
Line messenger
Yes
​
8
Receiving geolocation from an Bot User in a Script
Line messenger
Yes
Format: location: coordinates|address
9
Delivery of messages over 1000 characters from Agent to Bot User
Line messenger
Yes
Format: type|file id|link to the file
10
Get a link to the lead source
Line messenger
No
​
11
Markdown usage
Line messenger
No
​
12
Mailing with Notification
Line messenger
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.