LINE

What You Get

1:1 chat and group message support
Flex Messages (LINE’s rich card format) for structured replies
Compatible with any LINE account (Japan, Taiwan, Thailand, Indonesia, etc.)
Works via the official LINE Messaging API (no unofficial scraping)

1. Create a LINE Developer Account

Go to the LINE Developers Console
Sign in with your LINE account (or create one)
Create a new Provider if you don’t have one
Create a new Messaging API channel inside the provider

2. Get your credentials

From your channel’s settings:

Channel access token (long-lived) — under Messaging API → Channel access token → Issue
Channel secret — under Basic settings

3. Configure webhook

In your channel’s Messaging API tab, set:
- Webhook URL: https://your-host/webhook/line
- Use webhook: Enabled
- Auto-reply messages: Disabled (so Butler handles all replies)
- Greeting messages: Optional — your welcome text shown on follow

4. Store Credentials

aibutler vault set line_channel_access_token YOUR_CHANNEL_ACCESS_TOKEN
aibutler vault set line_channel_secret YOUR_CHANNEL_SECRET

5. Enable the Channel

configurations:
  channels:
    active:
      - line

6. Restart

aibutler run

You should see line: tools registered and line: webhook listening in the logs.

7. Add the bot to a chat

Scan your channel’s QR code (shown in the LINE Developer Console under Messaging API → QR code) from the LINE app to add the bot as a friend. Once added, send a message and Butler should respond.

Features

Feature	Supported
1:1 chats	Yes
Group chats	Yes (requires `Allow bot to join groups` enabled)
Flex Messages	Yes
Image messages	Yes (send + receive)
Voice messages	Yes (transcribed via STT)
Stickers	Yes (received as sticker metadata)
Streaming replies	No (LINE is edit-based)

Troubleshooting

401 Unauthorized when sending replies. The channel access token expired or was copied wrong. Regenerate it in the Developer Console.

Webhook verification fails. LINE sends a signed request with the X-Line-Signature header — your channel secret must match what’s in the vault. Double-check there’s no trailing whitespace when you ran aibutler vault set.

Bot doesn’t receive messages in groups. LINE requires the Allow bot to join groups and multi-person chats setting to be enabled in your channel’s Messaging API tab.