LobbyStack

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

Pourquoi les équipes utilisent LobbyStack

La plupart des outils de réceptionniste IA sont fermés, coûteux et difficiles à adapter aux processus réels des entreprises. LobbyStack est différent.

• Open source par défaut. Consultez le code, auto-hébergez la plateforme, étendez-la et gardez le contrôle de vos données.
• Conçu pour les vrais appels téléphoniques. Gérez des conversations vocales naturelles, les interruptions, les transferts en direct et les messages destinés à votre équipe.
• Appels et SMS au même endroit. Consultez les appels, les enregistrements, les transcriptions et les SMS entrants depuis le même tableau de bord.
• Planification intégrée. Prenez, reprogrammez et annulez des rendez-vous via Google Calendar.
• Conçu pour les petites entreprises. Configuration guidée, tarifs transparents et aucune fonctionnalité réservée aux grandes entreprises.
• Relais humain. Transférez les appels ou transmettez les messages lorsqu’une personne doit intervenir.

Fonctionnalités principales

☎️ Réceptionniste téléphonique IA

LobbyStack répond aux appels entrants avec un agent vocal naturel entraîné à partir des informations de votre entreprise. Il peut répondre aux questions courantes, recueillir les coordonnées des appelants, prendre des messages, qualifier les demandes, proposer des créneaux de rendez-vous et transférer l’appel à une personne si nécessaire.

💬 SMS

LobbyStack enregistre les SMS envoyés à votre numéro professionnel et en informe votre équipe. Vous consultez la conversation et répondez manuellement depuis le tableau de bord. L’IA ne répond pas aux SMS ; STOP et HELP reçoivent des réponses prédéfinies.

📅 Prise de rendez-vous

LobbyStack se connecte à Google Calendar, Cal.com ou Calendly, vérifie les disponibilités, propose des créneaux, prend des rendez-vous et envoie un SMS de confirmation ainsi qu’un SMS de rappel 24 heures avant, si l’appelant est d’accord. Les appelants peuvent également reprogrammer ou annuler leur rendez-vous lors d’un appel ultérieur.

📚 Base de connaissances

Importez les informations de votre entreprise, les FAQ, les services, les tarifs, les politiques et les notes internes. L’IA s’appuie sur ces connaissances pour répondre avec précision et cohérence.

🧑‍💼 Transfert à une personne

LobbyStack peut transférer un appel en direct, prendre un message ou avertir l’équipe par e-mail ou par SMS avec consentement lorsqu’une personne doit répondre.

📥 Boîte de réception partagée

Consultez les appels, les conversations SMS, les transcriptions, les enregistrements, les rendez-vous et les coordonnées des clients depuis un seul tableau de bord.

🔌 Intégrations

LobbyStack prend des rendez-vous dans Google Calendar, Cal.com ou Calendly. Une API REST, des webhooks signés, Zapier et un serveur MCP permettent de le connecter à vos autres outils. La synchronisation avec les CRM ou les logiciels de gestion de cabinet n’est pas encore disponible.

Cas d’utilisation

LobbyStack peut être adapté aux processus de nombreuses entreprises locales :

• Cliniques et cabinets médicaux
• Salons, spas et barbiers
• Ateliers de réparation automobile
• Entreprises de services à domicile
• Restaurants
• Cabinets dentaires
• Cabinets d’avocats et services professionnels
• Gestionnaires immobiliers
• Toute entreprise qui reçoit par téléphone des questions sur les rendez-vous, les tarifs, les horaires ou les disponibilités

Domaines du produit

Domaine	Ce qu’il vous apporte
Accueil téléphonique	Appels téléphoniques et appels depuis un navigateur entrants pris en charge par OpenAI GPT-Live, avec des numéros de téléphone fournis par Twilio ou Telnyx.
Connaissances de l’entreprise	Réponses fondées sur des informations structurées sur l’entreprise, des entrées textuelles, des documents et des pages web importées.
Prise de rendez-vous	Planification adaptée aux services, avec vérification des disponibilités et transfert vers le calendrier.
Modifications de rendez-vous	Processus plus sûrs d’annulation et de reprogrammation, avec recherche et vérification des rendez-vous.
Transfert à une personne	Transfert en direct et tâches de suivi pour les appels nécessitant l’attention du personnel.
Messages	SMS entrants avec réponses manuelles, associés à l’historique du client.
Widget de site web	Chat intégrable, collecte de prospects et appels depuis un navigateur, avec contrôles d’accès par site. Accès restreint : les nouvelles clés de widget sont désactivées, sauf si vous définissez WIDGET_KEY_ISSUANCE_ENABLED=true.
Serveur MCP	Un serveur Model Context Protocol à l’adresse /api/mcp qui permet à Claude, ChatGPT et à d’autres assistants de consulter les appels et de prendre des rendez-vous.
Tableau de bord	Appels, messages, contacts, rendez-vous, enregistrements, transcriptions, suivis et analyses réunis au même endroit.
Utilisation et facturation	Forfaits hébergés, utilisation vocale, SMS d’alerte, tentatives de transfert, stockage et plafonds de dépenses.
Utiliser vos propres clés API	Les déploiements auto-hébergés peuvent utiliser vos propres identifiants Twilio ou Telnyx, d’IA compatible avec OpenAI, de calendrier, d’e-mail, d’analyse et de fournisseur de facturation.

Serveur MCP

LobbyStack exécute un serveur Model Context Protocol, ce qui vous permet de connecter Claude, ChatGPT, Claude Code, Cursor, VS Code ou tout autre client MCP à une entreprise et de poser des questions en langage courant : « Qui a appelé hier sans prendre rendez-vous ? » ou « Prends rendez-vous pour Dana Whitfield mardi matin pour un nettoyage. »

Paramètre	Valeur
URL du serveur	https://app.lobbystack.com/api/mcp (auto-hébergé : https://<your-domain>/api/mcp)
Transport	HTTP avec flux continu
Authentification	Connectez-vous à LobbyStack (OAuth), ou Authorization: Bearer <API key>
Nom dans le registre	io.github.lobbystack/lobbystack dans le registre MCP officiel

Ajoutez-le à Claude Code :

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

Le serveur expose 18 outils pour une entreprise. Chaque outil nécessite une portée, et chaque modification est inscrite dans le journal d’audit de l’entreprise.

Outils	Portée
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

Les outils en lecture seule portent readOnlyHint, et ceux qui annulent, déplacent ou remplacent des données portent destructiveHint. Les partenaires White Label disposent d’outils supplémentaires pour gérer leur console partenaire.

L’implémentation se trouve dans apps/admin/src/lib/mcp/ : server.ts construit le McpServer et enregistre les outils de tools.ts et partner-tools.ts, et apps/admin/app/api/mcp/route.ts le sert. Le guide du serveur MCP présente les portées, les erreurs et les limites.

Technologies

Couche	Principaux composants
Application	Next.js, React, Tailwind CSS, shadcn/ui
Backend	PostgreSQL, Drizzle ORM, Redis, BullMQ
Voix	OpenAI GPT-Live via SIP et WebRTC, par l’intermédiaire de Twilio Elastic SIP Trunking ou de connexions SIP Telnyx
Agent	Vercel AI SDK, gpt-6-luna ou tout modèle compatible avec OpenAI
MCP	@modelcontextprotocol/server via HTTP avec flux continu, avec OAuth ou des clés API

Hébergé et open source

LobbyStack est un logiciel open source doté d’un service cloud hébergé.

Choisissez LobbyStack Cloud si vous souhaitez que le produit soit géré pour vous. Vous gardez le contrôle du comportement du réceptionniste, des connaissances, des services, des règles, des numéros, des intégrations et du flux de travail de l’équipe depuis l’application.

Auto-hébergez la plateforme si votre équipe souhaite exécuter la pile sur sa propre infrastructure, utiliser ses propres clés API et ses propres comptes PostgreSQL, Twilio ou Telnyx, d’IA compatible avec OpenAI, de calendrier, d’analyse, de facturation et de fournisseur de messagerie.

Pour l’auto-hébergement sur Railway, déployez le modèle LobbyStack. Railway génère tous les secrets et mots de passe de base de données ; vous devez fournir une clé API OpenAI et vos identifiants Twilio.

Après le déploiement, définissez quelques variables dans Railway :

• E-mail : SMTP_* et EMAIL_FROM sur le worker. Sans elles, les réinitialisations de mot de passe, les codes de vérification et les invitations échouent.
• Appels téléphoniques : un webhook OpenAI vers https://your_admin_domain/api/webhooks/openai/live, son secret sous OPENAI_WEBHOOK_SECRET sur l’admin, et votre trunk SIP Twilio Elastic sous TWILIO_SIP_TRUNK_SID sur le worker. Consultez docs/voice/runtime.md. Pour utiliser Telnyx dans certains pays ou dans tous les pays, suivez le guide Utiliser Telnyx.
• Facultatif : FIRECRAWL_API_KEY sur le worker pour l’importation de sites web, et GOOGLE_CLIENT_ID et GOOGLE_CLIENT_SECRET sur l’admin pour Google Calendar.
• Domaine personnalisé : APP_BASE_URL sur l’admin. Les autres variables d’URL y font référence.

Le guide d’auto-hébergement détaille chaque étape.

Contrôle complet du produit dans l’application hébergée. Maîtrise de l’infrastructure en auto-hébergement. Le même cœur open source dans les deux cas.

Architecture pour les contributeurs

LobbyStack est un monorepo TypeScript dont PostgreSQL constitue la source de vérité durable. OpenAI héberge l’audio des appels ; l’application admin démarre chaque appel et le worker l’exécute.

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

Consultez la présentation de l’auto-hébergement pour connaître les fournisseurs et les attentes en matière de déploiement, ou suivez le guide Docker Compose pour la configuration de référence officielle sur un seul hôte.

Pour commencer

Utiliser l’application hébergée

1. Créez un compte LobbyStack.
2. Vérifiez votre numéro de mobile.
3. Importez les connaissances de votre site web, ou ignorez cette étape et ajoutez-les manuellement plus tard.
4. Choisissez un forfait.
5. Obtenez un numéro professionnel avec Starter ou Pro.
6. Configurez les paramètres de l’IA, les services, les connaissances et les règles avant de recevoir des appels en direct.

Le guide complet de prise en main de la version hébergée se trouve dans le guide de configuration.

Exécuter l’environnement de développement local

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

En développement local, les enregistrements et les fichiers importés sont stockés dans .lobbystack/storage. Définissez STORAGE_PROVIDER=s3 si vous devez tester un service compatible avec S3.

Les fournisseurs simulés font partie du parcours de développement par défaut, ce qui permet aux contributeurs de tester les flux sans identifiants actifs pour Twilio, l’IA, le calendrier ou la messagerie. Les notes de configuration des fournisseurs se trouvent dans la documentation.

Déployer avec 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

La pile utilise les journaux stdout et des points de terminaison de contrôle d’état sans exécuter de conteneurs de surveillance. Définissez OTEL_EXPORTER_OTLP_ENDPOINT et OTEL_EXPORTER_OTLP_HEADERS pour envoyer la télémétrie du serveur à PostHog ou à un autre backend compatible avec OTLP.

Pour connaître les prérequis, les vérifications locales et la mise en production, les scripts d’aide et le dépannage, consultez le guide d’auto-hébergement avec Docker Compose.

Contribuer

Les contributions sont les bienvenues. Commencez par CONTRIBUTING.md, conservez la logique métier durable dans les couches domaine et base de données, et placez les outils du réceptionniste dans le cœur de l’agent.

Avant d’ouvrir une PR, exécutez :

pnpm typecheck
pnpm build
pnpm test

Licence

LobbyStack est distribué sous la licence MIT.