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
- Ô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.
- Ô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
- Ông A cũng cẩn thận lưu log mọi request lại
- 1 cái IDE hoặc Text Editor để code
- Tài khoản và App Telegram, đương nhiên rồi
- 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...
Đầ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-messengerCò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
Đăng nhận xét