ChatBot VCD

Puesta en marcha del bot

Interfaz

Primero se deben inicializar las bases de datos y la interfaz.

1. Abrir el programada llamado “xampp” y dar click en start para las filas “Apache” y
“MySql” (una vez que se da click en start se ponen en verde. VER IMAGEN).

2. Abrir carpeta “chatbot” que se encuentra en el escritorio y ejecutar el archivo

llamado “main”.
 Si todo esta OK debería aparecer esa pantalla. NO se debe cerrar, solo se minimiza.

Inicio del bot

Abrir “VCD Customer Support Manager” que se encuentra en 192.168.100.57:3000 . Una

vez dentro dar click en el botón “Escanear”.

Se abre una ventana de google Chrome para escanear el código qr con el teléfono.
También aparece lo siguiente, NO se debe cerrar solo minimizar:

Una vez que se escanea el QR y se abre WhatsApp Web se debe dar click en el Boton “RUN”
dentro de la interfaz principal.
Cuando se abre, aparece lo siguiente. NO se debe cerrar solo minimizar.

Una vez hecho todo esto dejar solo maximizado el WhatsApp Web en primer plano.

Se recomienda crear un nuevo escritorio (con ctrl + tecla Windows + D) y ejecutar todos los
archivos anteriores en ese nuevo escritorio.
 Como parar el bot
Para detener el bot se deben cerrar los programas keepsession.py y bot.py, que se ejecutaron
cuando se inició el bot.

Como usar la Interfaz

En la interfaz gráfica se pueden modificar las opciones del bot (“VER OPCIONES”) y además
consultar las alertas (“VER ALERTAS”) que generaron los usuarios cuando el bot está activo.

Las alertas son aquellas opciones que seleccionaron los usuarios y deben ser respondidas por
una persona humana. Estas opciones son generar (botón de pago), no (servicio técnico) y 5
(Consultar cobertura).

Se pueden consultar las alertas por contestar desde la interfaz principal en “VER ALERTAS”.

Una vez adentro se listan las alertas pendientes. Para atenderlas se dispone del número de
teléfono para buscarlo en WhatsApp y contestar la consulta. Una vez atendida la alerta se
debe dar click en OK para que el bot vuelva a tomar el control del chat para ese número.
 NOTA: Cuando se da click en "OK" se confirma que se atendió la alerta y el numero solicitante
está habilitado para volver a ser atendido por el bot. Por lo tanto se debe confirma el "OK"
cuando el personal que atendió la alerta escribió el último mensaje hacia el solicitante y
asegurarse que se atendió correctamente, de lo contrario el bot contestará todos los mensajes
que le lleguen desde ese número. Por lo tanto, se recomienda que se levante la alerta una vez
que se le mando el último mensaje por parte del personal.

Uso
Debido a que hasta Junio de 2021 WhatsApp no permite usar WhatsApp Web en mas de un
dispositivo, se recomienda dejar funcionando este bot y no responder desde WhatsApp Web
(si puede ser desde el teléfono físico). Cuando se deseen responder las alertas pendientes se
debe parar el bot (cerrar los archivos bot.py. VER APARTADO “Parar bot”) para luego cuando
estén todas atendidas dar click en el botón “RUN” nuevamente (VER APARTADO “Inicio del
bot”, siempre y cuando ya esté realizado el apartado “Interfaz”, dentro de “Puesta en marcha
del bot”).
Tips y datos útiles
 Si el bot no responde puede ser que el proceso se pauso. Se debe ir al programa
abierto bot.py y apretar ctrl + x para reanudar el proceso.
 Si el bot no responde puede ser que el programa se cerró, en ese caso repetir el
procedimiento de “Puesta en marcha del bot”.
 Si el bot no responde puede ser porque el WhatsApp web no está abierto en primer
plano. En ese caso maximizar el WhatsApp Web. Se recomienda crear un nuevo
escritorio (con ctrl + tecla Windows + D) y ejecutar todos los archivos del apartado
“Puesta en marcha del bot” en ese nuevo escritorio.
 Si el bot no responde puede ser porque no se abrió el “xampp” y no se inicializaron las
bases de datos y la interfaz. En ese caso ver “Puesta en marcha del bot”.
 Se se apreta ctrl + C en bot.py , keepsession.py o main.py se para el bot y para volver a
ponerlo en funcionamiento repetir el procedimiento de “Puesta en marcha del bot”.
 Si el teléfono se apaga, no tiene WIFI u otro motivo, el bot no funcionará.
 NO se recomienda usar el WhatsApp web desde la misma computadora donde el bot
está funcionando, ya que podría llegar a confundirlo.
 Una vez que se genera una alerta el bot no responderá a ese número hasta que se
levante esa alerta.
 Hasta Junio de 2021 WhatsApp no permite usar WhatsApp Web en más de un
dispositivo, por lo que se recomienda dejar funcionando este bot y no responder
desde WhatsApp Web (si puede ser desde el teléfono físico), y cuando se deseen
responder las alertas se debe parar el bot para luego cuando estén todas atendidas
dar click en el botón “RUN”.

Posibles fallas y soluciones

 En casos de fallas puede ser que WhatsApp Web se haya actualizado y cambiado de
nombre las etiquetas HTML. Para dar solución a esto ayudarse del archivo
“Ubicación etiquetas HTML para BOT VCD”
 Otra falla común puede ser que Google Chrome (o el navegador que se use) se haya
actualizado. En este caso se debe obtener el driver actualizado de Chrome (sacarlo
de https://chromedriver.chromium.org/) y pegarlo en la carpeta driver
 También pudo haber cambiado el color de fondo verde de los mensajes enviados,
por este motivo el bot toma como respuetas sus propios mensajes. Se debe
actualizar los valores rgb en el código bot.py