การใช้งานฟังชั่น Telegram Notify ใน Himpro HRM

Himpro HRM มีฟังชั่นสำหรับแจ้งเตือนข้อความเข้า App Telegram ซึ่งมี API ที่สามารถให้นักพัฒนาส่งข้อความถึงผู้ใช้งานได้ และสามารถใช้งานได้ฟรี ไม่จำกัดข้อความ และสามารถส่งแบบส่วนตัว และแบบส่งเข้ากลุ่มได้

สิ่งที่ต้องเตรียม

สร้าง Telegram Bot
สร้าง กลุ่ม Telegram (กรณีต้องการให้ส่งข้อความแจ้งเตือน Notify ไปยังกลุ่มใน Telegram)
เปิดใช้งาน ฟังชั่น Telegram Notify ใน Himpro HRM
ลงทะเบียน Telegram Id ใน Himpro HRM
คำสั่ง SQL สำหรับดึงข้อมูลจากฐานข้อมูลไปส่งเป็นข้อความแจ้งเตือน

1 สร้าง Telegram Bot

สมัครใช้งาน Telegram (กรณีที่ยังไม่มีบัญชี Telegram) จากนั้นสร้าง Bot ตาม คู่มือการสร้าง Bot ของ Telegram

เมื่อสร้าง Bot สำเร็จแล้ว บันทึก Bot Token เอาไว้เพื่อใช้ในการกำหนดค่าในขั้นตอนต่อไป

ตัวอย่าง Bot Token

4839574812:AAFD39kkdpWt3ywyRZergyOLMaJhac60qc

2 สร้างกลุ่ม Telegram (กรณีต้องการส่งข้อความเข้ากลุ่ม)

สร้างกลุ่มแชท Telegram ตาม คู่มือการสร้างกลุ่ม Telegram

3 เปิดใช้งานฟังชั่น Telegram Notify ใน Himpro HRM

นำ Bot Token ที่ได้จากการสร้าง bot ในขั้นตอนที่ 1 มากำหนดค่าในไฟล์ DbConfig.txt

"telegram_bot_token": "{bot token}",

จากนั้น Restart Site ของ hrm ใน IIS

4 ลงทะเบียน Telegram Id ใน Himpro HRM

เพิ่ม bot เป็นเพื่อน โดนการคลิกที่ id ของ bot หรือ สามารถค้นหา bot โดยการพิมพ์ค้นหาที่ช่อง Search โดยพิมพ์เครื่องหมาย @ นำหน้า แล้วตามด้วยชื่อ bot ที่ต้องการค้นหา

คลิก Start เพื่อเริ่มสนทนากับ bot และลงทะเบียนกับ bot

หลังจากคลิก Start ให้รอประมาณ 30 วินาที ระบบจะส่งข้อความตอบกลับมา เพื่อแนะนำวิธีในการลงทะเบียน จากนั้น copy ข้อความ แล้วเติมข้อมูลของคุณลงไปตามคำแนะนำแล้วกด ส่งข้อความ หากข้อมูลของคุณถูกต้องตรงกันกับข้อมูลในฐานข้อมูล ระบบจะแจ้งข้อความว่า “ลงทะเบียนเรียบร้อย”

สามารถดูได้ว่า User คนไหนที่ลงทะเบียน Telegram เข้ามาบ้าง ในเมนู “จัดการบัญชีผู้ใช้”

การลงทะเบียนกลุ่ม Telegram

ให้ Add Bot เข้ากลุ่ม จากนั้นพิมพ์ข้อความอะไรก็ได้ในกลุ่ม ระบบจะตรวจจับเองว่า Bot เข้าอยู่ไหนบ้าง และเก็บข้อมูล Group Id เอาไว้สำหรับส่งข้อความแจ้งเตือน

5 คำสั่ง SQL สำหรับดึงข้อมูลจากฐานข้อมูลไปส่งเป็นข้อความแจ้งเตือน

เขียนคำสั่ง sql ให้ออกมาตามโครงสร้างนี้

ชื่อ	ประเภท	คำอธิบาย
uuid	varchar	UUID (Universally Unique Identifier) เป็นรหัสที่ใช้สำหรับระบุข้อมูลหรือวัตถุอย่างไม่ซ้ำกัน
regdate	date	วันที่กำกับข้อมูล
seq	int	ลำดับของข้อมูล
message	text	ข้อความที่จะให้ระบบส่งไปยังผู้ใช้

ตัวอย่างคำสั่ง sql

SELECT UUID() 'uuid',date(NOW()) 'regdate',1 as 'seq','ทดสอบ Telegram Notify' as 'message';

การเพิ่มโปรเจ็คใหม่

เพิ่มโปรเจ็คใหม่โดยการไปที่เมนู “Telegram Notify” แล้วคลิก “เพิ่ม project”

กำหนดค่า และวาง คำสั่ง sql ตามโครงสร้างที่กำหนด แล้วคลิก Save

จากนั้นระบบจะเริ่มทำการตรวจสอบคำสั่งทุกๆ 1 นาที ว่าเข้าเงื่อนไขที่กำหนดหรือไม่ หากเข้าก็จะเริ่มทำการดึงข้อมูลมาส่งแจ้งเตือนไปยังผู้ใช้ทันที