LobbyStack

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

Alasan tim menggunakan LobbyStack

Sebagian besar alat resepsionis AI bersifat tertutup, mahal, dan sulit disesuaikan dengan alur kerja bisnis yang sebenarnya. LobbyStack berbeda.

• Sumber terbuka sejak awal. Periksa kodenya, hosting sendiri, kembangkan, dan tetap kendalikan data Anda.
• Dibuat untuk panggilan telepon sungguhan. Tangani percakapan suara alami, interupsi, transfer langsung, dan pesan untuk tim Anda.
• Panggilan dan pesan teks di satu tempat. Tinjau panggilan, rekaman, transkrip, dan pesan teks masuk dari dasbor yang sama.
• Penjadwalan sudah tersedia. Buat, jadwalkan ulang, dan batalkan janji temu melalui Google Calendar.
• Dirancang untuk bisnis kecil. Penyiapan terpandu, harga transparan, dan tanpa pembatasan fitur khusus perusahaan besar.
• Pengalihan ke manusia. Alihkan panggilan atau eskalasikan pesan saat AI sebaiknya tidak menanganinya sendiri.

Fitur inti

☎️ Resepsionis telepon AI

LobbyStack menjawab panggilan masuk dengan agen suara alami yang dilatih menggunakan informasi bisnis Anda. Agen ini dapat menjawab pertanyaan umum, mengumpulkan detail penelepon, menerima pesan, mengkualifikasi permintaan, menawarkan slot janji temu, dan mengalihkan panggilan kepada manusia bila diperlukan.

💬 Pesan teks

LobbyStack menyimpan pesan teks yang dikirim ke nomor bisnis Anda dan memberi tahu tim Anda. Anda membaca percakapan dan membalas secara manual dari dasbor. AI tidak membalas pesan teks; STOP dan HELP mendapatkan balasan tetap.

📅 Penjadwalan janji temu

LobbyStack terhubung ke Google Calendar, Cal.com atau Calendly, memeriksa ketersediaan, menawarkan slot waktu, membuat janji temu, serta mengirim pesan teks konfirmasi dan satu pesan pengingat 24 jam sebelumnya jika penelepon menyetujuinya. Penelepon juga dapat menjadwalkan ulang atau membatalkan janji temu saat menelepon kembali.

📚 Basis pengetahuan

Unggah informasi bisnis, FAQ, layanan, harga, kebijakan, dan catatan internal. AI menggunakan pengetahuan ini untuk menjawab secara akurat dan konsisten.

🧑‍💼 Pengalihan ke manusia

LobbyStack dapat mengalihkan panggilan langsung, menerima pesan, atau memberi tahu tim melalui email atau SMS dengan persetujuan saat seseorang perlu merespons.

📥 Kotak masuk bersama

Tinjau panggilan, percakapan SMS, transkrip, rekaman, janji temu, dan detail pelanggan dari satu dasbor.

🔌 Integrasi

LobbyStack membuat janji temu di Google Calendar, Cal.com atau Calendly. REST API, webhook bertanda tangan, Zapier, dan server MCP menghubungkannya dengan alat Anda yang lain. Saat ini, LobbyStack belum menyinkronkan data dengan CRM atau perangkat lunak manajemen praktik.

Kasus penggunaan

LobbyStack dapat disesuaikan untuk berbagai alur kerja bisnis lokal:

• Klinik dan kantor layanan kesehatan
• Salon, spa, dan barbershop
• Bengkel mobil
• Perusahaan jasa rumah tangga
• Restoran
• Praktik dokter gigi
• Firma hukum dan layanan profesional
• Pengelola properti
• Bisnis apa pun yang menerima pertanyaan melalui telepon tentang janji temu, harga, jam operasional, atau ketersediaan

Area produk

Area	Manfaat
Resepsionis suara	Panggilan telepon dan browser masuk dijawab oleh OpenAI GPT-Live, dengan nomor telepon dari Twilio atau Telnyx.
Pengetahuan bisnis	Jawaban berdasarkan fakta bisnis terstruktur, entri teks, dokumen, dan halaman situs web yang diimpor.
Pemesanan	Penjadwalan berdasarkan layanan dengan pemeriksaan ketersediaan dan pengalihan ke kalender.
Perubahan janji temu	Alur pembatalan dan penjadwalan ulang yang lebih aman dengan pencarian dan verifikasi janji temu.
Pengalihan ke manusia	Transfer langsung dan tugas tindak lanjut untuk panggilan yang memerlukan perhatian staf.
Pesan	Pesan teks masuk dengan balasan manual, terhubung ke riwayat pelanggan.
Widget situs web	Chat yang dapat disematkan, pengumpulan prospek, dan panggilan browser dengan kontrol akses per situs. Dibatasi: kunci widget baru dinonaktifkan kecuali Anda menetapkan WIDGET_KEY_ISSUANCE_ENABLED=true.
Server MCP	Server Model Context Protocol di /api/mcp yang memungkinkan Claude, ChatGPT, dan asisten lainnya membaca panggilan dan membuat janji temu.
Dasbor	Panggilan, pesan, kontak, janji temu, rekaman, transkrip, tindak lanjut, dan analitik dalam satu tempat.
Penggunaan dan penagihan	Paket hosting, penggunaan suara, SMS peringatan, upaya transfer, penyimpanan, dan batas pengeluaran.
Gunakan kunci API Anda sendiri	Deployment yang dihosting sendiri dapat menggunakan kredensial penyedia Twilio atau Telnyx, AI yang kompatibel dengan OpenAI, kalender, email, analitik, dan penagihan milik Anda sendiri.

Server MCP

LobbyStack menjalankan server Model Context Protocol, sehingga Anda dapat menghubungkan Claude, ChatGPT, Claude Code, Cursor, VS Code, atau klien MCP lainnya ke sebuah bisnis dan bertanya dengan bahasa sehari-hari: "Siapa yang menelepon kemarin tetapi tidak membuat janji?" atau "Buat janji untuk Dana Whitfield untuk pembersihan pada Selasa pagi."

Pengaturan	Nilai
URL server	https://app.lobbystack.com/api/mcp (hosting mandiri: https://<your-domain>/api/mcp)
Transport	Streamable HTTP
Autentikasi	Masuk dengan LobbyStack (OAuth), atau Authorization: Bearer <API key>
Nama registri	io.github.lobbystack/lobbystack di MCP Registry resmi

Tambahkan ke Claude Code:

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

Server ini menyediakan 18 alat untuk satu bisnis. Setiap alat memerlukan cakupan, dan setiap perubahan tercatat di log audit bisnis.

Alat	Cakupan
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

Alat hanya-baca memiliki readOnlyHint, sedangkan alat yang membatalkan, memindahkan, atau mengganti data memiliki destructiveHint. Mitra White Label mendapatkan alat tambahan untuk menjalankan konsol mitra mereka.

Implementasinya berada di apps/admin/src/lib/mcp/: server.ts membangun McpServer dan mendaftarkan alat dari tools.ts dan partner-tools.ts, lalu apps/admin/app/api/mcp/route.ts menyajikannya. Panduan server MCP membahas cakupan, kesalahan, dan batasan.

Teknologi

Lapisan	Komponen utama
Aplikasi	Next.js, React, Tailwind CSS, shadcn/ui
Backend	PostgreSQL, Drizzle ORM, Redis, BullMQ
Suara	OpenAI GPT-Live melalui SIP dan WebRTC, menggunakan Twilio Elastic SIP Trunking atau koneksi SIP Telnyx
Agen	Vercel AI SDK, gpt-6-luna atau model apa pun yang kompatibel dengan OpenAI
MCP	@modelcontextprotocol/server melalui Streamable HTTP, dengan OAuth atau kunci API

Hosting dan sumber terbuka

LobbyStack adalah perangkat lunak sumber terbuka dengan layanan cloud terhosting.

Gunakan LobbyStack Cloud jika Anda ingin produk dikelola untuk Anda. Anda tetap mengendalikan perilaku resepsionis, pengetahuan, layanan, aturan, nomor, integrasi, dan alur kerja tim melalui aplikasi.

Hosting sendiri jika tim Anda ingin menjalankan stack di infrastruktur sendiri, menggunakan kunci API sendiri, serta memakai akun PostgreSQL, Twilio atau Telnyx, AI yang kompatibel dengan OpenAI, kalender, analitik, penagihan, dan penyedia email milik Anda sendiri.

Untuk hosting mandiri di Railway, deploy template LobbyStack. Railway membuat setiap rahasia dan kata sandi basis data, lalu Anda memasukkan kunci API OpenAI dan kredensial Twilio.

Setelah deployment, tetapkan beberapa variabel di Railway:

• Email: SMTP_* dan EMAIL_FROM pada worker. Pengaturan ulang kata sandi, kode verifikasi, dan undangan tidak akan berfungsi tanpanya.
• Panggilan telepon: webhook OpenAI ke https://your_admin_domain/api/webhooks/openai/live, rahasianya sebagai OPENAI_WEBHOOK_SECRET pada admin, dan trunk Twilio Elastic SIP Anda sebagai TWILIO_SIP_TRUNK_SID pada worker. Lihat docs/voice/runtime.md. Untuk menggunakan Telnyx di beberapa negara atau semuanya, ikuti Gunakan Telnyx.
• Opsional: FIRECRAWL_API_KEY pada worker untuk impor situs web, serta GOOGLE_CLIENT_ID dan GOOGLE_CLIENT_SECRET pada admin untuk Google Calendar.
• Domain khusus: APP_BASE_URL pada admin. Variabel URL lainnya merujuk ke variabel ini.

Panduan hosting mandiri menjelaskan setiap langkah.

Kendali penuh atas produk di aplikasi terhosting. Kepemilikan infrastruktur saat Anda melakukan hosting mandiri. Inti sumber terbuka yang sama untuk keduanya.

Arsitektur untuk kontributor

LobbyStack adalah monorepo TypeScript dengan PostgreSQL sebagai sumber kebenaran yang persisten. OpenAI menghosting audio panggilan; aplikasi admin memulai setiap panggilan dan worker menjalankannya.

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

Baca ikhtisar hosting mandiri untuk mengetahui peta penyedia dan ekspektasi deployment, atau gunakan panduan Docker Compose untuk konfigurasi dasar resmi pada satu host.

Memulai

Gunakan aplikasi terhosting

1. Buat akun LobbyStack.
2. Verifikasi nomor ponsel Anda.
3. Impor pengetahuan dari situs web, atau lewati dan tambahkan pengetahuan secara manual nanti.
4. Pilih paket.
5. Dapatkan nomor bisnis di paket Starter atau Pro.
6. Konfigurasikan pengaturan AI, layanan, pengetahuan, dan aturan sebelum menerima panggilan langsung.

Panduan lengkap penggunaan aplikasi terhosting tersedia di panduan penyiapan.

Jalankan pengembangan lokal

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

Pengembangan lokal menyimpan rekaman dan unggahan di .lobbystack/storage. Tetapkan STORAGE_PROVIDER=s3 saat Anda perlu menguji layanan yang kompatibel dengan S3.

Penyedia tiruan merupakan bagian dari alur pengembangan default, sehingga kontributor dapat menguji alur tanpa kredensial Twilio, AI, kalender, atau email aktif. Catatan penyiapan penyedia tersedia di dokumentasi.

Deploy dengan Docker Compose

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

Stack ini menggunakan log stdout dan endpoint kesehatan tanpa menjalankan kontainer pemantauan. Tetapkan OTEL_EXPORTER_OTLP_ENDPOINT dan OTEL_EXPORTER_OTLP_HEADERS untuk mengirim telemetri server ke PostHog atau backend lain yang kompatibel dengan OTLP.

Untuk prasyarat, pengujian lokal dibandingkan peluncuran produksi, skrip bantuan, dan pemecahan masalah, lihat panduan hosting mandiri Docker Compose.

Berkontribusi

Kontribusi sangat diterima. Mulailah dengan CONTRIBUTING.md, simpan logika bisnis persisten di lapisan domain dan basis data, serta tempatkan alat resepsionis di inti agen.

Sebelum membuka PR, jalankan:

pnpm typecheck
pnpm build
pnpm test

Lisensi

LobbyStack dilisensikan berdasarkan Lisensi MIT.