LobbyStack

npx add-mcp 'https://app.lobbystack.com/api/mcp'

Ekipler neden LobbyStack kullanıyor?

Çoğu yapay zekâ resepsiyon aracı kapalı kaynaklı, pahalı ve gerçek iş akışlarına uyarlanması zordur. LobbyStack ise farklıdır.

• Varsayılan olarak açık kaynaklı. Kodu inceleyin, kendi kendinize barındırın, genişletin ve verileriniz üzerindeki kontrolü elinizde tutun.
• Gerçek telefon aramaları için tasarlandı. Doğal sesli konuşmaları, araya girmeleri, canlı aktarımları ve ekibiniz için mesajları yönetin.
• Aramalar ve mesajlar tek yerde. Aramaları, kayıtları, dökümleri ve gelen mesajları aynı kontrol panelinden inceleyin.
• Yerleşik randevu planlama. Google Calendar üzerinden randevu oluşturun, yeniden planlayın ve iptal edin.
• Küçük işletmeler için tasarlandı. Rehberli kurulum, şeffaf fiyatlandırma ve yalnızca kurumsal müşterilere sunulan özelliklerle ilgili kısıtlamalar yok.
• İnsan desteğine geçiş. Yapay zekânın tek başına ele almaması gereken durumlarda aramaları aktarın veya mesajları ekibe iletin.

Temel özellikler

☎️ Yapay zekâ telefon resepsiyonisti

LobbyStack, işletme bilgilerinizle eğitilmiş doğal sesli bir ajanla gelen aramaları yanıtlar. Sık sorulan soruları yanıtlayabilir, arayanların bilgilerini alabilir, mesaj bırakabilir, talepleri değerlendirebilir, randevu saatleri önerebilir ve gerektiğinde aramayı bir kişiye aktarabilir.

💬 Metin mesajları

LobbyStack, işletme numaranıza gönderilen mesajları kaydeder ve ekibinizi bilgilendirir. Konuşma dizisini okuyup kontrol panelinden elle yanıt verirsiniz. Yapay zekâ mesajları yanıtlamaz; STOP ve HELP için sabit yanıtlar gönderilir.

📅 Randevu planlama

LobbyStack, Google Calendar, Cal.com veya Calendly'ye bağlanır; uygunluğu kontrol eder, saat aralıkları sunar, randevu oluşturur ve arayan kabul ederse bir onay mesajı ile 24 saat önce bir hatırlatma mesajı gönderir. Arayanlar daha sonraki bir aramada randevularını yeniden planlayabilir veya iptal edebilir.

📚 Bilgi bankası

İşletme bilgilerini, SSS'leri, hizmetleri, fiyatlandırmayı, politikaları ve dahili notları yükleyin. Yapay zekâ, doğru ve tutarlı yanıtlar vermek için bu bilgileri kullanır.

🧑‍💼 Bir kişiye aktarma

Bir kişinin yanıt vermesi gerektiğinde LobbyStack canlı aramayı aktarabilir, mesaj alabilir veya ekibi e-posta ya da isteğe bağlı SMS ile bilgilendirebilir.

📥 Paylaşılan gelen kutusu

Aramaları, SMS konuşma dizilerini, dökümleri, kayıtları, randevuları ve müşteri bilgilerini tek bir kontrol panelinden inceleyin.

🔌 Entegrasyonlar

LobbyStack, Google Calendar, Cal.com veya Calendly'de randevu oluşturur. REST API, imzalı web kancaları, Zapier ve bir MCP sunucusu onu diğer araçlarınıza bağlar. Henüz CRM'lerle veya muayenehane yönetim yazılımlarıyla eşitlenmez.

Kullanım alanları

LobbyStack birçok yerel işletme iş akışına uyarlanabilir:

• Klinikler ve sağlık kuruluşları
• Salonlar, spa merkezleri ve berberler
• Oto tamir atölyeleri
• Ev hizmetleri şirketleri
• Restoranlar
• Diş klinikleri
• Hukuk büroları ve profesyonel hizmetler
• Gayrimenkul yöneticileri
• Telefonla randevu, fiyat, çalışma saatleri veya uygunluk soruları alan tüm işletmeler

Ürün alanları

Alan	Sağladıkları
Sesli karşılama	Twilio veya Telnyx telefon numaralarıyla, OpenAI GPT-Live tarafından yanıtlanan gelen telefon ve tarayıcı aramaları.
İşletme bilgileri	Yapılandırılmış işletme bilgileri, metin girdileri, belgeler ve içe aktarılan web sitesi sayfalarından alınan yanıtlar.
Randevu oluşturma	Uygunluk kontrolü ve takvim aktarımı içeren, hizmete göre randevu planlama.
Randevu değişiklikleri	Randevu arama ve doğrulama içeren daha güvenli iptal ve yeniden planlama akışları.
Bir kişiye aktarma	Personelin ilgilenmesi gereken aramalar için canlı aktarım ve takip görevleri.
Mesajlar	Müşteri geçmişine bağlı, elle yanıtlanan gelen mesajlar.
Web sitesi bileşeni	Site başına erişim denetimleriyle gömülebilir sohbet, potansiyel müşteri toplama ve tarayıcı aramaları. Kısıtlı: WIDGET_KEY_ISSUANCE_ENABLED=true ayarlanmadıkça yeni bileşen anahtarları devre dışıdır.
MCP sunucusu	/api/mcp adresindeki Model Context Protocol sunucusu; Claude, ChatGPT ve diğer asistanların aramaları okumasını ve randevu oluşturmasını sağlar.
Kontrol paneli	Aramalar, mesajlar, kişiler, randevular, kayıtlar, dökümler, takipler ve analizler bir arada.
Kullanım ve faturalandırma	Barındırılan planlar, ses kullanımı, uyarı SMS'leri, aktarma girişimleri, depolama ve harcama sınırları.
Kendi API anahtarlarınızı kullanın	Kendi kendine barındırılan dağıtımlar, kendi Twilio veya Telnyx, OpenAI uyumlu yapay zekâ, takvim, e-posta, analiz ve faturalandırma sağlayıcısı kimlik bilgilerini kullanabilir.

MCP sunucusu

LobbyStack bir Model Context Protocol sunucusu çalıştırır. Böylece Claude, ChatGPT, Claude Code, Cursor, VS Code veya başka bir MCP istemcisini bir işletmeye bağlayıp doğal dille şunları sorabilirsiniz: "Dün kim aradı ve randevu almadı?" veya "Dana Whitfield için salı sabahına temizlik randevusu oluştur."

Ayar	Değer
Sunucu URL'si	https://app.lobbystack.com/api/mcp (kendi kendine barındırılan: https://<your-domain>/api/mcp)
Aktarım	Streamable HTTP
Kimlik doğrulama	LobbyStack'te oturum açın (OAuth) veya Authorization: Bearer <API key>
Kayıt adı	Resmî MCP Registry içinde io.github.lobbystack/lobbystack

Claude Code'a ekleyin:

claude mcp add --transport http lobbystack https://app.lobbystack.com/api/mcp

Sunucu, tek bir işletme için 18 araç sunar. Her araç bir kapsam gerektirir ve her değişiklik işletmenin denetim günlüğüne kaydedilir.

Araçlar	Kapsam
get_business, list_services, list_staff	business:read
update_business_hours	business:write
list_calls, get_call	calls:read
search_contacts, get_contact	contacts:read
create_contact, update_contact	contacts:write
list_appointments, get_appointment, check_availability	appointments:read
book_appointment, cancel_appointment, reschedule_appointment	appointments:write
list_messages	messages:read
add_knowledge	knowledge:write

Salt okunur araçlar readOnlyHint taşır; verileri iptal eden, taşıyan veya değiştiren araçlar ise destructiveHint taşır. White Label iş ortakları, iş ortağı konsollarını yönetmek için ek araçlara erişir.

Uygulama apps/admin/src/lib/mcp/ içinde yer alır: server.ts, McpServer oluşturur ve tools.ts ile partner-tools.ts içindeki araçları kaydeder; apps/admin/app/api/mcp/route.ts ise sunar. MCP sunucu kılavuzu kapsamları, hataları ve sınırları açıklar.

Teknoloji

Katman	Temel bileşenler
Uygulama	Next.js, React, Tailwind CSS, shadcn/ui
Arka uç	PostgreSQL, Drizzle ORM, Redis, BullMQ
Ses	Twilio Elastic SIP Trunking veya Telnyx SIP bağlantıları üzerinden SIP ve WebRTC kullanan OpenAI GPT-Live
Ajan	Vercel AI SDK, gpt-6-luna veya OpenAI uyumlu herhangi bir model
MCP	OAuth veya API anahtarlarıyla Streamable HTTP üzerinden @modelcontextprotocol/server

Barındırılan hizmet ve açık kaynak

LobbyStack, barındırılan bir bulut hizmetiyle birlikte açık kaynaklıdır.

Ürünün sizin için yönetilmesini istiyorsanız LobbyStack Cloud'u kullanın. Uygulama üzerinden resepsiyonistin davranışını, bilgi bankasını, hizmetleri, kuralları, numaraları, entegrasyonları ve ekip iş akışını yine siz denetlersiniz.

Ekibiniz yığını kendi altyapısında çalıştırmak, kendi API anahtarlarını kullanmak ve kendi PostgreSQL, Twilio veya Telnyx, OpenAI uyumlu yapay zekâ, takvim, analiz, faturalandırma ve e-posta sağlayıcısı hesaplarını kullanmak istiyorsa kendi kendine barındırmayı tercih edin.

Railway'de kendi kendine barındırmak için LobbyStack şablonunu dağıtın. Railway tüm gizli anahtarları ve veritabanı parolalarını oluşturur; siz de bir OpenAI API anahtarı ve Twilio kimlik bilgilerinizi girersiniz.

Dağıtımdan sonra Railway'de birkaç değişken ayarlayın:

• E-posta: Çalışan üzerinde SMTP_* ve EMAIL_FROM. Bunlar olmadan parola sıfırlama, doğrulama kodları ve davetler çalışmaz.
• Telefon aramaları: https://your_admin_domain/api/webhooks/openai/live adresine bir OpenAI web kancası, yönetici üzerinde gizli anahtarı olarak OPENAI_WEBHOOK_SECRET ve çalışan üzerinde Twilio Elastic SIP trunk'ınız olarak TWILIO_SIP_TRUNK_SID. docs/voice/runtime.md bölümüne bakın. Bazı ülkelerde veya tüm ülkelerde Telnyx kullanmak için Telnyx kullanımı adımlarını izleyin.
• İsteğe bağlı: Web sitesi içe aktarma için çalışan üzerinde FIRECRAWL_API_KEY; Google Calendar için yönetici üzerinde GOOGLE_CLIENT_ID ve GOOGLE_CLIENT_SECRET.
• Özel alan adı: Yönetici üzerinde APP_BASE_URL. Diğer URL değişkenleri bu değişkene başvurur.

Her adım için kendi kendine barındırma kılavuzuna bakın.

Barındırılan uygulamada ürünün tüm denetimi sizde. Kendi kendinize barındırdığınızda altyapının sahibi olursunuz. Her iki durumda da aynı açık kaynaklı temel kullanılır.

Katkıda bulunanlar için mimari

LobbyStack, kalıcı tek doğruluk kaynağı olarak PostgreSQL kullanan bir TypeScript monoreposudur. Arama sesini OpenAI barındırır; yönetici uygulaması her aramayı başlatır ve çalışan uygulama aramayı yürütür.

apps/
  admin/           Next.js dashboard and HTTP API
  worker/          asynchronous jobs, outbox dispatch, and live calls
packages/embed/    Vite bundle for the embeddable website widget loader
packages/          database, domain, agent core, jobs, providers, telemetry, and shared contracts
mintlify/          public documentation source
docs/              architecture notes, ADRs, provider docs, and validation notes

Sağlayıcı haritası ve dağıtım beklentileri için kendi kendine barındırma genel bakışını okuyun veya resmî tek sunucu temel kurulumu için Docker Compose kılavuzunu kullanın.

Başlarken

Barındırılan uygulamayı kullanın

1. Bir LobbyStack hesabı oluşturun.
2. Cep telefonu numaranızı doğrulayın.
3. Web sitesi bilgilerini içe aktarın veya bu adımı atlayıp bilgileri daha sonra elle ekleyin.
4. Bir plan seçin.
5. Starter veya Pro planında bir işletme numarası alın.
6. Canlı aramaları yönlendirmeden önce yapay zekâ ayarlarını, hizmetleri, bilgi bankasını ve kuralları yapılandırın.

Barındırılan hizmetin tüm kurulum adımları kurulum kılavuzunda yer alır.

Yerel geliştirme ortamını çalıştırın

cp .env.example .env
pnpm install
docker compose up -d postgres redis
pnpm db:migrate
pnpm dev

Yerel geliştirme ortamı kayıtları ve yüklemeleri .lobbystack/storage altında saklar. S3 uyumlu bir hizmeti test etmeniz gerektiğinde STORAGE_PROVIDER=s3 ayarlayın.

Sahte sağlayıcılar varsayılan geliştirme akışının bir parçasıdır; böylece katkıda bulunanlar canlı Twilio, yapay zekâ, takvim veya e-posta kimlik bilgileri olmadan akışları deneyebilir. Sağlayıcı kurulum notları belgelerde yer alır.

Docker Compose ile dağıtın

git clone https://github.com/lobbystack/lobbystack.git
cd lobbystack
pnpm install
cp .env.example .env
# Replace every placeholder before exposing the stack.
docker compose --env-file .env up -d --build

Yığın, izleme kapsayıcıları çalıştırmadan stdout günlüklerini ve sağlık uç noktalarını kullanır. Sunucu telemetrisini PostHog'a veya OTLP uyumlu başka bir arka uca göndermek için OTEL_EXPORTER_OTLP_ENDPOINT ve OTEL_EXPORTER_OTLP_HEADERS ayarlayın.

Ön koşullar, yerel duman testleri ile üretime geçiş, yardımcı betikler ve sorun giderme için Docker Compose ile kendi kendine barındırma kılavuzuna bakın.

Katkıda bulunma

Katkılarınızı bekliyoruz. CONTRIBUTING.md dosyasından başlayın, kalıcı iş mantığını etki alanı ve veritabanı katmanlarında tutun ve resepsiyonistin araçlarını ajan çekirdeğine yerleştirin.

Bir PR açmadan önce şunu çalıştırın:

pnpm typecheck
pnpm build
pnpm test

Lisans

LobbyStack, MIT Lisansı kapsamında lisanslanmıştır.