ข้ามไปยังเนื้อหาหลัก

ตั้งค่า Cloudbeds PMS Integration

ตั้งค่าด่วน

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

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

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

Settings → Essentials → Property Management System (PMS) Integration

ก่อนเริ่ม​

คุณจะต้องมี:

  • บัญชี Cloudbeds ที่มีสิทธิ์ระดับผู้ดูแลระบบ
  • ข้อมูลเข้าสู่ระบบ 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 ขอเฉพาะสิทธิ์ต่อไปนี้:

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

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

ขั้นตอนที่ 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 ยังไม่จบขั้นตอนอนุญาตเชื่อมต่อใหม่จาก 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 จับคู่ข้อผิดพลาดจาก backend ไม่ได้คัดลอกข้อความเต็มและติดต่อซัพพอร์ต

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

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

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

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

ข้อมูล

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

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

  • ฟอร์มผู้เข้าพักปรับตามกฎของ Cloudbeds ฟิลด์ที่บังคับและฟิลด์ที่ซ่อนจะเปลี่ยนตามการตั้งค่า Cloudbeds ดังนั้นผู้เข้าพักจะเห็นเฉพาะสิ่งที่ต้องกรอก
  • การค้นหาการจองใช้ Cloudbeds หากไม่ได้เชื่อมต่อ Cloudbeds ขั้นตอนค้นหาผู้เข้าพักจะล้มเหลว
  • การตั้งค่าสภาพห้องมีผลเฉพาะการซิงก์งานแม่บ้าน การตั้งค่านี้กำหนดว่า AVA จะส่งสถานะ Clean หรือ Inspected ไปยัง Cloudbeds เมื่อห้องถูกทำเครื่องหมายว่าสะอาดใน AVA และไม่เปลี่ยน UI ของผู้เข้าพัก
  • AVA ขอสิทธิ์ item และ add-on แบบอ่านอย่างเดียว ตั้งใจไม่รวม write:addon
  • สิทธิ์อ่านของ Cloudbeds จะรีเฟรชเมื่อเชื่อมต่อใหม่ ให้เชื่อมต่อใหม่หากต้องใช้ข้อมูลโรงแรม อัตรา หรือภาษี/ค่าธรรมเนียมจาก grant เก่า

การตัดการเชื่อมต่อ Cloudbeds​

ตัดการเชื่อมต่อเฉพาะเมื่อคุณ:

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

วิธีตัดการเชื่อมต่อ:

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

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

การแก้ไขปัญหา​

การเชื่อมต่อค้างที่ "Connecting..."​

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

ข้อความผิดพลาด OAuth ของ Cloudbeds​

สิ่งที่เห็น: ข้อความ OAuth ของ Cloudbeds ปรากฏในแถบแจ้งเตือน

วิธีแก้:

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

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

การจองไม่ซิงก์​

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

แท็บ Items หรือ Add-ons ไม่ปรากฏ​

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

วิธีแก้:

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

หน้าต่างป๊อปอัปไม่เปิด​

  1. ตรวจสอบการตั้งค่าตัวบล็อกป๊อปอัปของเบราว์เซอร์
  2. อนุญาตป๊อปอัปจากโดเมน AVA
  3. ลองเบราว์เซอร์อื่นหรือโหมดไม่ระบุตัวตน

ความปลอดภัย​

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

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

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

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

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

ยังติดอยู่?​

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

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

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

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

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