How can you send/receive Line Messages from XCALLY?

Image result for icon line messenger

XCALLY Motion Open Channel offers the integration of Line messenger as a New Channel, allowing:

the Customers to interact with your Agents sending direct messages to your Line Official Account;

your Agents to receive the incoming messages on a special Line Queue and to reply from the XCALLY Motion standard GUI;

the Customers to receive the messages back on Line messenger.

Compatibility

The minimum required version of XCALLY Motion is 2.0.69

The integration allows you to exchange text or attachments. To send both text and attachments, you must send more messages

On this page:

Setup Open Channel Account

Below you can find the steps to create an Open Channel Account and an Open Channel Queue:

Create a new Open Channel Account in your XCALLY Motion in the Open Channel Section:

The Reply URL should be http://localhost:3008/sendMessage

Complete the Open Channel account configuration (Disposition, Action, etc)

Don't forget to select line as the mapKey and add the proper Agents to your account.

Create a new Open Channel Queue and then Add Agents to it as well;

Open Channel

For more info on this step please refer to the Configure a new OpenChannel account section of documentation.

Setup Line Account

Below you can find the steps to create a LINE account and enable integration with XCALLY Motion:

Create LINE Business ID (https://account.line.biz/login?redirectUri=https%3A%2F%2Fmanager.line.biz%2F)
Create LINE Official account (https://manager.line.biz/)
Add new LINE channel (https://developers.line.biz/en/docs/liff/getting-started/)

Add new LINE channel

In details:

Create new provider

Create Messaging API channel

Fill the mandatory fields and agree the Terms of Use

Open channel configuration to:
- Copy Channel secret value
- Issue and copy the Channel access token from Messaging settings
- Enable Webhooks from Messaging settings
- Add Webhook URL from Messaging settings

The webhook URL should follow the format: https://{HOSTNAME}/api/plugins/webhook?port={PORT}&path=/api/messages&token={TOKEN}

where {HOSTNAME} is usually your XCALLY hostname or IP address, or the hostname of another server in case you would like to host your integration/application separately.
{PORT} is usually 3008, or the specific port you have defined in your Line Plugin settings inside XCALLY Motion.
{TOKEN} is the Open Channel Account token

Make sure that Greeting message and Auto-response are disabled

About Line

For more information about Line Messaging API go to: https://developers.line.me/en/docs/messaging-api/getting-started/

The public visibility of your Line official account is dependent on the type of Line@ subscription. Please consult Line documentation for more details. Alternatively, its also possible to share the QR code of your channel to provide users the possibility to add your Line official account as friend.

Installing the Plugin to XCALLY Motion

Download the Line Plugin:

https://repository.xenialab.com/repository/plugins-legacy/line-plugin/line-plugin-v1.2.1.zip

Login as admin in XCALLY Motion, upload the Line Plugin and Install it

After the installation, it should be visible in the list of plugins:

and also in the list of Plugins on sidebar:

Setup Line Plugin

Configure the Plugin for Line by selecting Line messenger from the list of Plugins (in sidebar) and
- Insert Channel Secret (as obtained in previous steps)
- Insert Channel access token (obtained in previous steps)
- Select your Open Channel account from the list (as created in the previous step)
- Insert the Username and Password for XCALLY Admin user

After saving the changes, Reload the Plugin from: App Zone > Plugins > Line messenger (3 dots menu) > Restart Plugin

You are ready!

Additional Information

Configuring your firewall

If your XCALLY service is hosted behind a firewall then please make sure that the HTTPS port is able to accept incoming requests from LINE webhook server.

A few suggestions in this regard:

Try to find the IP address for LINE server, that is sending webhook requests to XCALLY, using your preferable network analysis tool.
Add the rule to allow incoming traffic from Line's IP address, on Port 443, in your firewall policy.

-- OR --

Modify the file /etc/sysconfig/iptables and add the following line:

-A INPUT -s 0.0.0.0/0 -p tcp --dport 443 -j ACCEPT

Disclaimer: This method will open port 443 of your XCALLY server for all IP addresses.

Debugging/Troubleshooting

All of the log files for Line Messenger plugin events are available at /var/log/xcally/ directory under openchannel-line- naming convention.