ตั้งค่า STB EVA Government Integration
เปิด Government Integration, เลือก TEST/LIVE แล้วทำการเริ่มใช้งาน 6 ขั้นตอนตามลำดับ โรงแรมส่วนใหญ่ใช้เวลา 10-20 นาที
คู่มือนี้ช่วยให้คุณทำ STB EVA onboarding ของสิงคโปร์ให้เสร็จสมบูรณ์จาก Settings → Check-in
AVA จะข้าม EVA เมื่อสัญชาติของผู้เข้าพักหรือรัฐที่ออกเอกสารถูกระบุเป็นสิงคโปร์ หากทั้งสองค่าไม่ใช่สิงคโปร์ AVA จะส่งผู้เข้าพักไป EVA
| การตั้งค่า | ควบคุมอะไร | ผลลัพธ์ |
|---|---|---|
| Government Integration | เปิดเครื่องมือเริ่มใช้งานของ EVA | คุณเริ่ม STB onboarding ได้ |
| EVA Environment | ปลายทาง EVA ที่ใช้ (TEST หรือ LIVE) | ใช้ API key และรันรายการทดสอบได้ |
| Hotel Code | รหัสโรงแรมที่ใช้ในคำขอ EVA | ขั้นตอนที่ 2 จะปลดล็อกหลังบันทึก |
| JWKS | กุญแจสำหรับลงนามของ EVA และการยืนยันขั้นตอนที่ 3 | ขั้นตอนที่ 4 จะปลดล็อกหลังคุณยืนยันการส่ง |
| EVA API Key | ข้อมูลรับรองสำหรับเรียก transaction ของ EVA | รัน test transaction ได้หลังบันทึกถูกต้อง |
| EVA skip rule | ป้องกันการส่ง EVA ที่ไม่จำเป็น | ผู้เข้าพักที่เกี่ยวข้องกับสิงคโปร์จะไปต่อโดยไม่เรียก EVA |
| Generate New JWKS | แทนที่ข้อมูลรับรองการเริ่มใช้งานเดิม | คุณต้องทำขั้นตอนที่ 3-6 ใหม่ |
ก่อนเริ่มต้น
- ประเทศของโรงแรมเป็น Singapore
- คุณมีสิทธิ์ Settings write
- คุณทราบ hotel code ของ STB
- คุณเข้าถึงฟอร์ม STB และลิงก์ส่ง JWKS ได้
ขั้นตอนการตั้งค่าแบบทีละขั้น
-
เปิด Government Integration
-
ใน Environment เลือก TEST หรือ LIVE แล้วคลิก Save EVA Environment
-
กรอก hotel code แล้วคลิก Save Hotel Code
✓ ตอนนี้คุณเริ่มขั้นตอนที่ 2 ได้แล้ว
-
ใน Step 2 คลิก Open STB Form
-
ส่งแบบฟอร์ม STB onboarding
-
กลับไปที่ Streamliner แล้วคลิก I have submitted the form
✓ สถานะ Step 2 จะเปลี่ยนเป็น Completed
-
ใน Step 3 คลิก Generate JWKS
-
คลิก Download JWKS txt
-
คลิก Submit JWKS Form และส่ง JWKS กับ STB ให้เสร็จ
-
กลับไปที่ Streamliner แล้วคลิก I have submitted the JWKS
-
ใน popup ยืนยัน คลิก Yes, I have submitted the JWKS
✓ สถานะ Step 3 จะเปลี่ยนเป็น Completed
- ใน Step 4 กรอก API key ที่ STB ออกให้ แล้วคลิก Save API Key
ℹ️ หากเคยบันทึก key ไว้ก่อนหน้า ช่องจะโชว์ดอกจันที่ปิดบังไว้จนกว่าคุณจะคลิกเข้าไป
- รอการตรวจสอบอัตโนมัติ
✓ หากสำเร็จ Streamliner จะบันทึก key และเริ่ม test transaction
- ใน Step 5 คัดลอก transaction ID หากจำเป็น ให้คลิก Re-generate Test Transaction
- ใน Step 5 คลิก Send Automated Email to STB
- รออีเมลยืนยันการเชื่อมต่อจาก STB
- ใน Step 6 คลิก Mark STB Confirmation Received
✓ สถานะ Step 6 จะเปลี่ยนเป็น Completed
หากคุณเห็นคำเตือน ⚠️ เช่น "We sent this test transaction to your email only" แปลว่า Streamliner ยังไม่ได้ส่งอีเมลให้ STB
ให้ forward อีเมลนั้นไปยัง STB แล้วรอการยืนยันจาก STB จากนั้นทำ Step 6 ให้เสร็จ
หากมีคีย์อยู่แล้ว การสร้าง JWKS ใหม่จะมาแทนที่คีย์เก่าและล้างความคืบหน้า onboarding ที่ตามมา คุณต้องทำ Steps 3-6 ใหม่ รวมถึงการบันทึก API key, test transaction และการยืนยันจาก STB
การแก้ไขปัญหา
EVA ถูกข้ามสำหรับผู้เข้าพักที่เกี่ยวกับสิงคโปร์
สิ่งที่คุณเห็น: ผู้เข้าพักเช็กอินเสร็จโดยไม่มีการส่ง EVA
วิธีแก้:
- ตรวจสัญชาติของผู้เข้าพักและรัฐที่ออกเอกสาร
- หากค่าใดค่าหนึ่งเป็นสิงคโปร์ ให้ถือว่าการข้าม EVA เป็นพฤติกรรมปกติ
- ดำเนินโฟลว์เช็กอินต่อโดยไม่ส่งผู้เข้าพักไป EVA อีกครั้ง
ปุ่ม Step 2 ถูกปิดใช้งาน
สิ่งที่คุณเห็น: คุณยืนยันการส่งฟอร์มไม่ได้
วิธีแก้:
- บันทึกค่าใน Hotel Code
- ยืนยันว่า Government Integration เปิดอยู่
- ลองอีกครั้ง
ยืนยัน Step 3 ไม่ได้
สิ่งที่คุณเห็น: ปุ่ม I have submitted the JWKS ยังปิดใช้งานอยู่
วิธีแก้:
- สร้างหรือ override JWKS ก่อน
- ส่ง JWKS ในฟอร์ม STB
- กลับมาแล้วคลิกปุ่มยืนยัน
- ทำ popup ยืนยันให้เสร็จ
การบันทึก API key ถูกบล็อกด้วยข้อความจาก Step 3
สิ่งที่คุณเห็น: ข้อผิดพลาดบอกให้ทำ Step 3 ให้เสร็จก่อนบันทึก EVA API key
วิธีแก้:
- กลับไปที่ Step 3
- คลิก I have submitted the JWKS
- ยืนยัน popup
- ลอง Save API Key ใหม่ใน Step 4
บันทึก API key ไม่สำเร็จ
สิ่งที่คุณเห็น: ข้อผิดพลาดบอกว่า API key format ไม่ถูกต้อง
วิธีแก้:
- ตรวจว่า key เป็นรูปแบบ UUID เต็ม
- ลบช่องว่างเกินออก
- บันทึกใหม่
ช่อง API key แสดงเฉพาะดอกจัน
สิ่งที่คุณเห็น: Step 4 แสดง ********-****-****-****-************
วิธีแก้:
- คลิกในช่อง API key
- วางค่า key ใหม่
- คลิก Save API Key
Test transaction ล้มเหลว
สิ่งที่คุณเห็น: Step 5 แสดงข้อความข้อผิดพลาด
วิธีแก้:
- ยืนยันว่า EVA Environment ถูกบันทึกแล้ว
- ยืนยันว่า Step 3 และ Step 4 เสร็จแล้ว
- คลิก Re-generate Test Transaction
- หากยังล้มเหลว ให้ติดต่อซัพพอร์ต
การส่งอัตโนมัติขึ้นคำเตือนว่าไปที่อีเมลของคุณเท่านั้น
สิ่งที่คุณเห็น: คำเตือน ⚠️ บอกว่า "We sent this test transaction to your email only" หลังคุณคลิก Send Automated Email to STB
วิธีแก้:
- ตรวจกล่องอีเมลของคุณหาอีเมล transaction
- ส่งต่ออีเมลไปยัง STB
- รอการยืนยันจาก STB แล้วทำ Step 6 ให้เสร็จ
- ติดต่อซัพพอร์ตหากต้องการเปิดอีเมลอัตโนมัติไปยัง STB สำหรับที่พักของคุณ
onboarding ถูกซ่อนไว้พร้อมคำเตือน SG
สิ่งที่คุณเห็น: มีข้อความบอกว่า EVA onboarding ใช้ได้เฉพาะสิงคโปร์
วิธีแก้:
- ไปที่ Settings → Essentials → Hotel Basic Details
- ยืนยันว่า Country เป็น Singapore
- รีเฟรชและเปิด Government Integration ใหม่
ยังติดปัญหาอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ สถานะ Step ไม่อัปเดตหลังบันทึก
- ❌ การยืนยันจาก STB ล้มเหลวหลังลองหลายครั้ง
- ❌ การส่งอัตโนมัติล้มเหลวซ้ำ ๆ
ข้อมูลที่ควรแนบ:
- ภาพหน้าจอหน้า Government Integration
- ข้อความข้อผิดพลาดแบบตรงตัว
- เวลาที่เริ่มเกิดปัญหา