في هذه المقالة:


ميزة مميزة

ميزات التكامل متاحة فقط للمستخدمين المشتركين في خطط Premium و Business Pro.

 

ما الذي يفعله التكامل؟


Hostaway هو برنامج لإدارة العقارات المخصصة للإيجارات قصيرة الأجل وعقارات Airbnb. يتيح استخدام تكامل Hostaway مع Keycafe إنشاء رموز تعليمات الوصول إلى المفتاح وإرسالها تلقائيًا إلى ضيوفك عند إنشاء حجز في Hostaway.

 

كيفية إعداد التكامل


1. إنشاء مفتاح Hostaway API

  1. اتبع الخطوات من Hostaway لإنشاء مفتاح API.
  2. دوِّن كلاً من Account ID و API Key.

API secret key generated successfully.png

 

2. ربط حساباتك

  1. في لوحة تحكم Keycafe الخاصة بك، اختر +Add → Integration Hostaway.
  2. أدخل Hostaway Account ID، و Hostaway API key، ثم انقر على Submit

 

إضافة Webhook إلى Hostaway


بمجرد إكمال إعداد التكامل، ستتلقى بريدًا إلكترونيًا يحتوي على عنوان URL للـ webhook.

  1. انسخ عنوان URL.
  2. في لوحة تحكم Hostaway الخاصة بك، اختر Settings → Integrations، ثم مرر لأسفل إلى Unified webhooks.
  3. تحت Add Webhook، الصق عنوان URL وتأكد من أن Is enabled مضبوط على Yes، ثم انقر على +Add.

 

ربط مفتاح Keycafe بقائمة إعلاناتك في Hostaway


إضافة وسم Keycafe إلى قائمة الإعلانات في Hostaway

لكل إعلان في Hostaway ترغب في تضمينه في تكامل Keycafe، يجب إضافة وسم "Keycafe" في تفاصيل الإعلان. لن يتم إنشاء حجوزات تلقائيًا في Keycafe للإعلانات التي لا تحتوي على هذا الوسم.

  1. في لوحة تحكم Hostaway الخاصة بك، اختر Listings → Details  Edit.
  2. في حقل Tags، أدخل الوسم "Keycafe".

image.jpg

 

وسوم مفيدة إضافية

يمكن تعديل وسم "Keycafe" لتضمين بعض الإعدادات الإضافية لتكاملك:

  • -sn (كتم الإشعارات): إذا كنت تفضل إرسال بريد إلكتروني لضيفك يتضمن رمز الوصول إلى المفتاح والتعليمات عبر Hostaway فقط، فيمكنك تعطيل البريد الإلكتروني التلقائي من Keycafe بإضافة "-sn" إلى الوسم. يصبح الوسم الكامل حينئذٍ "Keycafe-sn".
  • -dc (رمز الباب): إذا كنت ترغب في تخزين رمز حجز Keycafe الخاص بالمفتاح تلقائيًا في حقل Door Code الخاص بحجز Hostaway، أضف "-dc" إلى الوسم. يصبح الوسم الكامل حينئذٍ "Keycafe-dc". لاحظ أنه إذا تم إضافة هذا الوسم وقمت بإدخال رمز باب يدويًا عند إنشاء حجز في Hostaway، فسيتم استبداله برمز حجز Keycafe.

إضافة كلا الوسمين

إذا كنت ترغب في كتم الإشعارات وتخزين رمز الحجز تلقائيًا في حقل رمز الباب، يمكنك استخدام الوسم "Keycafe-sn-dc" أو "Keycafe-dc-sn".

 

إضافة رقم تعريف الإعلان إلى المفتاح في Keycafe

يُستخدم Listing ID الخاص بـ Hostaway لتحديد المفتاح المرتبط في Keycafe. إذا كان لديك إعلانات متعددة ومفاتيح متعددة، فيجب القيام بذلك لكل زوج.

  1. في لوحة تحكم Hostaway الخاصة بك، اختر Listings، ثم انسخ Listing ID Number.

Screenshot 2024-12-13 at 3.44.09 PM.png

  1. في لوحة تحكم Keycafe الخاصة بك، اختر Keys، ثم المفتاح الخاص بالإعلان. إذا لم تكن قد أنشأت المفتاح الخاص بالإعلان بعد، فراجع Adding a Key للقيام بذلك.
  2. اختر About Key → Edit، ثم أدخل Listing ID Number من الخطوة 1 في حقل Internal Notes وانقر على Save.

Screenshot 2025-01-27 at 5.19.24 PM.jpg

 

استخدام التكامل


بمجرد إنشاء حجز ضيف في Hostaway، سيتم تلقائيًا إنشاء one-time booking في Keycafe للمفتاح المرتبط بنفس تاريخ ووقت بدء وانتهاء الحجز. ستنعكس أي تغييرات على الحجز في Hostaway في حجز Keycafe، بما في ذلك إلغاء الحجز. يرجى الانتظار 1-2 دقيقة لظهور الحجوزات والتغييرات الجديدة في حجز Keycafe.

ثم يتم إرسال رمز الحجز للوصول إلى المفتاح في SmartBox الخاص بك تلقائيًا إلى الضيف عبر البريد الإلكتروني.

موقع SmartBox

لاحظ أن البريد الإلكتروني لا يحدد موقع SmartBox الخاص بك، لذا ستحتاج إلى إبلاغ ضيفك بموقعه بشكل منفصل.

 

قطع اتصال حسابك في Hostaway


  1. في لوحة تحكم Keycafe الخاصة بك، اختر Integrations Hostaway About Integration Disconnect.
  2. انقر على Disconnect للتأكيد.

 

مساعدة إضافية


هل لديك أسئلة حول التكامل أو اقتراحات لتحسينه؟ راسلنا عبر البريد الإلكتروني على support@keycafe.com.