You are not logged in.

Announcement

 Téléchargez la dernière version stable de GLPI      -     Et vous, que pouvez vous faire pour le projet GLPI ? :  Contribuer
 Download last stable version of GLPI                      -     What can you do for GLPI ? :  Contribute

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

robertocarlos.floresh
Moderator
From: San Salvador, El Salvador
Registered: 2014-12-29
Posts: 254

Tutorial / Plugins - TelegramBot (Ubuntu)

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.
Screenshot-from-2019-11-12-10-51-09.png

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

  • Configuración

    • Plugins

Screenshot-from-2019-11-12-10-51-47.png

Justo ahí veremos todos los plugins que tenemos instalados

Screenshot-from-2019-11-12-11-54-02.png

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

Screenshot-from-2019-11-12-10-53-03.png

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

Screenshot-from-2019-11-12-10-54-24.png

Veremos toda la información referente al plugin.

Screenshot-from-2019-11-12-10-55-37.png

Descarga del plugin

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

Screenshot-from-2019-11-12-10-59-19.png

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 

Screenshot-from-2019-11-12-11-01-16.png

Una carpeta habra sido creada, bajo el nombre de telegrambot
Screenshot-from-2019-11-12-11-01-54.png

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

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

Screenshot-from-2019-11-12-11-02-31.png

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

Screenshot-from-2019-11-12-11-02-31.png

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

Screenshot-from-2019-11-12-11-03-28.png


Y posterior se debe de hacer click en el switch color rojo,
Screenshot-from-2019-11-12-11-03-34.png

Este cambiará a verde para la activación
Screenshot-from-2019-11-12-11-03-44.png

Si se llegará a ver el error de  XXXX tablas no migradas al motor InnoDB, se deberá de seguir el siguiente tutorial.
Screenshot-from-2019-11-12-15-53-57.png



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:

Screenshot-from-2019-11-12-11-04-45.png

Se debe de cambiar Habilitar seguimiento hacia . Y se verá de esta manera, posterior a ello se debe de cambiar Enable followups via Telegram hacia
Screenshot-from-2019-11-12-11-04-58.png

Luego hacemos clic en Telegram followups configuration
Screenshot-from-2019-11-12-11-05-04.png


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
Screenshot-from-2019-11-12-13-27-39.png

Se selecciona y se inicia un chat con el, este mostrará todos los comando disponibles:
Screenshot-from-2019-11-12-13-27-51.png

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,
Screenshot-from-2019-11-12-11-10-15png.png

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

Screenshot-from-2019-11-12-11-10-21.png


Buscaremos nuestro bot en Telegram
Screenshot-from-2019-11-12-11-14-01.png


Configuración del Usuario

Iniciamos una conversación con nuestro bot... un simple "hola" bastará.
Screenshot-from-2019-11-12-11-14-23.png

Luego entramos a:

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

  • Configuración

    • Acciones automaticas

      • messagelistener

Screenshot-from-2019-11-12-11-15-24.png

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.

Screenshot-from-2019-11-12-11-16-22.png

Posterior a eso entramos a:

  • Administración

    • Usuarios

Screenshot-from-2019-11-12-14-53-08.png

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.

Screenshot-from-2019-11-12-11-18-00.png

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

Screenshot-from-2019-11-12-15-23-30.png

Deberán de añadir una nueva plantilla haciendo clic en el botón +
Screenshot-from-2019-11-12-11-18-40.png

Luego llenan el formulario con la siguiente información y hacen click en Guardar:
Screenshot-from-2019-11-12-11-25-51.png

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


Screenshot-from-2019-11-12-11-26-08.png

Screenshot-from-2019-11-12-11-23-19.png
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

Screenshot-from-2019-11-12-11-26-18.png

Y en la lista desplegable de "Plantilla de notificación", seleccionan: Nuevo Ticket (telegram), que fue el que se creo hace unos momentos.
Screenshot-from-2019-11-12-11-26-53.png

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

Screenshot-from-2019-11-12-11-27-58.png

Y se hace click en "Actualizar"

Para hacer una prueba de que el plugin funcione se creamos un ticket, como en cualquier otro momento:
Screenshot-from-2019-11-12-11-28-56.png

Y en unos pocos segundos se recibirá el mensaje a Telegram
Screenshot-from-2019-11-12-11-32-07.png


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.


Roberto Flores
Telegram: @rcfloresh

Grupo de GLPI Español (Telegram): https://t.me/glpisp   // Discord: https://discord.gg/NXwp2UjC

Offline

#2 2020-10-20 12:20:15

zurrachillo
Member
Registered: 2016-02-18
Posts: 15

Re: Tutorial / Plugins - TelegramBot (Ubuntu)

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

Offline

#3 2022-05-31 19:52:22

tute123456
Member
Registered: 2022-05-06
Posts: 2

Re: Tutorial / Plugins - TelegramBot (Ubuntu)

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!

Offline

Board footer

Powered by FluxBB