# News: Articles for 2018

Specification change for the Messaging API

# The image and icon

Now you can specify any aspect ratio of images and icons within a certain range.

For more information, see the updated reference documentation below.

# URI action

Now you can set different action URLs for PC users (LINE for macOS and Windows) and smartphone users (LINE for iOS and Android).

For more information, see URI action.

LINE SDK 4.0.10 for Android released

The LINE SDK 4.0.10 for Android has been released. You can download the SDK from the following page.

Changes:

  • Fixed an issue where an activity is not found when authenticating with LINE Login after LINE is invalidated on the device.

We will continue to provide improvements so that you can code more easily.

[Update] Change to the imagemap message

We decided not to make the specification change of the imagemap message that we announced on November 14, 2018, for compatibility. We apologize for any inconveniences caused and appreciate your understanding.

You can continue to send imagemap messages even if you set actions in the area that does not fit the width and height of the image specified by the baseSize property.

However, the layout of such imagemap messages might be broken on the user device. We recommend setting actions within the area that fits the width and height of the image specified by the baseSize property.


The behavior of a consent screen displayed to LINE Login users has changed

The behavior of a consent screen displayed to users at login has been changed when you use LINE Login to request your users to grant your app permission to get their email address.

Previously, when a user attempted to log in, a consent screen was displayed at each login with or without the prompt parameter.

Currently, a consent screen is not displayed for a certain period unless the user's email address changes.

For more information, see Authentication process.


LINE Things Developer Trial released

LINE Things Developer Trial has been released. For usage, see the following guide and API reference:

These documentation sets will be translated into English soon.


LINE SDK 5.0.0 released

The LINE SDKs 5.0.0 for Android, iOS Swift, and iOS Objective-C have been released. For installation and usage instructions, see the following guides:

# Changes

# LINE Login v2.1 and Social API v2.1 are supported

You can set permissions to be granted to your app as scopes when users log in to your app with LINE Login. By setting scopes, you can get ID tokens when you get access tokens. Those tokens contain user information according to the scopes you set with the login request.

You can display an option to add your bot as a friend to users logging in to your app. You can get the friendship status between users and your bot with login responses and the Social API.

# New SDK version in Swift

Developed in Swift, the LINE SDK for iOS Swift provides a modern way of implementing LINE APIs. The LINE SDK 5.0.0 for iOS Objective-C is the last version of our Objective-C SDK.

# Open-source SDK

The LINE SDK for Android and iOS Swift are open-sourced. Visit the following repositories to check the provided code and samples.

# Detailed reference

Now you can access detailed reference based on the source code. For more information, see the following references:

Correction to documentation

There were errors in the news release and documentation for the new LIFF server API to update a LIFF app. We apologize for any inconvenience.

# News

【Incorrect】 The HTTP request to the API endpoint to update a LIFF app is changed from PUT to PATCH. Now you can partially update the properties of your LIFF apps.

【Correct】 The API endpoint for updating a LIFF app is changed. Now you can partially update the properties of your LIFF apps.

# API reference

【Incorrect】 PATCH https://api.line.me/liff/v1/apps/{liffId}

【Correct】 PUT https://api.line.me/liff/v1/apps/{liffId}

For more information, see Update LIFF app.

Renewed LIFF server API

Now you can set the following properties to your LIFF apps.

  • description property
  • features.ble property

The HTTP request to the API endpoint to update a LIFF app is changed from PUT to PATCH. Now you can partially update the properties of your LIFF apps.

For more information, see the following sections:

New webhook events are added for the Messaging API

We have added two webhook events: Member join event and member leave event.

For more information, see the following sections:


A new login method has been added

Now you can use your LINE Business ID to log in to the LINE Developers Console.

If you are an enterprise user who satisfies both of the two conditions below, click "Log in with email" and enter the email address and password associated with your LINE Business ID to log in to the LINE Developers Console.

  • You use the LINE Developers Console for the first time.
  • You have a LINE Business ID.

Otherwise, click "Log in with LINE" and enter the email address and password associated with your LINE account to log in to the LINE Developers Console.

Maintenance period for the LINE Developers site is extended

Today, we will perform maintenance for the LINE Developers site to change its domain name. Due to circumstances, the maintenance period is extended as below.

We apologize for any inconvenience and appreciate your understanding.

# Scheduled maintenance time

November 15, 2018 12:00-13:00 JST (+9 GMT)

The maintenance period is extended by 50 minutes.

# Impact

The LINE Developers site will be unavailable during the maintenance time.

In this maintenance the LINE Developers site's domain name will change from "developers.line.me" to "developers.line.biz". All accesses to the old domain will be redirected to the new domain.

Change to the imagemap message is scheduled

We'd like to inform you that we will change the specification of the imagemap message.

After the specification change, if the method of setting actions in imagemap messages is incorrect as below, an error occurs and you cannot send imagemap messages.

The current specification: You can send imagemap messages even if actions are set in the area that does not fit the width and height of the image specified by the baseSize property.

In this case, the layout of the imagemap displayed on the user device might be broken.

The new specification: You cannot send imagemap messages because the API request fails if actions are set in the area that does not fit the width and height of the image specified by the baseSize property.

This specification change will be released on November 27th.

Domain name change for the LINE Developers site

On November 15, 2018, we will perform maintenance for the LINE Developers site to change its domain name.

# Scheduled maintenance time

November 15, 2018 12:00-12:10 JST (+9 GMT)

# Impact

The LINE Developers site will be unavailable during the maintenance time.

In this maintenance the LINE Developers site's domain name will change from "developers.line.me" to "developers.line.biz". All accesses to the old domain will be redirected to the new domain.

Correction to documentation

There were errors in the description of the new destination property added to webhook events released yesterday. We correct it as below:

【Incorrect】The destination property includes the MID of a bot that should reeive the webhook events. The property value is a string that matches the regular expression, "u[0-9a-f]{32}".

【Correct】The destination property includes the user ID of a bot that should reeive the webhook events. The property value is a string that matches the regular expression, "U[0-9a-f]{32}".

For more information, see Request body.


Specification change for the Messaging API

# You can play videos in imagemap messages

Now you can play videos in imagemap messages.

For more information, see Imagemap message.

Note that this change doesn't include the validation of action areas of imagemap messages announced on October 24. We will inform you once we decide on our schedule.

# New properties are added to webhook events

  • The body of webhook events now includes the user ID (destination) of a bot that should receive the webhook events. For more information, see Request body.
  • New information is available in message objects for image, video, and audio messages. For more information, see Image, Video, and Audio.

Correction on November 9, 2018 : MID -> user ID

# Flex Messages can now be multicast

Now you can send Flex Messages with the /v2/bot/message/multicast endpoint.

For the /v2/bot/message/multicast endpoint, see Send multicast message in the Messaging API reference.

LIFF apps can now be added with the LINE Developers Console

Now you can add LIFF apps with the LINE Developers Console. As before, you can still add LIFF apps with the LIFF server API.

For more information, see Adding a LIFF app.


Change to the imagemap message is scheduled

We'd like to inform you that we will change the specification of the imagemap message.

After the specification change, if the method of setting actions in imagemap messages is incorrect as below, an error occurs and you cannot send imagemap messages.

The current specification: You can send imagemap messages even if actions are set in the area that does not fit the width and height of the image specified by the baseSize property.

In this case, the layout of the imagemap displayed on the user device might be broken.

The new specification: You cannot send imagemap messages because the API request fails if actions are set in the area that does not fit the width and height of the image specified by the baseSize property.

This specification change will be released in the week starting November 5th.

The scheme of the picture URL returned when getting a user profile has been changed

Now we support https as the scheme of the pictureUrl property. The response to the GET https://api.line.me/v2/bot/profile/{userId} request includes this property.


[Update] Discontinuation of the long-lived channel access token

We'd like to inform you of the change in the discontinuation of the long-lived channel access token that we announced in August.

We have concluded that discontinuing the long-lived channel access token by November can cause difficulty to many developers. Therefore, we will continue to support the long-lived channel access token and find alternative ways in the future that will not affect our developers.


Default rich menu can now be configured with the Messaging API

Now you can configure the default rich menu with the Messaging API.

Both default rich menus created using LINE@ Manager (opens new window) and the Messaging API are supported and can be used at the same time.

For more information on how to use the rich menu features, see the following pages.

More stickers are available for your bot

We have increased the number of sticker types available for bots from 342 to 462. You can create a smarter, more expressive bot with various new stickers.

For more information, see Sticker message and the sticker list.


Long-term channel access token to be discontinued

We'd like to inform you that we will discontinue the long-lived channel access token used with the Messaging API.

The discontinuation is scheduled in November 2018 with the removal of the endpoints of the Messaging API v1.

Note that the long-lived channel access token is issued only from the LINE Developers Console. This endpoint to issue a short-lived channel access token will not be affected.

https://api.line.me/v2/oauth/accessToken

We will provide further details for a replacement method soon.

Flex Message is now available on your desktop

Flex Message is now available on your desktop.

The feature is supported on LINE 5.9.0 for macOS and Windows.

In addition, we have added the following new Flex Message properties so that you can create messages in a more flexible way.

  • action property of the box
  • maxLines property of the text

For more information, see the following pages:

Quick reply released

We have released the quick reply feature for messages sent through the Messaging API. When a user receives a message that contains quick reply buttons, those buttons appear at the bottom of the chat screen. The user can simply tap one of the buttons to reply to your bot.

Quick reply sample

The quick reply feature is supported on LINE 8.11.0 and later for iOS and Android.

For more information, see Using quick replies.


The maximum number of LIFF apps has been increased

Now you can add up to 30 LIFF apps for one channel. The previous maximum number was 10.

For more information, see Add LIFF app in the LIFF API reference documentation.


An important message for our users in Thailand, Taiwan, and Indonesia

Important notice concerning LINE Official Accounts, LINE@ accounts, Business Connect accounts, and Customer Connect accounts The following message applies to our users in Thailand, Taiwan, and Indonesia. LINE Corporation will be collecting information from LINE Official Accounts, LINE@ accounts, Business Connect accounts, and Customer Connect accounts (OAs) in order to improve our services. You must agree to these terms by September 2, 2018.

Log in to LINE@ Manager (opens new window)

With these revised terms, we will work on improving services requested by OA users, such as visualization of delivery performance through message views, click counts, video views, etc. and targeting delivery based on user response logs to messages.


Clova Extensions Kit released

We have released the Clova Extensions Kit that allows you to develop skills for Clova, AI assistant from LINE. We have also released the Clova Developer Center (opens new window) for tutorials and documentation in Japanese.

Clova Developer Center

Now you can create skill channels in the LINE Developers Console.

For more information, refer to the documentation (opens new window) on the Clova Developer Center.

Introducing the redesigned LINE Developers site

We are excited to introduce our new, redesigned LINE Developers site. We hope that this renewal will improve developer experience, making it easier to use the LINE Platform products. There are no major changes in the LINE Developers Console functionality. Here, we'll take you through some of the key changes to the site.

# Changes in the LINE Developers Console

  • We have added the provider list screen so that you can easily select the provider of the channel that you want to configure.
  • Now the role of the logged-in user is displayed in the provider and channel lists.
  • You can quickly access tools such as Flex Message Simulator and Bot Designer through the tool list in the navigation bar.

# Changes in the documentation site

  • Each page has breadcrumbs at the top so that you can easily keep track of the page structure.
  • The new navigation bar allows easier access to the API reference for each product. You can also browse the API reference within the feature guide as before.
  • Each page of the feature guides has a table of contents on the right side so that you can quickly move across sections.

# Conclusion

We will continue to make improvements to the LINE Developers site and our developer documentation to make it easier for you to develop apps using our products.

If you want to keep up-to-date with our latest developments, add the LINE Developers Official Account as a friend on LINE using the QR code or the button below.

QR code for the LINE Developers account

Add friend (opens new window)

Notice about service outage for the Messaging API (resolved)

We'd like to inform you about a service outage regarding the Messaging API. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date of recovery

Date: June 27, 2018 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

When the Messaging API was called to unlink a rich menu from a user that was not in a chat with the bot, the rich menu was not unlinked from the user. This issue occured only to users with LINE 8.7.0 or later for iOS and rich menus configured at admin-official.line.me.

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

Notice about service outage for LINE Login and the Social API (resolved)

We'd like to inform you about a service outage regarding LINE Login and the Social API. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

Date: June 26, 2018

Time: 16:25–17:00 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

An error was returned when the following API features were accessed:

  • Get user profiles
  • Get friendship status
  • LINE Login

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

Notice about service outage for LINE Front-end Framework (resolved)

We'd like to inform you about a service outage regarding LINE Front-end Framework. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date and time of recovery

Date: June 21, 2018 around 17:30 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

When a LIFF app was added to a channel, the permission to retrieve the user's email address was revoked if it had been granted to the channel. Please check if the email permission has been revoked or not from the LINE Developers Console. Request the permission again if it has been revoked.

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

Flex Message released

We have released Flex Message, a new message type for the Messaging API. Flex Messages are messages with a customizable layout. You can customize the layout freely by combining multiple elements.

Flex Message samples

Flex Messages are only supported on LINE 6.7.0 and later for iOS and Android.

For more information, see Sending Flex Messages.


LINE Front-end Framework released

LINE Front-end Framework (LIFF) is a platform for web apps that run within LINE.

When launching a web app (LIFF app) registered in LIFF in LINE, the LIFF app can get data from the LINE Platform such as the LINE user ID. The LIFF app can use such data to provide features that utilize user information and send messages on behalf of the user.

For more information, see LINE Front-end Framework.


The maximum number of rich menus has been increased

Now you can set up to 1000 rich menus for one bot with the Messaging API. The previous maximum number was was 10.

For more information about rich menus, see Using rich menus.


LINE SDK for iOS 4.1.1 released

The LINE SDK for iOS version 4.1.1 has been released. You can download the SDK from the following page.

Changes:

  • Fixed an issue that the LineSDKLogin object has the access token in cache even after logout.

We will continue to provide improvements so that developers can code more easily.

Notice about service outage for LINE Developers site (resolved)

We'd like to inform you about a service outage regarding the LINE Developers site. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

Date: April 11, 2018 Time: 12:00 ~ 22:00 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

During the date and time stated above, certain users could not access the LINE Developers Console.

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

English documentation for the Account link feature released

The guide and API reference for the account link feature are now also available in English.

Check out the article at Linking user accounts and the Messaging API reference.


Account link feature released

You will now be able to securely link the user account for your existing service with the LINE account of the user if they have friended your bot. This will allow you to utilize the user information you already have and use LINE bots to provide even better services.

For more information, see Linking user accounts. We will let you know when English documents become available.


Notice about service outage for Messaging API (resolved)

We'd like to inform you about a service outage regarding the Messaging API. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date and time of outage

Date: March 27, 2018 Time: 21:40 ~ 23:50 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

HTTP status code 500 was sometimes returned when the following API endpoints were accessed:

  • Get content API: https://api.line.me/v2/bot/message/{messageId}/content
  • Rich menu API: https://api.line.me/v2/bot/richmenu/*

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

Notice about service outage for LINE Developers site (resolved)

We'd like to inform you about a service outage regarding the LINE Developers site. The issue has now been resolved but we sincerely apologize for any inconvenience that this may have caused.

# Date and time of recovery

March 23, 2018 around 19:20 JST (GMT+9)

# Cause of the outage

Issue with our servers.

# Details

The icon image of a LINE@ account was not updated after setting or changing the icon image of the Messaging API (bot) channel that corresponds to the LINE@ account at the LINE Developers site.

This outage has now been resolved and the icon image of a LINE@ account can be configured by setting an icon image again on the "Channel settings" page.

We will continue to improve the quality of the services we provide to our developers and we greatly appreciate your understanding.

SSL root certificate authority for api.line.me will change

Please be advised that we will be updating the SSL certificate on the API server (api.line.me) for the LINE Platform on the following date and time. This update includes changing the root certification authority for the certificate from GeoTrust to Digicert.

# Planned date and time

Date: March 22, 2018 Time: 14:00-17:30 JST (GMT+9)

We appreciate your patience and apologize for any inconvenience this may cause.

LINE SDK for Android 4.0.8 released

The LINE SDK for Android version 4.0.8 has been released. You can download the SDK from the following page.

Changes:

  • Fixed an infinite loading indicator problem that occurs if the user attempts to log in before LINE has been opened for the first time.

We will continue to provide improvements so that you can code more easily.

LINE Bot Designer released

LINE Bot Designer lets you prototype LINE bots faster and easier without any programming knowledge. You can freely design chatbots in a desired scenario.

LINE Bot Designer free for use. Download it now. Anyone with a LINE account can use it.

For more information, see the LINE Bot Designer page.


New permission to get users' email address released

Now 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 LINE Developers Console.

For more information, see the sections below in Integrating LINE Login with your web app.


LINE Login v1 to be discontinued

Note: This notice only applies to LINE Login v1 users. These changes do not apply if you are using the latest v2.1 or v2 endpoints.

Starting from March 31, 2018 we will start terminating LINE Login V1 endpoints. Please see the following schedule on the termination date for each endpoint. After an endpoint is terminated, any access to it will result in a 4XX status code as a response.

# Endpoints terminating on March 31, 2018
  • Issue access token: https://api.line.me/v1/oauth/accessToken
# Endpoints terminating on April 30, 2018
  • Get user profile: https://api.line.me/v1/profile
  • Logout: https://api.line.me/v1/oauth/logout
# Endpoints terminating on June 30, 2018
  • Verify access token: https://api.line.me/v1/oauth/verify
  • API endpoints for the LINE SDK for iOS and Android version 3.x or earlier

To avoid any issue related to the termination of LINE Login V1, please make sure to update your service to the latest LINE Login version. Please see the following page for more details on the latest LINE Login version.

Social API overview

Please also notice that the LINE user identifier is different between LINE Login V1 and LINE Login V2 or higher. If you are using the V1 user identifier on your service, you will need to convert the user identifier to use the latest LINE Login version. Please see the following page for more details on how to convert the LINE user identifier.

Converting an MID to a user ID

If you are a partner, we will contact you individually for more details.

New article on converting an MID to a user ID

Users are identified using a user ID in LINE Login v2 or later instead of an MID in v1. If you have integrated LINE Login v1 into your app and want to migrate it to v2 or later, you need to convert MIDs to user IDs.

For more information, see Converting an MID to a user ID.


Property for accessibility released

Now you can specify text to be spoken using the label property for imagemap messages and rich menus when the accessibility feature is enabled on the client device. This feature is supported on LINE 8.2.0 and later for iOS.

For more information, see the updated reference documentation below.


Introducing the Community site for developers

We are excited to introduce our new Community site (opens new window) added to the LINE Developers site.

Community site

You can find knowledge and examples from our developer community on the Community site, including expert tips from third-party developers and information about how to create attractive applications using the LINE APIs. Currently, the site has a Bot Directory, a showcase of chatbots available on LINE, and a Q&A section for development techniques.

Bot Directory and Q&A


New properties for template messages and postback actions released

# Default actions can now be set for template messages

The defaultAction property has been added to the column object for buttons and carousel template messages. As a result, you can indicate a single action to be executed when a user taps anywhere in the image, title, or text area.

For more information, see the updated reference documentation below.

# displayText property for postback actions released

We have released the displayText property and have deprecated the text property for postback actions. We recommend using displayText instead of the text property. Note that the dislayText and text properties cannot both be used at the same time.

For more information, see the Postback action reference documentation.

LINE SDK for Android 4.0.7 released

The LINE SDK for Android version 4.0.7 has been released. You can download the SDK from the following page.

Changes:

  • Fixed a crash that occurs if the user exits LINE using the home button and then opens the SDK app before LINE finishes the authentication process.

We will continue to provide improvements so that you can code more easily.

Let us announce the LINE API experts of the first quarter of 2018

LINE API Expert (opens new window) is a program that recognizes skilled engineers who have a deep understanding of the APIs provided by LINE and are influential in the community by giving them the title of "LINE API experts". In addition to providing an array of benefits, LINE will also support the various activities of these LINE API experts through this program.

The LINE API expert program was introduced at the LINE DEVELOPER DAY, September last year and a lot of engineers have applied through the LINE Developers site. Our internal review committee reviewed each item with a strict standard and came up with the final result. Please check the detail on the Expert List (opens new window) page or LINE Engineering Blog (opens new window).

We look forward to see the selected members to actively engage in the developer community through meetups, online forum, SNS or blogs, and other means. LINE will be opened to the range of activities and will support their moves with all means.

For the Q1, a total of 22 qualified engineers have been selected from four Asia countries, including Japan.

Japan

Hirotada Kobayashi, Nobisuke Sugawara, Hiroyuki Hiki, Naohiro Fujie, Masao Wakasa

Taiwan

Caeser Chi, Cheng-Lung Sung, David Tung, Kuan-Hung Kuo, Richard Lee, Will Huang, Wolke Lin

Thailand

Annop Kobkij, Suphakit Annoppornchai, Teerachart Kortrakul, Winn Voravuthikunchai

Indonesia

David Su, Habibi Mustafa, M Gilang Januar, Michelle Neysa, Nur Rohman, Soesapto Joeni Hantoro

LINE SDK for iOS 4.1.0 released

The LINE SDK for iOS version 4.1.0 has been released. You can download the SDK from the following page.

Changes:

  • The web login process now uses a Safari View Controller instead of an external browser.

We will continue to provide improvements so that developers can code more easily.

Community SDK section released

We have released a community SDK section to our Messaging API SDKs page with Messaging API SDKs developed by our developer community. We currently have a C# (.NET) SDK (opens new window) and are looking to add more resources.

If you have developed a SDK or library for the Messaging API, see our Community contribution guidelines for information on how to submit your project to us for review.