Line Connect

To use Line as a social login provider, you will need an App ID and App Secret from your Line app, then copy these keys into your ReachFive settings.

This docs detail steps by steps how to create a Line App and connect it to your ReachFive account.

Line data

This is the collectable data for Line Connect.

Public data

User ID - A unique identifier for the user.

Display Name - The user’s display name.

Profile Picture - The user’s profile image.

Email Address - The user’s email address. Accessing this requires applying for permission in the LINE Developers Console.

Because email requires user consent, you may not be able to retrieve the email for all users. In the case where a user does not consent to sharing his or her profile, the profile is still created in ReachFive, just with no email address associated with the Line user.

Line Profile

The openid scope is required for accessing any information for Line Profile . See Line Profile addresses for more details on the address object.

Given name pronunciation - The phonetic pronunciation of the user’s given name. This is added to the user’s provider metadata. Requires the ReachFive real_name scope.

Middle name - The user’s middle name. Requires the ReachFive real_name scope.

Family name - The user’s family name. Requires the ReachFive real_name scope.

Family name pronunciation - The phonetic pronunciation of the user’s family name. This is added to the user’s provider metadata. Requires the ReachFive real_name scope.

Gender - The user’s gender. Requires the ReachFive gender scope.

Date of Birth - The user’s date of birth. Requires the ReachFive birthdate scope.

Phone Number - The user’s phone number. Requires the ReachFive phone scope.

Address - The user’s address. Requires the ReachFive address scope.

Line Profile addresses

The address object received from Line includes the following which map directly onto our Addresses object.

postal_code
region
locality
street_address
country

To prevent duplicate addresses and respect user updates, ReachFive syncs the Line address only once. You must create a custom boolean field called is_line_address to enable this behavior.

Each time a user logs in via Line Profile :

If the is_line_address custom field is set to true in one of the user’s profile addresses, the incoming Line address is ignored (preventing overwrite or duplication).
Otherwise, the Line address is added to the user’s address table, and this custom field is automatically set to true for that address to mark it as synced.

If the is_line_address custom field has not been configured, the system does not return an error.

This ensures backwards compatibility for existing implementations.

Developer access

Log in to the LINE Developers console with the email address and password of your LINE account : https://developers.line.me/console

Note: If you do not have a LINE account with a registered email address, download LINE, then go to Settings > Account to register your email address.

On first login, you have to register as a developer : enter your name and email address to create a developer account on the LINE Developers console.

Create a new provider

Click on "create a new provider"

Enter a name for the provider. The provider is the entity that offers your app, you can use the name of your company.

Click on "confirm"

Create a channel

Click on "Create Channel" under LINE Login

Enter the required information for your channel. "LINE" or a similar string cannot be included in the channel name.

Enter App Name and check "Use WEB" case.

Enter your contact email address.

Click on "confirm"

Configure your application

Click on your App

Go to "Channel settings"

Scroll down

You can request users who log in using LINE Login to grant your app the permission to get their email address. To do so, you first need to apply for the permission in the console.

Click "Submit" next to "Email" in the "OpenID Connect" section in the "Channel settings" page. Agree to the application terms and upload a screen shot of the screen that explains to the user why you need to obtain their email address and what you will use it for. Once your application is accepted, "Applied" is displayed under "Email".

Go to "App settings"

Add https://{REACHFIVE_DOMAIN}/login/callback as Callback URL, where REACHFIVE_DOMAIN is your ReachFive domain.

Configure LINE as provider on ReachFive

The following must be done within the ReachFive Console.

Return to the ReachFive Console.
Go to Settings Providers.
Click the Line application option.
Add the Client ID, Client Secret, and associated Permissions.

This is the Channel ID and Channel secret from your Line application.

Have multiple brands using Line?

If you have multiple brands or subsidiaries using Line, you can add them as variants within the ReachFive Console.
Under Bot prompt, choose one of the following:
- Empty
- Normal
- Aggressive
  
  What is this exactly? 🤔
  The Bot prompt asks the user if they want to add a LINE friend when logged in.
  
  Empty means that the user is not prompted.
  
  Normal prompts the user on the consent screen.
  
  Aggressive prompts the user in a new window after the consent screen.
  
  For more details, check out LINE’s bot_prompt documentation.
Don’t forget to Save your input.