# Enabling the bot link feature with the SDK
You can display an option to add the LINE Official Account as a friend when a user logs in to your app. This is called the bot link feature. Developers can specify the LINE Official Account to be added as a friend.
Before getting started with the configuration, see Add a LINE Official Account as a friend when logged in (bot link) in the LINE Login documentation to understand the bot link feature and the following specifics:
- Linking a LINE Official Account with your channel on the LINE Developers Console
- The bot prompt parameter sent to the LINE Platform and its behavior
- The friendship status flag returned from the LINE Platform and its meaning
This topic explains how to enable these bot link functions with the LINE SDK:
- Setting the bot prompt parameter in the login request
- Checking the friendship status between the user and the LINE Official Account
# Setting the bot prompt parameter in the login request
The following sample code shows how to set the botPrompt
parameter when using the LoginButton
widget.
...
LoginButton loginButton = rootView.findViewById(R.id.line_login_btn);
loginButton.setAuthenticationParams(new LineAuthenticationParams.Builder()
.scopes(Arrays.asList(Scope.PROFILE))
.botPrompt(BotPrompt.normal) // configure it here
.build()
);
...
The following sample code shows how to set the botPrompt
parameter when using the LoginApi.getLoginIntent()
method.
Intent loginIntent = LineLoginApi.getLoginIntent(
view.getContext(),
Constants.CHANNEL_ID,
new LineAuthenticationParams.Builder()
.scopes(Arrays.asList(Scope.PROFILE))
.botPrompt(BotPrompt.normal) // configure it here
.build());
startActivityForResult(loginIntent, REQUEST_CODE);
For more information about the parameter values, see LineAuthenticationParams.BotPrompt in the LINE SDK for Android reference.
# Checking the friendship status between the user and the LINE Official Account
You can check the friendship status between the user and the LINE Official Account using the following methods.
- Check the
LineLoginResult
object in the login response: This method checks whether the friendship status has changed during login. - Use LINE Login to get friendship status: This method gets the friendship status between the user and the LINE Official Account.
# Check the LineLoginResult
object in the login response
After successful login, the LineLoginResult
object contains a boolean value that indicates whether the friendship status has changed. You can get the value with the getFriendshipStatusChanged()
method.
The following conditions must be met to get the friendship status flag:
- The
botPrompt
parameter is specified with theLineAuthenticationParams
object in the login request. - The consent screen with the option to add your LINE Official Account as a friend is displayed to the user.
The following sample code shows how to get the friendship status from the LineLoginResult
object.
public void onActivityResult(int requestCode, int resultCode, Intent data) {
...
LineLoginResult result = LineLoginApi.getLoginResultFromIntent(data);
boolean friendshipStatusChanged = result.getFriendshipStatusChanged();
...
}
For more information about the return values, see getFriendshipStatusChanged() in the LINE SDK for Android reference.
# Use LINE Login to get friendship status
Call the LineApiClient.getFriendshipStatus()
method after the user has logged in to your app and an access token has been returned.
boolean isFriendToTheBot = lineApiClient.getFriendshipStatus();
For more information about the return values, see getFriendshipStatus() in the LINE SDK for Android reference.