منصة ChatBeds للمطورين
ابنِ تكاملات تقرأ وتكتب غرف الفندق وأسعاره وحجوزاته وفواتيره في ChatBeds، نظام إدارة الفنادق الذي يعمل من WhatsApp ولوحة تحكم على الويب.
يدير ChatBeds الاستقبال والحجوزات والتدبير الفندقي والفوترة في الفندق من WhatsApp ولوحة تحكم على الويب. تتيح منصة المطورين لبرنامجك العمل مع هذه البيانات عبر واجهة REST واحدة هي Partner API (/partner/v1)، ومعرفة التغييرات عبر webhooks موقّعة.
ما الذي يمكنك بناؤه
- مواقع وقنوات الحجز. ابحث في التوفر والأسعار مباشرةً، ثم أنشئ الحجوزات وعدّلها وألغِها.
- مديرو القنوات وموصلات أنظمة PMS. اقرأ أنواع الغرف وخطط الأسعار والغرف، وأبقِ نسختك من كل حجز متطابقة أيًّا كان من أنشأه.
- أدوات مراسلة الضيوف. ابحث عن الإقامات بالتاريخ أو اسم الضيف أو مرجعك الخاص، وتفاعل عندما يتغير الحجز.
- أدوات الدفع والمحاسبة. اقرأ فاتورة الضيف وأضف الرسوم وسجّل المدفوعات وأنشئ روابط دفع بالبطاقة على حساب Stripe الخاص بالفندق.
طريقتان للدخول
| تطبيق (موصى به) | مفتاح خاص | |
|---|---|---|
| لمن | برنامج تقدّمه لفنادق كثيرة | فندق واحد يعمل معك مباشرة |
| كيف يتصل الفندق | ينقر Connect في دليل التطبيقات ثم Allow (OAuth 2.0) | ينشئ المالك مفتاحًا من Settings → Partner API ويرسله إليك |
| بيانات الاعتماد | رمز وصول cbat_... (ساعة واحدة) مع رمز تحديث | مفتاح API cbk_... (لا تنتهي صلاحيته حتى يُلغى) |
| الصلاحيات | النطاقات (scopes) التي سمح بها الفندق فقط | كل شيء في تلك المنشأة |
تستدعي الطريقتان العمليات الـ 25 نفسها على العنوان الأساسي نفسه، مع الـ idempotency نفسها وحدود المعدل نفسها والـ webhooks نفسها. وتعمل كل بيانات اعتماد لصالح منشأة واحدة.
كيف تترابط الأجزاء
- تسجّل للحصول على حساب مطوّر مجاني، فتحصل على Sandbox Hotel ببيانات اختبار ومفتاح API.
- تبني على الفندق التجريبي بهذا المفتاح.
- تسجّل تطبيقًا في صفحة Developers وتحصل على client ID وsecret.
- تربط التطبيق بفندقك التجريبي عبر OAuth لتجربة المسار كاملًا.
- ترسل التطبيق للمراجعة. وبعد موافقة ChatBeds يصبح مُدرجًا في دليل التطبيقات لدى كل فندق.
- يربط فندقٌ تطبيقك، فيستبدل خادمك الرمز بـ tokens ويستدعي
/partner/v1لتلك المنشأة. - يرسل ChatBeds إلى عنوان الـ webhook الخاص بك حدثًا موقّعًا كلما أُنشئ حجز في تلك المنشأة أو عُدّل أو أُلغي.
البناء مجاني
حسابات المطورين وSandbox Hotel مجانية ولا تُفوتَر أبدًا. يمكنك ربط تطبيقاتك بفندقك التجريبي في أي مرحلة، قبل المراجعة.
الخطوة التالية
هل تبني شيئًا؟