Skip to main content
GuidesAPI ReferenceSupport

LINE Reference and Resources

A lookup companion for the LINE section. LINE and 8x8 use different words for overlapping objects, and the object LINE calls a user ID is the field 8x8 calls channelUserId. This page gives you the vocabulary on both sides and the mapping between them.

Glossary: LINE Terms​

TermDefinition
LINE Official Account (OA)The LINE account that represents your business. Users add it as a friend, and messages are exchanged with those friends. On the 8x8 platform this is the line channel type value.
Unverified AccountAn Official Account that has not been reviewed by LINE. Available to any company, organization, or individual. Does not appear in LINE in-app search results.
Verified AccountAn Official Account that has passed LINE's review. Receives a Verified account badge and appears in LINE in-app search results. Review applications are accepted only for Japan, Taiwan, and Thailand, and take about 10 business days.
Premium AccountA tier that LINE may assign against criteria it sets. LINE states it has no responsibility to disclose those criteria. You cannot apply for it the way you apply for a Verified Account.
Basic IDThe account ID that LINE assigns to an Official Account automatically.
Premium IDA purchased account ID of your own choosing, replacing the basic ID. Up to 18 characters using half-width letters, numbers, dots, hyphens, and underscores. USD 12 per year, auto-renewing annually, non-refundable, and not changeable while in use. On the 8x8 provisioning form this is the OA ID field.
Business IDLINE's common login for its business and developer services, including LINE Official Account Manager and the LINE Developers Console. Up to 100 Official Accounts can be created under one Business ID.
ProviderThe LINE entity that owns your channels. Significant because LINE issues a different user ID for the same person under a different provider.
ChannelA communication path used to access features of the LINE Platform. Types include the Messaging API channel, the LINE Login channel, and the LINE MINI App channel.
Messaging API channelThe channel created when you enable the Messaging API on an Official Account. This is what 8x8 connects to.
Channel IDThe unique identifier of a Messaging API channel, found in LINE Official Account Manager under Settings > Messaging API (also visible in the LINE Developers Console). Required by 8x8 when you bring your own Official Account.
Channel SecretA private key known only to LINE and the developer, found on the channel's Basic settings tab. LINE uses it as the hash key when signing webhooks. Admin privileges are required to retrieve or reissue it.
Channel access tokenAn opaque string proving an application may use a channel. LINE issues four kinds, with lifetimes from 15 minutes to indefinite. 8x8 manages these on your behalf.
User IDLINE's opaque identifier for a user, format U[0-9a-f]{32}. Distinct from a display name and from the LINE ID a user registers to be searchable. On the 8x8 platform it is channelUserId, in both directions: you send to user.channelUserId and it arrives back in payload.user.channelUserId.
FriendA LINE user who has added your Official Account. Messages are exchanged with friends, and deleting the account deletes all of them.
Follow eventLINE's webhook event fired when a user adds your Official Account as a friend. This is the moment a user ID first becomes available to you.
OA Chat packageA separately purchased subscription add-on for an Official Account, bought in LINE Official Account Manager. If cancelled, it remains usable to the end of the current month, and tags and notes already created are not deleted.
LINE Official Account ManagerLINE's own console for an Official Account. Where you enable the Messaging API and retrieve the Channel ID, Channel Secret, and Webhook URL for it, manage the profile and search visibility, purchase plans and Premium IDs, manage administrators, and view Insights.
LINE Developers ConsoleLINE's advanced console for channels, also covering other channel types such as LINE Login and LINE MINI App. The Channel ID, Channel Secret, and Webhook URL for a Messaging API channel are visible here too, but LINE Official Account Manager's Messaging API settings page is the primary place 8x8 documentation points you to.
InsightsLINE's own account statistics, inside LINE Official Account Manager. One of only two features that remain usable after an Official Account is deleted, the other being billing.
Collaborative AccountAn advertising menu LINE provides separately, which enables the narrow published exceptions to LINE's prohibition on advertising for third parties.

Glossary: 8x8 Terms​

TermDefinition
8x8 AccountYour primary customer account with 8x8.
Sub-accountA logical grouping within your 8x8 Account that owns credentials and channels. All Messaging Apps calls are made in the context of a subAccountId. LINE requires a new sub-account, not an existing SMS sub-account, and LINE Official Notification requires its own sub-account separate from the LINE Official Account channel.
Channel type valueThe string that identifies a channel in the platform. line for the LINE Official Account channel, LineNotification for LINE Official Notification, and Line in the channels fallback override array.
API keyThe bearer token that authenticates a Messaging Apps request, generated per sub-account in the 8x8 Connect portal and sent as Authorization: Bearer {apiKey}.
umidThe unique message ID, a GUID generated by the 8x8 platform when a message is submitted. Returned in the send response, and repeated in every delivery receipt on channels that produce one.
clientMessageIdYour own reference for a message, maximum 50 characters. Echoed back in the send response, and in delivery receipts on channels that produce one.
batchId and clientBatchIdThe equivalent identifiers for a batch of messages, 8x8-generated and customer-supplied respectively. Present in delivery receipts for messages sent as a batch.
Delivery receipt (DR)A POST webhook the 8x8 platform sends to your callback URL when a message's status changes. Carries eventType of outbound_message_status_changed, currently in the v9 format. Both LINE products produce delivery receipts. The line channel reports Accepted and Sent. LINE Official Notification additionally reports Delivered.
Inbound message webhookA POST webhook the 8x8 platform sends to your callback URL when a user sends a message. Carries eventType of inbound_message_received, currently in the v3 format.
Callback URLThe URL on your server where 8x8 delivers webhooks. One URL serves every Messaging Apps channel, and the channel field identifies the source. Registered with the Webhooks Configuration API, and overridable per message with dlrCallbackUrl.
Channel fallbackA configured sequence of channels used to reach a recipient, with a wait time between each. Set up by the 8x8 team, and overridable per message with the channels array. The line channel reports Accepted and Sent, which the fallback chain can use to evaluate whether to proceed.
8x8 ConnectThe customer portal, where you generate API keys, manage sub-accounts, and view Messaging Apps analytics.
Messaging AppsThe 8x8 product that provides messaging over LINE, WhatsApp, Viber, RCS, Zalo, and other chat channels.

Term Mapping​

The same object often has one name in LINE's console and another in an 8x8 payload. This table is the bridge.

LINE termWhere it surfaces on 8x8
LINE user IDuser.channelUserId on the send request, and payload.user.channelUserId on inbound messages. On delivery receipts from the line channel it appears as payload.user.channelUserId, and a LON receipt carries msisdn instead
LINE Official AccountThe line channel type value, and the channel configured on your sub-account
Messaging API channelpayload.recipient.channelId on inbound messages
Channel ID and Channel SecretSupplied to 8x8 during provisioning. Not exposed in any 8x8 payload
Channel access tokenNot exposed. 8x8 authenticates to LINE for you; your application uses an 8x8 API key instead
Premium IDThe OA ID field on the 8x8 provisioning information sheet
Basic IDNo 8x8 equivalent. Assigned by LINE and visible in LINE Official Account Manager
LINE subscription plan and message allowanceNo 8x8 equivalent field. Managed in LINE Official Account Manager
LINE InsightsNo 8x8 equivalent. 8x8 volume reporting is separate, in Messaging Apps Analytics
Follow eventSurfaces as an inbound message webhook carrying channelUserId. LINE's raw event types are not passed through
LINE audio duration (milliseconds)content.audio.duration in seconds. Do not copy a value across
LINE location titlecontent.location.name

This section documents guides and payload catalogues. For the complete generated specification, use the API reference.

Additional Resources​

8x8 Cross-channel References:

LINE's Own References: