ตั้งค่า Cloudbeds PMS Integration

ตั้งค่าอย่างรวดเร็ว

การเชื่อมต่อ Cloudbeds โดยทั่วไปใช้เวลาประมาณ 10 นาที Cloudbeds ขอ item access, read-only add-on access และ read access สำหรับ hotel, rate และ taxes/fees

คู่มือนี้ช่วยให้คุณเชื่อมต่อ Cloudbeds ระบบจะซิงก์ข้อมูล reservation, guest, housekeeping, payment, room, currency, hotel, rate และ tax หาก Cloudbeds ปฏิเสธการเชื่อมต่อ AVA จะแสดงเหตุผลที่แน่ชัดบนแถบ error

ตำแหน่งที่พบ

Settings → Essentials → Property Management System (PMS) Integration

ก่อนเริ่มต้น

คุณต้องมี:

• บัญชี Cloudbeds ที่มีสิทธิ์ admin
• ข้อมูลเข้าสู่ระบบ Cloudbeds
• สิทธิ์อนุญาตแอปภายนอก

คำเตือน

เชื่อมต่อบัญชี Cloudbeds ได้เพียงหนึ่งบัญชีต่อหนึ่งที่พักเท่านั้น

เชื่อมต่อกับ Cloudbeds

ขั้นตอนที่ 1: เลือก Cloudbeds เป็น PMS ของคุณ

1. ไปที่ Settings → Essentials
2. เลื่อนไปที่ Property Management System (PMS) Integration
3. คลิกการ์ด Cloudbeds
4. เครื่องหมายถูก (✓) จะปรากฏเพื่อยืนยันการเลือก

ขั้นตอนที่ 2: เริ่มการเชื่อมต่อ

1. คลิกปุ่ม Connect to Cloudbeds
2. หน้าต่างใหม่จะเปิดไปยัง Cloudbeds

ขั้นตอนที่ 3: อนุญาตการเข้าถึง

1. เข้าสู่ระบบบัญชี Cloudbeds ของคุณ
2. ตรวจสิทธิ์ที่ AVA ขอใช้
3. คลิก Authorize หรือ Allow
4. หน้าต่างจะปิดเองโดยอัตโนมัติ

ตอนนี้ AVA ขอสิทธิ์ดังต่อไปนี้:

Permission	AVA ใช้สิ่งนี้ทำอะไร
read:hotel	ดู metadata ของโรงแรม
read:guest	ดูรายละเอียดผู้เข้าพัก
write:guest	อัปเดตรายละเอียดผู้เข้าพัก
read:housekeeping	ดูข้อมูล housekeeping
write:housekeeping	อัปเดตข้อมูล housekeeping
read:rate	ดูข้อมูล rate plan
read:payment	ดูข้อมูลการชำระเงิน
write:payment	อัปเดตข้อมูลการชำระเงิน
read:reservation	ดูข้อมูล reservation
write:reservation	อัปเดตข้อมูล reservation
read:room	ดูข้อมูลห้อง
write:room	อัปเดตข้อมูลห้อง
read:currency	อ่านการตั้งค่าสกุลเงินของที่พัก
read:taxesAndFees	ดูข้อมูลภาษีและค่าธรรมเนียม
read:item	ดูข้อมูลแคตตาล็อกรายการ
write:item	อัปเดตข้อมูลแคตตาล็อกรายการ
read:addon	ดูข้อมูลแคตตาล็อก add-on

การเชื่อมต่อเก่า

หากคุณเชื่อมต่อ Cloudbeds ก่อนหน้านี้ ให้เชื่อมต่อใหม่เพื่อรีเฟรช read scopes ที่ได้รับ

ขั้นตอนที่ 4: ตรวจสอบการเชื่อมต่อ

1. กลับไปที่การตั้งค่า AVA
2. รอข้อความ "Finalizing connection..." (5-10 วินาที)
3. สถานะจะแสดงเครื่องหมายถูกสีเขียว
4. ข้อความจะแสดง: "Cloudbeds Account Linked"

เชื่อมต่อเสร็จแล้ว! 🎉

ข้อผิดพลาด OAuth ของ Cloudbeds

เมื่อ Cloudbeds บล็อกการเชื่อมต่อ AVA จะแสดงข้อความที่อ่านได้ คุณไม่ต้องเดาจากข้อความล้มเหลวแบบกว้าง ๆ อีกต่อไป

สิ่งที่คุณเห็น	หมายความว่าอะไร	ต้องทำอะไร
Cloudbeds did not return the OAuth state parameter.	callback ของ Cloudbeds ไม่มีข้อมูล state	เริ่มการเชื่อมต่อใหม่
Cloudbeds did not return an authorization code.	Cloudbeds ไม่ได้จบขั้นตอน authorization	เชื่อมต่อใหม่จาก Settings → Essentials
Cloudbeds OAuth state verification failed.	state ใน callback ไม่ถูกต้องหรือหมดอายุ	เชื่อมต่อ Cloudbeds ใหม่
Could not identify the merchant for this Cloudbeds link.	AVA จับคู่ callback กับโรงแรมของคุณไม่ได้	ตรวจว่าคุณล็อกอินใน property ที่ถูกต้อง
Cloudbeds rejected the authorization code exchange.	Cloudbeds บล็อกการแลก token	ตรวจ scopes และ redirect URI แล้วลองอีกครั้ง
Failed to link Cloudbeds account.	AVA แมป error ฝั่ง backend ไม่ได้	คัดลอกข้อความเต็มแล้วติดต่อซัพพอร์ต

สิ่งที่ซิงก์อัตโนมัติ

Cloudbeds ใช้ webhooks สำหรับอัปเดตแบบ real-time เมื่อมีการเปลี่ยนแปลงใน Cloudbeds AVA จะได้รับแจ้งทันที:

เหตุการณ์	เกิดอะไรขึ้น
Reservation created	AVA ได้รับการแจ้งและสามารถกำหนดเวลาข้อความ pre-arrival ได้
Reservation dates changed	AVA อัปเดตข้อความที่ตั้งเวลาไว้
Check-in/out status	สถานะซิงก์แบบเรียลไทม์

เมื่อคุณดู reservation ใน AVA ระบบจะดึงข้อมูลล่าสุดจาก Cloudbeds โดยตรง ทำให้คุณเห็นข้อมูลปัจจุบันเสมอ

ข้อมูล

ข้อมูลไหลหลักจาก Cloudbeds → AVA การอัปเดตผู้เข้าพักที่ทำใน AVA เช่นการเช็กอิน จะถูกส่งกลับไป Cloudbeds

การป้องกันการอ่านของ Cloudbeds

หากมีเจ้าหน้าที่หลายคนร้องขอข้อมูล Cloudbeds เดียวกันพร้อมกัน AVA จะใช้คำขออ่านร่วมกันหนึ่งครั้ง หาก Cloudbeds ส่ง error เดิมเกี่ยวกับ access หรือ success:false อีกครั้ง AVA จะหยุดการ retry ซ้ำชั่วคราว

ผลต่อผู้เข้าพักและพนักงาน

• แบบฟอร์มผู้เข้าพักปรับตามกฎของ Cloudbeds ฟิลด์ที่ต้องกรอกและฟิลด์ที่ซ่อนจะเปลี่ยนตามการตั้งค่า Cloudbeds ดังนั้นผู้เข้าพักจะเห็นเฉพาะสิ่งที่จำเป็น
• การค้นหา reservation ใช้ Cloudbeds หาก Cloudbeds ไม่ได้เชื่อมต่อ ขั้นตอนค้นหาผู้เข้าพักจะล้มเหลว
• ป้ายชื่อแหล่งการจองสามารถใช้ metadata ของ Cloudbeds หาก reservation ไม่มี sourceName AVA จะ fallback ไปใช้ชื่อ Cloudbeds ที่เชื่อมโยงไว้
• Source collect มาจากระเบียน source ที่เชื่อมโยงเมื่อมี วิธีนี้ทำให้พฤติกรรมของ hotel และ channel source สอดคล้องกับการตั้งค่า Cloudbeds
• การตั้งค่า room condition มีผลเฉพาะการซิงก์ housekeeping ค่านี้ควบคุมว่า AVA จะส่งสถานะ Clean หรือ Inspected ไป Cloudbeds เมื่อห้องถูกทำเครื่องหมายว่า clean ใน AVA เท่านั้น ไม่ได้เปลี่ยน UI ของผู้เข้าพัก
• AVA ขอสิทธิ์ item access และ read-only add-on access โดยตั้งใจไม่รวม write:addon
• read scopes ของ Cloudbeds จะรีเฟรชเมื่อ reconnect ให้เชื่อมต่อใหม่หากต้องใช้ข้อมูล hotel, rate หรือ taxes/fees บนสิทธิ์เก่า

ยกเลิกการเชื่อมต่อ Cloudbeds

ควรยกเลิกการเชื่อมต่อเฉพาะเมื่อคุณ:

• กำลังสลับไปใช้ PMS อื่น
• กำลังเปลี่ยนบัญชี Cloudbeds
• กำลังแก้ปัญหา sync

วิธียกเลิกการเชื่อมต่อ:

1. ไปที่ Settings → Essentials
2. คลิก Disconnect from Cloudbeds
3. ยืนยันเมื่อมีข้อความถาม

ข้อควรระวัง

การยกเลิกการเชื่อมต่อจะหยุดการซิงก์ทั้งหมดทันที ข้อมูลเดิมจะยังอยู่แต่จะไม่อัปเดต

การแก้ปัญหา

ค้างที่ "Connecting..."

1. รอ 30 วินาที
2. รีเฟรชหน้า
3. ตรวจการเชื่อมต่ออินเทอร์เน็ต
4. ลองใช้เบราว์เซอร์อื่น
5. ปิดตัวบล็อก popup

ข้อความ Cloudbeds OAuth error

สิ่งที่คุณเห็น: มีข้อความ Cloudbeds OAuth แสดงในแถบแจ้งเตือน

วิธีแก้:

1. อ่านข้อความก่อน
2. เทียบกับตารางด้านบน
3. เชื่อมต่อ Cloudbeds ใหม่หากข้อความพูดถึง state, code หรือ token exchange
4. ยืนยันว่าคุณใช้บัญชี Cloudbeds admin
5. ตรวจ redirect URI หาก token exchange ยังล้มเหลว

ข้อมูล

แถบแจ้งเตือนจะแสดงรายละเอียด error ของ Cloudbeds เองเมื่อมี ซึ่งช่วยให้คุณเริ่มแก้ปัญหาได้ชัดเจนขึ้น

Reservation ไม่ซิงก์

1. รอ 15 นาทีสำหรับการซิงก์ครั้งแรก
2. ตรวจสถานะการเชื่อมต่อ (ควรเป็นสีเขียว)
3. ลอง disconnect แล้วเชื่อมต่อใหม่
4. ตรวจว่ามี reservation อยู่ใน Cloudbeds

ข้อผิดพลาด access หรือ property ของ Cloudbeds

สิ่งที่คุณเห็น: ข้อความเช่น You don't have access to property ID หรือ error เดิมของ Cloudbeds กลับมาทันที

สาเหตุ: บัญชี Cloudbeds ที่เชื่อมต่อไม่มีสิทธิ์อ่าน property นั้น AVA ยังหยุด retry ซ้ำชั่วคราวด้วย

วิธีแก้:

1. ยืนยันว่าคุณล็อกอินอยู่ใน Cloudbeds property ที่ถูกต้อง

2. ให้ Cloudbeds admin ตรวจ access และสิทธิ์ของ property

3. รอหนึ่งนาทีก่อนกด Refresh อีกครั้ง

4. ติดต่อซัพพอร์ตหากข้อความยังวนกลับมา

   ✓ การรีเฟรชครั้งถัดไปควรใช้งานได้หลังแก้ปัญหา Cloudbeds access แล้ว

ไม่เห็นแท็บแคตตาล็อก

สิ่งที่คุณเห็น: แท็บ Items หรือ Add-ons หายไป

วิธีแก้:

1. เปิดหน้า Rooms ใหม่
2. ตรวจ prompt สิทธิ์ของ Cloudbeds
3. ยืนยันว่า prompt มี read:item, write:item และ read:addon
4. ติดต่อซัพพอร์ตหากแท็บแคตตาล็อกยังไม่ปรากฏ

หน้าต่าง popup ไม่เปิด

1. ตรวจการตั้งค่าตัวบล็อก popup ของเบราว์เซอร์
2. อนุญาต popups จากโดเมน AVA
3. ลองใช้เบราว์เซอร์อื่นหรือโหมด incognito

ความปลอดภัย

• การเชื่อมต่อใช้ OAuth 2.0 ที่ปลอดภัย
• รหัสผ่านของคุณจะไม่ถูกเก็บไว้ใน AVA
• สามารถถอนสิทธิ์ได้ทุกเมื่อจาก Cloudbeds
• การเชื่อมต่อจะหมดอายุหลังไม่มีการใช้งาน 90 วัน

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

เชื่อมต่อ Cloudbeds หลาย property ได้ไหม? ไม่ได้ หนึ่ง property ต่อหนึ่งบัญชี AVA เท่านั้น

ยกเลิกการเชื่อมต่อแล้วข้อมูลจะถูกลบไหม? ไม่ ข้อมูลเดิมจะยังอยู่ แต่จะไม่อัปเดต

พนักงานสามารถเชื่อมต่อ Cloudbeds ได้ไหม? ไม่ได้ เฉพาะผู้ดูแลระบบเท่านั้นที่จัดการการเชื่อมต่อ PMS ได้

ยังติดปัญหาอยู่?

ติดต่อ success@vouch-technologies.com หาก:

• ❌ error OAuth เดิมยังแสดงหลัง reconnect
• ❌ Cloudbeds ยังคงปฏิเสธการแลก authorization code
• ❌ คุณยืนยันบัญชีหรือ property ของ Cloudbeds ที่ถูกต้องไม่ได้

ข้อมูลที่ช่วยได้:

• ภาพหน้าจอของแถบ error
• เวลาเริ่มเกิดปัญหา
• ข้อความที่ AVA แสดงแบบตรงตัว

คู่มือที่เกี่ยวข้อง

• PMS Connection
• PMS Options
• PMS Connection Errors