LobbyStack

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

Vì sao các nhóm sử dụng LobbyStack

Hầu hết công cụ lễ tân AI đều đóng, đắt đỏ và khó điều chỉnh cho phù hợp với quy trình làm việc thực tế của doanh nghiệp. LobbyStack thì khác.

• Mã nguồn mở theo mặc định. Kiểm tra mã nguồn, tự lưu trữ, mở rộng và giữ quyền kiểm soát dữ liệu của bạn.
• Được xây dựng cho các cuộc gọi điện thoại thực tế. Xử lý hội thoại bằng giọng nói tự nhiên, lời ngắt ngang, chuyển cuộc gọi trực tiếp và tin nhắn cho nhóm của bạn.
• Cuộc gọi và tin nhắn ở cùng một nơi. Xem lại cuộc gọi, bản ghi âm, bản chép lời và tin nhắn đến từ cùng một bảng điều khiển.
• Tích hợp sẵn tính năng lên lịch. Đặt lịch, đổi lịch và hủy lịch hẹn thông qua Google Calendar.
• Được thiết kế cho doanh nghiệp nhỏ. Thiết lập có hướng dẫn, giá cả minh bạch và không hạn chế tính năng chỉ dành cho doanh nghiệp lớn.
• Có phương án chuyển cho người thật. Chuyển cuộc gọi hoặc chuyển tiếp tin nhắn khi AI không nên tự xử lý.

Tính năng cốt lõi

☎️ Lễ tân điện thoại AI

LobbyStack trả lời các cuộc gọi đến bằng tác nhân giọng nói tự nhiên được huấn luyện dựa trên thông tin doanh nghiệp của bạn. Tác nhân có thể trả lời các câu hỏi thường gặp, thu thập thông tin người gọi, nhận tin nhắn, xác định nhu cầu, đề xuất khung giờ hẹn và chuyển cuộc gọi cho nhân viên khi cần.

💬 Tin nhắn văn bản

LobbyStack lưu các tin nhắn gửi đến số điện thoại doanh nghiệp của bạn và thông báo cho nhóm. Bạn đọc chuỗi tin nhắn và tự trả lời từ bảng điều khiển. AI không trả lời tin nhắn; STOP và HELP sẽ nhận các câu trả lời cố định.

📅 Lên lịch hẹn

LobbyStack kết nối với Google Calendar, Cal.com hoặc Calendly, kiểm tra tình trạng còn chỗ, đề xuất khung giờ, đặt lịch hẹn và gửi tin nhắn xác nhận cùng một tin nhắn nhắc lịch 24 giờ trước đó nếu người gọi đồng ý. Người gọi cũng có thể đổi hoặc hủy lịch trong cuộc gọi sau.

📚 Cơ sở kiến thức

Tải lên thông tin doanh nghiệp, câu hỏi thường gặp, dịch vụ, giá cả, chính sách và ghi chú nội bộ. AI sử dụng kiến thức này để trả lời chính xác và nhất quán.

🧑‍💼 Chuyển tiếp cho nhân viên

LobbyStack có thể chuyển cuộc gọi trực tiếp, nhận tin nhắn hoặc thông báo cho nhóm qua email hay SMS nếu người dùng đã đồng ý, khi cần nhân viên phản hồi.

📥 Hộp thư dùng chung

Xem lại cuộc gọi, chuỗi tin nhắn SMS, bản chép lời, bản ghi âm, lịch hẹn và thông tin khách hàng từ một bảng điều khiển.

🔌 Tích hợp

LobbyStack đặt lịch vào Google Calendar, Cal.com hoặc Calendly. REST API, webhook có chữ ký, Zapier và máy chủ MCP kết nối LobbyStack với các công cụ khác của bạn. Hiện tại, nền tảng chưa đồng bộ với CRM hoặc phần mềm quản lý phòng khám.

Trường hợp sử dụng

LobbyStack có thể được điều chỉnh cho nhiều quy trình làm việc của doanh nghiệp địa phương:

• Phòng khám và văn phòng chăm sóc sức khỏe
• Salon, spa và tiệm cắt tóc
• Cửa hàng sửa chữa ô tô
• Công ty dịch vụ tại nhà
• Nhà hàng
• Phòng khám nha khoa
• Công ty luật và dịch vụ chuyên nghiệp
• Đơn vị quản lý bất động sản
• Mọi doanh nghiệp nhận câu hỏi qua điện thoại về lịch hẹn, giá cả, giờ hoạt động hoặc tình trạng còn chỗ

Các khu vực sản phẩm

Khu vực	Sản phẩm cung cấp
Tiếp nhận cuộc gọi thoại	Trả lời cuộc gọi điện thoại và cuộc gọi qua trình duyệt đến bằng OpenAI GPT-Live, với số điện thoại từ Twilio hoặc Telnyx.
Kiến thức doanh nghiệp	Câu trả lời dựa trên thông tin doanh nghiệp có cấu trúc, mục văn bản, tài liệu và các trang web đã nhập.
Đặt lịch	Lên lịch theo dịch vụ, kiểm tra tình trạng còn chỗ và chuyển tiếp sang lịch.
Thay đổi lịch hẹn	Quy trình hủy và đổi lịch an toàn hơn, có tra cứu và xác minh lịch hẹn.
Chuyển tiếp cho nhân viên	Chuyển cuộc gọi trực tiếp và tạo tác vụ theo dõi cho các cuộc gọi cần nhân viên xử lý.
Tin nhắn	Tin nhắn đến có thể được trả lời thủ công và được liên kết với lịch sử khách hàng.
Tiện ích trên website	Chat có thể nhúng, thu thập khách hàng tiềm năng và gọi qua trình duyệt với quyền truy cập được kiểm soát theo từng trang web. Bị hạn chế: khóa tiện ích mới bị tắt trừ khi bạn đặt WIDGET_KEY_ISSUANCE_ENABLED=true.
Máy chủ MCP	Máy chủ Model Context Protocol tại /api/mcp cho phép Claude, ChatGPT và các trợ lý khác đọc cuộc gọi và đặt lịch hẹn.
Bảng điều khiển	Cuộc gọi, tin nhắn, danh bạ, lịch hẹn, bản ghi âm, bản chép lời, việc cần theo dõi và phân tích được tập hợp tại một nơi.
Mức sử dụng và thanh toán	Gói dịch vụ lưu trữ, mức sử dụng thoại, SMS cảnh báo, lần thử chuyển cuộc gọi, dung lượng lưu trữ và giới hạn chi tiêu.
Sử dụng khóa API của riêng bạn	Các bản triển khai tự lưu trữ có thể dùng thông tin xác thực của riêng bạn cho Twilio hoặc Telnyx, AI tương thích OpenAI, lịch, email, phân tích và nhà cung cấp thanh toán.

Máy chủ MCP

LobbyStack chạy máy chủ Model Context Protocol, vì vậy bạn có thể kết nối Claude, ChatGPT, Claude Code, Cursor, VS Code hoặc bất kỳ ứng dụng khách MCP nào khác với một doanh nghiệp và hỏi bằng ngôn ngữ thông thường: "Ai đã gọi hôm qua nhưng chưa đặt lịch?" hoặc "Đặt lịch vệ sinh cho Dana Whitfield vào sáng thứ Ba."

Cài đặt	Giá trị
URL máy chủ	https://app.lobbystack.com/api/mcp (tự lưu trữ: https://<your-domain>/api/mcp)
Giao thức truyền tải	Streamable HTTP
Xác thực	Đăng nhập bằng LobbyStack (OAuth), hoặc Authorization: Bearer <API key>
Tên trong registry	io.github.lobbystack/lobbystack trong MCP Registry chính thức

Thêm vào Claude Code:

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

Máy chủ cung cấp 18 công cụ cho một doanh nghiệp. Mỗi công cụ cần một phạm vi quyền, và mọi thay đổi đều được ghi vào nhật ký kiểm tra của doanh nghiệp.

Công cụ	Phạm vi quyền
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

Các công cụ chỉ đọc có readOnlyHint, còn các công cụ hủy, di chuyển hoặc thay thế dữ liệu có destructiveHint. Các đối tác White Label được cung cấp thêm công cụ để vận hành bảng điều khiển đối tác.

Phần triển khai nằm trong apps/admin/src/lib/mcp/: server.ts xây dựng McpServer và đăng ký các công cụ từ tools.ts và partner-tools.ts, còn apps/admin/app/api/mcp/route.ts phục vụ máy chủ này. Hướng dẫn máy chủ MCP trình bày về phạm vi quyền, lỗi và giới hạn.

Công nghệ

Lớp	Thành phần chính
Ứng dụng	Next.js, React, Tailwind CSS, shadcn/ui
Backend	PostgreSQL, Drizzle ORM, Redis, BullMQ
Thoại	OpenAI GPT-Live qua SIP và WebRTC, thông qua Twilio Elastic SIP Trunking hoặc kết nối SIP của Telnyx
Tác nhân	Vercel AI SDK, gpt-6-luna hoặc bất kỳ mô hình nào tương thích OpenAI
MCP	@modelcontextprotocol/server qua Streamable HTTP, với OAuth hoặc khóa API

Dịch vụ lưu trữ và mã nguồn mở

LobbyStack là phần mềm mã nguồn mở có dịch vụ đám mây được lưu trữ.

Dùng LobbyStack Cloud nếu bạn muốn chúng tôi quản lý sản phẩm thay bạn. Bạn vẫn kiểm soát hành vi của lễ tân, kiến thức, dịch vụ, quy tắc, số điện thoại, tích hợp và quy trình làm việc của nhóm từ ứng dụng.

Tự lưu trữ nếu nhóm của bạn muốn chạy toàn bộ hệ thống trên cơ sở hạ tầng riêng, dùng khóa API của riêng mình và sử dụng tài khoản PostgreSQL, Twilio hoặc Telnyx, AI tương thích OpenAI, lịch, phân tích, thanh toán và nhà cung cấp email của riêng mình.

Để tự lưu trữ trên Railway, hãy triển khai mẫu LobbyStack. Railway tự tạo mọi bí mật và mật khẩu cơ sở dữ liệu; bạn nhập khóa API OpenAI và thông tin xác thực Twilio.

Sau khi triển khai, hãy đặt một số biến trong Railway:

• Email: SMTP_* và EMAIL_FROM trên worker. Nếu thiếu các biến này, việc đặt lại mật khẩu, gửi mã xác minh và lời mời sẽ không hoạt động.
• Cuộc gọi điện thoại: webhook OpenAI trỏ đến https://your_admin_domain/api/webhooks/openai/live, bí mật của webhook đó dưới dạng OPENAI_WEBHOOK_SECRET trên admin và trunk Twilio Elastic SIP của bạn dưới dạng TWILIO_SIP_TRUNK_SID trên worker. Xem docs/voice/runtime.md. Để dùng Telnyx ở một số quốc gia hoặc tất cả các quốc gia, hãy làm theo hướng dẫn Sử dụng Telnyx.
• Tùy chọn: FIRECRAWL_API_KEY trên worker để nhập website, và GOOGLE_CLIENT_ID cùng GOOGLE_CLIENT_SECRET trên admin cho Google Calendar.
• Tên miền tùy chỉnh: APP_BASE_URL trên admin. Các biến URL khác tham chiếu đến biến này.

Hướng dẫn tự lưu trữ trình bày từng bước.

Toàn quyền kiểm soát sản phẩm trong ứng dụng được lưu trữ. Toàn quyền sở hữu cơ sở hạ tầng khi tự lưu trữ. Dù chọn cách nào, bạn vẫn dùng cùng một lõi mã nguồn mở.

Kiến trúc dành cho người đóng góp

LobbyStack là một monorepo TypeScript, sử dụng PostgreSQL làm nguồn dữ liệu bền vững đáng tin cậy. OpenAI lưu trữ âm thanh cuộc gọi; ứng dụng admin khởi tạo từng cuộc gọi và worker vận hành cuộc gọi đó.

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

Đọc tổng quan về tự lưu trữ để biết sơ đồ nhà cung cấp và yêu cầu triển khai, hoặc xem hướng dẫn Docker Compose để thiết lập cơ sở chính thức trên một máy chủ.

Bắt đầu

Sử dụng ứng dụng được lưu trữ

1. Tạo tài khoản LobbyStack.
2. Xác minh số điện thoại di động của bạn.
3. Nhập kiến thức từ website hoặc bỏ qua và tự thêm kiến thức sau.
4. Chọn gói dịch vụ.
5. Đăng ký số điện thoại doanh nghiệp với gói Starter hoặc Pro.
6. Cấu hình cài đặt AI, dịch vụ, kiến thức và quy tắc trước khi nhận cuộc gọi thực tế.

Hướng dẫn đầy đủ để bắt đầu sử dụng dịch vụ lưu trữ có trong hướng dẫn thiết lập.

Chạy môi trường phát triển cục bộ

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

Môi trường phát triển cục bộ lưu bản ghi âm và tệp tải lên trong .lobbystack/storage. Đặt STORAGE_PROVIDER=s3 khi bạn cần kiểm thử dịch vụ tương thích S3.

Các nhà cung cấp mô phỏng là một phần của quy trình phát triển mặc định, giúp người đóng góp kiểm thử quy trình mà không cần thông tin xác thực thực tế của Twilio, AI, lịch hoặc email. Ghi chú thiết lập nhà cung cấp có trong tài liệu.

Triển khai bằng 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

Hệ thống sử dụng nhật ký stdout và các endpoint kiểm tra tình trạng hoạt động mà không cần chạy container giám sát. Đặt OTEL_EXPORTER_OTLP_ENDPOINT và OTEL_EXPORTER_OTLP_HEADERS để gửi dữ liệu đo từ xa của máy chủ đến PostHog hoặc backend khác tương thích OTLP.

Để biết các yêu cầu tiên quyết, cách kiểm tra nhanh cục bộ so với đưa vào vận hành thực tế, tập lệnh hỗ trợ và cách khắc phục sự cố, hãy xem hướng dẫn tự lưu trữ bằng Docker Compose.

Đóng góp

Chúng tôi hoan nghênh các đóng góp. Hãy bắt đầu với CONTRIBUTING.md, giữ logic nghiệp vụ cần lưu trữ lâu dài trong các lớp domain và cơ sở dữ liệu, đồng thời đặt các công cụ của lễ tân trong lõi tác nhân.

Trước khi mở PR, hãy chạy:

pnpm typecheck
pnpm build
pnpm test

Giấy phép

LobbyStack được cấp phép theo Giấy phép MIT.