1. Register to Line by downloading the app for your phone on your app store

2. Create your own developer account from https://account.line.biz/login?redirectUri=https%3A%2F%2Fdevelopers.line.biz%2Fconsole%2F

3. Create a provider and a channel, following this guide

4. From Messaging settings, enable Webhooks and add Webhook URL

5. Line plugin needs a long lived channel access token. Retrieve the Channel access token and secret from your channel configuration page.

6. Save the Access Token and the Channel Secret. They will be required later during the Line plugin configuration.

3. Fill the below fields:

• Name: choose a name for your Line Account

• Key: enter a specif key (it must different for each channel)

• Reply URL: http://localhost:3008/api/from-motion-to-line, where 3008 must be replaced with the port used for the plugin. This URL is going to be used by Open Channel to answer to the interactions.

• List: Choose the List where the new contacts will be saved in the Contacts Manager. If a contact is already present in the List, the new interaction will be associated and reported in the Customer Journey. 

• Description: (Optional) Describe to which bot the channel is associate.

4. Click Add Open Channel Account

5. Find the Line Account, that you have just created, in the list of Openchannel Accounts

6. Click on the three dots button next to the Line account and select Edit Open Channel account.

On the top of the screen, you can see the ID Account (the number that follows the # ).

7. Save the Open Channel Account ID – This will be required later during the Line plugin configuration.

8. Save the Token from the Advanced settings – This token is also needed for the Line plugin setup.

To generate the API Key:

1. Go to the Staff section

2. Open the Users section

3. Select the account of interest and press on the three dots button to Edit it.

4. Click on the API Key Manager Icon:

   1. Generate the API KEY. If the API KEY has been already generated, you just need to copy it.

5. Copy the API Key. This will be required later during the Line plugin configuration.

2. Open the App Zone section → Plugins

3. Upload the Line Plugin clicking the plus button, choosing the zip file and clicking on Confirm

4. After the upload, you will find the plugin in the list of the uploaded App Zone Plugins

5. To Install the plugin, click on the three dots button next to the plugin and click Install plugin

6. Click on the three dots button next to the plugin and click Edit plugin.

7. In the Sidebar field, select how and to whom this integration should be displayed in the menu. (default value: Admin Only)

Plugin config

• Motion API Key: Insert the API Key previously saved.

• Plugin port: Plugin port (choose a different port for each plugin)

• Map Key: Insert a key to map the plugin

• Receive URL: Insert the Receive URL previously saved.

• Public motion server address: Enter the public XCALLY Motion URL

• Proxy token: If necessary, insert the proxy token

Line config

• Access token: Insert the Line Access Token previously saved.

• Channel secret: Insert the Line Channel Secret name previously saved.

Message config

• Automatic response to stickers: Message that appears to your Customers in case they’re trying to send stickers (Stickers are not supported on Motion)

• Warning sent to users when the message could not be delivered to Motion: Message that appears to your Customers in case of technical difficulties and messages could not be delivered

• Warning sent to agents when the message could not be delivered to Line: Message that appears to your Agents in case of technical difficulties and messages could not be delivered to Line

• Warning sent to agents for attachments too big to be forwarded to Motion: Message that appears to your Agents in case the attachment sent by the Customer is too big for Motion to handle.

Webhooks config

• Line webhook: http://localhost/api/plugins/webhook?port=3008&path=%2Fapi%2Ffrom-line-to-motion&token= ; this needs to be set in the Line channel admin page (where localhost is your XCALLY instance hostname and 3008 must be replaced with the port used for the plugin).

• Motion reply URL: http://localhost:3008/api/from-motion-to-line, where 3008 must be replaced with the port used for the plugin.

3. After the changes, remember to Restart the Plugin:

• Go to the App Zone section

• Find the Line plugin and click on the three dots button next to the plugin

• Choose the Restart plugin command.

The Line Integration is ready to be used!

Note that:

• XCALLY Motion can't show to agents any sticker sent by the users, as Line currently doesn't allow any way to retrieve those from their systems. Users sending stickers will receive an automated response you can customize in the plugin's settings.

• XCALLY Motion can’t receive contacts sent by the users, either from their personal contact list or their Line's contact list. Line is currently not forwarding those kind of messages to our systems.

• XCALLY Motion can't directly send attachments to users other than video and images. Any other kind of attachment will instead be converted into a downloadable URL.

• GIF\PNG images are converted to JPG. That's how Line send them back to Motion.

• Text or attachments can be exchanged: they must be sent in different messages.