ChatBeds개발자

ChatBeds 개발자 플랫폼

ChatBeds에서 호텔의 객실, 요금, 예약, 청구서를 읽고 쓰는 연동을 만드세요. ChatBeds는 WhatsApp과 웹 대시보드로 운영하는 호텔 PMS입니다.

ChatBeds는 호텔의 프런트, 예약, 하우스키핑, 정산을 WhatsApp과 웹 대시보드로 운영합니다. 개발자 플랫폼을 사용하면 소프트웨어가 하나의 REST API인 Partner API(/partner/v1)로 그 데이터를 다루고, 서명된 웹훅으로 변경 사항을 받을 수 있습니다.

만들 수 있는 것

  • 예약 사이트와 채널. 실시간 가용성과 요금을 조회한 뒤 예약을 만들고, 변경하고, 취소하세요.
  • 채널 매니저와 PMS 커넥터. 객실 유형, 요금 플랜, 객실을 읽고, 누가 만든 예약이든 내 사본을 항상 동기화하세요.
  • 투숙객 메시지 도구. 날짜, 투숙객 이름, 자체 참조 번호로 숙박을 찾고 예약이 바뀌면 대응하세요.
  • 결제 및 회계 도구. 투숙객 청구서를 읽고, 요금을 추가하고, 결제를 기록하고, 호텔의 Stripe 계정으로 카드 결제 링크를 만드세요.

두 가지 연결 방법

앱(권장)개인 키
대상여러 호텔에 제공하는 소프트웨어직접 협업하는 호텔 한 곳
호텔 연결 방법앱 디렉터리에서 Connect, 이어서 Allow 클릭(OAuth 2.0)소유주가 Settings → Partner API에서 키를 만들어 보내 줍니다
자격 증명액세스 토큰 cbat_...(1시간)과 갱신 토큰API 키 cbk_...(폐기 전까지 만료 없음)
권한호텔이 허용한 범위(scopes)만해당 숙소의 모든 것

두 방법 모두 같은 기본 주소에서 같은 25개 작업을 호출하며, 멱등성, 요청 한도, 웹훅도 같습니다. 각 자격 증명은 하나의 숙소를 대신해 작동합니다.

전체 흐름

  1. 무료 개발자 계정을 만들면 테스트 데이터가 있는 Sandbox Hotel과 API 키를 받습니다.
  2. 그 키로 샌드박스에서 개발합니다.
  3. Developers 페이지에서 앱을 등록하고 client ID와 secret을 받습니다.
  4. OAuth로 앱을 내 샌드박스에 연결해 전체 흐름을 테스트합니다.
  5. 앱을 검토에 제출합니다. ChatBeds가 승인하면 모든 호텔의 앱 디렉터리에 등록됩니다.
  6. 호텔이 앱을 연결하면 서버가 코드를 토큰으로 교환하고 해당 숙소의 /partner/v1을 호출합니다.
  7. 해당 숙소에서 예약이 생성, 변경, 취소될 때마다 ChatBeds가 서명된 이벤트를 웹훅 주소로 보냅니다.

개발은 무료

개발자 계정과 Sandbox Hotel은 무료이며 요금이 청구되지 않습니다. 검토 전 어느 단계에서든 내 앱을 내 샌드박스에 연결할 수 있습니다.

다음 단계

무언가 만들고 계신가요?

이 페이지의 내용