Web Sitenize Kurulum ve Misafir Linki

Bu sayfa, Mira'yı misafirlerinizin önüne çıkarmanın üç yolunu anlatır: web sitenize gömülü sohbet balonu, paylaşılabilir Misafir Linki ve odalara asılan QR kodlar. Yazılım bilmeniz gerekmez; web sitenize bir satır kod yapıştırabiliyorsanız (ya da bunu yapacak kişiye bu sayfayı verirseniz) yeterlidir. Kodları ve linkleri Widget sayfasından alırsınız.

Hangi yöntemi seçmeliyim?#

Üçü birlikte kullanılabilir. Hepsi aynı Mira'ya, aynı bilgilere bağlanır.

Adım adım: Web sitenize widget ekleme#

Örnek senaryo: "Mavi Koy Otel" (30 oda) web sitesinin her sayfasında sağ altta sohbet balonu göstermek istiyor.

1. Kodu kopyalayın#

1. Panelde Widget'ı açın.
2. Web Sitesi Widget'ı kutusunda Konum'u seçin (ör. Sağ alt) ve Kaydet'e basın.
3. Kodu Kopyala'ya basın. Panoya şuna benzer bir satır kopyalanır:

<script async src="https://app.airoomier.com/widget.js" data-hotel="mavi-koy-otel"></script>

data-hotel değeri işletmenize özel tanımlayıcıdır (misafir linkindeki /assistant/ sonrasındaki kısım). Kodu panelden kopyalayın, elle yazmayın; adres ve tanımlayıcı birebir doğru olmalıdır.

2. Kodu sitenize yapıştırın#

Kod, sayfanın kapanış </body> etiketinden hemen önce durmalıdır. Widget'ın her sayfada görünmesini istiyorsanız kodu tüm sayfalarda ortak olan bir yere (sitenin altbilgi/footer şablonuna) koyun. Kod yalnızca bir kez eklenmelidir; birden fazla eklerseniz birden fazla balon görünür.

Kendi HTML sitenizde: Dosyanızı açın, </body> satırını bulun ve kodu hemen üstüne yapıştırın.

WordPress: Genel yaklaşım: kodu sitenin tüm sayfalarında yayınlanan bir "altbilgi (footer) betiği" alanına eklemek. Bunun için genellikle bir "header/footer script ekleme" eklentisi kullanılır ya da temanızın footer.php dosyasında </body> etiketinden önceye eklenir. Bir sayfa içeriğindeki "Özel HTML" bloğuna yapıştırırsanız widget yalnızca o sayfada görünür. Görsel editör kodu bozabilir; kod/HTML modunu kullanın.

Wix, Squarespace, Shopify gibi site kurucular: Bu platformların hepsinde sitenin ayarlarında "özel kod / code injection / tema kodu" gibi adlarla, sayfa sonuna (footer / body end) kod eklenebilen bir yer bulunur. Menü adları platforma ve güncellemelere göre değişir; platformun yardım sayfasında "custom code" veya "code injection" arayın. Bazı platformlarda bu özellik ücretli plan gerektirir. Shopify'da kodu genellikle tema dosyası theme.liquid içinde </body> etiketinden önceye eklersiniz.

Başka bir ajans/geliştirici ile çalışıyorsanız: Ona şunu iletin: "Bu <script> satırını sitenin tüm sayfalarında </body> öncesine ekleyin."

3. Yayınlayın ve yenileyin#

Sitenizde değişikliği yayınlayın. Sitenizde önbellek eklentisi veya CDN varsa önbelleği temizleyin, sonra sayfayı zorla yenileyin (Ctrl+F5 veya telefonda gizli sekmede açın).

4. Test edin#

1. Siteyi gizli/özel pencerede açın.
2. Yaklaşık 1,5 saniye sonra seçtiğiniz köşede yuvarlak bir Mira (veya Pro'da kendi asistan fotoğrafınız) balonu ve üstünde karşılama baloncuğu belirmelidir.
3. Balona tıklayın. Panelin ortasında kısa bir an üç küçük nokta (yükleme göstergesi) görünür, ardından sohbet yumuşak bir geçişle belirir. İlk açılışta bir Kullanım Koşulları penceresi çıkar; Kabul Et ile devam edin.
4. "Check-in saati kaçta?", "Evcil hayvan kabul ediyor musunuz?" gibi sorular sorun. Cevaplar İşletme Bilgileri'nde yazdıklarınızla aynı olmalı.
5. Telefonunuzdan da açın: ekran geniş değilse (yaklaşık 520 piksel ve altı) sohbet tam ekran açılır.

5. (İsteğe bağlı) Alan adı güvenliğini açın#

Kodunuz sitenizin kaynağında herkese açıktır; başka biri kopyalayıp kendi sitesine koyarsa sizin asistanınız ve AI görüşme kotanız orada kullanılır. Bunu önlemek için:

1. Widget sitenizde çalıştıktan sonra Widget → Alan Adı Güvenliği kutusunu açın.
2. İzin verilen alan adları kutusuna sitenizin alan adını yazın, ör. mavikoyotel.com (her satıra bir alan adı; https://, yol veya www. yazmanıza gerek yoktur, kök alan adı tüm alt alan adlarını kapsar).
3. Alan adı güvenliğini etkinleştir'i işaretleyip Değişiklikleri Kaydet'e basın.
4. Sitenizi gizli pencerede yeniden açıp balona tıklayın; sohbet normal açılmalıdır.

Bu ayar Basic ve Pro planda kullanılabilir. Yazım kuralları, engellenen sitede ziyaretçinin ne gördüğü ve nelerin etkilenmediği Widget sayfasındaki Alan Adı Güvenliği bölümünde ayrıntılı anlatılıyor.

Widget nasıl davranır?#

• Balon: 76 piksellik yuvarlak bir simge; etrafında hafif "nabız" halkaları vardır. Sağ (orta) ve Sol (orta) konumlarında ekran kenarının dikey ortasında, Sağ alt ve Sol alt konumlarında alt köşede durur.
• Karşılama baloncuğu: Sayfa açıldıktan yaklaşık 1,5 saniye sonra belirir, sayfa yüklemesi başına bir kez gösterilir. ✕ ile kapatılabilir; üzerine tıklamak sohbeti açar. Metnini Pro planda özelleştirebilirsiniz (Widget).
• Sohbet paneli (bilgisayar): Balona tıklayınca balonun yanında büyük bir panel açılır. Panelin üst köşesindeki noktalı tutamaçtan sürükleyerek boyutunu değiştirebilirsiniz; kapatmak için panelin köşesindeki ✕ ya da balona tekrar tıklama kullanılır. Panelin arkasındaki sayfa kaydırılabilir kalır.
• Sohbet paneli (telefon): Ekran genişliği yaklaşık 520 piksel ve altındaysa panel tam ekran açılır, üstte Siteye Dön çubuğu çıkar ve balon gizlenir. Panel açıkken sitenin kendisi arka planda kaymaz.
• Sohbet, sitenizin içinde bir pencere (iframe) olarak çalışır; sitenizin tasarımını bozmaz, kendi stilleriyle gelir. Panel ilk kez açılana kadar sohbet sayfası yüklenmez.
• Yükleme göstergesi: Panel açıldığında sohbet hazır olana kadar panelin ortasında üç küçük bronz nokta görünür; sohbet hazır olunca kısa, yumuşak bir geçişle belirir (beyaz veya siyah bir ekran yanıp sönmez). Sohbet her ne sebeple olursa olsun "hazırım" bildirimini göndermezse, sayfa yüklendikten en geç yaklaşık 1,5 saniye sonra yine de gösterilir. Aynı gösterge, dil değiştikten sonra panel yeniden yüklenirken de görünür.
• Her zaman açık tema: Sohbet ekranı, Airoomier panelini koyu temada kullanıyor olsanız bile her zaman açık renkli tasarımla açılır.
• Kullanım Koşulları penceresi: Misafir sohbeti ilk açtığında, tüm işletmelerde aynı olan ve panelden değiştirilemeyen bir koşullar penceresi görür (içeriği için bkz. Widget → Misafir Linki). Kabul Et seçimi o tarayıcıda hatırlanır; Reddet pencereyi kapatıp sohbete izin verir ama pencere bir sonraki açılışta yeniden çıkar.
• Alan Adı Güvenliği açıksa ve widget listede olmayan bir sitede açılırsa, balon görünür ama panelde sohbet yerine "Bu site için yetkilendirilmemiş" mesajı çıkar.

Kod seçenekleri (data-* parametreleri)#

Örnek (dili İngilizceye sabitlenmiş kod):

<script async src="https://app.airoomier.com/widget.js" data-hotel="mavi-koy-otel" data-lang="en"></script>

Widget hangi dilde açılır?#

Widget şu sırayla dili belirler:

1. Kodda data-lang varsa o dil,
2. yoksa ziyaretçinin tarayıcı dili,
3. bunların hiçbiri desteklenen dört dilden (Türkçe, İngilizce, Almanca, Rusça) biri değilse İngilizce.

Yani web sitesi widget'ı, İşletme Bilgileri'ndeki Varsayılan Dil'i değil, ziyaretçinin/sitenizin dilini kullanır. Siteniz Türkçeyse ama ziyaretçilerin tarayıcısı İngilizceyse, data-lang="tr" yazmazsanız onlar İngilizce görür. Sitenizde dil değiştirme düğmesi varsa aşağıdaki setLanguage yöntemini kullanın. Misafir, sohbetin içindeki TR/EN/DE/RU seçicisinden dili her zaman kendisi de değiştirebilir.

JavaScript ile kontrol: AiroomierWidget#

Widget, sayfaya window.AiroomierWidget adında iki küçük komut ekler. Bunları isteğe bağlı kullanırsınız; widget onlarsız da çalışır.

Örnekler:

<!-- Kendi düğmenizle sohbeti açın -->
<button onclick="window.AiroomierWidget && AiroomierWidget.open()">Mira ile konuş</button>

<script>
  // Sitenizin dil düğmesi değiştiğinde widget dilini de güncelleyin
  function siteDiliDegisti(kod) {
    if (window.AiroomierWidget) AiroomierWidget.setLanguage(kod);
  }
</script>

Bilmeniz gerekenler:

• Kod async yüklendiği için sayfa yeni açıldığında AiroomierWidget bir an için tanımsız olabilir. Yukarıdaki gibi window.AiroomierWidget && ile kontrol edin.
• setLanguage, ekrandaki karşılama baloncuğunun ve panel etiketlerinin dilini hemen günceller. Sohbet paneli kapalıysa bir sonraki açılışta yeni dilde yeniden yüklenir; panel açıkken devam eden görüşmeye dokunulmaz.
• Paneli kapatmak için ayrı bir komut yoktur; ziyaretçi ✕, Siteye Dön ya da balonla kapatır.

Adım adım: Misafir Linkini paylaşma#

Misafir Linki, işletmenize özel, değişmeyen bir adrestir (https://app.airoomier.com/assistant/mavi-koy-otel). Bir bağlantıyı açabilen herkes doğrudan Mira ile konuşabilir; web sitesi gerekmez.

1. Widget → Misafir Linki kutusuna gidin.
2. Bağlantıya sağ tıklayıp (telefonda uzun basıp) bağlantı adresini kopyalayın.
3. Aşağıdaki yerlerden uygun olanlara yapıştırın:

Örnek mesaj: "Merhaba! Sorularınız için 7/24 dijital resepsiyonistimiz Mira'ya buradan yazabilirsiniz: https://app.airoomier.com/assistant/mavi-koy-otel".

Linke dil eklemek#

Linkin sonuna ?lang= ekleyerek sohbetin hangi dilde açılacağını belirleyebilirsiniz (tr, en, de, ru). Yabancı misafirlere yönelik bir Instagram hesabı için örnek: https://app.airoomier.com/assistant/mavi-koy-otel?lang=en. Dil eklenmezse sohbet, işletmenizin Varsayılan Dil'inde açılır; misafir sohbetteki TR/EN/DE/RU seçicisinden değiştirebilir.

Adım adım: Oda QR kodu#

Oda QR kodu, misafirin hangi odadan yazdığını otomatik olarak Mira'ya bildirir. Misafirin oda numarasını söylemesi gerekmez.

1. Konaklama Tipleri'ni açın ve ilgili konaklama tipinin kartında Fiziksel Birimler listesine gidin. Bkz. Konaklama Tipleri.
2. İlgili odanın (ör. 101) kartında Düzenle'ye tıklayın.
3. Açılan bölümün en altında Oda Bağlantısı & QR düğmesine tıklayın.
4. Oda Bağlantısı — 101 kutusu açılır: QR kodu, bağlantı adresi, Linki Kopyala ve QR İndir (PNG) düğmeleri ve Kapat düğmesi vardır. QR, tarayıcınızda üretilir (dış bir servise gönderilmez).
5. QR'ı indirip oda kartına veya kapıya basın (dosya adı oda-101-qr.png gibidir).

Misafir QR'ı okuttuğunda sohbet o odaya bağlanır ve sohbet başlığında Oda 101 gibi bir rozet görünür. Bunun sonuçları:

• Mira, Wi-Fi şifresini bu misafire verir (şifre yalnızca odada kalanlara gösterilir; bkz. İşletme Bilgileri).
• Misafirin Mira üzerinden verdiği talepler (ör. havlu, temizlik; yalnızca Talep Türleri'nde aktif ettiğiniz türler için) otomatik olarak o odaya bağlanır; bkz. Misafir Talepleri. QR/bağlantı olmadan talep yalnızca misafirin bugünü kapsayan, birim atanmış onaylı bir rezervasyonu varsa açılabilir.
• Misafir aynı QR'ı sonra tekrar açarsa o odadaki açık taleplerinin sayısını görür.

Adım adım: Telefona uygulama gibi ekleme#

Misafirler, Misafir Linkini açarak Mira'yı telefonlarının ana ekranına bir uygulama gibi ekleyebilir. Sizin yapacağınız bir ayar yoktur; bu özellik otomatik açıktır.

1. Misafir, Misafir Linkini telefonunda açar (kısayol/QR/SMS ile).
2. Sohbet ekranının sağ üstünde Uygulamayı Yükle düğmesini görür (dar ekranda yalnızca telefon simgesi görünür).
3. Android / Chrome: Düğmeye dokunur, çıkan kurulum penceresini onaylar; kısayol ana ekrana eklenir.
4. iPhone / Safari: Düğmeye dokunur. Çıkan pencerede şu adımlar yazar: (1) alt menüdeki Paylaş simgesine dokunun, (2) Ana Ekrana Ekle'ye dokunun, (3) sağ üstteki Ekle'ye dokunun. İşlem bittikten sonra pencereyi Anladım ile kapatın.

Kurulan kısayol tam ekran açılır ve doğrudan işletmenizin sohbetine gider. Adı asistanın adıdır (varsayılan "Mira"; Pro planda kendi belirlediğiniz ad ve fotoğraf). Uygulama bir önbellek tutmaz: sohbet, müsaitlik ve fiyatlar her zaman canlı ve günceldir; internet olmadan çalışmaz. Kısayol, sohbeti Misafir Linkinde olduğu gibi Varsayılan Dil'inizde açar. Uygulama zaten kuruluysa ya da tarayıcı kurulumu desteklemiyorsa Uygulamayı Yükle düğmesi görünmez.

Sonrasında ne olur?#

• Widget veya link üzerinden gelen her sohbet Görüşmeler sayfasında listelenir; bkz. Görüşmeler. Bu sohbetler aylık AI görüşme kotanıza sayılır (Basic: ayda 100, Pro: ayda 1000; bkz. Hesap ve Planlar). Kota dolarsa misafir "Şu anda çok yoğunuz..." mesajını ve Bizi Arayın / WhatsApp / E-posta Gönderin düğmelerini görür.
• Misafir rezervasyon isterse talep Rezervasyonlar'a düşer; bkz. Rezervasyonlar.
• Panelden yaptığınız ayar değişiklikleri (konum, balon metni, asistan adı/fotoğrafı) sitenize kod değiştirmeden, en geç yaklaşık 1 dakika içinde yansır.

Sorun giderme#

İpuçları ve sık yapılan hatalar#

• Önce Canlı Önizleme: Siteye eklemeden önce Widget sayfasındaki Canlı Önizleme ile asistanı deneyin.
• Kodu elle düzenlemeyin: Konum ve metinleri panelden değiştirin; kodun kendisi hiç değişmez.
• Misafir Linkini kısaltmayın/değiştirmeyin: Linkin sonundaki işletme tanımlayıcısı değişirse sohbet açılmaz.
• Mobilde test edin: Misafirlerinizin çoğu telefonda; tam ekran açılışı ve Siteye Dön çubuğunu bir kez deneyin.
• Cevap vermediği konuları tamamlayın: Mira bir soruda "bilgim yok" derse Bilgi Bankası veya Tesis Olanakları altına bilgiyi ekleyin.