TeamKPI คู่มือการติดตั้ง
⏱ ติดตั้งประมาณ 10 นาที · ไม่ต้องเขียนโค้ด

ติดตั้ง TeamKPI แดชบอร์ดทีมขาย

แดชบอร์ดติดตาม KPI ทีมขายรายคนและรายทีม ตั้งเป้ารายเดือน บันทึกผลงานรายวัน แล้วระบบคำนวณ % ทำได้ คะแนน KPI ถ่วงน้ำหนัก และจัดอันดับให้อัตโนมัติ ใช้ประชุมทีมประจำสัปดาห์และประเมินผลประจำเดือนได้ทันที

👤บัญชี GoogleGmail หรือ Google Workspace
💻คอมพิวเตอร์ใช้ตอนติดตั้งครั้งแรก
📄3 ไฟล์Code.gs · Index.html · appsscript.json
📱เปิดดูได้ทุกที่คอม แท็บเล็ต มือถือ
📑 สารบัญ
ส่วนที่ 1

ติดตั้งบน Google

ทำครั้งเดียวบนคอมพิวเตอร์ ประมาณ 10 นาที

1

เริ่มต้น

สร้างไฟล์ Google Sheets ใหม่

ไฟล์นี้คือ “ฐานข้อมูล” ของแดชบอร์ด เก็บรายชื่อพนักงานขาย บันทึกผลงานรายวัน และเป้าหมายรายเดือนของแต่ละคน

  1. เข้า sheets.new (ล็อกอินบัญชี Google ที่จะใช้เป็นเจ้าของข้อมูล)
  2. คลิกชื่อไฟล์มุมซ้ายบน ตั้งชื่อ เช่น TeamKPI ทีมขาย
💡 ใช้บัญชีไหนติดตั้ง บัญชีนั้นเป็นเจ้าของข้อมูล

รายงานอีเมลจะส่งจากบัญชีนี้ และข้อมูลทั้งหมดอยู่ใน Drive ของบัญชีนี้ — กิจการควรใช้บัญชีกลางของร้าน/องค์กร ไม่ใช่บัญชีส่วนตัวของพนักงาน

2

ใส่ระบบ

วางไฟล์ Code.gs · Index.html · appsscript.json

ชุดไฟล์ที่ได้รับมี 3 ไฟล์หลักที่ต้องวางใน Apps Script

GS
Code.gsโค้ดฝั่งเซิร์ฟเวอร์ทั้งหมด
HTML
Index.htmlหน้าแดชบอร์ด (ไฟล์ชื่อ Index)
JSON
appsscript.jsonเขตเวลาและสิทธิ์
  1. ในไฟล์ชีต ไปที่เมนู ส่วนขยาย›Apps Script
  2. คลิกชื่อโปรเจกต์มุมซ้ายบน (“โปรเจกต์ที่ไม่มีชื่อ”) เปลี่ยนเป็น TeamKPI แดชบอร์ดทีมขาย — ชื่อนี้จะแสดงในหน้าขออนุญาตสิทธิ์
  3. เปิดไฟล์ Code.gs กด Ctrl + A ลบโค้ดเดิม แล้ววางเนื้อหาไฟล์ Code.gs ที่ได้รับทั้งไฟล์
  4. กดปุ่ม + ข้างคำว่า “ไฟล์” › HTML ตั้งชื่อว่า Index (ตัว I ใหญ่ ไม่ต้องพิมพ์ .html) ลบเนื้อหาเดิม แล้ววางไฟล์ Index.html ทั้งไฟล์
  5. ไปที่ ⚙ การตั้งค่าโปรเจกต์ ติ๊ก “แสดงไฟล์ Manifest ‘appsscript.json’ ในเครื่องมือแก้ไข” กลับมาเปิดไฟล์ appsscript.json แล้ววางทับทั้งไฟล์
  6. กด Ctrl + S บันทึกทุกไฟล์
⚠ ชื่อไฟล์ HTML ต้องเป็น Index

ถ้าตั้งชื่ออื่น (เช่น index ตัวเล็ก หรือ Index.html.html) หน้าเว็บจะเปิดไม่ขึ้นและแจ้งว่าไม่พบไฟล์ HTML

✓ appsscript.json ทำอะไร

ตั้งเขตเวลา Asia/Bangkok ให้ยอดรายวันและเวลาส่งรายงานตรงกับเวลาไทย และระบุสิทธิ์ที่ระบบขอให้ชัดเจน

3

ติดตั้ง

รันฟังก์ชัน setup เพื่อสร้างชีตและข้อมูลตัวอย่าง

  1. ในหน้า Apps Script เปิดไฟล์ Code.gs แล้วเลือกฟังก์ชัน setup จากช่องรายชื่อฟังก์ชันบนแถบเครื่องมือ
  2. กด ▷ เรียกใช้ — ครั้งแรก Google จะขออนุญาตสิทธิ์ ทำตามขั้นตอนที่ 4
  3. รอ 10–40 วินาที ดู บันทึกการดำเนินการ ด้านล่างจะขึ้นข้อความ “ติดตั้ง TeamKPI แดชบอร์ดทีมขาย เรียบร้อย…”
  4. กลับไปที่แท็บ Google Sheets จะเห็นชีต บันทึกผลงาน · พนักงานขาย · เป้าหมายรายเดือน พร้อมข้อมูลตัวอย่าง และเมนู 📊 TeamKPI บนแถบเมนู (ถ้ายังไม่เห็นให้รีเฟรชหน้า)
รันซ้ำได้อย่างปลอดภัย

setup สร้างเฉพาะชีตที่ขาดและจัดหัวตารางใหม่ ไม่ลบข้อมูลเดิม และใส่ข้อมูลตัวอย่างเฉพาะชีตที่ยังว่าง — ใช้ซ่อมกรณีเผลอลบชีตได้

4

ครั้งเดียว

อนุญาตสิทธิ์ให้สคริปต์

  1. หน้าต่าง “ต้องมีการให้สิทธิ์” กด ตรวจสอบสิทธิ์ แล้วเลือกบัญชี Google ของคุณ
  2. ถ้าขึ้น “Google ไม่ได้ยืนยันแอปนี้” กด ขั้นสูง (Advanced) › ไปที่ TeamKPI แดชบอร์ดทีมขาย (ไม่ปลอดภัย) — เป็นปกติของสคริปต์ที่ติดตั้งเองในบัญชีของคุณ
  3. ตรวจรายการสิทธิ์แล้วกด อนุญาต (ถ้ามีช่องติ๊กให้เลือกทั้งหมด)
หน้าเตือน “Google ไม่ได้ยืนยันแอปนี้” — กด ขั้นสูง แล้วเลือกไปที่โปรเจกต์ของคุณ
หน้าเตือน “Google ไม่ได้ยืนยันแอปนี้” — กด ขั้นสูง แล้วเลือกไปที่โปรเจกต์ของคุณ
หน้ารายการสิทธิ์ — เลื่อนลงแล้วกด อนุญาต
หน้ารายการสิทธิ์ — เลื่อนลงแล้วกด อนุญาต
สิทธิ์ที่ขอใช้ทำอะไร
ดู แก้ไข สร้าง และลบสเปรดชีตอ่านข้อมูลมาแสดงบนแดชบอร์ด และบันทึกรายการที่กรอกจากหน้าเว็บลงชีตของคุณ
ส่งอีเมลในนามคุณส่งรายงานสรุป/แจ้งเตือนไปยังอีเมลที่คุณตั้งไว้เท่านั้น
เรียกใช้เมื่อคุณไม่ได้อยู่ทริกเกอร์ตามเวลาสำหรับส่งรายงานอัตโนมัติ
แสดงเนื้อหาในแอปพลิเคชันของ Googleเมนู 📊 TeamKPI ในไฟล์ชีต
ดูอีเมลของคุณตั้งเป็นอีเมลผู้รับรายงานเริ่มต้น

หลังอนุญาตแล้ว ถ้า setup ยังไม่ทำงาน ให้กด ▷ เรียกใช้ อีกครั้ง

5

ออนไลน์

เผยแพร่เป็นเว็บแอป (Deploy)

  1. มุมขวาบนของ Apps Script กด การทำให้ใช้งานได้›การทำให้ใช้งานได้รายการใหม่
  2. กดไอคอนฟันเฟือง ⚙ ข้าง “เลือกประเภท” แล้วเลือก เว็บแอป
  3. ตั้งค่า ดำเนินการในฐานะ: ฉัน และ ผู้มีสิทธิ์เข้าถึง: ทุกคน แล้วกด การทำให้ใช้งานได้
  4. คัดลอก URL ของเว็บแอป (ลงท้ายด้วย /exec) เก็บไว้ — นี่คือลิงก์แดชบอร์ดของคุณ
เมนู การทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่
เมนู การทำให้ใช้งานได้ › การทำให้ใช้งานได้รายการใหม่
เลือกประเภท เว็บแอป
เลือกประเภท เว็บแอป
ดำเนินการในฐานะ ฉัน · ผู้มีสิทธิ์เข้าถึง ทุกคน แล้วกด การทำให้ใช้งานได้
ดำเนินการในฐานะ ฉัน · ผู้มีสิทธิ์เข้าถึง ทุกคน แล้วกด การทำให้ใช้งานได้
คัดลอก URL เว็บแอป (ในภาพเบลอไว้) แล้วกด เสร็จสิ้น
คัดลอก URL เว็บแอป (ในภาพเบลอไว้) แล้วกด เสร็จสิ้น
ทำไมเลือก “ทุกคน” ถึงยังปลอดภัย

ทุกคนที่มีลิงก์จะเห็นแค่หน้าใส่ PIN — ข้อมูลจะโหลดหลังใส่ PIN ถูกเท่านั้น ส่วนไฟล์ชีตยังเป็นส่วนตัวของคุณ · องค์กรที่ใช้ Google Workspace เลือก “ทุกคนใน [โดเมน]” เพื่อจำกัดเฉพาะบัญชีในองค์กรได้

6

พร้อมใช้

เปิดแดชบอร์ดครั้งแรกและเปลี่ยน PIN

  1. เปิด URL เว็บแอป ใส่ PIN เริ่มต้น
PIN เริ่มต้น: 1234
  1. ไปที่เมนู ตั้งค่า › เปลี่ยน PIN เข้าใช้งาน ตั้ง PIN ใหม่ 4–8 หลัก
  2. แก้ ชื่อบริษัท / หน่วยงาน และตั้งค่าเฉพาะของระบบ แล้วกดบันทึก
  3. ตั้ง ส่งรายงานสรุปอัตโนมัติ (รอบ เวลา อีเมลผู้รับ แนบ PDF) — ดูรายละเอียดในคู่มือการใช้งาน
  4. บนมือถือ เปิดลิงก์ใน Chrome/Safari แล้วเลือก เพิ่มไปยังหน้าจอหลัก เพื่อเปิดเหมือนแอป
หน้า ภาพรวมทีม เดือนที่แล้ว — KPI รวม กราฟ % ยอดขายเทียบเป้ารายคน และ 3 อันดับคะแนน KPI
หน้า ภาพรวมทีม เดือนที่แล้ว — KPI รวม กราฟ % ยอดขายเทียบเป้ารายคน และ 3 อันดับคะแนน KPI
7

ภายหลัง

อัปเดตเวอร์ชันใหม่โดยใช้ URL เดิม

  1. วางไฟล์ Code.gs / Index.html เวอร์ชันใหม่ทับของเดิม แล้วบันทึก
  2. กด การทำให้ใช้งานได้›จัดการการทำให้ใช้งานได้ › ไอคอนดินสอ ✏️ › ช่อง เวอร์ชัน เลือก เวอร์ชันใหม่ › การทำให้ใช้งานได้
  3. ถ้าเวอร์ชันใหม่เพิ่มชีต ให้รัน setup อีกครั้ง (ข้อมูลเดิมไม่หาย)
⚠ อย่าสร้าง “การทำให้ใช้งานได้รายการใหม่” ซ้ำ

จะได้ URL ใหม่ ต้องแจ้งลิงก์ใหม่กับทุกคน — ใช้ “จัดการการทำให้ใช้งานได้” เพื่อคง URL เดิม

ส่วนที่ 2

ข้อมูลในชีต

แดชบอร์ดอ่านข้อมูลจากชีตเหล่านี้โดยตรง

📋

โครงสร้าง

ชีตที่ระบบสร้างให้

ระบบอ่านตามลำดับคอลัมน์ เปลี่ยนชื่อหัวตารางได้แต่อย่าสลับลำดับ หรือแทรกคอลัมน์ตรงกลาง (เพิ่มคอลัมน์ของคุณเองทางขวาสุดได้) · วันที่พิมพ์ได้ทั้งแบบวันที่ของ Sheets, 25/09/2026, 2026-09-25 หรือปี พ.ศ. 25/09/2569

ชีต “บันทึกผลงาน”

คอลัมน์หัวตารางคำอธิบาย
Aวันที่วันที่ทำผลงาน
Bรหัสพนักงานตรงกับชีต พนักงานขาย
Cชื่อพนักงานใส่ไว้อ่านง่าย (ระบบใช้รหัสพนักงาน)
Dยอดขาย (บาท)
Eปิดดีลจำนวนดีล/ใบสั่งซื้อที่ปิดได้
Fลูกค้าใหม่
Gเข้าพบ/โทรจำนวนครั้งที่เข้าพบหรือโทรหาลูกค้า
Hหมายเหตุ

ชีต “พนักงานขาย”

คอลัมน์หัวตารางคำอธิบาย
Aรหัสพนักงานห้ามซ้ำ เช่น S01
Bชื่อ-สกุล
Cชื่อเล่น
Dทีม/สาขา
Eตำแหน่ง
Fวันเริ่มงาน
Gสถานะทำงาน / ลาออก (ลาออกจะไม่แสดงในอันดับถ้าไม่มีผลงาน)

ชีต “เป้าหมายรายเดือน”

คอลัมน์หัวตารางคำอธิบาย
Aเดือน (ปปปป-ดด)ปี ค.ศ.-เดือน เช่น 2026-10
Bรหัสพนักงาน
Cชื่อพนักงาน
Dเป้ายอดขาย
Eเป้าดีล
Fเป้าลูกค้าใหม่
Gเป้าเข้าพบ/โทร
🚀

เริ่มใช้จริง

ล้างข้อมูลตัวอย่างแล้วใส่ข้อมูลของคุณ

  1. ลองใช้งานกับข้อมูลตัวอย่างจนคุ้นเคย
  2. ในไฟล์ชีต เลือกเมนู 📊 TeamKPI›ล้างข้อมูลตัวอย่าง (เริ่มใช้งานจริง) แล้วกด ใช่ — ลบเฉพาะแถวข้อมูล หัวตารางยังอยู่
  3. แก้ชีต พนักงานขาย เป็นรายชื่อจริง (ชีตนี้ไม่ถูกล้าง) · ตั้งเป้าเดือนนี้ที่หน้า ตั้งเป้าหมาย · ให้พนักงานบันทึกผลงานทุกวันจากมือถือ หรือหัวหน้าวางข้อมูลจาก CRM ลงชีต บันทึกผลงาน
💡 ย้ายข้อมูลจากไฟล์เดิม

ถ้ามีข้อมูลจาก CRM / โปรแกรมบัญชี ให้สรุปเป็นรายวันต่อคน (วันที่ · รหัสพนักงาน · ชื่อ · ยอดขาย · ดีล · ลูกค้าใหม่ · เข้าพบ) แล้ววางต่อท้ายชีต บันทึกผลงาน — หนึ่งคนมีหลายแถวในวันเดียวกันได้ ระบบรวมให้

ช่วยเหลือ

คำถามที่พบบ่อย

เปิดเว็บแอปแล้วขึ้น “ยังไม่ได้ติดตั้งระบบ”

ยังไม่ได้รันฟังก์ชัน setup ในหน้า Apps Script — กลับไปทำขั้นตอนที่ 3 ของคู่มือติดตั้ง แล้วรีเฟรชหน้าเว็บแอป

ลืม PIN ทำอย่างไร

เปิดไฟล์ Google Sheets แล้วเลือกเมนู 📊 TeamKPI›รีเซ็ต PIN เป็น 1234 จากนั้นเข้าเว็บแอปด้วย 1234 แล้วตั้ง PIN ใหม่ที่หน้า ตั้งค่า (เฉพาะเจ้าของไฟล์ชีตเท่านั้นที่ทำได้)

แก้โค้ดหรืออัปเดตเวอร์ชันแล้ว แต่หน้าเว็บยังเป็นแบบเดิม

ต้องสร้างเวอร์ชันใหม่ของการทำให้ใช้งานได้ ดูขั้นตอนที่ 7 ของคู่มือติดตั้ง — URL เดิมจะใช้ได้ต่อ ไม่ต้องแจ้งลิงก์ใหม่

ไม่ได้รับอีเมลรายงาน

ตรวจว่าเปิดสวิตช์ส่งรายงานและใส่อีเมลถูกต้องที่หน้า ตั้งค่า · ลองกด ส่งอีเมลตอนนี้ ในหน้าต่างรายงาน · ดูโฟลเดอร์จดหมายขยะ · บัญชี Gmail ทั่วไปส่งอีเมลจากสคริปต์ได้ประมาณ 100 ฉบับต่อวัน (ระบบแสดงโควตาคงเหลือในหน้าตั้งค่า)

คนอื่นในทีมเปิดดูได้ไหม

ได้ ส่ง URL เว็บแอปพร้อม PIN ให้ทีม ผู้ดูไม่ต้องมีสิทธิ์แก้ไขไฟล์ชีต (ระบบทำงานในนามเจ้าของไฟล์) · ถ้าต้องการจำกัดเฉพาะบัญชีในองค์กร ให้เลือก “ผู้มีสิทธิ์เข้าถึง” เป็นบัญชีในโดเมนของคุณตอน Deploy

ข้อมูลเยอะขึ้นเรื่อย ๆ จะช้าไหม

ระบบออกแบบสำหรับข้อมูลระดับหลักหมื่นแถวได้สบาย (ข้อมูลตัวอย่างประมาณหนึ่งหมื่นแถวโหลดในไม่กี่วินาที) ถ้าเกินหลักแสนแถว แนะนำย้ายข้อมูลปีเก่าไปเก็บอีกไฟล์ แล้วเหลือเฉพาะ 1–2 ปีล่าสุดไว้ในไฟล์ที่ใช้งาน

ข้อมูลปลอดภัยไหม

ข้อมูลทั้งหมดอยู่ในไฟล์ Google Sheets ใน Drive ของคุณ ไม่มีการส่งออกไปเซิร์ฟเวอร์ภายนอก · PIN เก็บเป็นค่าแฮช · ทุกการเรียกข้อมูลต้องผ่าน PIN (เซสชันหมดอายุใน 6 ชั่วโมง) · ใส่ PIN ผิด 8 ครั้งระบบล็อก 10 นาที

พนักงานลาออกระหว่างปี ทำอย่างไร

เปลี่ยนสถานะในชีต พนักงานขาย เป็น ลาออก — ข้อมูลเก่ายังอยู่ในรายงานย้อนหลัง แต่จะไม่แสดงในช่วงที่ไม่มีผลงาน และไม่อยู่ในรายการตั้งเป้า

ย้ายพนักงานข้ามทีม

แก้คอลัมน์ ทีม/สาขา ในชีตพนักงานขาย — ผลงานทั้งหมดของคนนั้นจะนับเข้าทีมใหม่ (ระบบอ้างทีมปัจจุบัน)

คะแนนขึ้น “ไม่มีเป้า”

ยังไม่ได้ตั้งเป้าเดือนนั้นให้พนักงานคนนั้น ไปที่หน้า ตั้งเป้าหมาย เลือกเดือนแล้วบันทึก