วิธีใช้ DevConnext

แยกตามเรื่อง ทีละขั้น ตามที่ระบบทำงานจริงตอนนี้

DevConnext API คืออะไร ใครใช้ได้

อยู่ที่เว็บ dev.bizconnext.com (เข้าจากหน้าเลือกบริการที่ account.bizconnext.com) — ใช้ได้เมื่อบริษัทชำระแพ็กเกจ HRConnext แล้ว (ช่วงทดลองใช้ยังใช้ไม่ได้ ไม่มีค่าใช้จ่ายเพิ่ม) · ให้ระบบอื่นของบริษัท เช่น ERP โปรแกรมบัญชี หรือเครื่องลงเวลา อ่านข้อมูลจาก HRConnext ได้เอง ตอนนี้อ่านได้อย่างเดียว: สาขา แผนก ตำแหน่ง พนักงาน (ข้อมูลงาน) เวลาเข้า-ออก การลาและวันลาคงเหลือ กะ วันหยุด และรายงาน HR แบบตัวเลขรวม ไม่ส่งข้อมูลลับหรือข้อมูลที่ไม่จำเป็น (เงินเดือน เลขบัตร บัญชีธนาคาร ศาสนา วันเกิด ที่อยู่ เบอร์โทร พิกัด GPS รูป และเหตุผลการลา) ใช้ได้เฉพาะคนที่มีสิทธิ์ "การเชื่อมต่อ API" (เจ้าของบัญชีและผู้อำนวยการ HR ตั้งต้น)

อ่าน →

ถามน้องเน็กซ์ · ผู้เชี่ยวชาญ API

กดปุ่ม "ถามน้องเน็กซ์ · ผู้เชี่ยวชาญ API" ในเมนูของ dev.bizconnext.com ถามได้ทั้งไทยและอังกฤษ เช่น "จะยื่นลาแทนพนักงานใช้ endpoint ไหน" ได้การ์ด endpoint พร้อมโค้ด cURL / JavaScript / Python · "ได้ 428 คืออะไร" ได้ความหมายและวิธีแก้ · "ERP ส่งข้อมูลไม่เข้า ตรวจให้หน่อย" เน็กซ์ดูบันทึกการเรียกของบริษัท 24 ชั่วโมงล่าสุด แล้วบอกว่า key ไหน ผิดที่ endpoint ไหน เพราะอะไร (เช่น แพ็กเกจยังไม่รวมการเขียน หรือ key ขาด scope ไหน) · "webhook ไม่เข้า" ดูสถานะการส่ง · "เชื่อม Claude ยังไง" · เน็กซ์ดูได้เฉพาะการเชื่อมต่อของบริษัทคุณ อ่านอย่างเดียว ไม่แสดง key และไม่เก็บข้อความที่ถาม ประมวลผลบนเซิร์ฟเวอร์ของ HRConnext เอง · อย่าวาง API key ในแชท ถ้าวางไป เน็กซ์จะเตือนให้เพิกถอน key นั้น · หน้าเอกสาร API สาธารณะ (api.bizconnext.com/v1/docs) ก็มีปุ่ม "ถามน้องเน็กซ์" ให้ทีม IT หรือผู้พัฒนาที่ยังไม่มีบัญชีถามเรื่องทั่วไปได้ โดยไม่เห็นข้อมูลบริษัทใด ๆ

อ่าน →

สร้าง API key

กด "+ สร้าง API key" ตั้งชื่อให้รู้ว่าใช้กับระบบไหน เลือก "ทดสอบ (sandbox)" เพื่ออ่านข้อมูลตัวอย่าง หรือ "ใช้งานจริง" เพื่ออ่านข้อมูลจริง ติ๊กสิทธิ์ (scope) เท่าที่ระบบนั้นต้องใช้ เลือกวันหมดอายุ และใส่ IP ของเครื่องที่จะเรียกได้ (ไม่บังคับ แต่แนะนำ) ก่อนสร้าง key ใช้งานจริงใบแรก ต้องอ่านและติ๊กยอมรับข้อกำหนดการใช้ DevConnext API ในนามบริษัทหนึ่งครั้ง (ระบบบันทึกชื่อ เวลา และ IP ของผู้ยอมรับ ดูข้อกำหนดย้อนหลังได้จากลิงก์ "อ่านข้อกำหนด") key ทดสอบสร้างได้เลยโดยไม่ต้องยอมรับ key จะแสดงครั้งเดียว คัดลอกเก็บในที่ปลอดภัย ระบบเก็บแค่ค่าที่ย้อนกลับไม่ได้ ถ้าทำหายให้สร้างใหม่แล้วเพิกถอนอันเก่า ใช้งานจริงได้พร้อมกัน 2 key (อันที่ใช้ + อันใหม่สำหรับเปลี่ยน) และ key ทดสอบอีก 2 key

อ่าน →

ทดลองใน Playground ก่อนต่อระบบจริง

แท็บ Playground: เลือก "ข้อมูลทดสอบ" แล้วกด "ขอ token ทดสอบ" (ใช้ได้ 15 นาที) หรือเลือก "ใช้ key ของบริษัท" แล้ววาง key จริงเพื่อดูข้อมูลจริงแบบอ่านอย่างเดียว เลือก endpoint กรอกค่าที่ต้องการ แล้วกด "ส่งคำขอ" จะเห็นผลลัพธ์ status เวลาตอบ และ header · ลองเขียนข้อมูลได้ด้วย (เลือก endpoint ที่ขึ้นต้น POST / PATCH) เฉพาะข้อมูลทดสอบ ระบบเติมข้อมูลตัวอย่างและ id จากบริษัทจำลองให้ แก้ JSON ได้ ตั้ง dry_run = true เพื่อดูผลโดยไม่บันทึก ส่วน "โค้ดตัวอย่าง" มี curl / JavaScript / Python ให้คัดลอกไปใช้ โดยไม่ใส่ key ไว้ในโค้ด (ให้เก็บ key ในตัวแปรสภาพแวดล้อม) เอกสาร API ฉบับเต็มเปิดได้จากลิงก์ "เอกสาร API" ด้านบน

อ่าน →

ข้อมูลทดสอบ (sandbox)

ระบบสร้างบริษัทจำลองให้อัตโนมัติเมื่อสร้าง key ทดสอบหรือขอ token ครั้งแรก มีพนักงาน 12 คน เวลาเข้า-ออก 2 สัปดาห์ การลา กะ และวันหยุด key ทดสอบอ่านได้เฉพาะบริษัทจำลองนี้ ไม่แตะข้อมูลจริง และไม่มีใครได้รับแจ้งเตือนจากข้อมูลชุดนี้ กด "ล้างและสร้างข้อมูลทดสอบใหม่" ได้ทุกเมื่อ (id ทุกตัวในข้อมูลทดสอบจะเปลี่ยน แต่ key ทดสอบยังใช้ได้)

อ่าน →

ความปลอดภัย ลิมิต และข้อผิดพลาด

ที่อยู่ของ API คือ https://api.bizconnext.com/v1 · ส่ง key ใน header Authorization: Bearer เท่านั้น ห้ามใส่ใน URL (ระบบจะบล็อกทันที) หรือในหน้าเว็บที่คนอื่นเปิดได้ · ถ้าสงสัยว่า key หลุด กด "เพิกถอน" มีผลทันที · ลิมิตตามแพ็กเกจ นับต่อ key ต่อนาที และต่อบริษัทต่อวัน (เวลาไทย) ถ้าเกินจะได้ 429 พร้อมบอกเวลาที่ลองใหม่ได้ · ถ้าส่ง key ผิด หมดอายุ หรือถูกเพิกถอนเกิน 30 ครั้งในหนึ่งนาทีจาก IP เดียว IP นั้นจะถูกพัก 1 นาที (429) · ข้อผิดพลาดทุกแบบมี code เช่น insufficient_scope (key ไม่มีสิทธิ์นั้น) not_found (ไม่พบ หรือเป็น id ของบริษัทอื่น) key_revoked key_expired ip_not_allowed และ request_id สำหรับแจ้งทีมงาน · การเรียกทุกครั้งถูกบันทึกเวลา path และผล (ไม่บันทึกข้อมูลพนักงาน)

อ่าน →

ส่งข้อมูลเข้า HRConnext (เขียนข้อมูล)

เลือก scope ที่มีป้าย "เขียน" ตอนสร้าง key: เพิ่มแผนก (org:write) · เพิ่มพนักงานและแก้ข้อมูลงาน เช่น ชื่อ อีเมล ตำแหน่ง สาขา วันเริ่มงาน (employees:write) · ยื่นลาแทนพนักงาน (leave:write) ใบลาจะส่งให้ผู้อนุมัติใน LINE ตามปกติ และยอดวันลาเปลี่ยนเมื่ออนุมัติแล้วเท่านั้น (อนุมัติผ่าน API ไม่ได้ ผู้อนุมัติกดใน LINE เท่านั้น) · ส่งเวลาจากเครื่องลงเวลา และขอแก้เวลาแทนพนักงาน (attendance:write) เวลาจากเครื่องใช้กฎเดียวกับการลงเวลาใน LINE (สาย/ออกก่อน และการหักค่าจ้างเวลาที่ไม่ได้ทำงานถ้าบริษัทเปิดไว้) ในหน้าเข้า-ออกงานจะมีป้าย "เครื่องลงเวลา" ส่งซ้ำได้ไม่เกิดรายการซ้ำ ส่วนการขอแก้เวลาจะส่งให้ผู้อนุมัติ · ยื่นเบิกค่าใช้จ่ายแทนพนักงานพร้อมใบเสร็จ jpg png pdf (expense:write) ส่งให้ผู้อนุมัติตามปกติ รูปถ่ายจะถูกลบข้อมูลแฝง (เช่น พิกัดที่ถ่าย) ก่อนเก็บ · key ที่เขียนได้ทำรายการในนามของคนที่สร้าง key และทำได้เฉพาะสิ่งที่คนนั้นมีสิทธิ์ทำในแอป ถ้าคนนั้นถูกปิดบัญชีหรือเสียสิทธิ์ key จะเขียนไม่ได้ทันที (ยังอ่านได้) · ผ่าน API แก้สถานะพนักงาน (ลาออก/เลิกจ้าง) เงินเดือน เลขบัตร บัญชีธนาคาร และศาสนาไม่ได้ ต้องทำในแอป · ทุกรายการอยู่ในประวัติการใช้งาน ชื่อผู้ทำรายการเป็น "DevConnext API · ชื่อ key (แทน ชื่อคนสร้าง)" · แพ็กเกจของบริษัทต้องรองรับการเขียนผ่าน API (ถ้าไม่รองรับจะได้ write_not_in_plan) · ระบบที่เชื่อมควรส่ง Idempotency-Key ทุกครั้ง (ส่งซ้ำได้โดยไม่เกิดรายการซ้ำ) ส่ง If-Match เมื่อแก้ข้อมูล และลอง ?dry_run=true ก่อนเพื่อดูว่าจะเปลี่ยนอะไรโดยไม่บันทึก

อ่าน →

Webhooks — ให้ HRConnext แจ้งระบบของคุณ

แท็บ "Webhooks": กด "+ เพิ่มที่อยู่ webhook" ใส่ที่อยู่ https ของระบบคุณ (ต้องเป็นที่อยู่สาธารณะ ที่อยู่ภายในเครือข่ายใช้ไม่ได้) เลือกเหตุการณ์ เช่น อนุมัติการลา อนุมัติเบิก มีพนักงานเข้า-ออก ปิดรอบเงินเดือน แล้วคัดลอกรหัสลายเซ็น (whsec_…) ที่แสดงครั้งเดียวไปใส่ในระบบของคุณเพื่อตรวจ HRC-Signature · ระบบส่งเฉพาะ id และชื่อฟิลด์ที่เปลี่ยน ไม่ส่งข้อมูลลับ ให้ระบบของคุณใช้ API key ดึงรายละเอียดต่อ · กด "ส่งทดสอบ" เพื่อลองส่งตัวอย่าง และ "บันทึกการส่ง" เพื่อดูว่าส่งสำเร็จไหม (เก็บ 30 วัน) กด "ส่งอีกครั้ง" ได้เมื่อระบบของคุณกลับมา · ส่งไม่สำเร็จระบบลองใหม่ 8 ครั้งใน 24 ชั่วโมง ถ้าล้มติดต่อกัน 3 วันจะปิดเอง กด "เปิด" เมื่อแก้แล้ว · "เปลี่ยนรหัสลายเซ็น" แล้วรหัสเดิมยังใช้ได้อีก 24 ชั่วโมง · ต้องมีแพ็กเกจที่รองรับ วิธีตรวจลายเซ็นอยู่ในเอกสาร API

อ่าน →

เชื่อมแอป AI (DevConnext MCP)

เมื่อ HRConnext เปิด DevConnext MCP ให้บริษัทแล้ว จะมีแท็บ "แอป AI (MCP)" ให้คัดลอกที่อยู่ MCP ไปวางในแอป AI ที่รองรับ MCP (เช่น Claude ทดสอบกับ Claude แล้ว) ในส่วนเพิ่ม connector แบบกำหนดเอง แอปจะเปิดหน้า HRConnext ให้เข้าสู่ระบบ แล้วแสดงชื่อแอป โดเมนที่จะส่งกลับไป และสิทธิ์ที่ขอ ติ๊กเฉพาะที่อยากให้อ่าน แล้วกด "อนุญาต" (เฉพาะเจ้าของบัญชีหรือผู้อำนวยการ HR และบริษัทต้องยอมรับข้อกำหนดการใช้ DevConnext API แล้ว) · แอปอ่านได้อย่างเดียว ในนามของคนที่อนุญาต ไม่มีข้อมูลลับ ได้ครั้งละไม่เกิน 50 แถว · ข้อมูลที่แอปอ่านจะส่งไปยังผู้ให้บริการ AI ของแอปนั้น ซึ่งอาจประมวลผลนอกประเทศไทย ก่อนเชื่อมให้ตรวจข้อกำหนดของผู้ให้บริการ AI (เช่น การเก็บข้อมูลและการนำไปฝึกโมเดล) และแจ้งพนักงานตามที่กฎหมายกำหนด (ข้อกำหนดการใช้ DevConnext API ข้อ 9) · คำตอบของ AI อาจผิดหรือไม่ครบ ตรวจกับข้อมูลใน HRConnext ก่อนใช้ตัดสินใจเรื่องที่มีผลต่อพนักงาน · ดูได้ว่าใครเชื่อมแอปอะไร และกด "ถอนสิทธิ์" ได้ทุกเมื่อ มีผลทันที ถ้าคนที่อนุญาตถูกปิดบัญชีหรือไม่มีสิทธิ์แล้ว แอปจะหยุดเองเช่นกัน · แอปที่มีป้าย "ยังไม่ยืนยัน" คือแอปที่ลงทะเบียนเอง ตรวจชื่อและโดเมนให้แน่ใจก่อนอนุญาต

อ่าน →

ให้ทั้งบริษัทเริ่มใช้ได้ภายในวันนี้

สมัครด้วยอีเมล เพิ่มพนักงาน ส่งลิงก์ LINE ให้ทุกคน ทีมงานช่วยตั้งค่าฟรี

เริ่มทดลองฟรี 14 วัน

คุยกับทีมงาน @bizconnext →