Chuyển đến nội dung chính
Plugin Telegram (nagare.plugin.builtins.telegram) cho phép bạn trò chuyện với Nagare từ ứng dụng Telegram, nhận kết quả cron job và phê duyệt công cụ khi không ngồi trước máy.

​
Cài đặt

1

Tạo bot Telegram

Trò chuyện với @BotFather, dùng lệnh /newbot và lưu lại bot token.
2

Đặt biến môi trường cho gateway

Plugin đọc token từ biến NAGARE_TELEGRAM_TOKEN. Plugin kế thừa môi trường của gateway, nên hãy đặt biến này trước khi khởi động gateway:
3

Cài plugin

Gói plugin được cài sẵn tại:
Vào Settings → Plugins → Install Plugin:
  • Trên giao diện web: tải lên tệp .nagare_plugin ở trên.
  • Trên ứng dụng desktop: nhập đường dẫn tuyệt đối tới tệp.
Sau đó kích hoạt plugin. Xem Tổng quan plugin.
4

Bắt đầu trò chuyện

Mở bot trên Telegram và gửi /start.

​
Lệnh

Mọi tin nhắn văn bản khác được chuyển tới Nagare như một tin nhắn trò chuyện bình thường.

​
Phê duyệt công cụ

Khi Nagare cần chạy công cụ có rủi ro, bot gửi tin nhắn kèm hai nút Approve và Reject. Bạn cũng có thể dùng lệnh /approve hoặc /reject kèm ID yêu cầu.

​
Lưu ý

Plugin không giới hạn người dùng Telegram nào được phép trò chuyện. Bất kỳ ai tìm thấy bot đều có thể gửi yêu cầu tới Nagare trên máy của bạn. Hãy giữ bí mật tên bot và luôn đọc kỹ yêu cầu phê duyệt trước khi chấp nhận.
  • Bot dùng long polling, nên không cần mở cổng hay cấu hình webhook.
  • Nếu cuộc trò chuyện không hoạt động trong 2 giờ, kênh được giải phóng; tin nhắn tiếp theo sẽ tự kết nối lại.
  • Nhật ký của plugin nằm tại ~/.nagare/logs/plugins/nagare.plugin.builtins.telegram.log.