คู่มือการใช้งาน API
HyperBot-XN ระบบแจ้งเตือนเงินเข้าอัตโนมัติสำหรับธุรกิจออนไลน์ รับแจ้งเตือนทันทีเมื่อมีเงินโอนเข้าบัญชีผ่าน Webhook หรือ API
ทำไมต้องใช้ HyperBot-XN?
- Real-time — รับแจ้งเตือนทันทีเมื่อมีเงินเข้า
- หลายธนาคาร — รองรับ SCB, K PLUS, TrueMoney, LINE และอื่นๆ
- Webhook — ส่งข้อมูลไปยังระบบของคุณอัตโนมัติ
- กรองบัญชี — เลือกรับเฉพาะบัญชีที่ต้องการ
- ป้องกันซ้ำ — Deduplication อัตโนมัติ
หลักการทำงาน
แอพ Android ดักจับ Notification
เมื่อมีเงินเข้าบัญชี แอพธนาคารส่ง notification มาที่มือถือ HyperBot จะดักจับ notification นี้
ส่งข้อมูลไปยัง Server
แอพแยกข้อมูล (จำนวนเงิน, บัญชี, ธนาคาร) แล้วส่งไปยัง API Server
Server ประมวลผลและบันทึก
Server ตรวจสอบความถูกต้อง กรองรายการซ้ำ และบันทึกลงฐานข้อมูล
ส่ง Webhook ไปยังระบบของคุณ
ถ้าตั้งค่า Webhook ไว้ ระบบส่งข้อมูลไปยัง URL ที่กำหนดทันที
เริ่มต้นอย่างรวดเร็ว
ขอ KEY จาก Admin
ติดต่อ Admin เพื่อขอ KEY และ SECRET สำหรับใช้งาน
ติดตั้งแอพ Android
ติดตั้ง APK บนมือถือที่ใช้รับ notification ธนาคาร
ให้สิทธิ์ Notification Access
ตั้งค่า → เปิดสิทธิ์ให้แอพอ่าน notification
ใส่ KEY ในแอพ
เปิดแอพ HyperBot แล้วใส่ KEY ที่ได้รับ
ทดสอบ!
ลองโอนเงินเข้าบัญชี แล้วดูรายการใน Dashboard
การยืนยันตัวตน
Key & Secret คืออะไร?
- KEY — รหัสผู้ใช้ 8 ตัวอักษร ใช้ระบุตัวตน
- SECRET — รหัสลับ 16 ตัวอักษร ใช้ยืนยันความถูกต้อง
Base URL
https://hyperbot.shop/th/api.php
Login
ตรวจสอบ KEY และดึงข้อมูลผู้ใช้ ใช้สำหรับแอพ Android ตอนเริ่มต้น
{ "status":"ok", "name":"Shop A", "secret":"8ad219f42618fafc", "active":"1", "apps":"com.scb.phone", "accounts":"0711,0133", "webhook":"https://example.com/wh" }
Event — รับแจ้งเตือน
Endpoint หลักสำหรับรับ notification จากแอพ Android (แอพเรียกอัตโนมัติ)
{ "key":"051a9fb6", "app":"com.scb.phone", "title":"SCB Easy", "text":"รายการเงินเข้า 500.00 บาท เข้าบัญชี X-0711", "time":1714200000000 }
{ "status":"ok", "msg":"saved", "amount":"500.00", "direction":"IN", "account":"0711", "bank":"SCB" }
Logs — รายการธุรกรรม
{ "status":"ok", "logs":[{ "id":1, "bank":"SCB", "amount":500.00, "direction":"IN", "account":"0711", "time":1714200000000 }], "count":1 }
Stats — สถิติ
{ "status":"ok", "today":{ "total_in":15000.00, "count_in":10 }, "all":{ "total_in":500000.00, "total_count":1500 }, "users":5 }
การติดตั้งแอพ Android
ดาวน์โหลด APK
ดาวน์โหลดไฟล์ APK จาก Admin หรือลิงก์ที่ได้รับ
อนุญาตติดตั้งจากแหล่งที่ไม่รู้จัก
ตั้งค่า → ความปลอดภัย → แหล่งที่ไม่รู้จัก แล้วเปิดใช้งาน
ติดตั้ง APK
เปิดไฟล์ APK แล้วกด ติดตั้ง
การให้สิทธิ์ Notification Access
เปิดการตั้งค่า
ตั้งค่า → แอพ → การเข้าถึงพิเศษ → การเข้าถึงการแจ้งเตือน
เปิดสิทธิ์ให้แอพ HyperBot
หาแอพ HyperBot แล้วเปิดสวิตช์
ยืนยัน
กด อนุญาต เมื่อมีข้อความแจ้งเตือน
ธนาคารที่รองรับ
com.kasikornbank.k-mobile.banking และ com.kasikorn.retail.mbanking.wapคำถามที่พบบ่อย
ทำไมไม่ได้รับแจ้งเตือน?
- แอพได้รับสิทธิ์ Notification Access หรือยัง?
- KEY ถูกต้องหรือไม่?
- Package name ของแอพธนาคารตรงกับที่ตั้งค่าไว้หรือไม่?
- บัญชีที่รับเงินตรงกับที่ตั้งค่าไว้หรือไม่?
รองรับเงินออกไหม?
ไม่ — ระบบกรองเฉพาะ เงินเข้า (IN) เท่านั้น
แก้ไขปัญหา
Error: invalid_key / invalid_user
KEY ไม่ถูกต้อง — ตรวจสอบหรือติดต่อ Admin
Error: disabled
บัญชีถูกปิดใช้งาน — ติดต่อ Admin เพื่อเปิดใช้งาน
Error: account_not_registered
บัญชีที่รับเงินไม่ตรงกับที่ตั้งค่าไว้ — เพิ่มเลขบัญชี 4 หลักท้ายใน Admin Panel
Response: duplicate
รายการซ้ำ — ระบบตรวจพบว่ารายการนี้เคยบันทึกแล้ว (ไม่ใช่ error)
Response: ignored_out
รายการโอนออก — ระบบข้ามเพราะเป็นเงินออก (ไม่ใช่ error)