Passer au contenu principal
LobbyStack peut tourner sur un seul hôte Docker ou sous forme de services gérés distincts. L’auto-hébergement vous donne le contrôle des données de l’application, des identifiants, de l’utilisation des fournisseurs, des sauvegardes et des mises à niveau.
Les appels en direct exigent quand même Twilio, OpenAI et un point de terminaison HTTPS public pour le tableau de bord. Les appels téléphoniques nécessitent aussi un trunk Twilio Elastic SIP qui envoie les appels à votre projet OpenAI.

Hébergez-la vous-même. Votre assistant déploie LobbyStack sur vos serveurs, jusqu'à un appel test.

Déployer sur Railway

Le modèle Railway de LobbyStack déploie les services admin, worker et de migration avec PostgreSQL, Redis et un bucket de stockage. Railway génère tous les secrets et les mots de passe des bases de données. Vous saisissez une clé API OpenAI et vos identifiants Twilio, puis vous créez votre compte sur le domaine de l’admin et suivez les étapes ci-dessous. Déployer sur Railway

Après le déploiement

Les appels de test dans le navigateur fonctionnent dès la fin du déploiement. Les courriels, les appels téléphoniques, l’import de sites Web et Google Calendar demandent plus de configuration, et les étapes pour le téléphone et le calendrier utilisent le domaine de l’admin que Railway attribue. Définissez chaque variable sur le service indiqué, puis déployez les modifications en attente dans Railway.

Configurez les courriels

La réinitialisation des mots de passe, les codes de vérification, les invitations d’équipe et les alertes aux opérateurs échouent tant que le worker ne peut pas envoyer de courriels. Sur le service worker, définissez :
  • SMTP_HOST, SMTP_USERNAME et SMTP_PASSWORD fournis par votre fournisseur de courriel
  • SMTP_PORT, qui vaut 587 par défaut, et SMTP_SECURE, qui vaut false par défaut. Utilisez 465 et true si votre fournisseur exige TLS dès la connexion.
  • EMAIL_FROM, une adresse depuis laquelle votre fournisseur vous laisse envoyer, par exemple LobbyStack <no-reply@example.com>
  • EMAIL_REPLY_TO, si les réponses doivent aller à une autre adresse

Terminez la configuration des appels téléphoniques

Les appels dans le navigateur fonctionnent sans ces étapes. Les appels téléphoniques exigent un projet OpenAI avec SIP activé et un trunk Twilio Elastic SIP :
  1. Dans le tableau de bord OpenAI, ajoutez un webhook pour live.transport.incoming qui pointe vers https://votre_domaine_admin/api/webhooks/openai/live.
  2. Définissez le secret de signature du webhook comme OPENAI_WEBHOOK_SECRET sur le service admin.
  3. Dans Twilio, créez un trunk Elastic SIP avec l’URI d’origination sip:votre_id_de_projet_openai@sip.api.openai.com;transport=tls.
  4. Définissez le SID du trunk comme TWILIO_SIP_TRUNK_SID sur le service worker. Sans lui, le worker ne peut pas provisionner de numéro de téléphone.
Le guide du runtime vocal (en anglais) explique les réglages de transfert du trunk et le déplacement des numéros existants.

Importez des sites Web (facultatif)

Définissez FIRECRAWL_API_KEY sur le service worker. Sans elle, l’import de sites Web échoue.

Connectez Google Calendar (facultatif)

Dans Google Cloud, activez l’API Google Calendar et créez un client OAuth pour une application Web. Ajoutez https://votre_domaine_admin/api/calendar/google/callback comme URI de redirection autorisée. Définissez GOOGLE_CLIENT_ID et GOOGLE_CLIENT_SECRET sur le service admin. Le modèle remplit GOOGLE_REDIRECT_URI, et le worker lit les trois valeurs depuis l’admin. Une fois ces deux valeurs définies, les pages de connexion et d’inscription proposent aussi Continuer avec Google. Ajoutez https://votre_domaine_admin/api/auth/callback/google au même client OAuth comme deuxième URI de redirection autorisée. Les domaines de vos partenaires ne le proposent pas : on s’y connecte par courriel et mot de passe. Les entreprises de vos partenaires connectent leur agenda sur le domaine du partenaire avec la même URI de redirection /api/calendar/google/callback. Google renvoie la personne vers votre domaine admin, qui la redirige vers le domaine du partenaire pour terminer.

Connecter Cal.com (facultatif)

Dans Cal.com, ouvrez Settings, puis Developer, puis OAuth clients, et créez un client confidentiel. Ajoutez https://votre_domaine_admin/api/calendar/calcom/callback comme URI de redirection et sélectionnez toutes les portées que LobbyStack demande : PROFILE_READ, EVENT_TYPE_READ, SCHEDULE_READ, BOOKING_READ, BOOKING_WRITE, APPS_READ, WEBHOOK_READ et WEBHOOK_WRITE. Cal.com examine un nouveau client avant que d’autres comptes puissent l’autoriser, et l’examine de nouveau quand vous ajoutez une portée. Définissez CALCOM_CLIENT_ID et CALCOM_CLIENT_SECRET sur le service admin. Le modèle remplit CALCOM_REDIRECT_URI, et le worker lit les variables Cal.com depuis l’admin. LobbyStack réserve avec une adresse de participant de remplacement, booking+appointment_id@ suivie de CALCOM_PLACEHOLDER_EMAIL_DOMAIN. Définissez aussi cette variable sur le service admin : Cal.com reste désactivé tant qu’elle manque, car Cal.com vérifie que le domaine a un enregistrement MX. Pointez le domaine vers un serveur de courriel qui jette les messages. Cal.com envoie ses webhooks de réservation à APP_BASE_URL, donc le worker doit y avoir l’adresse publique de l’admin.

Connecter Calendly (facultatif)

Dans Calendly, ouvrez Developer tools depuis le menu du profil, sélectionnez Create OAuth app et choisissez l’environnement Production. Ajoutez https://votre_domaine_admin/api/calendar/calendly/callback comme URI de redirection et sélectionnez toutes les portées que LobbyStack demande : users:read, organizations:read, event_types:read, availability:read, scheduled_events:read, scheduled_events:write, webhooks:read et webhooks:write. Calendly n’affiche qu’une fois l’identifiant client, le secret client et la clé de signature de webhook : copiez les trois. Définissez CALENDLY_CLIENT_ID, CALENDLY_CLIENT_SECRET et CALENDLY_WEBHOOK_SIGNING_KEY sur le service admin. Le modèle remplit CALENDLY_REDIRECT_URI, et le worker lit les variables Calendly depuis l’admin. LobbyStack réserve avec une adresse d’invité de remplacement, booking+appointment_id@ suivie de CALENDLY_PLACEHOLDER_EMAIL_DOMAIN. Définissez aussi cette variable sur le service admin : Calendly reste désactivé tant qu’elle manque. Calendly envoie ses notifications d’invité à cette adresse, alors pointez le domaine vers un serveur de courriel qui jette les messages. Calendly envoie ses webhooks de réservation à APP_BASE_URL, et le worker a donc besoin de l’adresse publique de l’admin à cet endroit.

Utilisez un domaine personnalisé

Ajoutez le domaine au service admin, puis donnez à APP_BASE_URL sur le service admin la valeur https://votre_domaine. Ces variables y font référence et suivent le changement :
  • SITE_URL, AUTH_TRUSTED_ORIGINS, TWILIO_SMS_WEBHOOK_URL, TWILIO_STATUS_CALLBACK_URL et GOOGLE_REDIRECT_URI sur le service admin
  • APP_BASE_URL, TWILIO_STATUS_CALLBACK_URL et GOOGLE_REDIRECT_URI sur le service worker
Un déploiement issu d’une ancienne version du modèle contient le domaine Railway écrit dans chacune de ces variables, alors modifiez-les toutes. Faites ensuite pointer le webhook OpenAI et les deux URI de redirection Google vers le nouveau domaine. Les numéros de téléphone provisionnés avant le changement gardent leurs anciennes URL de SMS et de rappel de statut dans Twilio jusqu’à ce que vous les y mettiez à jour. Le tableau de bord ne répond que sur le nom d’hôte de APP_BASE_URL, les origines exactes de AUTH_TRUSTED_ORIGINS et les domaines de vos partenaires. Après le changement, le domaine Railway reçoit donc une erreur 404. Pour le garder, ajoutez son origine à AUTH_TRUSTED_ORIGINS. Un motif comme https://*.example.com ne rend aucun nom d’hôte accessible : ajoutez chaque nom d’hôte comme une origine distincte. Les vérifications d’état et les webhooks des fournisseurs répondent sur n’importe quel nom d’hôte.

Base officielle

Le fichier docker-compose.yml du dépôt exécute :
  • PostgreSQL avec pgvector pour les données durables, l’état d’authentification et les embeddings des connaissances
  • Redis pour les files d’attente, les limites de débit et la coordination en temps réel
  • un volume Docker persistant pour les enregistrements et les documents téléversés
  • le tableau de bord d’administration Next.js et l’API HTTP
  • le worker d’arrière-plan et le répartiteur de l’outbox transactionnelle, qui exécute aussi chaque appel GPT-Live
  • Caddy, qui achemine le nom d’hôte du tableau de bord en HTTP simple, derrière le proxy ou l’équilibreur de charge qui termine le HTTPS, ou en HTTPS avec les certificats que Caddy émet pour votre tableau de bord et les domaines de vos partenaires
LobbyStack n’ajoute pas de conteneurs de surveillance à la pile Compose. Les environnements d’exécution serveur peuvent envoyer des traces, des métriques et des journaux OpenTelemetry vers un backend compatible OTLP configuré.

Flux de données

  1. Le tableau de bord et l’API lisent et écrivent dans PostgreSQL par des connexions propres à chaque rôle et avec la sécurité au niveau des lignes.
  2. Les effets de bord durables entrent dans l’outbox PostgreSQL dans la même transaction que les changements d’état de l’entreprise.
  3. Le worker répartit les tâches en file d’attente et actualise les instantanés du contexte de l’entreprise.
  4. OpenAI héberge l’audio des appels. L’admin démarre chaque appel avec l’instantané de l’entreprise, et le worker répond aux demandes de GPT-Live pour les réservations, les messages et les transferts.
  5. L’admin et le worker partagent le fournisseur de stockage configuré. Les déploiements Compose sur un seul hôte utilisent par défaut un volume local persistant.

Responsabilités

Vous êtes responsable des éléments suivants :
  • la durabilité de PostgreSQL, de Redis et du stockage de fichiers
  • les sauvegardes, les exercices de restauration, les mises à niveau et la surveillance
  • le DNS public et le TLS du tableau de bord
  • les identifiants Twilio, OpenAI, de courriel, de calendrier, de facturation et d’analytique
  • la rotation des secrets et les rôles de base de données à privilèges minimaux
Poursuivez avec le guide de déploiement Docker Compose, les variables d’environnement et la référence des fournisseurs.
Le stockage local exige que l’admin et le worker tournent sur le même hôte Docker. Les déploiements dont les conteneurs d’application sont répartis sur plusieurs hôtes doivent définir STORAGE_PROVIDER=s3 et utiliser AWS S3 ou un service compatible.

Obtenir du support

Vous pouvez obtenir l’aide gratuite de la communauté ou acheter un forfait de support auprès de l’équipe LobbyStack :
  • Posez vos questions sur Discord et signalez les bogues dans les issues GitHub. L’aide de la communauté est gratuite.
  • Achetez Support Premium ou Support Enterprise pour obtenir un support par courriel avec des délais de réponse cibles et de l’aide pour installer et mettre à niveau. La page des tarifs de l’auto-hébergement indique les prix et le contenu de chaque forfait.
  • Si votre agence exploite le programme partenaire sur ses propres serveurs, la page sur la marque blanche présente des forfaits de support à prix unique par agence.