LINE - Novu — ContextQMD

The LINE chat integration lets you send messages to subscribers who have added your LINE Official Account as a friend. Novu uses the LINE Messaging API push endpoint with a Channel Access Token configured on the integration, and a LINE user ID stored on each subscriber's channel endpoint.

Supported message types:

Text - default workflow chat step content
Flex Message - rich layouts via trigger overrides
Image - image messages via trigger overrides
Sticker - sticker messages via trigger overrides

Configure a LINE Messaging API channel

Before connecting LINE in Novu, create a Messaging API channel in the LINE Developers Console and issue a Channel Access Token.

<Steps> <Step title="Open the LINE Developers Console"> Go to the [LINE Developers Console](https://developers.line.biz/console/) and sign in. </Step> <Step title="Create a provider and channel"> Create a provider (if you do not have one), then create a **Messaging API** channel for your LINE Official Account. </Step> <Step title="Issue a Channel Access Token"> Open your channel, go to the **Messaging API** tab, and issue a **Channel access token** (long-lived). Copy the token - you will paste it into Novu. </Step> <Step title="Enable webhooks (recommended)"> On the same tab, enable **Use webhook** if you plan to capture subscriber LINE user IDs from follow or message events. Set the webhook URL to your backend endpoint that creates `line_user` channel endpoints in Novu.

See LINE's docs on [getting user IDs](https://developers.line.biz/en/docs/messaging-api/getting-user-ids/) for details.

</Step> </Steps> <Note> Push messages can only be delivered to users who have added your LINE Official Account as a friend. </Note>

Configure LINE integration in Novu

<Steps> <Step title="Open Integrations Store"> In the Novu Dashboard, click **Integrations Store** in the sidebar. </Step> <Step title="Connect LINE"> Click **Connect Provider**, select **Chat**, then choose **LINE**. </Step> <Step title="Add credentials"> Paste your **Channel Access Token** from the LINE Developers Console and click **Create Integration**. </Step> </Steps>

Connect subscribers

Each subscriber needs a LINE user ID (for example, U1234567890abcdef) so Novu knows where to deliver messages. Create a line_user channel endpoint for the subscriber using the channel endpoints API.

<Tabs> <Tab title="Node.js"> ```typescript import { Novu } from '@novu/api';

const novu = new Novu({ secretKey: '<NOVU_SECRET_KEY>', // Required if using EU region // serverURL: 'https://eu.api.novu.co', });

await novu.channelEndpoints.create({ subscriberId: 'subscriberId', integrationIdentifier: 'line-<integration-id>', type: 'line_user', endpoint: { userId: '<LINE_USER_ID>', }, });

  </Tab>
  <Tab title="cURL">
```bash
curl -L -X POST 'https://api.novu.co/v1/channel-endpoints' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: ApiKey <NOVU_SECRET_KEY>' \
-d '{
  "subscriberId": "<SUBSCRIBER_ID>",
  "integrationIdentifier": "line-<integration-id>",
  "type": "line_user",
  "endpoint": {
    "userId": "<LINE_USER_ID>"
  }
}'

</Tab> </Tabs>

See the Create a channel endpoint API reference for full request details.

<Note> Push messages can only be delivered to users who have added your LINE Official Account as a friend. Capture the LINE user ID from follow or message webhook events, then register it as a `line_user` channel endpoint. </Note>

Send notifications

Create a workflow with a Chat step, add your message content, and trigger the workflow for a subscriber that has a line_user channel endpoint configured.

typescript

import { Novu } from '@novu/api';

const novu = new Novu({
  secretKey: '<NOVU_SECRET_KEY>',
});

await novu.trigger({
  workflowId: 'order-shipped',
  to: {
    subscriberId: 'subscriberId',
  },
  payload: {
    orderId: 'ORD-12345',
  },
});

The chat step content is sent as a plain text LINE message unless you override the message type at trigger time.

Rich message types

Pass flex, image, or sticker under overrides.chat when triggering a workflow. When present, Novu sends that message type instead of plain text.

<Tabs> <Tab title="Sticker"> ```typescript await novu.trigger({ workflowId: 'order-shipped', to: { subscriberId: 'subscriberId' }, payload: {}, overrides: { chat: { sticker: { packageId: '1', stickerId: '1', }, }, }, }); ``` </Tab> <Tab title="Image"> ```typescript await novu.trigger({ workflowId: 'order-shipped', to: { subscriberId: 'subscriberId' }, payload: {}, overrides: { chat: { image: { originalContentUrl: 'https://example.com/image.jpg', previewImageUrl: 'https://example.com/preview.jpg', }, }, }, }); ``` </Tab> <Tab title="Flex Message"> ```typescript await novu.trigger({ workflowId: 'order-shipped', to: { subscriberId: 'subscriberId' }, payload: {}, overrides: { chat: { flex: { altText: 'Order shipped', contents: { type: 'bubble', body: { type: 'box', layout: 'vertical', contents: [ { type: 'text', text: 'Your order has shipped!', }, ], }, }, }, }, }, }); ``` </Tab> </Tabs> <Note> Image URLs must be direct HTTPS links to JPEG or PNG files. Redirects and unsupported formats may cause delivery failures. See LINE's [message types documentation](https://developers.line.biz/en/docs/messaging-api/message-types/) for payload requirements. </Note>