Con el plugin de Telegram podrás configurar fácilmente eventos en Ubidots que envían mensajes a un grupo de Telegram. Esto es posible gracias a una URL HTTPS proporcionada por el plugin que recibe mensajes y los envía al grupo utilizando tu propio bot de Telegram.
1. Creando un bot de Telegram
Para que este plugin funcione, primero debemos crear un bot en Telegram. Sigue estos pasos para hacerlo:
Abre la aplicación de Telegram.
Toca el ícono de búsqueda en la esquina superior derecha.
Escribe "botfather" en la barra de búsqueda y toca el resultado de BotFather para iniciar un chat.
En el chat con BotFather, escribe "/newbot" y envía el mensaje.
BotFather te pedirá que elijas un nombre para tu bot, elige uno y envíalo como mensaje.
Elige un nombre de usuario único para tu bot. Este nombre de usuario debe terminar con la palabra "bot" (por ejemplo, "myexamplebot"). Envía el nombre de usuario como un mensaje.
Si el nombre de usuario elegido está disponible, BotFather creará el bot y te proporcionará un token. Este token se utilizará como entrada para este plugin.
2. Configurando el plugin
Ve a “Dispositivos” → “Plugins”. Haz clic en el botón “+” en la esquina superior derecha, elige la opción de Telegram y sigue estos pasos:
Ingresa el token de tu bot.
Nombra tu plugin.
Completa una descripción (opcional).
3. Configuración del grupo de Telegram
Ahora es el momento de invitar al bot al grupo donde queremos recibir los mensajes de nuestro plugin/evento. Sigue estos pasos:
Abre la aplicación de Telegram.
Haz clic en el botón de hamburguesa y luego haz clic en “Nuevo Grupo”. Dale un nombre distintivo (por ejemplo, "Alertas Meteorológicas").
Invita a tu bot al grupo.
Envía un mensaje tipo comando inicial al grupo (incluso si el comando no hace nada). Los comandos en Telegram comienzan con “/”, así que este mensaje inicial puede ser algo como “/help”.
4. Creando un evento que activa el plugin de Telegram
En este caso, el tipo de acción que debemos usar para nuestro evento es el “trigger webhook”. Para configurar este tipo de evento, sigue esta guía y recuerda introducir las siguientes entradas de acuerdo a lo indicado:
Coloca la URL del endpoint HTTPS de tu plugin en el campo “URL” durante la configuración de “acciones”. Puedes localizar esta URL ingresando a tu plugin y luego dirigiéndote a su sección de “decoder”.
Cambia la carga útil predeterminada con este JSON:
{"groupname": "<GROUPNAME>", "message": "<MESSAGE>"}Donde:
<GROUPNAME>es el nombre del grupo de Telegram objetivo. Esta entrada es sensible a mayúsculas y minúsculas, así que asegúrate de escribir/copiar exactamente como aparece en Telegram.<MESSAGE>es el contenido del mensaje que se enviará.
Nota: Es mejor si escribes manualmente todas las comillas dobles en la carga útil para evitar posibles problemas de formato.
5. Solución de problemas
Puedes verificar el estado de la entrega de mensajes revisando los registros del plugin. También puedes probar tu bot enviando una solicitud HTTPS POST directa a la URL de este plugin utilizando una herramienta HTTP como Postman. Esta solicitud también debe tener una carga útil como se indicó anteriormente.