คู่มือติดตั้ง Office Chat
แบบละเอียดทุกขั้น

0. ข้อสังเกตจากบอส

1สิ่งที่ต้องเตรียมก่อนติดตั้ง

ตรวจ Node.js ก่อน

ถ้ายังไม่มี ดาวน์โหลด LTS จาก nodejs.org แล้วติดตั้งแบบปกติ ไม่ต้องเลือกอะไรเพิ่ม

2ติดตั้งแบบละเอียด (ทีละขั้น)

2.1 เปิด PowerShell ที่โฟลเดอร์โปรเจกต์

2.2 สร้างไฟล์ .env จากแม่แบบ

2.3 ติดตั้ง dependencies

รอจนเสร็จ (ครั้งแรกอาจใช้เวลา 1–3 นาที ขึ้นกับเน็ต)

2.4 ตรวจสภาพเครื่อง (แนะนำ)

สคริปต์นี้จะบอก IP ที่ใช้เปิดจากเครื่องอื่นในวง LAN, ตรวจ Node.js, ตรวจ port ว่าง

2.5 เปิดใช้งานครั้งแรก

Server จะฟังที่ http://0.0.0.0:3000

เปิดเบราว์เซอร์:

• เครื่องเซิร์ฟเวอร์เอง: http://localhost:3000
• เครื่องอื่นใน LAN: http://<IP-เครื่องเซิร์ฟเวอร์>:3000 (ดู IP จาก npm run doctor)

2.6 สร้างบัญชี Admin คนแรก

เมื่อเปิดครั้งแรก ระบบจะพาไปหน้า First-run setup ให้ตั้ง:

• ชื่อ-นามสกุล
• อีเมล/เบอร์โทร (สำหรับ login)
• รหัสผ่าน (แนะนำ 12 ตัวอักษรขึ้นไป ผสมตัวเลข/ตัวพิมพ์ใหญ่/สัญลักษณ์)

2.7 เปิด Setup Center

จากเมนูบนขวา → ตั้งค่า → Setup Center (หรือเข้า URL /admin/setup-center ตรง ๆ ก็ได้)

หน้านี้คือศูนย์รวมตั้งค่าทุกอย่าง — ไม่ต้องแก้ไฟล์ .env ด้วยมืออีก (แม้ระบบจะเขียนลง .env ให้เอง)

นี่คือ mockup หน้า Setup Center (ส่วนบน — แสดงสถานะการเชื่อมต่อทั้งหมด):

3วิธีใส่ API Key (AI Provider)

ส่วนนี้สำหรับตั้งค่า AI ให้น้องแอสลาสตอบลูกค้าและช่วยงานแอดมิน ระบบรองรับ 3 ตัวเลือก:

แนะนำสำหรับงานจริง: openai แล้วใช้ GOOGLE_API_KEY เป็น fallback

3.2 ขอ OpenAI API Key

1. ไป platform.openai.com/api-keys
2. ล็อกอิน (หรือสมัครใหม่)
3. กด Create new secret key → ตั้งชื่อ เช่น office-chat-server → Create
4. คัดลอก key ทันที (ขึ้นต้นด้วย sk-...) — จะปิดหน้านี้แล้วดูอีกไม่ได้
5. ตั้ง billing ให้เรียบร้อยที่ platform.openai.com/account/billing

3.3 ขอ Google Gemini API Key (ทางเลือกเสริม)

1. ไป aistudio.google.com/apikey
2. ล็อกอิน Google account
3. กด Create API key → เลือก (หรือสร้าง) Google Cloud project
4. คัดลอก key (ขึ้นต้นด้วย AIza...)

3.4 ใส่คีย์ใน Setup Center

1. เปิดหน้า ตั้งค่า → Setup Center
2. เลือกกลุ่ม AI Provider

4. สำคัญ: ช่อง secret ที่เว้นว่าง ระบบจะ เก็บค่าเดิม ไว้ ถ้าจะเปลี่ยน key ให้วางใหม่ ถ้าจะลบ key ให้ติ๊ก "ล้างค่าที่บันทึก"
5. กด บันทึกการตั้งค่าทั้งหมด

3.5 ตรวจว่าคีย์ใช้ได้

• ดูสถานะบนหน้า Setup Center: การ์ด AI ต้องขึ้น "ready"
• ลองคุยกับ น้องแอสลาส ในห้องส่วนตัว (ระบบสร้างให้อัตโนมัติทุก user)
• ถ้า error ให้ดู log ที่โฟลเดอร์ logs/

4วิธีเชื่อมต่อ LINE Official Account (LINE OA)

4.1 ภาพรวม

ต้องมี:

1. LINE Official Account (สร้างที่ manager.line.biz)
2. Messaging API channel (สร้างใน LINE Developers console)
3. HTTPS domain ที่ชี้มาที่เซิร์ฟเวอร์ (เพราะ LINE ส่ง webhook ผ่าน HTTPS เท่านั้น)

4.2 สร้าง LINE Official Account + Messaging API

ขั้น A: สร้าง Provider และ Channel

1. ไป developers.line.biz/console
2. ล็อกอินด้วย LINE account เดียวกับที่ผูกกับ LINE OA
3. เลือก Provider (ถ้ายังไม่มี กด Create a new provider → ตั้งชื่อบริษัท)
4. ในหน้า Provider → กด Create a new channel
5. เลือก Messaging API
6. กรอกข้อมูล:
   • Channel name: ชื่อที่ลูกค้าจะเห็น
   • Channel description: คำอธิบาย
   • Category / Subcategory: เลือกให้ตรงธุรกิจ
   • Email: อีเมลผู้ดูแล
7. ยอมรับ terms → Create

นี่คือหน้า LINE Developers Console ที่บอสจะเห็นหลังสร้างเสร็จ:

ขั้น B: ผูก Channel กับ LINE OA ที่มีอยู่ (ถ้ามี)

• ถ้ามี LINE OA อยู่แล้ว: LINE Developers → Channel → LINE Official Account → เลือก OA ที่ผูก
• ถ้ายังไม่มี OA: ไป manager.line.biz → สร้าง LINE OA ใหม่ → กลับมา LINE Developers console → ผูก

ขั้น C: ตั้งค่า Channel ที่หน้า Channel ของคุณ

4.3 เตรียม HTTPS + Public URL

LINE webhook ต้องเป็น HTTPS — มี 3 ทางเลือก:

ทาง A: ใช้ HTTPS domain ที่ชี้มาที่เครื่องเซิร์ฟเวอร์

• ตั้ง DNS: chat.yourcompany.com → IP เครื่องเซิร์ฟเวอร์
• ใช้ reverse proxy (Nginx / Caddy) ทำ TLS ด้วย Let's Encrypt

ทาง B: ใช้ Cloudflare Tunnel / ngrok (สำหรับ dev/ทดสอบ)

จะได้ URL https://xxx.trycloudflare.com ใช้เป็น Public URL

ทาง C: ใช้ NSSM + Windows Server + certbot — สำหรับ production จริงจังในองค์กร

ตั้ง OFFICE_CHAT_PUBLIC_URL ใน .env (หรือ Setup Center) เป็น URL HTTPS เต็ม ๆ เช่น https://chat.yourcompany.com

4.4 ใส่ค่าใน Setup Center

กลับมาที่ ตั้งค่า → Setup Center → กลุ่ม LINE Official Account:

กด บันทึกการตั้งค่าทั้งหมด → การ์ดสถานะ LINE OA ต้องขึ้น "ready"

4.5 เลือกโหมดตอบ LINE

4.6 ผูก Webhook กลับใน LINE Developers

กลับไปที่ developers.line.biz/console:

1. เลือก Channel ของคุณ → แท็บ Messaging API
2. หัวข้อ Webhook URL → กรอก https://<โดเมน>/api/line/webhook
3. กด Update → กด Verify (ถ้าสำเร็จจะขึ้น Success)
4. เปิด Use webhook ให้เป็นเขียว

4.7 ทดสอบจริง

1. จากมือถือ เพิ่มเพื่อน LINE OA ของคุณ (สแกน QR จาก LINE OA Manager)
2. ส่งข้อความ "ทดสอบ" หรือ "สวัสดี"
3. ตรวจ 3 จุด:
   • ใน LINE: ถ้าโหมด auto/direct จะได้รับคำตอบจาก AI ทันที
   • ใน Office Chat: ต้องมีห้องใหม่ชื่อลูกค้า (ถ้าโหมดไม่ใช่ direct) พร้อม draft หรือสำเนา
   • ในหน้า Admin → LINE Workspace: จะเห็นข้อความเข้า

4.8 คำสั่งแอดมินในห้อง LINE

แอดมินสามารถพิมพ์ในห้องลูกค้า LINE ใน Office Chat:

5เริ่มเปิดใช้งานจริง (Checklist)

• Node.js 24+ ติดตั้งแล้ว
• npm install สำเร็จ
• .env ถูกสร้างจาก .env.example
• npm start ทำงาน ไม่มี error ใน console
• npm run doctor ผ่าน
• เข้าหน้าเว็บได้ทั้งจากเครื่องเซิร์ฟเวอร์และเครื่องอื่นใน LAN
• สร้างบัญชี Admin คนแรกแล้ว
• ใส่ API Key (OpenAI/Gemini) ใน Setup Center → การ์ด AI ขึ้น ready
• ทดสอบคุยกับน้องแอสลาสได้
• ตั้ง HTTPS + Public URL (ถ้าจะใช้ LINE)
• ใส่ LINE Channel secret + access token → การ์ด LINE OA ขึ้น ready
• ตั้ง webhook URL ใน LINE Developers → Verify ผ่าน
• ทดสอบส่งข้อความจาก LINE OA เข้ามา
• เลือกโหมดตอบ (แนะนำ draft ก่อน)
• ตั้ง firewall เฉพาะ port ที่จำเป็น
• ตั้ง Task Scheduler / NSSM ให้ server รันอัตโนมัติ (ดูหัวข้อ 7)
• ตั้ง backup data/ และ uploads/ เป็นประจำ

6คำสั่งที่ใช้บ่อย

7ตั้งให้รันอัตโนมัติบน Windows (Task Scheduler)

1. เปิด Task Scheduler → Create Task
2. แท็บ General:
   • Name: Office Chat Server
   • Run whether user is logged on or not: ✓
   • Run with highest privileges: ✓
3. แท็บ Triggers → New: At system startup
4. แท็บ Actions → New:
   • Program/script: powershell.exe
   • Arguments: -NoProfile -ExecutionPolicy Bypass -File "D:\For sale\Chat OF\scripts\start-office-chat.ps1"
5. แท็บ Conditions: Start only if network is available: ✓

หรือใช้ NSSM (แนะนำสำหรับ production) — ให้บริการ restart อัตโนมัติเมื่อ crash

8Backup / Restore

สำรองข้อมูล (ทำทุกวัน):

แนะนำ:

• backup รายวันไป NAS / external disk
• เก็บย้อนหลังอย่างน้อย 30 วัน
• ทดสอบ restore เดือนละครั้ง

กู้คืน:

9Troubleshooting (เจอปัญหาทำยังไง)

10ตำแหน่งไฟล์สำคัญ (อ้างอิงด่วน)

11เอกสารที่เกี่ยวข้อง

• README.md — ภาพรวมฟีเจอร์และการติดตั้งแบบย่อ
• docs/BUYER_QUICKSTART_TH.md — quick start 10 นาที (สำหรับผู้ซื้อซอร์ส)
• docs/FEATURE_CATALOG_TH.md — แค็ตตาล็อกฟีเจอร์ทั้งหมด
• docs/RUNBOOK.md — คู่มือ operator
• docs/SELL_SOURCE_CHECKLIST_TH.md — checklist สำหรับผู้ขายซอร์ส
• LINE_LOYALTY_HANDOFF.md — รายละเอียด LINE OA และ loyalty

เวอร์ชันอื่น: INSTALL_GUIDE.html (v2 · ฉบาดอัจฉริยะ 4 ขั้น)