hatang.dev

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ư.

Cập nhật ngày

Trong bài này

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.
  • Đã 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 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
Trang kết nối LINE với ô Channel secret và Channel access token

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.

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

Bước tiếp theo

Bài viết này có giúp ích cho bạn không?

Bài viết liên quan

Chưa tìm thấy điều bạn cần?

Đội ngũ của chúng tôi trả lời qua chat, bằng tiếng Việt hoặc tiếng Anh.

Gửi email cho chúng tôi

Bạn đang tích hợp API hoặc SDK? Xem tài liệu cho lập trình viên →