55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
---
|
|
summary: "Thiết lập plugin LINE Messaging API, cấu hình và cách sử dụng"
|
|
read_when:
|
|
- Bạn muốn kết nối Moltbot với ứng dụng LINE
|
|
---
|
|
# 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:
|
|
```bash
|
|
moltbot plugins install @moltbot/line
|
|
```
|
|
|
|
## Các bước thiết lập
|
|
1. Tạo một tài khoản LINE Developers và truy cập Console tại: [developers.line.biz](https://developers.line.biz/console/).
|
|
2. Tạo một nhà cung cấp (Provider) và thêm một kênh **Messaging API**.
|
|
3. Sao chép **Channel access token** và **Channel secret** từ phần cài đặt kênh.
|
|
4. Bật tính năng **Use webhook** trong cài đặt Messaging API.
|
|
5. 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:
|
|
```json5
|
|
{
|
|
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](../../start/pairing.vi.md), [Cấu hình Plugin](../../plugin.vi.md).
|