Node-RED nodes for LINE Messaging API integration. Build LINE Bots easily with visual programming.
npm install node-red-contrib-line-messaging-apiNode-RED nodes for LINE Messaging API integration.
Build LINE Bots easily with Node-RED's visual programming interface.
---
This package provides Node-RED nodes for integrating with LINE Messaging API, allowing you to create LINE Bots using Node-RED's visual flow editor. Create webhooks, send messages, and handle LINE Bot events with simple drag-and-drop nodes.
---
Run the following command in the root directory of your Node-RED install:
``sh`
npm install node-red-contrib-line-messaging-api
Or using Node-RED's Palette Manager:
1. Go to the Node-RED menu
2. Select "Manage palette"
3. Click the "Install" tab
4. Search for "line-messaging-api"
5. Click install
---
The configuration node stores your LINE Bot credentials (Channel Secret and Channel Access Token). This background node isn't displayed in the editor but is accessible through the settings UI of Reply and Push nodes.
> 
Created LINE Bot configurations can be shared across multiple Reply and Push nodes.
---
1. Place a Webhook node and double-click to configure it. Set the /path and register the Webhook URL (your hostname + path) in the LINE Developers console for your Messaging API.msg.payload
2. Place a ReplyMessage node and configure the channel secret and access token.
3. Connect the Webhook node to the ReplyMessage node to create an echo bot that responds to LINE messages.
4. Process between the Webhook and ReplyMessage nodes to send various message types. Use plain text strings for text messages, or LINE-defined message objects for rich messages.
Send push messages by setting text in msg.payload to send text messages.
> 
#### Text Message v2 with User Mentions
Send push messages with user mentions using Text Message v2 by setting msg.payload with {placeholder} text and configuring msg.substitution.
- msg.payload: Welcome, {user1}! {laugh}\n{everyone} There is a newcomer!
- msg.substitution:
`json`
{"user1": {"type": "mention", "mentionee": {"type": "user", "userId": "Uxxxxxxxxxxxx"}},"laugh": {"type": "emoji","productId": "670e0cce840a8236ddd4ee4c","emojiId": "002"},"everyone": {"type": "mention","mentionee": {"type": "all"}}}
> 
#### Custom Messages
Send custom messages by setting arrays or message objects in msg.payload.
`js
msg.payload = [
{
type: "text",
text: "hogehoge",
},
{
type: "image",
originalContentUrl: 'https://i.gyazo.com/e772c3b48a07716226f7184d7f417cda.png',
previewImageUrl: 'https://i.gyazo.com/e772c3b48a07716226f7184d7f417cda.png'
}
]
return msg;
``
Send messages to all bot friends.
> 
Display loading indicators to users.
> 
> https://developers.line.biz/en/reference/messaging-api/#display-a-loading-indicator
Retrieve user profile information.
https://developers.line.biz/en/reference/messaging-api/#get-profile
Retrieve bot information.
https://developers.line.biz/en/reference/messaging-api/#get-bot-info
---
| Node Type | Description |
|-----------|-------------|
| Webhook | Receives webhooks from LINE platform |
| Reply Message | Sends reply messages using reply tokens |
| Push Message | Sends push messages to specific users |
| Broadcast Message | Sends messages to all bot friends |
| Loading | Displays loading indicators |
| Get Profile | Retrieves user profile information |
| Get Bot Info | Retrieves bot information |
| Limit | Checks message quota limits |
| LINE Bot Config | Stores bot credentials (background node) |
---
- HTTPS Required: For production webhook endpoints
- LINE Developers Account: Required for creating LINE Bots
- Node-RED: Compatible with Node-RED v1.0+
- Dependencies: @line/bot-sdk, express, body-parser, cors
---
* Node-RED Flows
* Libraries.io
* npm
---
This node restricts some dependencies to a specific major version
because newer major versions may introduce breaking changes.
- 2024/12/27: v0.4.3 - Added internationalization (i18n) support, removed LINE Notify nodes (API discontinued), updated documentation with English/Japanese versions
- 2024/12/27: Added Loading, getProfile, and config nodes
- 2023/12/11: Added Notify_new with sticker and image support
- 2021/8/1: Reply Message now supports images (thanks @ukkz)
- 2020/12/17: Added Broadcast Message support, Reply Message supports Flex Messages (thanks @gaomar)
- 2019/2/13: Added PUSH Message and LINE Notify support
- 2018/10/11: Initial release with basic reply functionality
---
Pull requests and bug reports are welcome.
This project is licensed under the Apache 2.0 license.
Created and maintained by n0bisuke.
---