Yardım Merkezi
Chatbot entegrasyonları

KWHotel ile entegrasyon

Son güncelleme:

Web sitesi ziyaretçilerinize gerçek zamanlı oda müsaitliği, rezervasyon yapma ve rezervasyon sorgulama imkanı sunmak için ChatLab chatbot'unuzu KWHotel tesis yönetim sisteminize bağlayın. Bu entegrasyon; oda ve müsaitlik verileri için GuestSage rezervasyon motorunu, rezervasyon sorgulama için ise KWHotel Integrations API altyapısını kullanır.

Örnek konuşma

Bir konuşmada görün

Seyahat tarihlerinden oda tekliflerine

Desteklenen bir konaklama entegrasyonu ve etkinleştirilmiş müsaitlik işlemi gerektirir. Bir teklif veya talep, rezervasyonu onaylamaz.

ChatLab örneğiÖrnek konuşma

Ziyaretçi: İki yetişkin için bir oda, 14-16 Ağustos.

Örneği oynatın veya aşağıdan okuyun. Gerçek müşteri verisi kullanılmaz.
1 / 6

Konaklama gereksinimlerini toplayın.

Bu örnek ekrandan çıktığında oynatma duraklatılır. Bu bir simülasyondur, canlı sohbet değildir. Oynatma içindeki widget kontrolleri etkileşimli değildir.
Örneğin tamamını okuyun
  1. Konaklama gereksinimlerini toplayın.

    Ziyaretçi: İki yetişkin için bir oda, 14-16 Ağustos.

  2. Aramadan önce eksik tarih ayrıntılarını sorun.

    Asistan: Hangi yılda konaklamak istersiniz?

  3. Misafir yılı belirtir.

    Ziyaretçi: 2027.

  4. Bağlı konaklama sistemini sorgulayın.

    Oda müsaitliği kontrol ediliyor...

  5. Bu konaklama için dönen teklifleri sunun.

    Deniz manzaralı çift kişilik oda, €280 / stay. İki yetişkin, iki gece için örnek teklif.

  6. Entegrasyonunuzun desteklediği rezervasyon adımlarını izleyerek devam edin.

    Asistan: Nihai fiyat ve koşullar için rezervasyon sayfasını inceleyin. Bu tanıtımda herhangi bir rezervasyon yapılmamıştır.

Bu örnek müşteri deneyimini gösterir. Kullanılabilir eylemler ve döndürülen bilgiler bu entegrasyona ve yapılandırmanıza bağlıdır.

Entegrasyonun sağladığı özellikler

KWHotel entegrasyonu etkinleştirildiğinde chatbot'unuz şunları yapabilir:

  • Açıklamalar, kapasite, alan ve fotoğraflarla oda tiplerini listeleme
  • Fiyatlandırma ile birlikte belirli bir tarih aralığı için müsait odaları bulma
  • Belirli bir oda ve tarih aralığı için müsaitlik durumunu kontrol etme
  • Misafir bilgileriyle yeni rezervasyonlar oluşturma
  • Mevcut rezervasyonları sorgulama

Ön koşullar

Entegrasyonu kurmadan önce aşağıdakilere sahip olduğunuzdan emin olun:

  • GuestSage rezervasyon motoru etkinleştirilmiş bir KWHotel hesabı
  • GuestSage rezervasyon motorundaki Otel Kimliğiniz (Hotel ID / UUID)
  • Rezervasyon sorgulama için: KWHotel tarafından tanımlanan sayısal Entegrasyon Otel Kimliğiniz (Integrations Hotel ID) ve Entegrasyon API Anahtarınız (Integrations API Key)
  • KWHotel entegrasyonu özelliğini içeren bir ChatLab aboneliği

Otel kimliğinizi (UUID) bulma

Otel Kimliği, GuestSage rezervasyon motorunda tesisinize atanan bir UUID değeridir.

  1. cloud.kwhotel.com adresine giriş yapın
  2. Modules (Modüller) > Booking Engine (Rezervasyon Motoru) bölümüne gidin
  3. General (Genel) sekmesinde Booking engine link (Rezervasyon motoru bağlantısı) alanını bulun
  4. URL'deki UUID değerini kopyalayın

KWHotel'de Otel Kimliğini Bulma|width=60

Örneğin, https://be.guestsage.com/en/82b0085d-da1b-4443-8fde-d5d569a859e6 bağlantısındaki Otel Kimliği 82b0085d-da1b-4443-8fde-d5d569a859e6 değeridir.


Integrations API kimlik bilgilerinizi bulma

KWHotel Integrations API, GuestSage UUID değerinden farklı bir tanımlayıcı kullanır:

  • Integrations Hotel ID - sayısal bir kimlik (örneğin 292)
  • Integrations API Key - KWHotel içinde oluşturduğunuz gizli anahtar

Sayısal otel kimliği (Hotel ID)

Sayısal Otel Kimliğini KWHotel yönetici panelinin sağ üst köşesinde bulabilirsiniz.

KWHotel yönetici panelindeki sayısal Otel Kimliği|width=31

API anahtarını oluşturma

API anahtarını KWHotel içinden kendiniz oluşturursunuz:

  1. KWHotel'e giriş yapın ve Synchronization (Senkronizasyon) modülünü açın
  2. Reset API key (API anahtarını sıfırla) butonuna tıklayın
  3. Oluşturulan anahtarı kopyalayın ve ChatLab bağlantı formuna yapıştırın

KWHotel'de REST API anahtarını oluşturma|width=19

Oluşturulan REST API anahtarı|width=60

Reset API key butonuna tıklamak (daha önce oluşturulmuşsa) önceki anahtarı kaldırır ve yenisini oluşturur. Önceki anahtarı kullanan diğer sistemler, siz yeni değerle güncelleyene kadar çalışmayı durdurur.


ChatLab'de entegrasyonu kurma

1. Adım: Connect sekmesine gidin

  1. ChatLab yönetici panelinizde oturum açın
  2. Yapılandırmak istediğiniz botu seçin
  3. Connect (Bağlan) sekmesine gidin
  4. Entegrasyonlar listesinde KWHotel öğesini bulun ve tıklayın

2. Adım: Bağlantı bilgilerini girin

Bağlantı formunu doldurun:

  • Hotel ID (UUID) - GuestSage rezervasyon motoru yapılandırmasından alınan KWHotel otel GUID bilginiz
  • Default Currency - sohbet kullanıcılarına döndürülen fiyatlandırma için kullanılan para birimi (varsayılan PLN)
  • Default Language - oda açıklamaları ve teklif metinleri için kullanılan dil (varsayılan Lehçe)
  • Integrations Hotel ID - KWHotel Integrations API için kullanılan sayısal otel kimliği (yukarıdaki UUID değerinden farklıdır)
  • Integrations API Key - KWHotel tarafından verilen gizli API anahtarı
  • Discount bot channel - isteğe bağlıdır. Ayarlandığında, teklifler bu KWHotel indirim kanalı için alınır ve yapay zeka tarafından sıralanır. Varsayılan kanalı kullanmak için boş bırakın.

3. Adım: Bağlanın

  1. Alanlar doldurulduğunda Connect (Bağlan) düğmesi aktif hale gelir
  2. Yapılandırmayı kaydetmek için Connect düğmesine tıklayın. ChatLab, GuestSage bağlantısını ve Integrations API bağlantısını test eder.
  3. İşlem başarılı olduğunda bir onay bildirimi görürsünüz.

Başarılı bir bağlantıdan sonra Connect düğmesi Update Chatbot (Chatbot'u güncelle) olarak değişir ve entegrasyonu daha sonra devre dışı bırakabilmeniz için bir Disconnect (Bağlantıyı kes) düğmesi görünür.

Kaydetme sırasında Integrations API kontrolü başarısız olursa, Get reservation eylemi otomatik olarak devre dışı bırakılır. Doğru kimlik bilgilerini yeniden girin ve eylemi etkinleştirmek için Update Chatbot düğmesine tıklayın.


Ek bağlantı seçenekleri

İstenen tarihlerde uygun yer olmadığında alternatif tarihler öner (Suggest alternative dates when nothing is available for the requested dates) seçeneği varsayılan olarak etkindir: istenen konaklama müsait olmadığında arama yakın tarihleri getirebilir. Döndürülen her teklifteki tarihleri kontrol edin.

Birden fazla tesis için çoklu otel seçeneğini etkinleştirin ve her oteli net bir görünen ad, UUID değeri ve isteğe bağlı tesise özel ayarlarla ekleyin. Rezervasyon sorgulama gerekiyorsa ilgili Integrations API kimlik bilgilerini ekleyin. Bağlan (Connect) veya Chatbot'u güncelle (Update Chatbot) ile kaydedin, ardından her tesisi ayrı ayrı test edin.

Yapay zeka eylemlerini yapılandırma

Bağlantı kurulduğunda oda arama ve müsaitlik durumu eylemleri etkinleşir. Rezervasyon sorgulama için ayrıca çalışan Integrations API kimlik bilgileri gereklidir. Rezervasyon oluşturma otomatik olarak etkinleştirilmez; botu yayına almadan önce hangi eylemlerin etkin olması gerektiğini gözden geçirin.

Kullanılabilir yapay zeka eylemleri

  • KWHotel - get rooms - Oda tiplerini açıklamalar, yatak düzeni, alan, kapasite ve fotoğraflarla listeler
  • KWHotel - find available rooms - Belirli bir tarih aralığı için müsait odaları arar ve fiyat teklifleriyle döndürür
  • KWHotel - check room availability - Belirli bir oda tipi ve tarih aralığı için müsaitlik durumunu kontrol eder
  • KWHotel - create reservation - Misafir detayları ve rezervasyon bilgileriyle yeni bir rezervasyon oluşturur
  • KWHotel - get reservation - Mevcut rezervasyonları sorgular

Eylemleri etkinleştirme ve özelleştirme

  1. Bağlantı kurulduktan sonra başarı penceresinde Configure AI Actions (Yapay zeka eylemlerini yapılandır) seçeneğine tıklayın veya Settings > Actions (Ayarlar > Eylemler) bölümüne gidip KWHotel kategorisini bulun
  2. Etkinleştirmek istediğiniz eylemleri açın
  3. Eylem etiketini (eylem çalışırken kullanıcılara gösterilen metin) ve prompt talimatlarını ihtiyacınıza göre özelleştirin
  4. Eylem penceresini gösterildiği gibi Enable (Etkinleştir) veya Update (Güncelle) seçeneğiyle onaylayın.

Tamamlanan kurulumu test edin

Overview (Genel bakış) ekranını açın ve gelecekteki bir tarih aralığı ile belirli bir konuk sayısı için oda sorgulayın. Tesis bilgisini, tarihleri, para birimini, fiyatı ve rezervasyon bağlantısını GuestSage ile karşılaştırarak kontrol edin. İnceleme yetkiniz bulunan bir rezervasyonu kullanarak rezervasyon arama özelliğini test edin. Create reservation (Rezervasyon oluştur) seçeneğini yalnızca chatbot'un gerçek rezervasyonlar oluşturmasını istiyorsanız etkinleştirin ve yapılacak rezervasyon testlerini tesis ekibinizle koordine edin.

En iyi uygulamalar

Chatbot yanıtlarını optimize etme

  • Botunuzu tesis bilgileriyle eğitin - Olanaklar, konum, yakındaki turistik yerler ve giriş/çıkış kuralları dahil olmak üzere odalarınızın ve otel olanaklarınızın açıklamalarını bilgi tabanına ekleyin
  • Net konuşma akışları belirleyin - Misafirleri müsaitlik durumu hakkında soru sormaya yönlendiren karşılama mesajları yapılandırın ve "Oda müsaitliğini kontrol et" veya "Odaları görüntüle" gibi önerilen sorular kullanın
  • Odaya özel sayfalar ekleyin - Web sitenizde her oda tipi için özel sayfalar oluşturun ve daha zengin yanıtlar sunabilmesi için chatbot'u bu sayfaların URL'leriyle eğitin

Rezervasyon motoru entegrasyonu

  • KWHotel entegrasyonu, envanter ve fiyatlandırma için GuestSage rezervasyon motoru üzerinden çalışır
  • Sohbet dışındaki doğrudan rezervasyon tamamlama işlemleri için ChatLab chatbot'unun yanı sıra web sitenize GuestSage rezervasyon widget'ını yerleştirin; chatbot, misafirler rezervasyon yapmaya hazır olduğunda onları rezervasyon sayfasına yönlendirebilir

Sorun giderme

  • Bağlantı başarısız oluyor - Hotel ID değerinizin GuestSage UUID'si olduğunu (sayısal Integrations ID olmadığını) ve tesisinizin GuestSage rezervasyon motorunda aktif olduğunu doğrulayın
  • Get reservation eylemi kapalı kalıyor - Kaydetme sırasında Integrations API bağlantı testi başarısız olursa eylem otomatik olarak devre dışı bırakılır. Integrations Hotel ID ve Integrations API Key bilgilerini tekrar girip Update Chatbot (Chatbotu Güncelle) butonuna tıklayın.
  • Oda verisi dönmüyor - Oda tiplerinizin KWHotel'de açıklamalarıyla birlikte doğru şekilde yapılandırıldığını ve müsaitliğin GuestSage'de yayınlandığını kontrol edin
  • Yanlış fiyatlandırma veya teklif yok - Fiyatlandırma GuestSage'den gelir. Güncel fiyatları yansıtmak için KWHotel'deki fiyat ve teklif ayarlarını güncelleyin. Bir Discount bot channel (İndirim bot kanalı) ayarladıysanız aktif teklifleri olduğundan emin olun.
  • Entegrasyon yönetici panelinde görünmüyor - KWHotel entegrasyonu, aboneliğinizde ilgili özelliğin bulunmasını gerektirir; yükseltme veya iletişim istemini takip edin

Oda kataloğu ve otele genel bakış

Hesabınızda Hotel (Otel) sekmesi görünüyorsa, oda kataloğunu ve eğitim durumunu incelemek için Hotel > Rooms (Otel > Odalar) yolunu kullanın. AI room search (Yapay zeka ile oda arama), tarihe dayalı müsaitlik kontrollerinden ayrıdır: müsaitlik eylemleri talep edilen konaklamayı kontrol ederken, bu özellik oda açıklamalarını eşleştirir. Otomatik oda indeksleme, katalog otomatik indekslemesine ve atanan oda kapasitesine bağlıdır; aksi takdirde, kullanılabilir olduğunda Train rooms (Odaları eğit) seçeneğini kullanın. Etkinleştirilen eylemleri gözden geçirin ve yapay zeka ile oda aramaya güvenmeden önce eğitimin tamamlanmasını bekleyin.

İlgili makaleler