Las llamadas en vivo siguen necesitando Twilio, OpenAI y un endpoint HTTPS público para el panel. Las llamadas telefónicas también necesitan un trunk Elastic SIP de Twilio que envíe las llamadas a su proyecto de OpenAI.
Ejecútela usted mismo. Su asistente despliega LobbyStack en sus servidores, hasta una llamada de prueba.
Implemente en Railway
La plantilla de LobbyStack para Railway implementa los servicios de administración, worker y migración con PostgreSQL, Redis y un bucket de almacenamiento. Railway genera todos los secretos y las contraseñas de las bases de datos. Usted introduce una clave de API de OpenAI y sus credenciales de Twilio. Luego crea su cuenta en el dominio de administración y sigue los pasos de abajo.Después de implementar
Las llamadas de prueba desde el navegador funcionan en cuanto termina la implementación. El correo electrónico, las llamadas telefónicas, la importación de sitios web y Google Calendar necesitan más configuración, y los pasos del teléfono y del calendario usan el dominio de administración que asigna Railway. Configure cada variable en el servicio indicado y luego implemente los cambios pendientes en Railway.Configure el correo electrónico
El restablecimiento de contraseñas, los códigos de verificación, las invitaciones al equipo y las alertas a los operadores fallan hasta que el worker pueda enviar correo. En el servicioworker, configure:
SMTP_HOST,SMTP_USERNAMEySMTP_PASSWORDde su proveedor de correoSMTP_PORT, que vale587por defecto, ySMTP_SECURE, que valefalsepor defecto. Use465ytruesi su proveedor exige TLS desde el inicio de la conexión.EMAIL_FROM, una dirección desde la que su proveedor le permita enviar, comoLobbyStack <no-reply@example.com>EMAIL_REPLY_TO, si las respuestas deben ir a otra dirección
Termine de configurar las llamadas telefónicas
Las llamadas desde el navegador funcionan sin estos pasos. Las llamadas telefónicas necesitan un proyecto de OpenAI con SIP activado y un trunk Elastic SIP de Twilio:- En el panel de OpenAI, agregue un webhook para
live.transport.incomingque apunte ahttps://su_dominio_de_administracion/api/webhooks/openai/live. - Configure el secreto de firma del webhook como
OPENAI_WEBHOOK_SECRETen el servicioadmin. - En Twilio, cree un trunk Elastic SIP con el URI de origen
sip:su_id_de_proyecto_openai@sip.api.openai.com;transport=tls. - Configure el SID del trunk como
TWILIO_SIP_TRUNK_SIDen el servicioworker. Sin él, el worker no puede aprovisionar números de teléfono.
Importe sitios web (opcional)
ConfigureFIRECRAWL_API_KEY en el servicio worker. Sin ella, la importación de sitios web falla.
Conecte Google Calendar (opcional)
En Google Cloud, active la API de Google Calendar y cree un cliente OAuth para una aplicación web. Agreguehttps://su_dominio_de_administracion/api/calendar/google/callback como URI de redireccionamiento autorizado. Configure GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET en el servicio admin. La plantilla completa GOOGLE_REDIRECT_URI, y el worker lee los tres valores del servicio de administración.
Con ambos valores configurados, las páginas de inicio de sesión y de registro también ofrecen Continuar con Google. Agregue https://su_dominio_de_administracion/api/auth/callback/google al mismo cliente OAuth como segundo URI de redireccionamiento autorizado. Los dominios de sus socios no lo ofrecen: allí las personas inician sesión con correo y contraseña.
Los negocios de sus socios conectan su calendario en el dominio del socio con el mismo URI de redireccionamiento /api/calendar/google/callback. Google devuelve a la persona a su dominio de administración, que la redirige al dominio del socio para terminar.
Conectar Cal.com (opcional)
En Cal.com, abra Settings, luego Developer, luego OAuth clients, y cree un cliente confidencial. Agreguehttps://su_dominio_admin/api/calendar/calcom/callback como URI de redirección y seleccione todos los alcances que pide LobbyStack: PROFILE_READ, EVENT_TYPE_READ, SCHEDULE_READ, BOOKING_READ, BOOKING_WRITE, APPS_READ, WEBHOOK_READ y WEBHOOK_WRITE. Cal.com revisa un cliente nuevo antes de que otras cuentas puedan autorizarlo, y lo revisa otra vez cuando agrega un alcance. Defina CALCOM_CLIENT_ID y CALCOM_CLIENT_SECRET en el servicio admin. La plantilla completa CALCOM_REDIRECT_URI, y el worker lee las variables de Cal.com desde el admin.
LobbyStack reserva con una dirección de asistente sustituta, booking+appointment_id@ seguida de CALCOM_PLACEHOLDER_EMAIL_DOMAIN. Defina también esa variable en el servicio admin: Cal.com queda desactivado hasta que esté definida, porque Cal.com comprueba que el dominio tenga un registro MX. Apunte el dominio a un servidor de correo que descarte los mensajes. Cal.com envía sus webhooks de reservas a APP_BASE_URL, por lo que el worker necesita ahí la dirección pública del admin.
Conectar Calendly (opcional)
En Calendly, abra Developer tools desde el menú del perfil, seleccione Create OAuth app y elija el entorno Production. Agreguehttps://su_dominio_admin/api/calendar/calendly/callback como URI de redirección y seleccione todos los alcances que pide LobbyStack: users:read, organizations:read, event_types:read, availability:read, scheduled_events:read, scheduled_events:write, webhooks:read y webhooks:write. Calendly muestra una sola vez el ID de cliente, el secreto de cliente y la clave de firma de webhooks, así que copie los tres. Defina CALENDLY_CLIENT_ID, CALENDLY_CLIENT_SECRET y CALENDLY_WEBHOOK_SIGNING_KEY en el servicio admin. La plantilla completa CALENDLY_REDIRECT_URI, y el worker lee las variables de Calendly desde el admin.
LobbyStack reserva con una dirección de invitado sustituta, booking+appointment_id@ seguida de CALENDLY_PLACEHOLDER_EMAIL_DOMAIN. Defina también esa variable en el servicio admin: Calendly queda desactivado hasta que esté definida. Calendly envía sus notificaciones de invitado a esa dirección, así que apunte el dominio a un servidor de correo que descarte los mensajes. Calendly envía sus webhooks de reservas a APP_BASE_URL, por lo que el worker necesita allí la dirección pública del admin.
Use un dominio personalizado
Agregue el dominio al servicioadmin y luego configure APP_BASE_URL en el servicio admin con el valor https://su_dominio. Estas variables hacen referencia a ella y siguen el cambio:
SITE_URL,AUTH_TRUSTED_ORIGINS,TWILIO_SMS_WEBHOOK_URL,TWILIO_STATUS_CALLBACK_URLyGOOGLE_REDIRECT_URIen el servicioadminAPP_BASE_URL,TWILIO_STATUS_CALLBACK_URLyGOOGLE_REDIRECT_URIen el servicioworker
APP_BASE_URL, los orígenes exactos de AUTH_TRUSTED_ORIGINS y los dominios de sus socios. Después del cambio, el dominio de Railway recibe un error 404. Para conservarlo, agregue su origen a AUTH_TRUSTED_ORIGINS. Un patrón como https://*.example.com no hace accesible ningún nombre de host, así que agregue cada nombre de host como un origen propio. Las comprobaciones de estado y los webhooks de los proveedores responden en cualquier nombre de host.
Base oficial
El archivodocker-compose.yml del repositorio ejecuta:
- PostgreSQL con pgvector para los datos persistentes, el estado de autenticación y los embeddings de conocimiento
- Redis para las colas, los límites de frecuencia y la coordinación en tiempo real
- un volumen persistente de Docker para las grabaciones y los documentos subidos
- el panel de administración de Next.js y la API HTTP
- el worker en segundo plano y el despachador de la bandeja de salida transaccional, que también ejecuta cada llamada de GPT-Live
- Caddy para dirigir el nombre de host del panel, por HTTP simple detrás del proxy o balanceador de carga que termina HTTPS, o por HTTPS con los certificados que Caddy emite para su panel y los dominios de sus socios
Flujo de datos
- El panel y la API leen y escriben en PostgreSQL mediante conexiones específicas de cada rol y seguridad a nivel de fila.
- Los efectos secundarios persistentes entran en la bandeja de salida de PostgreSQL en la misma transacción que los cambios de estado del negocio.
- El worker despacha los trabajos en cola y actualiza las instantáneas del contexto del negocio.
- OpenAI aloja el audio de las llamadas. El servicio de administración inicia cada llamada con la instantánea del negocio, y el worker responde a las solicitudes de GPT-Live sobre reservas, mensajes y transferencias.
- El servicio de administración y el worker comparten el proveedor de almacenamiento configurado. Las implementaciones de Compose en un solo host usan por defecto un volumen local persistente.
Responsabilidades
Usted es responsable de:- la durabilidad de PostgreSQL, Redis y el almacenamiento de archivos
- las copias de seguridad, los simulacros de restauración, las actualizaciones y el monitoreo
- el DNS público y el TLS del panel
- las credenciales de Twilio, OpenAI, correo electrónico, calendario, facturación y analíticas
- la rotación de secretos y los roles de base de datos con privilegios mínimos
Obtenga soporte
Puede recibir ayuda gratuita de la comunidad o contratar un plan de soporte con el equipo de LobbyStack:- Haga preguntas en Discord y reporte errores en las incidencias de GitHub. La ayuda de la comunidad es gratuita.
- Contrate Soporte Premium o Soporte Enterprise para recibir soporte por correo electrónico con tiempos de respuesta objetivo y ayuda para instalar y actualizar. La página de precios del autoalojamiento indica los precios y lo que incluye cada plan.
- Si su agencia ejecuta el programa de socios en sus propios servidores, la página de marca blanca muestra planes de soporte con un precio único por agencia.