# Official Account

## Overview

A LINE Official Account (OA) is used as a communication channel for Unifi Apps—for announcements, onboarding, marketing campaigns, and customer support.

For detailed instructions on creating an OA, refer to:

[Create an Account | LINE for Business >](https://www.linebiz.com/jp-en/other/)

## **Types of LINE Official Accounts**

### **Unverified OA (Recommended)**

* No approval required from LINE’s local legal entity
* Immediately usable and easy to integrate with Unifi Apps
* Recommended for all Unifi Apps onboarding cases

### **Verified OA**

* Requires approval from LINE local entities in **Japan, Thailand, or Taiwan**
* Approval process could take a long time (often 3+ months)
* Not recommended unless legally required

## OA Profile (Required)

The profile (name, icon, description) should follow the same style and branding as the Unifi Apps.

<figure><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2FtIwbxGR1LdQgKci5NQqZ%2FS__3563526.jpg?alt=media&#x26;token=572ed3a5-2a08-4652-99d9-f5109eb6de14" alt="" width="375"><figcaption></figcaption></figure>

## Contents for OA

<figure><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2F7r5gqXnMeCujZmt6Xw84%2Fimage%20(1).png?alt=media&#x26;token=33e8ddf1-3a0d-4353-9da2-cb6d9c8a4eee" alt=""><figcaption></figcaption></figure>

### Welcome Message&#x20;

#### Text

* **Default Language:** English\
  (Since OA is globally accessible, English is required as the default language.)
* **Optional Languages:** Japanese, Thai, Chinese
* It is acceptable to include multiple languages within a single welcome message.

#### Rich Message

* Rich messages may include **images or videos** with descriptive text.
* A **CTA URL** is required (e.g., Unifi Apps URL).

### Rich Menu Setup

> Location: LINE Official Account > Home > Chat screen > Rich menus > Menu content setting

#### **Language**

* Default: **English**

#### **Template Guidelines**

The following structure is optimized to increase user conversion into the Unifi Apps:

<figure><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2Fc4ocnHtW4rbpEF1rJwAC%2FOA_Richmenu_Unifi.png?alt=media&#x26;token=1852a045-baf1-47d0-a1fd-f70b81527c4e" alt="" width="563"><figcaption></figcaption></figure>

<table><thead><tr><th width="205.40631103515625">Section</th><th>Description</th></tr></thead><tbody><tr><td>A</td><td>LINE MINI App URL or LINE Login LIFF URL for Unifi Apps</td></tr><tr><td>B &#x26; C</td><td><ul><li><strong>If section A contains the LINE MINI App URL, insert the LINE Login LIFF URL in section B.</strong></li><li><strong>For all other sections, insert URLs for social media, the website, or related channels.</strong></li></ul></td></tr><tr><td>D</td><td><ul><li><p>Unifi URL</p><ul><li>Image: Unifi Icon + Unifi Wordmark (Unifi_Logo_Primary Image)</li><li>URL: <a href="https://liff.line.me/2006533014-8gD06D64">https://liff.line.me/2006533014-8gD06D64</a></li></ul></li></ul></td></tr></tbody></table>

{% file src="<https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2Fj9PFSWjmZyWzqQTAhJjI%2FUnifi_Symbol_400x400.png?alt=media&token=4de07c89-6d3f-4c43-8074-9a71bebff016>" %}

{% file src="<https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2F9SR4hzIufg6ISzlkZdAd%2FUnifi_Logo_Primary_512_512.png?alt=media&token=9d3d394f-6560-4f7c-861a-01d988d48980>" %}

{% file src="<https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2FvrLZztBsqzwlF6eh2uFb%2FUnifi_Logo_Primary_1024_1024.svg?alt=media&token=fd494a8c-c2fc-49c5-b30c-5fe36f859aff>" %}

## Sending Messages

* To send messages to specific users, operate bots, or integrate OA with external systems, you must use the **Messaging API**.
* [Messages API >](https://developers.line.biz/en/docs/messaging-api/)

## **(Optional) Multi-Language Welcome Message Automation**

<table><thead><tr><th>Step</th><th width="697">Details</th></tr></thead><tbody><tr><td>1</td><td>Create an OA channel on LINE Developers.</td></tr><tr><td>2</td><td><ul><li>Implement an API to receive Webhook events for the OA channel (used in Step 8).</li><li>method : POST</li><li><strong>URL</strong>: Flexible</li><li>Refer to the <a href="https://developers.line.biz/en/docs/messaging-api/receiving-messages/#webhook-event-in-one-on-one-talk-or-group-chat">Webhook specifications</a>.</li><li><a href="https://developers.line.biz/en/docs/messaging-api/receiving-messages/#verify-signature">It is recommended to verify the Webhook signature.</a></li></ul></td></tr><tr><td>3</td><td>When a <a href="https://developers.line.biz/en/reference/messaging-api/#follow-event">Follow Event </a>is received via the Webhook, retrieve the <code>userId</code> from the request body.</td></tr><tr><td>4</td><td><ul><li>Use the retrieved <code>userId</code> to fetch the user’s language setting on LINE.</li><li>Use the channel access token issued from the Messaging API tab in LINE Developers.</li><li>Utilize the <a href="https://developers.line.biz/en/reference/messaging-api/#get-profile">Get Profile API</a> to retrieve the user’s language.</li></ul></td></tr><tr><td>5</td><td><ul><li>Create templates for OA messaging. Configure the necessary content in multiple languages for each locale and store the templates locally or in the cloud. Refer to the <a href="https://developers.line.biz/en/reference/messaging-api/#message-objects">Message Objects API</a> for template formatting.</li><li><p>Example: For Korean and English support, save the templates as:</p><ul><li>oa_ko.json </li><li>oa_en.json</li></ul></li></ul></td></tr><tr><td>6</td><td>Load the appropriate template based on the user's language retrieved in Step 4, and call the <a href="https://developers.line.biz/en/reference/messaging-api/#send-push-message">OA Send API</a>.</td></tr><tr><td>7</td><td>Access the <strong>Messaging API</strong> tab in LINE Developers.<br><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2FAN8DQiuQzjPemtH9qz8h%2Fimage-2025-1-9_15-47-22.png?alt=media&#x26;token=2c22bc1a-3070-4418-aa6a-89f0e679c2bd" alt=""></td></tr><tr><td>8</td><td><ul><li>Set the API endpoint developed in Steps 1–6 as the Webhook URL.</li><li>Turn the <strong>Use Webhook</strong> option to ON.</li></ul><p><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2FIYlo3Ah3jfDLVPNy2Bt3%2Fimage-2025-1-9_15-48-4.png?alt=media&#x26;token=9b7cbc74-e03d-4839-b24c-2e33531f73b9" alt="" data-size="original"></p></td></tr><tr><td>9</td><td><p>After completing Step 8, followers will receive an automated welcome message in their  language.</p><p>(*Please make sure to turn OFF the welcome message setting in the existing Official Account Manager.)</p></td></tr></tbody></table>

## LINE OpenChat (Optional)

* Useful for two-way communication outside OA
* Available only in **Japan, Thailand, and Taiwan**
* You must have a LINE account registered in each country to create OpenChat there
* You may add **one translation bot**
  * Example: Korean ↔ English auto-translation

<figure><img src="https://3579085597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjuuhQ1BuKwYKE7NR6geM%2Fuploads%2FPW1zffhkDciNDQXjKubW%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202024-12-12%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%2012.19.26.png?alt=media&#x26;token=2913736a-d8bd-4707-a970-b86f74e2f64f" alt="" width="563"><figcaption></figcaption></figure>