Nhảy tới nội dung

Gửi tin nhắn Telegram, Lark, Slack

"Giới thiệu"

vnstock cung cấp tới bạn các hàm kết nối tới Telegram API và Slack API cho phép gửi tin nhắn, hình ảnh qua Slack channel và Telegram group. Đây là tính năng mở ra các ứng dụng gửi tin tức, cảnh báo giao dịch và các thông tin quan trọng tới bạn mà không cần đi qua bất kỳ dịch vụ trung gian nào. Các thiết dưới đây áp dụng với bản Vnstock 3.0.6

Trong Vnstock3, bạn sẽ sử dụng Messenger class để thực hiện việc gửi các loại tin nhắn đến nền tảng được hỗ trợ. Cấu hình class này như sau:

from vnstock3.botbuilder.noti import Messenger
noti = Messenger(platform='telegram', channel='-1001439492355', token_key='TOKEN_CỦA_BẠN')

Trong đó:

  • platform (str): tên của nền tảng nhắn tin bạn chọn, nhận các giá trị là telegram, slack và lark
  • channel (str): tên hoặc mã nhận dạng của kênh trong nền tảng nhắn tin. Ví dụ #news_update cho tên kênh Slack, -1001439492355 cho mã của nhóm nhận tin nhắn trong Telegram, để None nếu bạn chọn nền tảng là Lark.
  • token_key: là mã bảo mật của API sử dụng cho app nhắn tin bạn chọn theo từng nền tảng. Đối với Lark thì đây là mã id của webhook URL.

Tiếp theo, hàm send_message sẽ được sử dụng chung cho tất cả các nền tảng nhắn tin dù bạn gửi tin nhắn văn bản hay kèm hình ảnh.

noti.send_message(message='Tin nhắn của bạn', file_path='Đường dẫn file trên máy tính hoặc để None', title='Tiêu đề ảnh bạn chọn')

Cụ thể, thông số thiết lập gồm:

  • message (str, bắt buộc): Nội dung tin nhắn bạn muốn gửi qua bot
  • file_path (str, tuỳ chọn): Đường dẫn file trên máy tính. Nếu sử dụng trên máy tính Windows, lưu ý đặt chữ r phía trước, ví dụ r'path/to_your_image_file.png'
  • title (str, tuỳ chọn): tiêu đề ảnh/file nếu bạn gửi tin nhắn trong Slack khi có kèm file.

Kết quả trả về dưới dạng JSON từ server phản hồi. Cụ thể việc tạo và thiết lập bot cho từng nền tảng, bạn có thể tham khảo hướng dẫn bên dưới.

Gửi tin nhắn Telegram​

Tạo Telegram bot đầu tay là một quá trình tương đối đơn giản, bạn có thể thực hiện toàn bộ các công đoạn để có thể gửi được tin nhắn trong chưa đầy 15 phút.

  1. Nếu bạn không muốn sử dụng bot chung với tài khoản Telegram hiện có vì lý do bảo mật thì cần bắt đầu tạo tài khoản mới với App Telegram trên Smartphone trước khi bắt đầu. Trong giao diện nhắn tin, tìm kiếm BotFather và thao tác như hình dưới.
  2. Đăng nhập telgram web để tạo và thiết lập bot.
  3. Copy đoạn token và lưu giữ cẩn thận để bảo mật.
Open Modal

Gửi tin nhắn Lark BotBuilder​

Lark BotBuilder là một công cụ cho phép xây dựng các luồng tự động hoá công việc (automated workflows) trong bộ ứng dụng văn phòng LarkSuite. Bạn có thể gửi tin nhắn vào Webhook của 1 app bất kỳ tạo ra bởi BotBuilder một cách an toàn và bảo mật. Việc cài đặt 1 luồng công việc tự động với BotBuilder cũng tương đối đơn giản và linh hoạt theo hướng dẫn dưới đây. Ngoài việc dùng BotBuilder để gửi tin nhắn Lark, bạn còn có thể kích hoạt bot để gọi API và thực hiện nhiều luồng công việc khác nhau sử dụng các ứng dụng trong nền tảng Larksuite, bạn hãy khám phá thêm các ứng dụng thú vị cho riêng mình.

Truy cập trang web Botbuilder và tạo cho bạn 1 app đầu tay. Sau khi đặt tên Bot và bấm Create, bạn sẽ được đưa đến màn hình tiếp theo tại mục Flow Design, chọn Create để tiếp tục.

Open Modal

Gửi tin nhắn Slack​

Tham khảo hướng dẫn gửi tin nhắn Slack từ tài liệu API chính thức tại đây