LINE Connect

Dify Endpoint Plugin — Connect any Dify chatbot or agent app to a LINE Official Account in minutes.

English | ไทย | 日本語 | 中文

Overview

LINE Connect bridges LINE Messaging API and Dify's chat API. Users chat on LINE; your Dify app answers automatically — with full conversation persistence, image/file support, and a built-in admin dashboard.

Architecture

Screenshots

Dashboard

Overview of your LINE Connect workspace — total conversations, active users, message activity chart, and system status at a glance.

[Image blocked: Dashboard Overview]

Conversations

Real-time chat view with message history, bot toggle, tags, notes, and unread indicators.

[Image blocked: Conversations]

Analytics

Message volume trends, response time distribution, user growth, and peak hours heatmap.

[Image blocked: Analytics — Volume & Response Time]

[Image blocked: Analytics — User Growth & Peak Hours]

Settings

Quick reply templates, tag management, bot schedule, broadcast messaging, and storage info.

[Image blocked: Settings — Templates & Schedule]

[Image blocked: Settings — Schedule Days]

[Image blocked: Settings — Broadcast & Storage]

Features

Feature	Description
Two-way messaging	Receive LINE messages, forward to Dify, reply automatically
Image support	Users send images via LINE — uploaded to Dify as file variables for vision models
File support	Video, audio, and documents are uploaded and forwarded to Dify
Image debounce	Batch multiple images into a single Dify call (configurable delay)
Display name forwarding	Inject LINE user's display name as a Dify input variable
Markdown to FlexMessage	Render bot replies as rich FlexMessage bubbles with headings, bold, lists, tables, blockquotes
Conversation persistence	Each user/group gets a unique Dify conversation ID
Group & room chat	Works in 1:1, group, and multi-party room chats
Streaming with fallback	Stream-first with automatic blocking fallback for reliability
Multi-endpoint isolation	Each endpoint has its own isolated storage — fully separated
Admin dashboard	Password-protected web UI for managing all conversations
Analytics	Message volume, user growth, response time charts with daily breakdown
Typing indicator	Animated dots in dashboard while bot is processing
Unread badges	Per-chat unread count with visual indicators
Chat management	Custom names, tags, starred chats, notes, search
Broadcast	Send messages to all or starred conversations
Schedule	Working hours configuration with per-chat override
Scalable	Optimized for 1,000+ users with cached index lookups

Requirements

Requirement	Details
Dify	v0.7.0+ with plugin support enabled
LINE	A LINE Official Account with Messaging API channel
Dify App	A published Chatbot or Agent app with an API key

Quick Start

Step 1 — LINE Developers Console

Go to LINE Developers and create a Messaging API channel (or use an existing one).
Copy the Channel Secret from Basic settings.
Issue a Channel Access Token from the Messaging API tab.

Step 2 — Dify App

Create or open your Dify app (Chatbot or Agent).
Publish the app and go to API Access to copy the API key (starts with ).

Step 3 — Install the Plugin

In Dify, go to Plugins and upload the file (download from Releases).
Click + to add a new endpoint and fill in the settings:

[Image blocked: Plugin Settings (1/2)] [Image blocked: Plugin Settings (2/2)]

Settings Reference

Setting	Required	Default	Description
Endpoint Name	Yes	—	A name for this endpoint (e.g. )
Channel Secret	Yes	—	LINE Developers > Basic settings
Channel Access Token	Yes	—	LINE Developers > Messaging API
Dify App API Key	Yes	—	Your Dify app's API key ()
Admin Dashboard Password	Yes	—	Password to access the admin web UI
Dify API URL	No		Change for self-hosted Dify (e.g. )
Pass LINE Display Name	No		Forward user's LINE name as an input variable
Display Name Variable	No		Variable name for the display name in your Dify app
Enable Image Support	No		Accept images and files from LINE
Image Variable Name	No		Variable name for uploaded images in your Dify app
Image Prompt	No		Query text sent to Dify when user sends an image
Image Debounce (seconds)	No		Wait time to batch multiple images ( = disabled, recommended: )
Markdown to FlexMessage	No		Render replies as rich FlexMessage bubbles
Strip Markdown	No		Remove markdown formatting from bot replies
Debug Mode	No		Show error details in LINE replies (for development only)
Welcome Message	No		Message sent when a user adds the bot as friend
Max Stored Media	No		Max media files kept for admin preview
Max Media Storage (MB)	No		Max total size for stored media in MB

Step 4 — Set the Webhook URL

After installing, Dify shows the endpoint URLs:

[Image blocked: Plugin Endpoints]

Copy the POST URL.
In LINE Developers > Messaging API > Webhook URL, paste it.
Enable Use webhook.
Disable Auto-reply messages in the LINE Official Account Manager.

Step 5 — Admin Dashboard

Open the GET endpoint URL in your browser:

[Image blocked: Admin Dashboard Login]

Enter the admin password you configured in Step 3 to access the dashboard.

Message Types

LINE Message	Behavior	Dify Variable
Text	Forwarded as query	—
Image	Uploaded and forwarded	(configurable)
Video	Uploaded and forwarded
Audio	Uploaded and forwarded
File	Uploaded and forwarded
Sticker	Ignored silently	—

Image Debounce

When a user sends multiple images at once, each arrives as a separate webhook event. Without debounce, the bot responds to each individually:

Set to seconds for the best experience with multi-image uploads.

User Commands

Command	Action
	Reset conversation and start fresh
	Same as
	Same as

How It Works

Conversation Flow

LINE webhook arrives at the plugin's POST endpoint
Signature verification using HMAC-SHA256 with Channel Secret
Loading animation shown to the user while processing
Dify API call with streaming (automatic blocking fallback)
Response formatting — strip markdown, split long messages, extract image URLs
Reply via LINE Reply API (free) with Push API fallback

Retry Strategy

Storage

All storage keys are namespaced per endpoint using a hash of the Channel Secret, so multiple endpoints in the same plugin installation are fully isolated.

Key Pattern	Data	Limit
	Dify conversation ID	1 per chat
	Chat message history	100 messages
	Index of all conversations	1,000 entries
	Stored media files	configurable (default: 200 files / 800 MB)
	Bot disabled flag	1 per chat

Total plugin storage quota: 1 GB

Troubleshooting

Problem	Solution
Bot doesn't reply	Check webhook URL is correct and "Use webhook" is enabled in LINE settings
error in webhook	Verify Channel Secret and Channel Access Token are correct
Images not working	Enable "Image Support" in settings and add a file input variable in your Dify app
Bot replies multiple times for images	Set Image Debounce to seconds
Admin dashboard won't load	Use the GET endpoint URL (not the POST webhook URL)
Bot not responding in group chat	Make sure the bot is invited to the group and has permission to read messages
Conversation seems to reset	Check Dify app logs — the conversation ID may have expired or been invalidated

Changelog

See CHANGELOG.md for the full release history.

License

MIT

Author

suphachok — @DomT00T