LINE (Plugin)

Moltbot kết nối với LINE thông qua LINE Messaging API. Plugin này đóng vai trò là một bộ tiếp nhận Webhook trên Gateway, sử dụng "Channel access token" và "Channel secret" của bạn để xác thực.

Cài đặt Plugin

Trước tiên, bạn cần cài đặt plugin LINE cho Moltbot:

moltbot plugins install @moltbot/line

Các bước thiết lập

Tạo một tài khoản LINE Developers và truy cập Console tại: developers.line.biz.
Tạo một nhà cung cấp (Provider) và thêm một kênh Messaging API.
Sao chép Channel access token và Channel secret từ phần cài đặt kênh.
Bật tính năng Use webhook trong cài đặt Messaging API.
Thiết lập Webhook URL tới Gateway của bạn (Yêu cầu HTTPS): https://gateway-cua-ban/line/webhook

Cấu hình Moltbot.json

Cấu hình tối thiểu:

{
  channels: {
    line: {
      enabled: true,
      channelAccessToken: "MÃ_ACCESS_TOKEN_CỦA_BẠN",
      channelSecret: "MÃ_SECRET_CỦA_BẠN",
      dmPolicy: "pairing"
    }
  }
}

Kiểm soát quyền truy cập

Tin nhắn trực tiếp (DM): Mặc định sử dụng cơ chế ghép đôi (pairing). Người dùng mới phải nhập mã ghép đôi trước khi có thể ra lệnh cho bot.
Danh sách trắng (Allowlist): Bạn có thể chỉ định chính xác các ID người dùng hoặc nhóm được phép tương tác với bot để đảm bảo an toàn.

Tính năng tin nhắn phong phú

Moltbot hỗ trợ gửi các loại tin nhắn đặc thù của LINE như:

Flex Cards: Các thẻ thông tin có thể tùy chỉnh giao diện phức tạp.
Quick Replies: Các nút bấm phản hồi nhanh thường dùng cho các lựa chọn "Có/Không" hoặc menu lệnh.
Gửi vị trí: Gửi tọa độ bản đồ trực tiếp cho AI.

Giải quyết sự cố

Xác minh Webhook thất bại: Kiểm tra lại xem Webhook URL có phải là HTTPS không và mã channelSecret đã chính xác chưa.
Không nhận được tin nhắn: Đảm bảo cổng mạng trên máy chủ của bạn đã được mở và không bị chặn bởi tường lửa.

Tài liệu liên quan: Cơ chế Ghép đôi, Cấu hình Plugin.

2.6 KiB Raw Blame History