Telegram Bot - Ứng dụng trong việc theo dõi tính ổn định của sản phẩm

Hey, cuối tuần rảnh rỗi dành thời gian viết bài chia sẻ cách build 1 ứng dụng chatbot Telegram và dùng nó trong việc quản lý và theo dõi sản phẩm.

Case Study

Case đặt ra ở đây là hiện tại ông A đang quản lý 1 ứng dụng với lượng request lớn. Ứng dụng của ông A được thiết kế theo mô hình micro-service với việc gọi giữa các service với nhau có tỉ lệ thất thoát dữ liệu cũng như bị lạm dụng.

Đồng thời, product của ông A là 1 sản phẩm có bán sản phẩm hàng ngày. Đội sale yêu cầu ông A làm 1 cái gì đó để hàng ngày đúng 6 sáng họ mở mắt dậy ăn sáng bằng doanh số ngày hôm trước.

Trước đây ông A làm report bằng Email và kênh SMS private. Tuy nhiên, SMS thì ngày 1 đắt (500d/tin, buổi sáng gửi hết bát phở), Email thì phức tạp nên đội sale đôi khi cũng lười check.

Ông A khổ tâm lắm. Ông A quyết tâm nghĩ ra cách gì đó để report bắn liên tục mà bản thân nó phải nhanh, đơn giản và độ trễ thấp.

Tình cờ, ông A tìm ra thằng https://telegram.org/, 1 app OTT Message thịnh hành,  có app cho điện thoại và cả máy tính, có document rõ ràng và đơn giản. Đặc biệt đáp ứng được vấn đề chia sẻ one-one mà không cần phải add group.

Và dưới đây là cách ông A thực hiện.

Chuẩn bị nguyên liệu

  1. Ông A thì thích PHP, nên nguyên liệu chính ông A sử dụng là PHP, kèm theo Composer cho nó ngầu.
  2. Ông A sẽ build nó thành 1 API interface, build thành packages để có thể install nhanh vào project hoặc implement thành 1 restful API 1 cách đơn giản nhất
  3. Ông A cũng cẩn thận lưu log mọi request lại
  4. 1 cái IDE hoặc Text Editor để code
  5. Tài khoản và App Telegram, đương nhiên rồi
  6. Cốc nước lọc để code cho đỡ đói. 


Triển khai

Nguồn tài liệu chính: Tài liệu về Telegram BOT được trình bày ở đây, đầy đủ, chi tiết, bằng tiếng Anh tại https://core.telegram.org/bots


Đăng ký BOT với Telegram

Đầu tiên, để được Telegram cấp bot, bạn phải gọi Telegram bằng bố. Kiểu bố ơi, con muốn được giao tiếp với thế giới...



Đó, thấy đó, nó bắt ông A gọi là bố. Phận coder bèo bọt, để hoàn thành công việc kiếm gói mì tôm thay cốc nước lọc. Ông A đành nhắm mắt gọi nó là bố vậy.

Mở app Telegram lên, ông A search đến cái thằng @BotFather và trò chuyện với ông bố này.



Tìm được bố rồi, gõ /help để được bố nhìn thấy và trợ giúp


Đó, sau khi gõ /help, hắn reply ngay, đại ý là tao giúp được gì cho mày. Nếu mày muốn tạo bot mới thì mày phải chơi theo luật của tao. Và dưới đây là vài cái tao có thể giúp mày.

Mạnh dạn gõ /newbot để tạo bot mới


Sau đó nhập tên bot cần tạo vào ô chat, ở đây ông A lập cái bot tên là Test Bot Chơi và username cho bot là ong_a_test_bot


Đó, tạo bot xong, nó trả cho ông A cái token access, là đoạn
892069632:AAFbjTC98f0k-zQUq00pf38v5VbR4f6L4hw

Lưu đoạn này lại. OK, vậy là h có 1 con bot tồn tại tên là ong_a_test_bot trên cõi đời này

search thử con bot trên telegram và start chat với nó phát


Đến đây là xong bước đăng ký BOT với Telegram rồi.

Code module Send Message với con BOT mình vừa đăng ký

Do triển khai dạng composer nên việc đầu tiên là init composer, sau đó đăng ký sử dụng 2 packages

  • monolog/monolog: dùng để ghi log sự kiện
  • php-curl-class/php-curl-class: đây là 1 wrapper curl rất tiện dụng
  • Endpoint để gọi: https://api.telegram.org/bot{token}/method

file composer ông A xây dựng có dạng sau

và cấu trúc thư mục của ông A

trong đó

  • class src/Telegram.php là Class chịu trách nhiệm xử lý chính các tác vụ
  • test.php là file test class send Message. API Restful các ông tự xây nhé :))
  • config.php là file lưu dữ liệu cấu hình

Init class Telegram

Đầu tiên, khởi tạo class Telegram.php và đăng ký các biến request, config và logger, file sẽ tương tự như sau

và setup cấu hình tại file config.php

Xây dựng hàm gửi tin nhắn

Hàm gửi tin nhắn của Telegram chúng ta có thể tìm thấy ngay tại đây: https://core.telegram.org/bots/api#sendmessage




OK, phân tích api document, ta thấy để gửi được tin nhắn đi thì chỉ cần đơn giản 2 trường là chat_id và text, đối với trường hợp group thì chat_id chính là id của cuộc trò chuyện đó

Lấy thông tin chat_id

Đơn giản, gọi đến endpoint getUpdates để lấy thông tin các user đã tương tác với BOT


anh em thấy đoạn bôi đen rồi chứ, nó đó, chat_id đó

Từ đó, ta xây dựng được thêm mấy hàm sau trong class Telegram, tôi đã comment kĩ, các ông chịu khó đọc ha

Vậy là cơ bản xong class Send Message. Mỗi khi gọi hàm Send, response == true là thành công, false các ông check log

OK, vậy là cơ bản xong, h xây dựng file test thử cái nhờ

File test xây dựng đơn giản như vậy thôi

và tận hưởng thành quả :))

Kết luận


Rồi, bây h các ông đã sở hữu trong tay con bot mạnh mẽ rồi. Việc còn lại các ông implement vào project của mình dạng package cũng được, mà xây restful API cũng được.

Tôi đã build nhanh packages ở đây, các ông có thể install nhanh chóng với cú pháp require
composer require nguyenanhung/telegram-messenger
Còn đây là full source không che: https://github.com/tungvandev/scripts-telegram-bot-send-message

Còn logic nghiệp vụ bắt lỗi ở đâu, đó tùy nghiệp vụ với quan điểm từng người, tôi không chỉ được.

Nếu các ông cần trợ giúp, liên hệ sau sẽ có ích với các ông

Name: Hung Nguyen
Email: [email protected]
Skype: nguyenanhung5891
Facebook: @nguyenanhung
full-width

Post a Comment

Mới hơn Cũ hơn