Bot de Telegram para Gestión de Turnos en Hospitales

Este proyecto implementa un bot de Telegram que permite gestionar turnos médicos de forma sencilla e interactiva.

🛠️ Configuración Inicial

1. Crear un nuevo bot en Telegram

• Abre Telegram y conversa con @BotFather.
• Envía el comando /newbot y sigue las instrucciones.
• Al finalizar, recibirás un token de acceso.

2. Configurar variables de entorno

• Copia el archivo .env.example a .env:

cp .env.example .env

• Reemplaza el valor de <YOUR_TELEGRAM_TOKEN> con el token obtenido en el paso anterior.

Tests

Ejecuta las pruebas con:

bundle exec rake

⚠️ Los tests utilizan WebMock. Para testear el cliente correctamente, usa app.run_once, ya que el bot entra en un loop de espera si no se configura así.

▶️ Ejecutar la aplicación localmente

ruby app.rb

🐳 Docker (Modo Producción)

Para correr el bot en un entorno productivo con Docker:

docker-compose -f docker-compose.prod.yml --env-file ./.env up --build

🔗 Llamadas HTTP a otras APIs

El proyecto incluye la gema Faraday para realizar solicitudes HTTP de manera simple y flexible.

📋 Logging

La app utiliza la gema SemanticLogger.

• Puedes configurar el nivel de log en el archivo de configuración.
• Niveles disponibles: trace, debug, info, warn, error, fatal.

📚 Funcionalidades avanzadas

Para utilizar componentes interactivos como teclados personalizados de Telegram, consulta la documentación oficial de la gema utilizada:

👉 telegram-bot-ruby