แนะนำการใช้ REST API ของ AI SNS CHAT ตั้งแต่การเลือกใช้ให้เหมาะ การสตรีมคำตอบ เว็บฮุกที่ลงลายเซ็น ขีดจำกัดอัตรา ไปจนถึงเช็กลิสต์ความปลอดภัย
ร้านค้าออนไลน์หรือบริษัทที่ใช้ LINE เป็นช่องทางหลักมักมีระบบของตัวเองอยู่แล้ว ทั้งแอปสมาชิก หลังบ้านสั่งซื้อ และหน้าเว็บที่ออกแบบเอง คำถามที่ตามมาคือจะเอาเอเจนต์ AI เข้าไปอยู่ในระบบเหล่านั้นได้อย่างไร โดยไม่ต้องสร้างทุกอย่างใหม่ บทความนี้อธิบายว่าเมื่อไรควรใช้ REST API ของ AI SNS CHAT ส่วนประกอบหลักมีอะไรบ้าง ควรออกแบบอย่างไรให้เสถียร และต้องตรวจอะไรบ้างก่อนเปิดใช้งานจริง
เมื่อไรที่ API คือเครื่องมือที่ใช่ (และเมื่อไรที่ไม่ใช่)
API เป็นเครื่องมือที่ยืดหยุ่นมาก แต่ก็ต้องมีคนเขียนโค้ด ดูแล และเฝ้าระวังต่อเนื่อง ก่อนลงมือจึงควรถามก่อนว่าช่องทางหรือฟีเจอร์ที่มีอยู่แล้วตอบโจทย์หรือยัง
AI SNS CHAT มีช่องทางสำเร็จรูปให้ติดตั้งโดยไม่ต้องเขียนโค้ด เช่น วิดเจ็ตแชต LINE Messenger WhatsApp Instagram Telegram และอีกหลายช่องทางในเมนู Channels ถ้าเป้าหมายคือให้ลูกค้าคุยกับเอเจนต์ผ่าน LINE หรือ Messenger ก็ไม่จำเป็นต้องใช้ API เลย
โดยทั่วไป API เหมาะกับสถานการณ์เหล่านี้
- ต้องการให้เอเจนต์ตอบในแอปมือถือหรือพอร์ทัลสมาชิกที่ออกแบบหน้าจอเอง
- ต้องการให้ระบบหลังบ้านรับเหตุการณ์จากแชตไปทำงานต่อ เช่น เปิดงานในระบบภายใน
- ต้องการรวมการสนทนาเข้ากับเวิร์กโฟลว์ที่ปุ่มกดหรือหน้าตั้งค่าทำไม่ได้
ส่วนกรณีที่ไม่ควรเริ่มด้วย API คือเมื่อฟีเจอร์ที่มีอยู่ตอบโจทย์ได้แล้ว เช่น การส่งต่อให้เจ้าหน้าที่ การเก็บข้อมูลลูกค้าด้วยแอ็กชัน Collect leads หรือการแจ้งเตือนเข้า Slack การเลือกทางลัดเหล่านี้ก่อนช่วยลดงานดูแลระยะยาวได้มาก
องค์ประกอบพื้นฐาน
REST API ของ AI SNS CHAT ใช้รูปแบบ JSON และมีองค์ประกอบหลักสามส่วนที่ควรเข้าใจก่อนออกแบบ
1. คีย์ API
สร้างได้ที่ Workspace settings → API keys คีย์จะแสดงให้เห็นเพียงครั้งเดียวตอนสร้าง และเพิกถอนได้ทุกเมื่อ ดังนั้นต้องคัดลอกไปเก็บในที่ปลอดภัยทันที ฟีเจอร์นี้ใช้ได้ตั้งแต่แพ็กเกจ Hobby ขึ้นไป
2. การสตรีมคำตอบแบบ SSE
หากต้องการให้คำตอบทยอยปรากฏทีละคำเหมือนที่เห็นในแชตทั่วไป ให้ส่งพารามิเตอร์ stream=1 เพื่อรับข้อมูลแบบ Server-Sent Events ผู้ใช้จะไม่ต้องรอจนเอเจนต์เขียนครบทั้งข้อความ ซึ่งช่วยเรื่องความรู้สึกว่าระบบตอบเร็ว
3. เว็บฮุกที่ลงลายเซ็น HMAC
เมื่อมีเหตุการณ์เกิดขึ้น AI SNS CHAT ส่งเว็บฮุกไปยังปลายทางของคุณพร้อมลายเซ็นแบบ HMAC เพื่อให้ตรวจสอบได้ว่าคำขอมาจากเราจริง และมีบันทึกการส่ง (delivery log) ให้ย้อนดูว่าส่งสำเร็จหรือไม่
- 01แอปหรือหน้าเว็บของคุณ
- 02เซิร์ฟเวอร์ของคุณ (เก็บคีย์ API)
- 03REST API ของ AI SNS CHAT
- 04เว็บฮุกลงลายเซ็นกลับมายังระบบหลังบ้าน
รายละเอียดของปลายทาง พารามิเตอร์ และรูปแบบข้อมูลที่แน่นอน ให้ดูจากเอกสาร API reference ของ AI SNS CHAT เสมอ เพื่อให้โค้ดตรงกับเวอร์ชันล่าสุด
เคารพขีดจำกัดอัตราที่เผยแพร่
AI SNS CHAT เผยแพร่ขีดจำกัดอัตราไว้ในเอกสาร API reference ดังนี้
| ประเภท | ขีดจำกัดที่เผยแพร่ |
|---|---|
| การยืนยันตัวตน (auth) | 20 ครั้งต่อ 5 นาที ต่อ IP |
| แชตสาธารณะ (public chat) | 30 ครั้งต่อนาที ต่อ IP |
| การโพล (poll) | 120 ครั้งต่อนาที |
จุดที่มักพลาดคือคำว่า "ต่อ IP" สมมติว่าเซิร์ฟเวอร์ของคุณเรียกแชตสาธารณะแทนผู้ใช้ทุกคน ทุกคำขอจะออกจาก IP เดียวกัน เมื่อมีผู้ใช้พร้อมกันหลายคนก็อาจชนเพดาน 30 ครั้งต่อนาทีได้เร็วกว่าที่คิด ตัวอย่างสมมติ: หากแคมเปญของร้านทำให้มีคนทักพร้อมกัน 50 คนในนาทีเดียว และทุกคำขอผ่านเซิร์ฟเวอร์ตัวเดียว คำขอส่วนหนึ่งจะถูกจำกัด
แนวปฏิบัติที่ช่วยได้
- ใส่คิวและควบคุมจังหวะการส่งคำขอฝั่งเซิร์ฟเวอร์
- เมื่อถูกจำกัด ให้ลองใหม่แบบถอยห่างทีละขั้น (exponential backoff) ไม่ใช่ยิงซ้ำทันที
- ตั้งช่วงเวลาโพลให้เหมาะสม ไม่ถี่เกินจำเป็น
- ถ้าเป็นไปได้ ใช้การสตรีมหรือเว็บฮุกแทนการโพลถี่ ๆ
รูปแบบการออกแบบที่ใช้ได้ผล
ให้เซิร์ฟเวอร์ของคุณเป็นตัวกลางเสมอ
อย่าฝังคีย์ API ไว้ในหน้าเว็บหรือแอปมือถือ ใครเปิดดูโค้ดฝั่งไคลเอนต์ก็จะได้คีย์ไป ให้ไคลเอนต์คุยกับเซิร์ฟเวอร์ของคุณ แล้วเซิร์ฟเวอร์ค่อยเรียก AI SNS CHAT ด้วยคีย์ที่เก็บไว้อย่างปลอดภัย รูปแบบนี้ยังช่วยให้คุณใส่การยืนยันตัวตนผู้ใช้ของคุณเองและควบคุมปริมาณคำขอได้ในจุดเดียว
สตรีมคำตอบเข้าหน้าจอของคุณ
ถ้าต้องการให้ข้อความทยอยขึ้นในแอป ให้เซิร์ฟเวอร์รับสตรีม SSE จาก AI SNS CHAT แล้วส่งต่อให้ไคลเอนต์ของคุณ ควรเตรียมกรณีสตรีมขาดกลางทาง เช่น แสดงข้อความที่ได้ถึงตอนนั้นพร้อมปุ่มให้ลองถามใหม่
รับเว็บฮุกแล้วตอบรับเร็ว ประมวลผลทีหลัง
ตัวรับเว็บฮุกควรตรวจลายเซ็น ตอบรับกลับทันที แล้วโยนงานหนักเข้าคิวไปทำเบื้องหลัง เพราะหากตอบช้า ฝั่งผู้ส่งอาจถือว่าส่งไม่สำเร็จ นอกจากนี้ควรออกแบบให้การรับเหตุการณ์เดิมซ้ำไม่ทำให้เกิดผลซ้ำ (idempotent) เช่น ไม่เปิดงานในระบบภายในสองครั้งจากเหตุการณ์เดียวกัน
เก็บเท่าที่จำเป็น
เมื่อดึงบทสนทนาไปเก็บในระบบของคุณ ให้เลือกเฉพาะข้อมูลที่ใช้งานจริง ซึ่งสอดคล้องกับหลักการลดข้อมูลให้เหลือเท่าที่จำเป็นตาม PDPA
เช็กลิสต์ความปลอดภัยก่อนขึ้นระบบจริง
- เก็บคีย์ API ในที่เก็บความลับ (secret manager) หรือตัวแปรสภาพแวดล้อม ไม่ใส่ในโค้ดหรือคลังโค้ดสาธารณะ
- ใช้คีย์แยกกันตามสภาพแวดล้อม เช่น ทดสอบกับใช้งานจริง เพื่อเพิกถอนได้โดยไม่กระทบอีกฝั่ง
- เพิกถอนคีย์ทันทีเมื่อสงสัยว่ารั่ว หรือเมื่อคนที่เคยเข้าถึงคีย์ย้ายหน้าที่
- ตรวจลายเซ็น HMAC ของเว็บฮุกทุกครั้ง และปฏิเสธคำขอที่ลายเซ็นไม่ตรง
- ใช้ HTTPS ตลอดเส้นทาง
- อย่าบันทึกคีย์หรือข้อมูลส่วนบุคคลลงล็อกของระบบคุณ
- กำหนดระยะเวลาเก็บบทสนทนาในระบบของคุณเอง และมีวิธีลบเมื่อเจ้าของข้อมูลร้องขอ
- ตั้งการแจ้งเตือนเมื่อเว็บฮุกล้มเหลวติดกันหลายครั้ง
เรื่อง PDPA เป็นความรับผิดชอบของผู้ควบคุมข้อมูลอย่างองค์กรของคุณ การออกแบบการเก็บ ใช้ และเปิดเผยข้อมูลควรปรึกษาผู้เชี่ยวชาญด้านกฎหมายขององค์กร ทางด้าน AI SNS CHAT ระบุว่าแนวปฏิบัติด้านความเป็นส่วนตัว "ออกแบบโดยอ้างอิง GDPR และ APPI" ซึ่งไม่ใช่การรับรองตามมาตรฐานใด และรายละเอียดเพิ่มเติมดูได้ที่หน้า ความปลอดภัย
ทดสอบและทยอยเปิดใช้
- เริ่มจากเอเจนต์ทดสอบ สร้างเอเจนต์แยกต่างหาก และใช้ Playground ลองคำถามจริงก่อนต่อเข้าระบบ
- ทดสอบกรณีผิดปกติ เช่น คีย์ผิด เครือข่ายหลุดระหว่างสตรีม เว็บฮุกส่งซ้ำ และการชนขีดจำกัดอัตรา
- เปิดให้กลุ่มเล็กก่อน เช่น พนักงานภายในหรือลูกค้าไม่กี่ราย แล้วดูบันทึกการส่งเว็บฮุกและบันทึกแชตว่าเป็นไปตามคาดหรือไม่
- เตรียมทางถอย ให้สลับกลับไปใช้ช่องทางสำเร็จรูป เช่น วิดเจ็ตแชตหรือ LINE ได้ทันทีหากโค้ดเชื่อมต่อมีปัญหา
- ทยอยขยาย เมื่อทุกอย่างนิ่งแล้วจึงเปิดให้ผู้ใช้ทั้งหมด
การทำงานนี้ใน AI SNS CHAT
ขั้นตอนเริ่มต้นสำหรับทีมพัฒนามีดังนี้
- เลือกแพ็กเกจ การสร้างคีย์ API ต้องใช้แพ็กเกจ Hobby ขึ้นไป ดูรายละเอียดแพ็กเกจและเครดิตได้ที่ ราคา หากยังไม่มีบัญชี สมัครใช้งาน แล้วเริ่มจากแพ็กเกจฟรีเพื่อทดลองสร้างเอเจนต์ก่อนได้
- เตรียมเอเจนต์ สร้างเอเจนต์ด้วยวิซาร์ด ใส่แหล่งความรู้ที่เมนู Data sources เช่น ไฟล์ เว็บไซต์ หรือ Q&A แล้วทดลองใน Playground จนพอใจกับคำตอบ
- สร้างคีย์ ไปที่ Workspace settings → API keys สร้างคีย์ คัดลอกเก็บทันทีเพราะจะแสดงครั้งเดียว และเพิกถอนได้ในหน้าเดิมเมื่อไม่ต้องการแล้ว
- เรียก API จากเซิร์ฟเวอร์ ใช้เอกสาร API reference เป็นแหล่งอ้างอิงรูปแบบคำขอ หากต้องการคำตอบแบบทยอยขึ้น ให้ส่ง
stream=1 - ตั้งเว็บฮุก รับเหตุการณ์ที่ปลายทางของคุณ ตรวจลายเซ็น HMAC แล้วเปิดดู delivery log เมื่อต้องการตรวจว่าเหตุการณ์ใดส่งไม่สำเร็จ
- ติดตามผล ดูบทสนทนาทั้งหมดที่ Activity → Chat logs ซึ่งมีตัวกรอง การส่งออก และคะแนนถูกใจหรือไม่ถูกใจ ส่วนการใช้เครดิตดูแยกตามเอเจนต์ได้ที่หน้า Usage
ในกรณีที่ต้องการแค่ให้เอเจนต์ทำงานกับระบบอื่นโดยไม่เขียนโค้ดเชื่อมต่อทั้งหมด ให้ดูที่เมนู Integrations ก่อน มีแอ็กชันสำเร็จรูป เช่น Slack Shopify Stripe Custom actions และเครื่องมือค้นข้อมูลแบบอ่านอย่างเดียวอีกราว 50 รายการ แต่ละแพ็กเกจมีจำนวนแอ็กชันต่อเอเจนต์จำกัด และต้องใช้ Hobby ขึ้นไปเช่นกัน ภาพรวมการเชื่อมต่อทั้งหมดดูได้ที่ การเชื่อมต่อ และฟีเจอร์อื่น ๆ ที่ ฟีเจอร์
คำถามที่พบบ่อย
ต้องใช้แพ็กเกจไหนจึงจะใช้ REST API ได้
การสร้างคีย์ API ที่ Workspace settings → API keys ต้องใช้แพ็กเกจ Hobby ขึ้นไป แพ็กเกจฟรีใช้ทดลองสร้างและทดสอบเอเจนต์ได้ แต่ไม่รวมคีย์ API ราคาและเครดิตของแต่ละแพ็กเกจอาจมีการปรับ ดูค่าปัจจุบันได้ที่หน้าราคา
สตรีมคำตอบเข้าหน้าจอของเราเองได้ไหม
ได้ API รองรับการสตรีมแบบ SSE โดยส่งพารามิเตอร์ stream=1 เซิร์ฟเวอร์ของคุณรับสตรีมแล้วส่งต่อให้แอปหรือหน้าเว็บ จะได้ไม่ต้องเปิดเผยคีย์ API ฝั่งไคลเอนต์ และควรเตรียมวิธีรับมือกรณีสตรีมขาดกลางทางด้วย
จะรู้ได้อย่างไรว่าเว็บฮุกมาจาก AI SNS CHAT จริง
เว็บฮุกจาก AI SNS CHAT ลงลายเซ็นแบบ HMAC ให้ฝั่งรับคำนวณลายเซ็นจากข้อมูลที่ได้รับ แล้วเทียบกับลายเซ็นที่แนบมา หากไม่ตรงให้ปฏิเสธคำขอ รูปแบบการคำนวณที่แน่นอนอยู่ในเอกสาร API reference นอกจากนี้ยังมี delivery log ไว้ตรวจประวัติการส่ง
ขีดจำกัดอัตราของ API เป็นอย่างไร
ค่าที่เผยแพร่คือ auth 20 ครั้งต่อ 5 นาทีต่อ IP, แชตสาธารณะ 30 ครั้งต่อนาทีต่อ IP และ poll 120 ครั้งต่อนาที ควรใส่คิวและการลองใหม่แบบถอยห่างในโค้ด โดยเฉพาะเมื่อคำขอจำนวนมากออกจาก IP เดียวกัน
ต้องใช้ API เพื่อเอาเอเจนต์ไปไว้บน WhatsApp หรือ Messenger ไหม
ไม่ต้อง WhatsApp, Messenger, LINE และช่องทางอื่นมีให้เชื่อมต่อในเมนู Channels โดยตรง ไม่ต้องเขียนโค้ด API เหมาะเมื่อคุณต้องการหน้าจอหรือเวิร์กโฟลว์ที่ออกแบบเองมากกว่า


