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개 작업을 호출하며, 멱등성, 요청 한도, 웹훅도 같습니다. 각 자격 증명은 하나의 숙소를 대신해 작동합니다.
전체 흐름
- 무료 개발자 계정을 만들면 테스트 데이터가 있는 Sandbox Hotel과 API 키를 받습니다.
- 그 키로 샌드박스에서 개발합니다.
- Developers 페이지에서 앱을 등록하고 client ID와 secret을 받습니다.
- OAuth로 앱을 내 샌드박스에 연결해 전체 흐름을 테스트합니다.
- 앱을 검토에 제출합니다. ChatBeds가 승인하면 모든 호텔의 앱 디렉터리에 등록됩니다.
- 호텔이 앱을 연결하면 서버가 코드를 토큰으로 교환하고 해당 숙소의
/partner/v1을 호출합니다. - 해당 숙소에서 예약이 생성, 변경, 취소될 때마다 ChatBeds가 서명된 이벤트를 웹훅 주소로 보냅니다.
개발은 무료
개발자 계정과 Sandbox Hotel은 무료이며 요금이 청구되지 않습니다. 검토 전 어느 단계에서든 내 앱을 내 샌드박스에 연결할 수 있습니다.
다음 단계
무언가 만들고 계신가요?