Using beacons

# Using beacons

With LINE Beacon, your bot can receive beacon webhook events whenever a LINE user enters the proximity of a beacon. Using beacons, you can customize your bot app to interact with users in specific contexts.

Note

LINE Beacon is available in Japan, Taiwan, Thailand, and Indonesia.

Recommended environments for LINE Beacon

We recommend that you use the latest versions of LINE for LINE Beacon.

# Getting a beacon

To use LINE Beacon, you'll first need a Bluetooth® Low Energy beacon to link with your LINE Official Account. You can link one of the following types of devices with your LINE Official Account.

A beacon device that supports LINE Beacon. These devices are only supported in their countries.
- Supported devices in Japan are available here (opens new window).
- Supported devices in Thailand are available here (opens new window).
A Bluetooth® Low Energy device that uses the LINE Simple Beacon (opens new window) specification.

# Linking your LINE Official Account with a beacon

To link your LINE Official Account with a beacon, go to the beacon registration page in LINE Official Account Manager (opens new window). You can either link a LINE Beacon supported device with your LINE Official Account or issue a LINE Simple Beacon hardware ID for a device.

Note

You can link multiple beacons with a single LINE Official Account. However, a single beacon cannot be linked with multiple LINE Official Accounts.

# Receiving webhook events

For your bot server to receive beacon webhook events when a user is detected by the beacon, the user must have Bluetooth and the LINE Beacon setting on LINE turned on. The user must also have added a LINE Official Account associated with your bot as a friend.

To trigger a beacon webhook event, follow these steps.

Make sure that your smartphone has Bluetooth turned on
Select Use LINE Beacon from Settings > Privacy on LINE
Make sure that the beacon is turned on and bring your smartphone into its range
Confirm that your bot server receives a beacon event object

Example beacon event object

{
  "destination": "xxxxxxxxxx",
  "events": [
    {
      "replyToken": "nHuyWiB7yP5Zw52FIkcQobQuGDXCTA",
      "type": "beacon",
      "mode": "active",
      "timestamp": 1462629479859,
      "source": {
        "type": "user",
        "userId": "U4af4980629..."
      },
      "webhookEventId": "01FZ74A0TDDPYRVKNK77XKC3ZR",
      "deliveryContext": {
        "isRedelivery": false
      },
      "beacon": {
        "hwid": "d41d8cd98f",
        "type": "enter"
      }
    }
  ]
}

For more information, see beacon event in the Messaging API reference.

The beacon banner feature is only available to corporate users. For more information, contact your LINE representative or make an inquiry through the LINE for Business website.

The beacon banner is a banner that appears above the "Friends" or "Chats" screen when a user is detected by a beacon. With the beacon banner feature, you can let users turn on "LINE Beacon" on LINE, add your LINE Official Account as a friend, and receive a message from your LINE Official Account by tapping on the banner.

Beacon banner

Getting a beacon

Linking your LINE Official Account with a beacon

Receiving webhook events