LobbyStack

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

Por que as equipes usam o LobbyStack

A maioria das ferramentas de recepcionista de IA é fechada, cara e difícil de adaptar aos fluxos de trabalho reais das empresas. LobbyStack é diferente.

• Código aberto por padrão. Inspecione o código, hospede por conta própria, amplie-o e mantenha o controle dos seus dados.
• Criado para chamadas telefônicas reais. Gerencie conversas naturais por voz, interrupções, transferências ao vivo e mensagens para sua equipe.
• Chamadas e mensagens de texto em um só lugar. Consulte chamadas, gravações, transcrições e mensagens recebidas no mesmo painel.
• Agendamento integrado. Agende, reagende e cancele compromissos pelo Google Calendar.
• Projetado para pequenas empresas. Configuração guiada, preços transparentes e sem restrições de recursos exclusivas para grandes empresas.
• Alternativa humana. Transfira chamadas ou encaminhe mensagens quando a IA não deve lidar com algo sozinha.

Recursos principais

☎️ Recepcionista telefônica com IA

LobbyStack atende chamadas recebidas com um agente de voz natural treinado com as informações da sua empresa. Ele pode responder a perguntas frequentes, coletar dados de quem liga, anotar recados, qualificar solicitações, oferecer horários para agendamento e transferir a chamada para uma pessoa quando necessário.

💬 Mensagens de texto

LobbyStack salva as mensagens de texto enviadas para o número da sua empresa e alerta sua equipe. Você lê a conversa e responde manualmente pelo painel. A IA não responde às mensagens de texto; STOP e HELP recebem respostas fixas.

📅 Agendamento de compromissos

LobbyStack se conecta ao Google Calendar, Cal.com ou Calendly, verifica a disponibilidade, oferece horários, agenda compromissos e envia uma mensagem de confirmação e um lembrete por mensagem de texto 24 horas antes, se a pessoa que liga concordar. Também é possível reagendar ou cancelar durante uma chamada posterior.

📚 Base de conhecimento

Envie informações da empresa, perguntas frequentes, serviços, preços, políticas e notas internas. A IA usa esse conhecimento para responder com precisão e consistência.

🧑‍💼 Transferência para uma pessoa

LobbyStack pode transferir uma chamada ao vivo, anotar um recado ou notificar a equipe por e-mail ou SMS com consentimento quando uma pessoa precisa responder.

📥 Caixa de entrada compartilhada

Consulte chamadas, conversas por SMS, transcrições, gravações, compromissos e dados de clientes em um único painel.

🔌 Integrações

LobbyStack agenda compromissos no Google Calendar, Cal.com ou Calendly. Uma API REST, webhooks assinados, Zapier e um servidor MCP conectam o sistema às suas outras ferramentas. No momento, ele não sincroniza com CRMs nem com softwares de gestão de consultórios.

Casos de uso

LobbyStack pode ser adaptado a muitos fluxos de trabalho de empresas locais:

• Clínicas e consultórios médicos
• Salões de beleza, spas e barbearias
• Oficinas mecânicas
• Empresas de serviços residenciais
• Restaurantes
• Consultórios odontológicos
• Escritórios de advocacia e serviços profissionais
• Administradoras de imóveis
• Qualquer empresa que receba por telefone perguntas sobre agendamentos, preços, horários de funcionamento ou disponibilidade

Áreas do produto

Área	O que oferece
Atendimento por voz	Chamadas telefônicas e pelo navegador recebidas e atendidas pelo OpenAI GPT-Live, com números de telefone da Twilio ou Telnyx.
Conhecimento da empresa	Respostas baseadas em informações estruturadas da empresa, entradas de texto, documentos e páginas da web importadas.
Agendamento	Agendamento por serviço, com verificação de disponibilidade e integração com calendários.
Alterações de compromissos	Fluxos mais seguros para cancelamento e reagendamento, com busca e verificação de compromissos.
Transferência para uma pessoa	Transferência ao vivo e tarefas de acompanhamento para chamadas que precisam da atenção da equipe.
Mensagens	Mensagens de texto recebidas com respostas manuais, vinculadas ao histórico do cliente.
Widget para site	Chat incorporável, captura de leads e chamadas pelo navegador com controles de acesso por site. Restrito: novas chaves de widget ficam desativadas, a menos que você defina WIDGET_KEY_ISSUANCE_ENABLED=true.
Servidor MCP	Um servidor Model Context Protocol em /api/mcp que permite ao Claude, ChatGPT e outros assistentes consultar chamadas e agendar compromissos.
Painel	Chamadas, mensagens, contatos, compromissos, gravações, transcrições, acompanhamentos e análises em um só lugar.
Uso e cobrança	Planos hospedados, uso de voz, SMS de alerta, tentativas de transferência, armazenamento e limites de gastos.
Use suas próprias chaves de API	Implantações auto-hospedadas podem usar suas próprias credenciais da Twilio ou Telnyx, de IA compatível com OpenAI, calendário, e-mail, análise e provedor de cobrança.

Servidor MCP

LobbyStack executa um servidor Model Context Protocol, para que você possa conectar Claude, ChatGPT, Claude Code, Cursor, VS Code ou qualquer outro cliente MCP a uma empresa e fazer perguntas em linguagem simples: "Quem ligou ontem e não agendou?" ou "Agende uma limpeza para Dana Whitfield na terça-feira de manhã."

Configuração	Valor
URL do servidor	https://app.lobbystack.com/api/mcp (auto-hospedado: https://<your-domain>/api/mcp)
Transporte	HTTP com streaming
Autenticação	Entre com o LobbyStack (OAuth) ou Authorization: Bearer <API key>
Nome no registro	io.github.lobbystack/lobbystack no registro oficial do MCP

Adicione ao Claude Code:

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

O servidor disponibiliza 18 ferramentas para uma empresa. Cada ferramenta precisa de um escopo, e toda alteração é registrada no log de auditoria da empresa.

Ferramentas	Escopo
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

As ferramentas somente de leitura incluem readOnlyHint, e as ferramentas que cancelam, movem ou substituem dados incluem destructiveHint. Parceiros White Label recebem ferramentas adicionais para operar o console de parceiros.

A implementação está em apps/admin/src/lib/mcp/: server.ts cria o McpServer e registra as ferramentas de tools.ts e partner-tools.ts, e apps/admin/app/api/mcp/route.ts o disponibiliza. O guia do servidor MCP aborda escopos, erros e limites.

Tecnologia

Camada	Principais componentes
App	Next.js, React, Tailwind CSS, shadcn/ui
Backend	PostgreSQL, Drizzle ORM, Redis, BullMQ
Voz	OpenAI GPT-Live por SIP e WebRTC, via Twilio Elastic SIP Trunking ou conexões SIP da Telnyx
Agente	Vercel AI SDK, gpt-6-luna ou qualquer modelo compatível com OpenAI
MCP	@modelcontextprotocol/server por HTTP com streaming, com OAuth ou chaves de API

Hospedado e de código aberto

LobbyStack é de código aberto e oferece um serviço de nuvem hospedado.

Use o LobbyStack Cloud quando quiser que o produto seja gerenciado para você. Ainda assim, você controla o comportamento da recepcionista, o conhecimento, os serviços, as regras, os números, as integrações e o fluxo de trabalho da equipe pelo app.

Faça a auto-hospedagem quando sua equipe quiser executar a pilha na própria infraestrutura, usar suas próprias chaves de API e utilizar suas próprias contas de PostgreSQL, Twilio ou Telnyx, IA compatível com OpenAI, calendário, análise, cobrança e provedor de e-mail.

Para fazer a auto-hospedagem no Railway, implante o modelo do LobbyStack. O Railway gera todos os segredos e senhas do banco de dados; você informa uma chave de API da OpenAI e suas credenciais da Twilio.

Após a implantação, defina algumas variáveis no Railway:

• E-mail: SMTP_* e EMAIL_FROM no worker. A redefinição de senhas, os códigos de verificação e os convites não funcionarão sem elas.
• Chamadas telefônicas: um webhook da OpenAI para https://your_admin_domain/api/webhooks/openai/live, o segredo correspondente como OPENAI_WEBHOOK_SECRET no admin e seu tronco Twilio Elastic SIP como TWILIO_SIP_TRUNK_SID no worker. Consulte docs/voice/runtime.md. Para usar a Telnyx em alguns países ou em todos eles, siga Usar a Telnyx.
• Opcional: FIRECRAWL_API_KEY no worker para importar sites, e GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET no admin para o Google Calendar.
• Domínio personalizado: APP_BASE_URL no admin. As outras variáveis de URL fazem referência a ele.

O guia de auto-hospedagem apresenta cada etapa.

Controle total do produto no app hospedado. Propriedade da infraestrutura quando você faz a auto-hospedagem. O mesmo núcleo de código aberto em ambos os casos.

Arquitetura para colaboradores

LobbyStack é um monorepo TypeScript com PostgreSQL como fonte durável da verdade. A OpenAI hospeda o áudio das chamadas; o app admin inicia cada chamada e o worker a executa.

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

Leia a visão geral da auto-hospedagem para conhecer o mapa de provedores e as expectativas de implantação, ou consulte o guia do Docker Compose para ver a configuração oficial básica em um único host.

Primeiros passos

Use o app hospedado

1. Crie uma conta no LobbyStack.
2. Verifique seu número de celular.
3. Importe o conhecimento do site ou pule esta etapa e adicione o conhecimento manualmente mais tarde.
4. Escolha um plano.
5. Contrate um número comercial no plano Starter ou Pro.
6. Configure as definições de IA, os serviços, o conhecimento e as regras antes de receber chamadas reais.

O passo a passo completo para a versão hospedada está no guia de configuração.

Execute o ambiente de desenvolvimento local

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

No desenvolvimento local, as gravações e os arquivos enviados são armazenados em .lobbystack/storage. Defina STORAGE_PROVIDER=s3 quando precisar testar um serviço compatível com S3.

Provedores simulados fazem parte do fluxo de desenvolvimento padrão, para que os colaboradores possam testar os fluxos sem credenciais reais da Twilio, de IA, de calendário ou de e-mail. As instruções de configuração dos provedores estão na documentação.

Implante com 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

A pilha usa logs de stdout e endpoints de integridade sem executar contêineres de monitoramento. Defina OTEL_EXPORTER_OTLP_ENDPOINT e OTEL_EXPORTER_OTLP_HEADERS para enviar a telemetria do servidor ao PostHog ou a outro backend compatível com OTLP.

Para ver os pré-requisitos, as verificações locais e a entrada em produção, os scripts auxiliares e a solução de problemas, consulte o guia de auto-hospedagem com Docker Compose.

Contribuição

Contribuições são bem-vindas. Comece por CONTRIBUTING.md, mantenha a lógica de negócios durável nas camadas de domínio e banco de dados e coloque as ferramentas da recepcionista no núcleo do agente.

Antes de abrir um PR, execute:

pnpm typecheck
pnpm build
pnpm test

Licença

LobbyStack está licenciado sob a Licença MIT.