hotelist
📚 Dokümantasyon

Her şey tek yerde.

hotelist'ın tüm özellikleri, adım adım kurulumları ve mimarisi — şemalarla. Asistanınızı oluşturun, eğitin, her kanala bağlayın ve kendi sistemlerinizle entegre edin.

Yeni misiniz? Hızlı başlangıç ile 5 dakikada yayına alın. Geliştirici misiniz? API uçlarına geçin.

Genel bakış

hotelist, markanızın diliyle konuşan, yalnızca sizin verdiğiniz bilgilerden cevap veren çok kanallı bir yapay zeka asistan platformudur. Tek bir asistan; web sitesi, WhatsApp, Instagram, Messenger ve telefon kanallarında aynı anda çalışır. Bilgi tabanı, karakter ve ses tüm kanallarda ortaktır.

Nasıl çalışır — mimari şema

Müşteri hangi kanaldan yazarsa yazsın, istek aynı beyne ulaşır. Beyin; yapay zeka modeli, bilgi tabanı araması (RAG) ve tanımladığınız özel araçlarla yanıtı üretir.

🌐 Web
💬 WhatsApp
📷 Instagram
💙 Messenger
📞 Telefon
→
hotelist beyni
Yapay zekaRAG aramaBilgi tabanıÖzel araçlar
→
Yanıt
📥 Gelen Kutusu
🧑‍💼 Operatör
Tek beyin, tüm kanallar — tutarlı bilgi ve karakter. Görüşmeler Gelen Kutusu'na düşer, gerektiğinde operatör devralır.

Hızlı başlangıç

  1. Bağla & besle — Panelde asistan oluşturun; belge yükleyin veya site adresinizi girin. Asistan saniyeler içinde öğrenir.
  2. Kişiselleştir — Sesini, karakterini, kapsam kurallarını ve bağlanacağı sistemleri seçin. (İsterseniz hazır sektör şablonu uygulayın.)
  3. Ekle & yayınla — Tek satır kodu sitenize yapıştırın veya kanalları bağlayın. Asistanınız 7/24 yayında.
Ücretsiz planla tüm kurulumu test edebilirsiniz; kart bilgisi gerekmez.

Bilgi tabanı & RAG

Bilgi tabanını siz tanımlarsınız; hotelist parçalara böler, anlamsal vektörlere (embedding) çevirir ve her soruda en alakalı parçaları bularak yapay zekaya verir. Böylece asistan binlerce sayfada bile doğru cevabı bulur, bilmediğini uydurmaz.

Belge / SitePDF, DOCX, CSV, TXT, MD
→
Parçalama
→
Embeddingvektör
→
Anlamsal aramasoruya en yakın
→
Yapay zekayanıt üretir
RAG akışı — “Retrieval-Augmented Generation”. Yanıt yalnızca bulunan parçalara dayanır.

Veri kaynakları

Otomatik tazeleme

Asistan ayarlarında tazeleme aralığı tanımlayın; hotelist sitenizi periyodik olarak yeniden tarar, bilgi güncel kalır. Kampanya/fiyat değişikliklerini elle güncellemeniz gerekmez.

Sektör şablonları

Sıfırdan başlamayın. Hazır şablonlar; sektöre özel kurallar, başlangıç bilgisi ve örnek araçlarla gelir. Panelde “Hazır Sektör Şablonu Uygula” deyin.

🛒 E-ticaret🎓 Eğitim🏥 Sağlık✈️ Turizm🏠 Emlak🍽️ Restoran

Karakter & ses

Birden çok asistan oluşturun; her biri ayrı kişilik. Hitap, ton, kapsam ve ses size aittir.

Çok dilli

Otomatik dil algılama. Müşteri hangi dilde yazarsa o dilde yanıt alır; bilgi tabanınız Türkçe olsa bile asistan yabancı müşteriye kendi dilinde anlatır.

Kanallar — genel & yönlendirme

Tek asistan, tüm kanallarda. Her kanal panelde ayrı ayrı bağlanır; gelen her mesaj/çağrı doğru asistana yönlenir.

Tek asistan
bilgi tabanıkarakterses
→
🌐 Web widget
💬 WhatsApp Business
📷 Instagram DM
💙 Messenger
📞 Telefon (SIP)
Aynı beyin beş kanala dağılır; deneyim her yerde tutarlıdır.

Web widget

Tek satır kodla sitenize ekleyin. agent kimliğini panelden alın (Asistanlar → Siteye Ekle).

<!-- hotelist widget -->
<script>
  window.VoiceBotConfig = {
    position: 'bottom-right',
    bubbleText: 'Bana sor 👋',
    appUrl: 'https://hotelist.ai/?embed=true&agent=AGENT_ID'
  };
</script>
<script src="https://hotelist.ai/voice-bot.js" async></script>
Widget mobilde tam ekran açılır, masaüstünde köşe balonu olur. Sesli + yazılı çalışır; mikrofon zorunlu değildir.

WhatsApp

Meta WhatsApp Business numaranıza gelen mesajlar asistana otomatik yanıtlanır. Panelde Kanallar → WhatsApp’tan bağlayın.

  1. Meta Business hesabında WhatsApp Business numarası ve Phone Number ID alın.
  2. Panelde Phone Number ID, kalıcı Access Token, App Secret ve bir Verify Token girin.
  3. Meta Webhook ayarına URL’yi girip “messages” alanına abone olun:
Webhook URL  https://hotelist.ai/webhook/whatsapp
Verify Token  (panelde belirlediğiniz değer)

Adım adım rehber: WhatsApp sıfırdan kurulum (.md)

Instagram & Messenger

Facebook Sayfanıza gelen Messenger mesajları ve Instagram DM’leri tek webhook ile asistana yanıtlanır. Panelde Kanallar → Messenger/Instagram.

  1. Meta uygulamanızda Page ID (Messenger) ve Instagram Business hesap ID’sini alın.
  2. Panelde Page access token, App Secret, Verify Token girin.
  3. Webhook’u bağlayın ve “messages” alanına abone olun:
Webhook URL  https://hotelist.ai/webhook/messenger

Adım adım rehber: Messenger & Instagram kurulum (.md)

Telefon (sesli arama)

Bir telefon numarasına gelen aramada müşteri yapay zeka ile sesli konuşur. Mimari: beyin hotelist’da, ses + telefon ElevenLabs’te. Numara için Türkiye’de Netgsm SIP Trunk önerilir.

📞 Arayan
→
Netgsm 0850SIP Trunk Yönlendirme
→
ElevenLabsses: STT + TTS
→
hotelist beyni
Custom LLM
Ses iki yönlü akar: arayanın sesi metne, hotelist’ın yanıtı tekrar sese çevrilir.
  1. Panelde Kanallar → Telefon’u etkinleştirin; size özel Server URL, Model ve API Key oluşur.
  2. ElevenLabs’te bir agent açıp LLM → Custom LLM’e bu bilgileri girin; dil Türkçe, bir ses seçin, Publish edin.
  3. Netgsm’den 0850 numara + SIP Trunk Yönlendirme alın; ElevenLabs’in verdiği SIP adresine yönlendirin ve numarayı agent’a atayın.

Adım adım rehber: Telefon kurulumu (.md)

E-posta bildirimi

Bir kanaldan ilk kez yazan her yeni müşteri için belirlediğiniz adrese anında e-posta bildirimi gider. Asistan ayarlarından bildirim e-postası girin; fırsatı kaçırmayın.

Gelen kutusu & operatöre devir

WhatsApp, Instagram, Messenger, telefon ve web — tüm kanallardan gelen mesajlar tek Gelen Kutusu’nda toplanır. Gerektiğinde sohbeti operatör canlı devralır; bot durur, insan yanıtlar.

Özel araçlar (webhook)

Asistan, müşteri sorusu üzerine kendi sisteminize HTTP isteği yapabilir: sipariş sorgu, randevu, stok, fiyat. Panelden tanımlayın: ad, açıklama, GET/POST, URL, auth, parametreler. URL ve sırlar sunucuda kalır, tarayıcıya gitmez.

Müşteri sorusu“siparişim nerede?”
→
Asistanaraç gerekli mi?
→
Sizin API’nizwebhook
→
Asistan yanıtısonucu anlatır
Araç çağrı döngüsü — asistan veriyi çeker, doğal dilde özetler.
Hazır sektör şablonları örnek araçlarla gelir; düzenleyip kendi uç noktalarınıza yönlendirin.

API uçları

Public uçlar her origin’den çağrılabilir (CORS açık). Yönetim uçları (/admin/*) Bearer token ister.

GET /config

Asistanın public yapılandırması (isim, tema, RAG durumu, public araç tanımları). Sır dönmez.

GET https://hotelist.ai/config?agent=AGENT_ID

POST /chat

Yazılı mesaj gönderip yanıt alın (RAG + araç çağrı döngüsü).

POST https://hotelist.ai/chat
Content-Type: application/json

{
  "agentId": "AGENT_ID",
  "message": "İade nasıl yapılır?",
  "history": [ {"role":"user","text":"merhaba"} ]
}

Yanıt: { "reply": "14 gün içinde..." }

AlanTipAçıklama
agentIdstringHedef asistan (boşsa ilk asistan)
messagestringKullanıcı mesajı (max 4000)
historyarrayÖnceki mesajlar (opsiyonel)
logboolfalse → görüşme kaydedilmez

GET /search (RAG)

Bilgi tabanında anlamsal arama; en alakalı parçaları döndürür. Bilgi tabanı otele ait olduğundan bu uç, /config yanıtındaki 1 saatlik widgetToken değerini X-Widget-Token başlığında ister (widget bunu kendiliğinden yapar). Süresi dolunca /config'i yeniden çağırın.

GET https://hotelist.ai/search?agent=AGENT_ID&q=kargo+süresi
X-Widget-Token: WIDGET_TOKEN

Yanıt: { "chunks": [ { "text": "...", "score": 0.82 } ] }

Rezervasyon webhook yanıtı: ödeme bağlantısı

Asistan bir rezervasyon kaydettiğinde otelinizin webhook adresine POST edilir. Yanıtınızda odeme_linki (https) ve isteğe bağlı tutar, para_birimi döndürürseniz asistan misafire bu bağlantıyı iletir; panelde ödeme sağlayıcısı ayarlamanız gerekmez. Yanıt vermezseniz ve panelde iyzico / PayTR / Stripe ayarlıysa bağlantı otomatik üretilir. Kart bilgisi hiçbir zaman asistandan geçmez.

{ "ok": true, "odeme_linki": "https://odeme.oteliniz.com/pay/abc123", "tutar": "4500", "para_birimi": "TRY" }

Custom LLM (telefon beyni)

OpenAI uyumlu uç nokta; ElevenLabs gibi sesli platformlar bu adrese bağlanarak hotelist’ı beyin olarak kullanır. Her asistanın kendi anahtarı vardır (panelden alın).

POST https://hotelist.ai/v1/AGENT_ID/chat/completions
Authorization: Bearer AGENT_PHONE_KEY
Content-Type: application/json

{ "model": "hotelist", "messages": [...], "stream": true }
Yanıt OpenAI chat.completions formatındadır (stream destekli). Telefon kanalını panelden etkinleştirmeniz gerekir.

Güvenlik & KVKK

Davet / bayi programı

Kişisel davet linkinizi paylaşın; gelen her ücretli müşteri için komisyon kazanın. Bayi olup kendi müşterilerinize hotelist’ı sunabilirsiniz. Panelde Ana Sayfa → Davet kartından linkinizi alın.

https://hotelist.ai/?ref=KODUNUZ
Daha fazlası veya kurumsal entegrasyon için bizimle iletişime geçin. Asistanınızı hemen kurmak için panele gidin.