# 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.

# 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.

  1. Make sure that your smartphone has Bluetooth turned on
  2. Select Use LINE Beacon from Settings > Privacy on LINE
  3. Make sure that the beacon is turned on and bring your smartphone into its range
  4. 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.

# Beacon banner

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