LINE #

Kết nối LINE Official Account của riêng bạn để các cuộc trò chuyện trên LINE đổ về ứng dụng và AI Agent có thể trả lời. Bạn kết nối bằng cách dán thông tin xác thực LINE Messaging API (Channel secret + access token) và thiết lập một webhook URL — không cần lập trình.

Tích hợp LINE là gì? #

Tích hợp LINE liên kết LINE Official Account (OA) mà bạn sở hữu với nền tảng thông qua Messaging API chính thức của LINE — hệ thống riêng của LINE để gửi và nhận tin nhắn tự động, thay vì bạn phải nhập thủ công trong ứng dụng LINE. Các cuộc trò chuyện 1-1 với những người đã thêm OA của bạn làm bạn bè sẽ khả dụng bên trong ứng dụng, và AI Agent, Broadcasts cũng như hộp thư đến dùng chung sẽ hoạt động trên các cuộc trò chuyện đó.

Không giống như Telegram hay WhatsApp Web, đây là một tích hợp chính thức — nó sử dụng Messaging API của riêng LINE, vì vậy nó ổn định và tuân thủ các quy tắc của LINE. Vì LINE không có nút “kết nối” một lần nhấp cho các công cụ của bên thứ ba, bạn sẽ dán thông tin xác thực OA của mình một lần trong quá trình thiết lập.

Tính khả dụng. Tài khoản chính thức LINE phổ biến nhất ở Nhật Bản, Đài Loan, Thái Lan và Indonesia, và không khả dụng tại EU. Bạn cần có Tài khoản chính thức LINE được đăng ký tại một khu vực được hỗ trợ để sử dụng kênh này.

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

Bạn sẽ tạo (hoặc sử dụng) ba thứ trong bảng điều khiển của LINE. Đây là thiết lập một lần mất khoảng 5 phút.

1. Một LINE Official Account (được tạo trong LINE Official Account Manager). Nếu bạn chưa có, hãy đăng nhập bằng LINE Business ID của bạn và tạo tài khoản mới — đặt tên và điền vào biểu mẫu ngắn.
2. Một kênh Messaging API cho OA đó. Cách dễ nhất là bật nó từ bên trong OA Manager (xem Bước 1 bên dưới) — bạn không cần phải tạo kênh thủ công trong Developers Console trước. Khi được nhắc, hãy chọn một nhà cung cấp (provider) hiện có hoặc tạo một cái mới.
3. Từ kênh đó, lấy ba giá trị bạn sẽ dán vào ứng dụng:
   • Channel ID (tab Basic settings) — tùy chọn, chỉ mang tính thông tin
   • Channel secret (tab Basic settings)
   • Channel access token — một token có thời hạn dài mà bạn cấp trên tab Messaging API

Không yêu cầu tài liệu kinh doanh đối với Tài khoản chính thức tiêu chuẩn (chưa xác minh) — chỉ cần LINE Business ID. Việc xác minh (huy hiệu màu xanh dương) là tùy chọn và chỉ được cung cấp ở một số khu vực.

Thiết lập LINE #

Bước 1: Kích hoạt Messaging API cho Official Account của bạn #

1. Đăng nhập vào LINE Official Account Manager (hoặc tạo Official Account mới trước).
2. Mở OA của bạn.
3. Nhấp vào Settings (góc trên bên phải).
4. Trong menu cài đặt, nhấp vào Messaging API.
5. Trạng thái ban đầu là Disabled — nhấp để bật nó lên.
6. Chọn nhà cung cấp (provider) cho kênh này (công ty/nhà phát triển sở hữu nó). Nếu bạn chưa có, hãy tạo nhà cung cấp mới, sau đó xác nhận.

Bước 2: Lấy thông tin xác thực từ Developers Console #

Việc bật Messaging API sẽ tạo một kênh dưới nhà cung cấp của bạn trong LINE Developers Console.

1. Mở tài khoản nhà phát triển / nhà cung cấp.
2. Nhấp vào kênh Messaging API.
3. Mở tab Basic settings và sao chép Channel ID và Channel secret của bạn.
4. Mở tab Messaging API, cấp (hoặc tạo lại) một Channel access token có thời hạn dài và sao chép nó.

Hãy giữ các giá trị này — bạn sẽ dán chúng vào ứng dụng ngay sau đây.

Bước 3: Kết nối LINE trong ứng dụng #

1. Trong thanh bên trái, nhấp vào Settings (Cài đặt) ở gần phía dưới.
2. Trong thanh điều hướng bên trái của Settings, tại mục Channels (Kênh), nhấp vào Channels.
3. Tìm thẻ LINE và nhấp vào Connect (Kết nối).
4. Tùy chọn, dán Channel ID (ID kênh) của bạn — chỉ mang tính chất thông tin.
5. Dán Channel secret (Mã bí mật kênh) của bạn.
6. Dán Channel access token (Mã truy cập kênh) của bạn.
7. Nhấp vào Connect (Kết nối).
8. Ứng dụng sẽ xác thực thông tin đăng nhập với LINE và hiển thị “Connected to: <tên OA của bạn>” (Đã kết nối với: <tên OA của bạn>). Nếu thông tin đăng nhập không chính xác, bạn sẽ nhận được thông báo lỗi — hãy cấp lại mã truy cập trong LINE Developers Console và thử lại.

Bước 4: Thiết lập Webhook URL trong LINE #

Sau khi kết nối, ứng dụng hiển thị phần Finish setup in LINE với một webhook URL — hãy sao chép nó. (Webhook URL chỉ là một địa chỉ web; việc dán nó vào LINE sẽ cho LINE biết nơi tự động gửi tin nhắn mới.) Sau đó, trong LINE Developers Console cho kênh Messaging API của bạn:

1. Mở tab Messaging API.
2. Dán URL vào Webhook URL.
3. Nhấp vào Update.
4. Bật Use webhook sang ON.

Bước 5: Sửa cài đặt trong Official Account Manager (Quan trọng) #

Theo mặc định, một LINE OA tự xử lý các cuộc trò chuyện và tự động trả lời, điều này ngăn tin nhắn đến được với AI. Quay lại LINE Official Account Manager, mở cài đặt OA của bạn và thiết lập:

Nếu ứng dụng cảnh báo rằng tài khoản của bạn đang ở Chat mode, hãy chuyển sang Bot mode tại đây — bot sẽ không thể nhận hoặc gửi tin nhắn cho đến khi bạn thực hiện việc này.

Bước 6: Kiểm tra Bot #

1. Từ một điện thoại khác (ví dụ: ứng dụng LINE của riêng bạn), hãy thêm Official Account của bạn làm bạn bè và gửi cho nó một tin nhắn.
2. Mở ứng dụng và đi tới Chats — tin nhắn đến sẽ xuất hiện trong danh sách cuộc trò chuyện.
3. Nếu AI Agent đang xử lý kênh này, bạn sẽ thấy nó tự động trả lời tin nhắn thử nghiệm.

Sau khi kết nối với webhook đã thiết lập và các nút gạt trên đã chính xác, tài khoản LINE của bạn sẽ hiển thị là Connected trên trang Channels và AI sẽ phản hồi các tin nhắn đến.

Chi phí #

LINE là một kênh miễn phí trong ứng dụng — không có phí mỗi tin nhắn và không có phí kết nối hàng tháng từ chúng tôi. Lưu ý rằng các gói của riêng LINE có giới hạn hàng tháng riêng cho tin nhắn push (gửi chủ động), thay đổi tùy theo khu vực và loại tài khoản. Các phản hồi được gửi ngay sau khi khách hàng nhắn tin cho bạn là miễn phí trên LINE; các tin nhắn gửi chủ động/broadcast sẽ được tính vào hạn mức gói LINE của bạn.

Tin nhắn đa phương tiện #

Ảnh, video, tin nhắn thoại, tệp, nhãn dán và vị trí gửi đến đều được nhận diện để AI biết rằng phương tiện đã được gửi (một ghi chú ngắn sẽ được thêm vào cuộc trò chuyện). Các phản hồi AI gửi đi trong phiên bản này bao gồm văn bản và hình ảnh. Các phản hồi dài sẽ được tự động cắt bớt theo giới hạn 5.000 ký tự của LINE.

Quản lý phiên #

Kiểm tra trạng thái kết nối #

Trạng thái kết nối LINE của bạn được hiển thị trên thẻ LINE tại trang Kênh (Channels):

Thẻ này cũng kiểm tra lại cài đặt Chế độ trò chuyện (Chat mode) trong tài khoản của bạn mỗi khi bạn mở trang Kênh (Channels). Nếu tài khoản LINE của bạn đã bị chuyển ngược lại Chế độ trò chuyện (khiến bot ngừng nhận hoặc gửi tin nhắn), một cảnh báo màu vàng sẽ xuất hiện trên thẻ, yêu cầu bạn chuyển lại về Chế độ bot (Bot mode) trong LINE Official Account Manager — hãy kiểm tra lại các nút chuyển đổi ở Bước 5 tại đó và cảnh báo sẽ biến mất trong lần truy cập tiếp theo.

Ngắt kết nối #

Mở thẻ LINE và nhấp vào Quản lý, sau đó nhấp vào Ngắt kết nối trong bảng điều khiển mở ra và xác nhận Xóa LINE?. Thao tác này sẽ xóa kết nối ở phía chúng tôi. Để dừng hoàn toàn việc LINE gửi sự kiện, hãy tắt Sử dụng webhook (hoặc xóa URL webhook) trong Bảng điều khiển dành cho nhà phát triển LINE.

Hạn chế #

• Mỗi kết nối cho một Official Account. Kết nối từng OA riêng biệt; một OA chỉ có thể được liên kết với một tài khoản.
• Gửi văn bản + hình ảnh. AI phản hồi bằng văn bản và hình ảnh; các tin nhắn dạng “Flex”/mẫu/carousel phong phú sẽ không được gửi trong phiên bản này.
• Khu vực. LINE Official Accounts không khả dụng tại EU; bạn cần có OA tại một khu vực được hỗ trợ (ví dụ: Nhật Bản, Đài Loan, Thái Lan, Indonesia).
• Thời gian phản hồi. Các phản hồi tức thì miễn phí của LINE có khung thời gian ngắn; các tin nhắn gửi sau đó sẽ tự động được gửi dưới dạng tin nhắn push (có tính vào hạn mức).

Khắc phục sự cố #

Thông tin xác thực bị từ chối khi kết nối #

• Đảm bảo bạn đã tạo kênh Messaging API (không phải “LINE Login”).
• Cấp lại mã truy cập kênh dài hạn (long-lived channel access token) trên tab Messaging API và dán giá trị mới vào.
• Xác nhận bạn đã sao chép Channel secret từ tab Cài đặt cơ bản (không phải Channel ID).

Bot không phản hồi #

• Xác nhận Webhooks đã được bật (On) trong cả Developers Console và OA Manager.
• Xác nhận Webhook URL khớp với URL hiển thị trong ứng dụng.
• Xác nhận Chế độ phản hồi (Response mode) là Bot (không phải Chat) trong OA Manager.

Khách hàng nhận được hai phản hồi #

• Tắt (Off) Tin nhắn tự động (Auto-response messages) và Tin nhắn chào mừng (Greeting messages) trong OA Manager — các tính năng tự động phản hồi tích hợp sẵn của LINE đang gửi tin nhắn cùng lúc với AI.

Tin nhắn không đến được ứng dụng #

• Xác minh rằng người liên hệ đã thêm Tài khoản chính thức (Official Account) của bạn làm bạn bè (LINE chỉ gửi tin nhắn từ bạn bè).
• Kiểm tra lại webhook URL và đảm bảo Sử dụng webhook (Use webhook) đã được bật.

Các phương pháp hay nhất #

• Hoàn tất các thiết lập trong OA Manager (Chế độ Bot, bật Webhooks, tắt Tin nhắn chào mừng + Tự động phản hồi) — hầu hết các vấn đề thiết lập đều xuất phát từ đây.
• Phản hồi kịp thời để giữ các phản hồi trong phạm vi miễn phí của LINE và tiết kiệm hạn mức gửi tin nhắn (push quota) của bạn.
• Giữ an toàn cho mã truy cập (access token) của bạn — bất kỳ ai có mã này đều có thể gửi tin nhắn dưới danh nghĩa Tài khoản chính thức của bạn. Hãy cấp lại mã trong Developers Console nếu mã bị lộ.