# Kết nối LINE

Kết nối LINE Official Account qua Messaging API để tin nhắn của khách trên LINE về Hộp thư.

Kết nối **LINE Official Account** để tin khách nhắn tới tài khoản trên LINE về **Hộp thư**, cạnh các kênh khác. Kênh này hợp với doanh nghiệp bán cho khách ở Thái Lan, Nhật Bản hay Đài Loan, nơi LINE là ứng dụng nhắn tin chính. Quy tắc phân phối, luồng, trợ lý AI và báo cáo chạy như mọi kênh khác.

## Kênh này hỗ trợ gì

| Chiều | Hỗ trợ |
|---|---|
| Nhận | Văn bản và emoji, sticker (hiện dạng chữ kèm từ khoá), ảnh, video, âm thanh, tệp, vị trí, trả lời trích dẫn |
| Gửi | Văn bản (trích tin của khách), ảnh JPEG và PNG, video MP4; tệp khác gửi dạng link |
| Hồ sơ | Tên và ảnh của khách lấy từ hồ sơ LINE |
| Sự kiện | Ghi chú nội bộ khi khách thu hồi tin, kết bạn với tài khoản hoặc chặn tài khoản |
| Đã xem | Khách thấy tin đã được xem khi nhân viên mở hội thoại (cần bật Chat, xem bên dưới) |

Chỉ **chat 1-1** về Hộp thư. Tin trong nhóm và phòng chat không được xử lý.

## Trước khi bắt đầu

- Một **LINE Official Account**, tạo trong [LINE Official Account Manager](https://manager.line.biz).
- Đã bật **Messaging API** cho tài khoản đó: trong LINE Official Account Manager, mở **Settings → Messaging API** và bật (chọn hoặc tạo provider).
- Một website ở **Hỗ trợ khách hàng → Kênh**, và mức **Quản lý** ở module Hỗ trợ khách hàng.

## Bước 1: Lấy Channel secret và access token

Mở [LINE Developers console](https://developers.line.biz/console/) và chọn kênh Messaging API của tài khoản:

1. Ở tab **Basic settings**, chép **Channel secret** (32 ký tự chữ và số).
2. Ở tab **Messaging API**, mục **Channel access token (long-lived)**, bấm **Issue** và chép token.

## Bước 2: Kết nối trên Hạ Tầng

1. Vào **Hỗ trợ khách hàng → Kênh**, bấm **Thêm kênh** và chọn **LINE** trong nhóm **Ứng dụng nhắn tin**.
2. Nếu doanh nghiệp có nhiều website, chọn một website ở **Gắn kết nối mới vào site**.
3. Dán **Channel secret** và **Channel access token**, rồi bấm **Kết nối LINE**.

![Trang kết nối LINE với ô Channel secret và Channel access token](https://hatang.dev/help/img/vi/channels/connect-line.webp)

Hạ Tầng kiểm tra token, đặt webhook cho kênh trong LINE và nhờ LINE gửi thử. Tài khoản hiện với `@basic ID` và trạng thái **Hoạt động**.

Nếu lần gửi thử thất bại, trang của tài khoản hiện cảnh báo như `Webhook test failed …: turn on "Use webhook" in LINE Developers → Messaging API`. URL webhook cũng hiện trên trang của tài khoản, mục **Cách hoạt động**, để bạn dán tay khi cần.

## Bước 3: Hoàn tất cài đặt trong LINE

1. Trong **LINE Developers → Messaging API**, bật **Use webhook**.
2. Trong **LINE Official Account Manager → Response settings**, **tắt** tin tự động trả lời và tin chào, để khách không nhận hai câu trả lời.
3. Bật **Chat** nếu muốn khách thấy tin đã được xem khi nhân viên mở hội thoại.

Nhắn thử tới tài khoản từ ứng dụng LINE để kiểm tra tin đã về Hộp thư.

## Chi phí tin nhắn

| Khi bạn trả lời | Chi phí |
|---|---|
| Trong khoảng một phút sau tin của khách | Miễn phí |
| Trễ hơn | Tính vào số tin miễn phí hằng tháng của gói OA |

Hạ Tầng luôn trả lời theo cách miễn phí khi có thể: tin trả lời gửi trong khoảng 50 giây sau tin mới nhất của khách là miễn phí. Khi hết số tin của tháng, các tin trả lời sau đó không gửi được và hội thoại có ghi chú nội bộ.

## Giới hạn

- Tin dài được chia thành nhiều tin 5.000 ký tự.
- Tệp nhận được giữ đến 25 MB.
- Tin trả lời viết trong LINE Official Account Manager **không** hiện trong Hộp thư, vì LINE không gửi chúng cho ứng dụng. Hãy trả lời khách từ Hạ Tầng.
- LINE không cho ứng dụng thu hồi tin, nên không thu hồi được tin đã gửi.
- Không xử lý rich menu và Flex message.

Muốn giao hội thoại LINE cho một nhóm, tích **LINE** ở mục **Kênh (không chọn = mọi kênh)** của [quy tắc phân phối](https://hatang.dev/vi/help/automation/routing-rules).

## Ngắt kết nối

**Ngắt kết nối** trên trang của tài khoản sẽ dừng tin mới về Hộp thư. Hội thoại cũ vẫn được giữ. LINE không cho ứng dụng xoá URL webhook, nên hãy tự gỡ trong LINE Developers nếu bạn ngừng dùng Hạ Tầng; tin tới tài khoản đã ngắt kết nối đều bị bỏ qua. Kết nối lại cùng tài khoản thì lịch sử được giữ nguyên.

## Xử lý sự cố

| Sự cố | Nguyên nhân | Cách xử lý |
|---|---|---|
| Hộp thư báo "LINE Official Account đã dùng hết số tin nhắn miễn phí của tháng" | Gói đã hết số tin của tháng | Nâng gói trong LINE Official Account Manager, hoặc trả lời ngay khi khách nhắn |
| Hộp thư báo "Channel access token của LINE không còn hợp lệ" | Token bị thu hồi hoặc phát hành lại | Phát hành token mới trong LINE Developers rồi kết nối lại LINE |
| Không có tin nào về | **Use webhook** đang tắt, hoặc chưa đặt webhook | Bật **Use webhook** trong LINE Developers và kiểm tra URL webhook |
| Khách nhận hai câu trả lời | Tin tự động trả lời hoặc tin chào của OA vẫn bật | Tắt chúng trong LINE Official Account Manager |
| Kết nối báo "LINE rejected this channel access token" | Token bị gõ sai hoặc đã bị thu hồi | Phát hành token mới trong LINE Developers |
| Kết nối báo "The Channel secret is 32 hexadecimal characters" | Dán nhầm giá trị | Chép Channel secret ở **Basic settings** |