Tutorial / Plugins - TelegramBot (Ubuntu)

robertocarlos.floresh · 2019-11-13 00:14:23

Instalación de Plugin Telegram

En esta ocasión se realizará la instalación del plugin TelegramBot, el cual ha sido desarrollado por : Truly Systems

Los pasos que se verán a continuación son los siguientes:

Ubicación del plugin
Descarga del plugin
Instalación y Activación de TelegramBot
Configuración del plugin
- Creación del Bot
- Configuración del usuario
- Configuración de mensajes
- Configuración de notificaciones
- Prueba

Ubicación del plugin

Como para todo debemos de ingresar a GLPI y pues veremos la pantalla principal.

Seguido de eso se hace click en lo siguientes menú:

Configuración
- Plugins

Justo ahí veremos todos los plugins que tenemos instalados

Entonces, para ver el catátalogo de plugins, hacemos click sobre el botón que dice Ver cátalogo de plugins

Posterior a eso, nos enviará hacia la pagina principal donde podremos ver todos los plugins disponibles para GLPI, entonces buscamos el plugin de TelegramBot

Veremos toda la información referente al plugin.

Descarga del plugin

Ahora descargarán el archivo y los enviará hacia https://github.com/pluginsGLPI/telegrambot/releases

Donde podrán descargar el plugin más reciente, en esta ocasión usaremos la version 2.0.0 que es compatible para GLPI 9.4.x

Se descargará el archivo bajo el nombre de: glpi-telegrambot-2.0.0.tar.bz2

Tambien podemos hacer uso del siguiente comando, para descargalo mediante la Terminal

wget https://github.com/pluginsGLPI/telegrambot/releases/download/2.0.0/glpi-telegrambot-2.0.0.tar.bz2

Instalación y Activación de TelegramBot

Una vez haya sido descargado, abren el directorio de origen a travez de la terminal y descomprimen el archivo usando la siguiente linea:

tar -xvf glpi-telegrambot-2.0.0.tar.bz2

Una carpeta habra sido creada, bajo el nombre de telegrambot

Ahora moveremos la carpeta hacia el directorio de plugins de GLPI, dentro del servidor:

sudo mv telegrambot/ /var/www/html/glpi/plugins/

Luego regresamos al navegador de preferencia, entreamos a la sección de plugins de GLPI y veran el plugins alojado, sin embargo no estará instalado

Para instalarlo solo se debe de hacer click en la carpeta/folder con el signo +

Y posterior se debe de hacer click en el switch color rojo,

Este cambiará a verde para la activación

Si se llegará a ver el error de XXXX tablas no migradas al motor InnoDB, se deberá de seguir el siguiente tutorial.

Configuración del plugin

Seguido de eso se hace click en los siguientes menú:

Configuración
- Notificaciones

Si se llegará a encontrar de esta manera:

Se debe de cambiar Habilitar seguimiento hacia Sí. Y se verá de esta manera, posterior a ello se debe de cambiar Enable followups via Telegram hacia Sí

Luego hacemos clic en Telegram followups configuration

Creación del Bot

Esta información la tendremos que llenar haciendo uso de Telegram y la creación de nuestro bot, esto se hace de la siguiente manera:

Se busca @botfather

Se selecciona y se inicia un chat con el, este mostrará todos los comando disponibles:

Enviamos los siguientes comandos...

/newbot

Luego nos pedirá cual será el nombre de nuestro bot, en esta ocasión se usará:

Instalacion TelegramBot

Posterior nos pedira que creemos un usuario para el bot.

instalacion_telegram_bot

En este punto, se verá de la siguiente manera,

Los datos importantes de esto son HTTP API

La información que usaremos es la siguiente:

Bot token: 1005287763:AAE-J0i2lr9e022RVeftH4lVuA4CzAHRi6g
Bot username: instalacion_telegram_bot

LO MARCADO EN COLOR ROJO ES LA INFORMACIÓN QUE @Botfather LES HA PROPORCIONADO

Buscaremos nuestro bot en Telegram

Configuración del Usuario

Iniciamos una conversación con nuestro bot... un simple "hola" bastará.

Luego entramos a:

Seguido de eso se hace click en los siguientes menú:

Configuración
- Acciones automaticas
  - messagelistener

Hacemos click en ejecutar, y luego revisamos la base de datos, este paso lo podemos omitir, si ya conocemos el nombre del usuario, pero les recomiendo hacerlo solo para asegurarse, la tabla que deberan de revisar es 'glpi_plugin_telegrambot_user' y la columna que nos interesa es username y de ahí tomaremos el usuario.

Posterior a eso entramos a:

Administración
- Usuarios

En este caso usaremos el usuario glpi, sin embargo se puede agregar a los usuarios administradores de la plataforma.

Una vez dentro del perfil del usuario, agregaremos el nombre de usuario de Telegram en el campo creado por el plugin llamado Telegram username, este es el nombre del usuario que se extrajo de la tabla del plugin.

Y hacemos click en Guardar

Configuración de mensajes

Luego de esto, se deberán de configurar los mensajes, eso se hace a traves de la creación de una nueva plantilla, para esto se deberá de ingresar a:

Administración
- Notificaciones
- Plantillas de notificación

Deberán de añadir una nueva plantilla haciendo clic en el botón +

Luego llenan el formulario con la siguiente información y hacen click en Guardar:

Una vez se haya creado la nueva plantilla, entran a ella y seleccionan la tab Plantillas, y hacen click en el botón Agregar una nueva plantilla

Un mensaje corto con la información necesaria sería esta información la que habra que colocar:

Nuevo Ticket

ID: ##ticket.id##
Titulo: ##ticket.title##
Usuario: ##ticket.authors##
Descripcion: ##ticket.description##

En la pantalla les aparecerá lo siguiente, en la lista desplegable de "Modo", seleccionan: Telegram

Y en la lista desplegable de "Plantilla de notificación", seleccionan: Nuevo Ticket (telegram), que fue el que se creo hace unos momentos.

Luego, regresamos a la plantilla de Nuevo ticket (Telegram), y en el tab de "Receptores" se agregan los siguiente.

Y se hace click en "Actualizar"

Para hacer una prueba de que el plugin funcione se creamos un ticket, como en cualquier otro momento:

Y en unos pocos segundos se recibirá el mensaje a Telegram

Los creadores del plugin Truly Systems, tambien han hecho un video de donde tome la información para la creación de este archivo.
https://youtu.be/TKqIpIaAIAE

Si tienen alguna duda o comentario favor hacerlo saber.

zurrachillo · 2020-10-20 12:20:15

Hola.
Buen tutorial, me funciona correctamente, pero seria posible que en vez de enviar a usuarios, fuera a grupos?
Existe alguna forma de añadir tickets desde telegram a GLPI¿?
gracias

tute123456 · 2022-05-31 19:52:22

hola, ante todo muuuuuuuchas gracias por este tutorial, te comento que segui todo el tuto al pie de la letra (funcionando con exito) pero en la parte donde empieza la configuracion de las notificaciones (Administración - Notificaciones - Plantillas de notificación) , aca es donde me pierdo ya que en vez de ir a administracion me dirijo a Configuracion notificaciones - plantillas.. y lo demas no es igual a como sigue la guia, si bien estas usando la version 9.4.4 yo lo hice en esa misma version y tambien en 9.5.7 actualmente (en la version 10) no puedo hacer que el telegrambot arranque (execution error) por ende no me arroja el username en el phpmyadmin , pero en estas 2 versiones anteriores no tuve problemas en ejecutar e incluso me llegaron los mensajes al bot
una vez mas muchas gracias por este tutorial ! saludos!

Forum GLPI-Project

Announcement

#1 2019-11-13 00:14:23