IdoBooking ile Entegrasyon

Web sitesi ziyaretçilerinize anlık müsaitlik bilgisi ve rezervasyon desteği sunmak için ChatLab chatbot'unuzu IdoBooking rezervasyon sisteminize bağlayın.

Örnek konuşma

Bu örnek, müşteri deneyimini göstermektedir. Kullanılabilen eylemler ve sağlanan bilgiler, bu entegrasyona ve yaptığınız yapılandırmaya bağlıdır.

Başlamadan önce

Öncelikle bir chatbot oluşturun veya seçin. Chatbot'un entegrasyonlarını yönetme yetkisine ve harici hesabın bağlantı ayarlarına erişime ihtiyacınız vardır. Connect (Bağlan) kartında bir yükseltme veya iletişim uyarısı görünüyorsa aboneliğinizin bu entegrasyonu kapsayıp kapsamadığını kontrol edin. API kimlik bilgilerini gizli tutun; bunları asla web sitesi ekleme koduna (embed code) yapıştırmayın.

Entegrasyonun Sağladığı Özellikler

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

• Müsait daireleri ve konaklama birimlerini açıklamalar ve fotoğraflarla listeleme
• Belirli tarihler için müsaitlik kontrolü yapma
• Belirli bir tarih aralığı için fiyat bilgisiyle birlikte müsait daireleri bulma
• Mevcut rezervasyonları kimlik (ID), durum veya tarih aralığına göre sorgulama
• Misafir bilgileriyle yeni rezervasyonlar oluşturma

Bu entegrasyonu kurmanın iki yolu vardır - IdoBooking Marketplace üzerinden (önerilen) veya ChatLab yönetim paneli üzerinden manuel olarak.

---

Seçenek A: IdoBooking Marketplace Kurulumu (Önerilen)

ChatLab'i IdoBooking'e bağlamanın en hızlı yolu IdoBooking Marketplace üzerindendir. Bu yöntem API kimlik bilgilerini otomatik olarak işler ve chatbot'unuz için okuma eylemlerini etkinleştirir.

1. Adım: ChatLab'i IdoBooking Marketplace'ten Yükleyin

1. IdoBooking yönetim panelinize giriş yapın
2. Marketplace bölümüne gidin
3. ChatLab'i bulun ve Install (Yükle) butonuna tıklayın

IdoBooking, API kimlik bilgilerinizi otomatik olarak ChatLab'e gönderir - ayrı bir API kullanıcısı oluşturmanıza veya kimlik bilgilerini manuel olarak kopyalamanıza gerek yoktur.

2. Adım: ChatLab Hesabınızı Oluşturun veya Giriş Yapın

ChatLab'i pazaryerinde etkinleştirdikten sonra yönlendirmeli bir kurulum sihirbazına aktarılırsınız. Zaten bir ChatLab hesabınız varsa giriş yapın. Aksi takdirde yeni bir hesap oluşturun.

3. Adım: Bir Abonelik Planı Seçin

İhtiyaçlarınıza uygun bir abonelik planı seçin. IdoBooking rezervasyon entegrasyonu özellikleri (daire arama, müsaitlik kontrolü, rezervasyonlar), IdoBooking entegrasyonu özelliğini gerektirir. Aboneliğiniz bunu içermiyorsa yükseltme veya iletişim yönlendirmesini takip edin.

4. Adım: Bir Chatbot Seçin

IdoBooking'e bağlamak için mevcut bir chatbot seçin veya yeni bir tane oluşturun. Sihirbaz sizin için otomatik olarak yeni bir bot oluşturabilir.

5. Adım: Kurulumu Tamamlayın

Sihirbaz otomatik olarak:

• IdoBooking kimlik bilgilerinizi seçilen chatbot'a bağlar
• Daire arama, müsaitlik kontrolü ve rezervasyon sorgulama özelliklerini etkinleştirir. Rezervasyon oluşturma otomatik olarak etkinleştirilmez.
• Sizi tekrar IdoBooking'e veya ChatLab yönetim paneline yönlendirir

Sihirbazı tamamladıktan sonra chatbot'unuz rezervasyon sorularını yanıtlamaya hazırdır. Ayrı AI eylemlerini Settings > Actions (Ayarlar > Eylemler) bölümünden ince ayarla düzenleyebilirsiniz.

---

Seçenek B: Manuel Kurulum

Entegrasyonu manuel olarak yapılandırmayı tercih ediyorsanız aşağıdaki adımları izleyin.

1. Bölüm: IdoBooking'de API Kullanıcısı Oluşturma

ChatLab'i IdoBooking sisteminize bağlamadan önce IdoBooking panelinizde API erişimine sahip özel bir kullanıcı oluşturmanız gerekir.

1. Adım: Kullanıcı Yönetimine Gidin

1. IdoBooking yönetim panelinize giriş yapın
2. Settings > Users (Ayarlar > Kullanıcılar) bölümüne gidin
3. Add new user (Yeni kullanıcı ekle) seçeneğine tıklayın

2. Adım: Kullanıcı Hesabını Oluşturun

1. Yeni kullanıcı için bir kullanıcı adı (login) girin (örn. "chatlab-api")
2. Kalan gerekli bilgileri doldurun
3. Bu hesap için güvenli bir şifre (password) belirleyin

3. Adım: API Erişimini Yapılandırın

Yeni kullanıcı için aşağıdaki erişim ayarlarını yapılandırın:

1. "Active API access" (Aktif API erişimi) seçeneğini etkinleştirin (Enable) - entegrasyonun çalışması için bu gereklidir
2. "Active panel access" (Aktif panel erişimi) seçeneğini devre dışı bırakın (Disable) - kullanıcının yönetim paneline erişmesine gerek yoktur

4. Adım: Kullanıcı Rolünü ve İzinleri Belirleyin

Kullanıcı rolünü yapılandırmak için iki seçeneğiniz vardır:

Seçenek A: Administrator Rolü (Daha Basit)

• Rol olarak Administrator seçin
• Bu, panel erişimi devre dışı bırakıldığında bile geniş API izinleri verir. Entegrasyonun yalnızca seçili okuma işlemlerine ihtiyacı varsa özel bir rol kullanın.

Seçenek B: Custom User Rolü (Daha Ayrıntılı)

Daha ayrıntılı denetimi tercih ediyorsanız Custom user seçeneğini belirleyin ve aşağıdaki modül izinlerini yapılandırın:

• Reservations - Read-only (Salt okunur - chatbot yalnızca rezervasyon bilgilerini alacaksa) veya Full access (Tam erişim - chatbot rezervasyon oluşturacaksa)
• Customers - Read-only (Salt okunur)
• Offers - Read-only (Salt okunur)

Özel kullanıcılar için konum izinlerini de yapılandırmanız gerekir:

1. Location and accommodation permissions (Konum ve konaklama izinleri) bölümüne kaydırın
2. Bu chatbot'un kapsayacağı tesisleri seçin; yalnızca hedeflediğiniz kapsam buysa tümüne erişim verin.

5. Adım: Gereksiz Bildirimleri Kapatın

API kullanıcısının operasyonel bildirimler almasını önlemek için aşağıdaki seçenekleri devre dışı bırakın:

• Notifications for property staff - Disable (Devre dışı bırak)
• Automatic email notifications - Disable (Devre dışı bırak)

6. Adım: Kaydedin ve Bağlantı Bilgilerini Alın

1. Kullanıcı hesabını oluşturmak için Save (Kaydet) seçeneğine tıklayın
2. ChatLab yapılandırması için gerekeceğinden aşağıdaki bilgileri bir yere not edin:

• Login - Oluşturduğunuz kullanıcı adı (örn. chatlab-api)
• Password - Belirlediğiniz şifre
• Subdomain - IdoBooking alt alan adınız (örn. client3760)

Alt alan adınızı bulma: IdoBooking panel adresinize (URL) bakın. Örneğin adresiniz https://client3760.idosell.com ise alt alan adınız client3760 değeridir.

2. Bölüm: Entegrasyonu ChatLab'de Kurma

1. Adım: Connect Sekmesine Gidin

1. ChatLab yönetim panelinize giriş yapın
2. Yapılandırmak istediğiniz botu seçin
3. Connect (Bağlan) sekmesine gidin
4. Entegrasyonlar listesinde IdoBooking seçeneğini bulup tıklayın

2. Adım: Bağlantı Bilgilerini Girin

IdoBooking'den aldığınız bilgilerle bağlantı formunu doldurun:

• Client Subdomain - IdoBooking alt alan adınızı girin (tam URL olmadan). Örnek: client3760 (https://client3760.idosell.com değil)
• System Login - IdoBooking'de oluşturduğunuz API kullanıcısının adını girin
• System Password - API kullanıcısının şifresini girin
• Default Currency - Fiyat bilgisi için para birimini seçin
• Default Language - Tesis açıklamaları için dili seçin

3. Adım: Bağlanın

1. Gerekli tüm alanları doldurduktan sonra Connect butonu aktif hale gelir
2. Bağlantıyı kurmak için Connect butonuna tıklayın
3. Onay mesajını bekleyin
4. Bağlantı kurulduğunda bir başarı bildirimi görürsünüz

Başarılı bağlantının ardından buton "Connect" yerine "Update Chatbot" (Chatbot'u Güncelle) olarak değişir ve daha sonra entegrasyonu devre dışı bırakmanız gerekirse bir "Disconnect" (Bağlantıyı Kes) butonu görünür.

---

AI Eylemlerini Yapılandırma

IdoBooking entegrasyonunuz bağlandıktan sonra (her iki yöntemle de), chatbot'unuzun hangi AI eylemlerini gerçekleştirebileceğini yapılandırabilirsiniz. Her iki kurulum yönteminden sonra da etkin eylemleri gözden geçirin. Rezervasyon oluşturma otomatik olarak etkinleştirilmez.

Kullanılabilir AI Eylemleri

• Get Apartments - Müsait daireleri ve konaklama birimlerini açıklamalar, yatak düzenleri ve fotoğraflarla listeler
• Find Available Apartments - Belirli bir tarih aralığı için fiyat bilgisiyle birlikte müsait daireleri arar
• Check Apartment Availability - Belirli bir daire ve tarih aralığı için müsaitliği kontrol eder
• Get Reservations - Mevcut rezervasyonları kimlik, durum veya tarih aralığına göre sorgular
• Create Reservation - Misafir detayları ve rezervasyon bilgileriyle yeni rezervasyonlar oluşturur
• AI room search - Tarihleri kontrol etmek yerine bir misafirin ne istediğine dair açıklamasını oda açıklamalarınızla eşleştirir

AI room search ve Get Apartments birbirini tamamlayan değil, alternatif eylemlerdir. AI room search açık olduğunda düz listeleme aracının yerini alır ve Get Apartments chatbot'tan kaldırılır; böylece aynı anda yalnızca bir oda listeleme aracı etkin olur. Tarihe dayalı eylemler bundan etkilenmez.

Eylemleri Etkinleştirme ve Özelleştirme

1. Bağlantı kurulduktan sonra başarı modalındaki Configure AI Actions (AI Eylemlerini Yapılandır) butonuna tıklayın veya Settings > Actions bölümüne gidip IdoBooking kategorisini bulun
2. Etkinleştirmek istediğiniz eylemleri açın
3. Eylem etiketini (eylem çalışırken kullanıcılara gösterilen metin) ve talimatları gerektiği gibi özelleştirin
4. Eylem iletişim kutusunda yeni bir eylem için Enable (Etkinleştir) veya mevcut bir eylem için Update (Güncelle) butonuna tıklayın.

"Find available apartments" Eylemini Yapılandırma

Find available apartments eylemi, bir misafir müsaitlik sorduğunda chatbot'un kaç daire göstereceğini ve hangi dairelerin seçileceğini belirleyen iki ek denetime sahiptir. Bunlara erişmek için eylemi Settings > Actions > IdoBooking - find available apartments üzerinden açın.

Gösterilecek teklif sayısı (Number of offers to show)

3 ile 10 arasında değişen bir kaydırıcıdır (varsayılan 6). Chatbot'un kullanıcıya tek bir yanıtta kaç daire döndüreceğini belirler.

• Daha düşük değerler (3-4), yanıtı kısa ve odaklı tutar; çoğu misafir yalnızca birkaç favori seçenek arasında karar verirken kullanışlıdır.
• Daha yüksek değerler (8-10), misafirlere karşılaştırma yapabilecekleri daha fazla çeşitlilik sunar; daha geniş bir kataloğa sahip tesisler için uygundur.

Teklif seçim stratejisi (Offer selection strategy)

Tarih ve misafir sayısına göre filtrelendikten sonra, müsait sonuçların tam listesinden hangi dairelerin seçileceğini belirleyen bir açılır menüdür. Dört seçenek mevcuttur:

• En ucuz teklifler (Cheapest offers) (varsayılan) - en düşük minimum fiyata sahip daireleri en ucuzdan en pahalıya doğru sıralanmış olarak döndürür. Misafirler fiyata duyarlı olduğunda veya en erişilebilir seçenekleri öne çıkarmak istediğinizde uygundur.
• Fiyata göre eşit dağıtılmış (Evenly distributed by price) - fiyat aralığına eşit olarak dağıtılmış daireleri seçer. Örneğin 9 teklifte yaklaşık 3 en ucuz, 3 orta fiyatlı ve 3 en pahalı teklif sunar. Yalnızca bütçe dostu seçenekler yerine misafirlerin mevcut tüm yelpazeyi görmesini istediğinizde kullanışlıdır.
• En pahalı teklifler (Most expensive offers) - en yüksek fiyatlı daireleri en pahalıdan en ucuza doğru sıralanmış olarak döndürür. Premium tesisler için veya en üst düzey birimlerinizi öne çıkarmak istediğinizde uygundur.
• Rastgele seçim (Random selection) - filtrelenmiş sonuçlardan daireleri rastgele seçer. Konuşmalar arasında hangi dairelerin vurgulandığını çeşitlendirmek ve her zaman aynı birimleri önermekten kaçınmak istediğinizde kullanışlıdır.

Her iki ayar da mevcut özel prompt ve eylem etiketiyle birlikte bot başına kaydedilir.

---

Tamamlanan kurulumu test edin

Overview (Genel Bakış) bölümünü açın ve yeni bir test sohbeti başlatın. Gelecekteki bir tarih aralığı ve belirli bir misafir sayısı için oda isteyin, ardından iletilen rezervasyon bağlantısını açıp tarihleri, para birimini ve fiyatı IdoBooking ile karşılaştırın. Görüntüleme yetkiniz olan bir rezervasyonla rezervasyon sorgulama özelliğini test edin. Yalnızca gerçek bir rezervasyon oluşturmak istediğinizde Create Reservation eylemini etkinleştirip test edin; sohbet testi rezervasyon sisteminize veri yazabilir.

En İyi Uygulamalar

Güvenlik Önerileri (Manuel Kurulum)

• Özel bir API kullanıcısı kullanın - Kişisel yönetici hesabınızı kullanmak yerine ChatLab entegrasyonu için özel olarak ayrı bir kullanıcı oluşturun
• Minimum izinler - Yalnızca kullanım senaryonuz için gerekli olan izinleri verin. Chatbot'un yalnızca bilgi alması gerekiyorsa salt okunur (read-only) erişim kullanın
• Düzenli kimlik bilgisi yenileme - API kullanıcısının şifresini belirli aralıklarla güncelleyin, ardından kimlik bilgilerini ChatLab'de güncelleyin

Chatbot Yanıtlarını Optimize Etme

• Botunuzu tesis bilgileriyle eğitin - Olanaklar, oda özellikleri ve konum detayları dahil olmak üzere konaklama birimlerinizin açıklamalarını bilgi bankasına ekleyin
• Net konuşma akışları belirleyin - Kullanıcıları müsaitlik sormaya yönlendiren karşılama mesajları yapılandırın ve "Müsaitliği kontrol et" veya "Odaları görüntüle" gibi önerilen sorular kullanın

---

Sorun giderme

• Bağlantı başarısız oluyor - IdoBooking içinde kullanıcı için "Active API access" (Aktif API erişimi) seçeneğinin etkinleştirildiğini doğrulayın
• "Access denied" (Erişim engellendi) hataları - Kullanıcının doğru modül izinlerine sahip olduğunu kontrol edin
• Hiçbir veri dönmüyor - Kullanıcının ilgili konumlara ve tesislere erişimi olduğundan emin olun
• Yanlış alt alan adı - IdoBooking URL adresinizi kontrol edin ve yalnızca alt alan adı kısmını alın (örneğin, client3760; kaynak URL: https://client3760.idosell.com)

---

Oda Kataloğu ve Otel Genel Bakışı

Hesabınızda Hotel 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, tarihe dayalı müsaitlik kontrollerinden ayrıdır: müsaitlik eylemleri talep edilen bir konaklamayı kontrol ederken, AI room search oda açıklamalarıyla eşleştirme yapar. Odaların otomatik dizine eklenmesi, katalog otomatik dizine ekleme özelliğine ve atanan oda kapasitesine bağlıdır; aksi takdirde mevcut olduğunda Train rooms (Odaları eğit) seçeneğini kullanın. AI room search özelliğine güvenmeden önce etkin eylemleri gözden geçirin ve eğitimin tamamlanmasını bekleyin.

İlgili makaleler

• Chatbot'u web sitenize ekleme
• Chatbot'unuzu eğitme
• Chatbot'unuza bağlantı gönderme