Prerequisites

Before integrating LINE into Capillary, ensure the following prerequisites are met:

• Create a LINE account: A LINE account is the primary account used to login to the LINE Developer Platform.
• Create a LINE Developer Platform Account: The LINE Developer Platform is the portal to connect and utilize the LINE API.
• Create a Provider: A provider is an individual developer or organization that provides services and acquires user information on the LINE Developers platform.
• **Create a Channel: **A channel is a communication path for providers to use the LINE platform's features.
• **Create a Bot: **A bot allows you to send messages to users and leverage features such as rich menus and quick replies.
• **Create a Webhook: **A webhook allows you to receive real time information from LINE.
• **Configure the LINE Message API: **The Messaging API lets you develop two-way communication between your service and LINE users.
• **Channel ID and Secret Keys: **The Channel ID and Secret Keys are identifiers used when integrating your LINE account with Capillary.

Creating a line account

Download and install the LINE app and create an account if not already done.

Creating a line developer platform account

Create a LINE developer account on the LINE Developers platform using your LINE account.

On the LINE Developers Console, you can manage Developers, Providers, and Channels.

Creating a provider

To create a provider on the LINE Developer Platform, refer to the LINE Developer Console documentation on creating a provider.

❗️

Important

The provider name should be an official name such as the company name as it is used to verify your identity.

Creating a channel

The channel is the hub through which your messages are sent. Users can join your channel and receive promotional content and announcements through LINE.

To create a channel on the LINE Developer Platform, refer to the LINE Developer Console documentation on creating a channel.

📘

Note

Choose Messaging API as the channel type while creating a channel.

Creating a bot

Once you have created the provider and channel, you will need to create and configure a bot. This allows you to send messages to users. Additionally, you can configure the bot to use rich menus, and quick replies for a personalized experience.

To create a bot on the LINE Developer Platform, refer to the LINE Developer Console documentation on creating a bot.

Creating a webhook

For detailed steps, refer to the Capillary Developer Documentation on creating a webhook.

📘

Note

The generated webhook URL can then be used for integration on LINE.

Setting the webhook url

Once the webhook URL has been created, you need to set the webhook onto the LINE developer platform.

For detailed steps to set the webhook URL on the Line Developer Platform, refer to the LINE Developer Console Documentation.

Configuring the line message api

To connect your LINE account with Capillary, you need to enable the Messaging API for your account.

Follow these steps to enable Messaging API:

1. Log in to your LINE developer account and select your target account.
2. Click Settingsin the top right and go to the settings screen.
3. Select Messaging APIfrom the menu on the left.
4. Click on the Enable Messaging APIbutton.

5. Select the provider you want to associate with and click on Agree.

When the Channel information appears on the screen, the Messaging API activation is complete.

Channel id and channel secret keys

These are required while setting up a LINE source account on InTouch.

Channel IDis a unique identifier of the channel.

Channel Secret Keyis a unique secret key used to grant an app access to your channel.

📘

Note

Find the Channel ID and Channel Secret Keys on the LINE Developer Platform under Settings > Messaging API > Channel Info.

Once you have set up your LINE developer account and created a Provider, Channel and Webhook, configure Capillary to work with LINE.

The configuration procedure includes the following steps:

• Setting up LINE Source Account on InTouch
• Registering a LINE User on InTouch
• Creating a LINE Gateway
• Registering a User Without a LINE Profile on Capillary
• Setting Up a Webhook in the LINE Developer Account

Setting up a line source account on intouch

Setting up a LINE source account on InTouch involves configuring the LINE channel details obtained from the LINE developer platform.

This step is required to establish a functional connection between your LINE account and Capillary.

To set up a LINE source account, follow these steps:

1. Log in to InTouch and navigate to Organization Settings > Channel Configurations.

2. From the Channel List, select LINE.

👍

Tip

Use the search function to find it quickly .

3. Click on Add Accountin the top right and enter an Account Name.

4. Enter the Source Account ID, Channel ID, and **Channel Secret **from the channel created on the LINE Developers Console.
5. Click Submitto save the changes.

Registering a line user on intouch

To register a LINE user on InTouch, set up the LINE app, create an account if you don’t already have one, and scan the channel's QR code to connect with the LINE channel.

Ensuring that both sources are correctly mapped is crucial for integration between LINE and InTouch.

To register a LINE user on InTouch, follow these steps:

1. Download and install the LINE app.
2. Create an account by providing your mobile number, if you do not have an existing LINE account.
3. Scan the QR code for the target LINE channel using the LINE app.

📘

Note

The QR code for the channel is available on the LINE Developer Platform.

4. On your mobile device, click Addto send a request to the LINE channel when prompted.

📘

Note

The request can be viewed using the Webhook URL. useridis the unique identifier of a LINE account for the user.

5. On InTouch, register a customer using the customer registration API and the mobile number associated with the LINE app. Set the source as INSTORE.
6. Once the INSTORE profile for the customer is created, use the customer registration V2 API to register the same user with the source set as LINE.
7. Check the Member Care section for the registered customer to confirm that both sources (INSTORE and LINE) are mapped to the same customer.

📘

Note

The addition of a LINE user on InTouch can be automated as needed.

Creating a line gateway

Creating a LINE Gateway is required for managing message delivery through the LINE channel

To create a LINE gateway on InTouch, follow these steps:

1. Login to InTouch and navigate to the Gateways page.
2. Under Gateway Settings, choose **LINE **from the Gateway drop-down menu.
3. Define the Gateway Weight (the ratio in which messages will be delivered).
4. Define the Start and End Time.
5. Click on Submitto create a LINE Gateway.

You can now include the customer in any campaign lists and contact them via the LINE channel.

Setting up a webhook on the line developer platform

To set up a webhook on the LINE developer platform, follow these steps:

1. Configure the Webhook
   Setup the webhook URL for the specific LINE channel. This webhook will capture events for when the user opts in or out of the channel.
2. Manage Subscription Status
   • Use the LINE user ID from the API response to update the subscription status on Capillary via middleware.
   • If the user does not exist in the system create an INSTORE and LINE profile using the customer registration API.