Module 10: Advanced Features

10.1 LINE Beacon — Proximity Triggers

LINE Beacon uses Bluetooth Low Energy (BLE) to detect when a user enters or leaves a physical location, triggering a webhook event to your OA.

{
  "type": "beacon",
  "replyToken": "...",
  "source": { "userId": "U4a8b..." },
  "beacon": {
    "hwid": "abcdef123456",        // Hardware ID
    "type": "enter",                // "enter", "leave", "banner", "stay"
    "dm": "{\"key\":\"value\"}",    // Device message (optional)
    "deviceMessage": { "key": "value" }  // Object version
  }
}

10.2 Membership (Paid Subscriptions)

LINE OA supports paid membership tiers — users pay a recurring fee for exclusive content/benefits.

Set up in OA Manager: LINE Apps → Membership

API endpoints:

// List all membership plans
GET https://api.line.me/v2/bot/membership/list

// Get a user's subscription status
GET https://api.line.me/v2/bot/membership/subscription/{userId}

// List users subscribed to a plan
GET https://api.line.me/v2/bot/membership/{membershipId}/users/ids

Webhook events for membership:

{
  "type": "membership",
  "replyToken": "...",
  "source": { "userId": "U4a8b..." },
  "membership": {
    "membershipId": 1,
    "userId": "U4a8b..."
  }
}

// events: "membershipJoined", "membershipLeft", "membershipRenewed"

10.3 Coupons

Create and distribute discount coupons directly through LINE OA. Users see them in their LINE Wallet.

Creating a coupon via API:

POST https://api.line.me/v2/bot/coupon

{
  "name": "Summer Sale 2026",
  "issuanceCount": 500,           // Total coupons to issue
  "discountPercent": 15,          // 15% off
  "discountAmount": 0,            // Not using fixed amount
  "discountPrice": 0,             // Not using discounted price
  "discountConditions": [],       // Optional conditions
  "validFrom": 1748707200000,     // Unix ms
  "validUpto": 1751308800000,     // Unix ms
  "displayImageUrl": "https://example.com/coupon.jpg"
}

Response: { "couponId": "coupon-xxx" }

Send coupon to user via Messaging API:

{
  "type": "coupon",
  "couponId": "coupon-xxx",
  "title": "Summer Sale 2026",
  "promotionUrl": "https://yourdomain.com/sale",
  "reason": "For being a loyal customer!"
}

Or send the coupon by simply including it in a reply/push message as a coupon message type.

10.4 Reward Cards (Stamp Cards / Loyalty Cards)

Digital stamp cards within LINE — users collect stamps by taking actions and redeem rewards.

Set up in OA Manager: LINE Apps → Reward Cards

Note: Reward Cards are configured via the GUI, not the Messaging API. You can trigger stamp awards programmatically via postback data.

How it works:

• Create a card with N stamp slots (e.g., 8 stamps for a free drink)
• User gets a stamp when they perform an action (scan beacon, make purchase, etc.)
• When full, user gets a reward (discount, free item)
• Multiple cards can be active simultaneously

10.5 Step Messages (Automated Sequences)

Step Messages are timed, automated message sequences triggered by user actions or time intervals. Set up in OA Manager: LINE Apps → Step Messages.

Example welcome sequence:

1. Day 0 (immediate): Welcome + ฿50 coupon
2. Day 1: Introduction to rich menu features
3. Day 3: Showcase popular products
4. Day 7: "We miss you" + special offer
5. Day 14: Invite to LIFF app for full experience
6. Day 30: Check satisfaction + review request

Trigger types:

• Time elapsed since follow
• Time elapsed since last message
• Specific date (birthday, anniversary)

10.6 Surveys

Create in-chat questionnaires. Set up in OA Manager: LINE Apps → Survey.

• Multiple question types: single choice, multiple choice, text
• Responses collected in OA Manager
• Can be sent via broadcast or as a step message
• Results exportable to CSV