วิธีเชื่อมโยงข้อมูลแบบทดสอบ OOOPEN Lab กับ Webhook?

หากคุณต้องการส่งข้อมูลการตอบกลับและผลลัพธ์จากแบบทดสอบหรือโปรเจกต์เชิงโต้ตอบของ OOOPEN Lab กลับไปยังระบบภายในของคุณโดยอัตโนมัติ เช่น เว็บไซต์ CRM หรือ Google Sheets ตอนนี้คุณสามารถทำได้อย่างง่ายดายโดยใช้คุณสมบัติ Webhook ร่วมกับ API Key

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

สารบัญ

• ฉันจะเปิดใช้งาน Webhooks ได้อย่างไร? มีตัวอย่างข้อมูลไหม?
• มีฟิลด์ข้อมูลใดบ้าง?
• ข้อมูลใดบ้างที่ไม่สามารถส่งคืนได้?
• กลไกการรักษาความปลอดภัยที่แนะนำ

ฉันจะเปิดใช้งาน Webhook ได้อย่างไร? มีตัวอย่างข้อมูลไหม?

1. สมัครเป็นผู้ใช้แบบชำระเงินเพื่อเข้าถึงฟีเจอร์นี้ในช่วงระยะเวลาที่การสมัครใช้งานของคุณยังใช้งานอยู่ ( วิธีการเลือกแพ็กเกจ? )
2. ไปที่หน้า “โปรไฟล์ผู้เล่น” แล้วเลือก “ นักพัฒนา ”

1. หากเป็นครั้งแรกที่คุณเข้าสู่ส่วนนักพัฒนา โปรดสร้าง API Key ใหม่

1. เมื่อสร้าง API Key เสร็จแล้ว คุณสามารถเริ่มตั้งค่าเหตุการณ์ Webhook ได้

1. สามารถเรียกใช้งาน Webhook ได้สองจุด เลือกตามความต้องการของคุณ:
   1. เปิดใช้งานเหตุการณ์ “เริ่มแล้ว” : เมื่อผู้เล่นเข้าสู่หน้าคำถาม
   2. เปิดใช้งานเหตุการณ์ “เสร็จสมบูรณ์” : เมื่อผู้เล่นเล่นจบและไปถึงหน้าผลลัพธ์ ( คำจำกัดความของความสำเร็จ )

1. เมื่อตั้งค่าสำเร็จแล้ว ระบบจะส่งคำขอ POST ไปยัง URL ที่คุณกำหนดไว้ทุกครั้งที่ตรงตามเงื่อนไขที่กำหนด

ตัวอย่างข้อมูล JSON

{ "data": { "answerId": "o1VepeqjgSbe6XxeJlZs", "quizId": "nvCwKZUvGw43KTrMth3V", "startedAt": "2024-04-11T08:44:10.782Z", "ref": { "id": "gI11io", "label": "Channel Name" }, "utm": { "campaign": "", "id": "", "source": "" }, "fromQuiz": { "answerId": "", "quizId": "" }, "finishedAt": "2024-04-11T08:44:10.943Z", "result": { "id": "default", "label": "Result Name" }, "duration": 2513, "answers": [ { "id": "VvsB5w", "duration": 1297, "value": "adaff", "title": "Question 1" }, { "id": "WSgpX9", "duration": 1217, "value": "Other", "other": "User's custom response", "title": "Question 3" } ] }, "type": "finish", "timestamp": "2024-04-11T08:50:57.315Z" }

มีฟิลด์ข้อมูลใดบ้าง?

ช่องข้อมูลการตอบกลับทั่วไป:

ช่องข้อมูลที่ใช้ร่วมกันสำหรับกิจกรรมทุกประเภท:

ช่องข้อมูลเฉพาะสำหรับกิจกรรม “ทำแบบทดสอบเสร็จสมบูรณ์”:

ช่องสำหรับกรอกคำตอบ:

ช่องสำหรับอ้างอิง (แหล่งที่มาของช่อง):

ช่องข้อมูลสำหรับ UTM (ต้องใช้คุณสมบัติขั้นสูง “ การส่งออกระเบียน UTM ”):

ช่องข้อมูลสำหรับ fromQuiz (ต้องใช้ฟีเจอร์ขั้นสูง “ เปลี่ยนเส้นทางไปยังโปรเจกต์อื่น ”):

💡 หากแบบทดสอบใช้การเข้าสู่ระบบด้วยบัญชีโซเชียลหรือสมาชิก ข้อมูลที่ส่งไปอาจมี oauthUser เมื่อพบข้อมูลสมาชิก id จะระบุสมาชิกนั้นและจะปรากฏอยู่เสมอ email จะถูกเพิ่มเมื่อโปรเจ็กต์มีส่วนเสริมที่เกี่ยวข้องอย่างใดอย่างหนึ่งจากสองส่วน คือ “บันทึกอีเมลผู้เล่นจากการเข้าสู่ระบบด้วยบัญชีโซเชียล” หรือ “รวบรวมข้อมูลผู้เล่นในหน้าผลลัพธ์” provider มีขอบเขตที่แคบกว่า: จะถูกเพิ่มเฉพาะเมื่อโปรเจ็กต์มีสิทธิ์การใช้งานฟีเจอร์ขั้นสูงของ OAuth ซึ่งเป็นอย่างแรกจากสองส่วนนั้น หากไม่มีส่วนเสริมใดๆ อย่าคาดหวังว่าฟิลด์ใดฟิลด์หนึ่งจะปรากฏอยู่เสมอไป และหากไม่พบข้อมูลสมาชิก oauthUser อาจเป็น null ดังนั้นให้จัดการกรณีนั้นในตัวรับข้อมูลของคุณ

หากต้องการตั้งค่าการเข้าสู่ระบบ LINE ของคุณเอง โปรดดูวิธีเชื่อมต่อ OAuth สำหรับการตรวจสอบสิทธิ์การเข้าสู่ระบบโครงการ OOOPEN Lab

ข้อมูลใดบ้างที่ไม่สามารถส่งคืนได้?

เนื่องจากทริกเกอร์จำกัดอยู่เฉพาะเหตุการณ์ "เริ่มต้น" และ "เสร็จสมบูรณ์" เท่านั้น ข้อมูลที่ส่ง หลังจาก ทำแบบทดสอบเสร็จสิ้น เช่น คำตอบจากแบบฟอร์มเสริม ช่องเก็บข้อมูลลูกค้าเป้าหมาย หรือคะแนนจากแบบทดสอบที่มีการให้คะแนน จึงไม่สามารถส่งผ่าน Webhook ได้

กลไกการรักษาความปลอดภัยที่แนะนำ

การส่งข้อมูลผ่าน Webhook จะมีส่วนหัว x-ooopenlab-signature ซึ่งสามารถใช้เพื่อตรวจสอบว่าการแจ้งเตือนนั้นมาจาก OOOPEN Lab

ขั้นตอนการตรวจสอบ:

1. แปลงอ็อบเจ็กต์ข้อมูล (เฉพาะส่วนข้อมูล JSON ไม่ใช่เพย์โหลดทั้งหมด) ให้เป็นสตริง JSON จากนั้นใช้คีย์ API ของคุณร่วมกับอัลกอริทึม HMAC-SHA256 เพื่อสร้างค่าแฮชแบบเลขฐานสิบหก
2. หากค่าเลขฐานสิบหกนี้ตรงกับส่วนหัวของไฟล์ x-ooopenlab-signature แสดงว่าข้อมูลได้รับการตรวจสอบแล้ว

ตัวอย่าง

ถ้าข้อมูลคือ {“test”:123} และ API Key คือ abcdef0123 ลายเซ็นเลขฐานสิบหกที่ได้จะเป็น: c6dddde7ffbf0c651277f40b52cc8a07d80493982eaa6a10b7ab30bd6d9d4fe7

ตัวอย่างโค้ด (Node.js)

const crypto = require('crypto');

const key = 'abcdef0123';

const data = '{"test":123}';

ลายเซ็นคงที่ = การเข้ารหัส

.createHmac("sha256", key)

อัปเดต (ข้อมูล)

.digest("hex");

// ลายเซ็น === 'c6dddde7ffbf0c651277f40b52cc8a07d80493982eaa6a10b7ab30bd6d9d4fe7'

ลงทะเบียนเป็นครีเอเตอร์และเริ่มสร้างสรรค์ผลงานได้เลยด้วยการทดลองใช้ฟรี!

เพียงคลิก “เข้าสู่ระบบ/ลงทะเบียน” ที่มุมบนขวาเพื่อสมัครเป็นครีเอเตอร์ ด้วยแผนฟรี คุณสามารถสร้าง แก้ไข และเผยแพร่โปรเจ็กต์ได้ไม่จำกัดจำนวน โดยไม่มีกำหนดเวลา!

แพ็กเกจฟรีในปัจจุบันให้ใช้งานทดลองได้ไม่จำกัด แต่มีข้อจำกัดบางประการ คุณสามารถดูรายละเอียดได้ในส่วนหลังบ้าน ภายใต้หัวข้อ “ซื้อแพ็กเกจ > คลิกเพื่อขยายตารางเปรียบเทียบคุณสมบัติทั้งหมด” ก่อนที่จะเผยแพร่จริง เพียงแค่ซื้อแพ็กเกจออนไลน์เพื่อเปิดใช้งานบัญชีของคุณและปลดล็อกสิทธิ์การเผยแพร่ภายใน 1 นาที!