Bot de citas con n8n (Telegram)

Asistente conversacional que permite agendar, consultar, reprogramar y cancelar citas desde Telegram, conectado en tiempo real a Google Calendar y Google Sheets. Lo construí en n8n sobre mi propio servidor como demostración para un negocio ficticio (Clínica Dental Sonrisa · DEMO), y se adapta a cualquier negocio que trabaje con citas cambiando un solo nodo de configuración.

Puedes probarlo ahora mismo en Telegram: @ClinicaSonrisaDemounBot. El código y la guía de instalación están en GitHub.

Qué hace

• Agenda en cinco toques: servicio, día, hora, nombre y confirmación.
• Solo ofrece horarios realmente libres: consulta la agenda en Google Calendar y respeta el horario de atención, la duración de cada servicio y una anticipación mínima.
• Registra cada cita como evento en Google Calendar y como fila en Google Sheets, y avisa al negocio por Telegram.
• «Mis citas»: cada persona ve solo sus propias citas, con el nombre de cada una, y puede reprogramarlas (el mismo evento se mueve a otro horario libre) o cancelarlas con una confirmación previa; el horario queda libre al instante.
• Límite por cuenta: máximo tres citas futuras, configurable, para evitar abusos.
• Paso a una persona del equipo: si el cliente lo pide, el negocio recibe un aviso inmediato.

Cómo está construido

• n8n self-hosted con Docker, detrás de Nginx con HTTPS, en Oracle Cloud.
• Un motor de citas independiente del canal: Telegram es la primera entrada, y WhatsApp se conecta agregando solo su entrada y su salida, sin tocar la lógica.
• Webhook autenticado con una cabecera secreta, y respuestas enviadas en la misma petición, así el token del bot no queda guardado en el flujo.
• Cuenta de servicio de Google con acceso solo al calendario y a la hoja de la demo.
• Manejo de errores: si una integración falla, el cliente recibe un mensaje claro y el bot sigue funcionando.
• Simulación local de la conversación completa para probar la lógica sin depender de n8n ni de Google.

Próximo paso

Conectar el mismo motor a WhatsApp mediante la API oficial de Meta, el canal que más usan los negocios en Latinoamérica.