mendotran-whatsapp-bot

Mendotran-whatsapp-bot es un bot para WhatsApp que permite a los usuarios consultar los horarios de colectivos de la provincia de Mendoza de manera rápida y sencilla. Valiéndose del servicio Mendotran, el bot responde a comandos específicos para proporcionar información sobre los horarios de paradas y líneas de colectivos específicas, así como también sobre el metrotranvía.

Fuente de la fotografía: "MendoTran: comenzaron a instalar la señalética en algunas paradas" - Diario El Sol Mendoza

Guia

• Lista de comandos
• Demostración
• Instalación
• ¿Cómo funciona?
• Parada cercana a tu ubicación
• Pros y contras

Núcleo del bot: udmilla-whatsapp-bot. Librería: whatsapp-web.js

Lista de comandos

Alias	Sintaxis	Función	Ejemplo
❓ Ayuda Help ?	Ayuda [Comando]	Recibir información acerca del uso de un comando.	Ayuda Micro
🚍 Micro M	Micro [Línea] [Nº de parada]	Obtener los horarios de UN colectivo en determinada parada.	Micro 120 M14408
🚏 Parada P	Parada [Nº de parada]	Obtener TODOS los horarios de una parada de colectivos.	Parada M5707
📍 Paradas	> [Citar ubicación] Paradas	Lista las paradas cercanas a una ubicación.	Paradas
🚊 Estación Metro Metrotranvía	Estacion [Nombre de la estación]	Obtener los horarios de una estación de metrotranvía.	Estacion Godoy

Note

Existe la alternativa de localizar una parada por cercanía a una ubicación. Tan solo basta con enviar primero la ubicación, citarla (es decir darle a "responder" al mensaje) y utilizar alguno de estos comandos: parada, micro ó paradas. Vea el ejemplo.

Demostración

Horario de un micro específico en una parada

Todos los horarios de una parada

Note

Puede omitir la "M" y dejar solo el número de parada.

En el caso que la parada no posea cartel, o el mismo esté vandalizado, el bot puede localizarla usando su ubicación.

Horarios del metrotranvía en cierta estación

Note

Este comando admite 4 formas de ser invocado, más información en la lista de comandos.

Instalación

1. Instalar dependencias

Instale los siguientes paquetes utilizando un gestor de paquetes en Linux o bien manualmente en Windows.

npm chromium git

Warning

En Windows es probable que tenga que cambiar la línea "/usr/bin/chromium" en /src/modules/whatsapp/client.ts por la ruta de chromium en su sistema.

2. Clonar el repositorio

git clone https://github.com/Lautauro/mendotran-whatsapp-bot.git
cd mendotran-whatsapp-bot

3. Instalar paquetes NPM

npm i

4. Compilar el proyecto e iniciar el servidor

npm run dev

Note

Puede también usar npm build para compilar el proyecto y luego ejecutarlo con npm start.

La primera vez que inicie el servidor tendrá que escanear un QR para sincronizar la cuenta de WhatsApp que utilizará el bot. Es recomendable usar un teléfono celular específico para este uso, ya que que el bot utiliza la librería whatsapp-web.js para funcionar y esta NO es soportada oficialmente por Meta. Esto quiere decir que, a pesar de que en mi experiencia no ha sucedido, la cuenta puede ser baneada si Meta considera que incumple alguna de sus normas.

¿Cómo funciona?

Fuentes: smartphone.svg whatsapp-icon.svg server.svg

El bot utiliza una base datos local para funcionar más rápidamente ubicada en "./json/mendotran-data.json". Si por cualquier motivo necesita regenerar este archivo, bastará con iniciar el bot de la siguiente manera:

npm run refresh

Esto sobreescribirá a "mendotran-data.json", el archivo viejo será conservado bajo el nombre de "mendotran-data.json.old".

Note

En mi experiencia el número de paradas de colectivos detectadas por la regeneración de la base de datos varía según si se ejecuta un fin de semana o no. No estoy seguro del porqué de esto pero es necesario que lo mencione.

Así se ve más o menos la estructura de la base de datos:

// Versión de la base de datos:
"version": 1,
// Lista de paradas:
"stops": {
	// Número de la parada
	"M8845": {
		// ID interna:
		"id": "1606_62489",
		// Dirección:
		"address": "Av. San Martín (Luján de Cuyo, Mendoza)",
		// Colectivos que paran ahí:
		"busList": [
			"701",
			"704",
			"705",
			"708",
			"713",
			"714",
			"764",
			"766",
			"767"
		]
    }
},
// Lista de micros:
"buses": {
	// Número de la línea
	"701": {
		// ID interna:
		"id": "1606_166733",
		// Cartel del micro:
		"shortName": "701 UGARTECHE - Bº TIERRA SOL Y LUNA",
		// Color del colectivo:
		"color": "🟦"
	}
}

Parada cercana a tu ubicación

Si se desconoce el número de parada, enviando una ubicación al bot y respondiendo a la misma con alguno de los comando (parada, micro, etc), el sistema se encargará de buscar la parada más cercana y despachar sus horarios.

Comando "micro" para saber los horarios de UNA línea en específico:

Comando "parada" para mostrar los horarios de TODOS los colectivos de una parada:

Pros y contras

TLDR: Este bot ofrece una forma conveniente y rápida de acceder a la información de horarios de colectivos, aunque requiere un poco de configuración inicial y puede no ser ideal para todos los usuarios.

PROS	CONTRAS
El usuario no necesita gastar datos móviles entrando a la app oficial de Mendotran. Esto es incluso mejor si tiene WhastApp gratis con su compañía de celular.	El bot debe estar corriendo en un servidor para funcionar.
Puede ser más rápido que usar la aplicación oficial, esto dependerá de la velocidad del servidor y de la experiencia previa del usuario con el uso de bots.	Requiere más o menos tiempo habituarse a la lógica de los comandos. Habrá personas que prefieran el uso de una interfaz gráfica de usuario (GUI) antes que una interfaz de texto (TUI).
Si la privacidad le concierne, ésta forma de usar el servicio debería ser más privada, ya que el usuario no interactúa directamente con Mendotran sino el servidor. Mendotran afirma en su Play Store que no recolecta datos del usuario, sin embargo se contradice en las políticas de privacidad de su sitio web.	Si la privacidad le concierne probablemente no deba utilizar WhatsApp.
Más espacio libre en su dispositivo móvil al no tener instalada la aplicación.	Necesita saber el número de la parada de colectivos, en el caso contrario puede pedirle al bot que busque la parada más cercana a su ubicación actual. Esto último hace que pierda sentido el punto de usar menos datos, ya que Google Maps haría uso de los mismos.