Integración con Telegram

Recibe un mensaje en Telegram cuando tus comentarios necesiten atención. Voxtrics publica en Telegram desde una alerta: una regla que vigila las respuestas nuevas, por ejemplo «al menos 3 valoraciones de 2 o menos en una hora». Los mensajes los envía un bot de Telegram tuyo al chat que elijas: un grupo, un canal o tu chat personal con el bot. Voxtrics necesita una dirección que contenga las dos cosas: el token del bot y el ID del chat.

Crea un bot

  1. En Telegram, abre @BotFather y envía /newbot.
  2. Ponle al bot un nombre, por ejemplo Voxtrics alerts, y un nombre de usuario que termine en bot.
  3. BotFather responde con el token del bot, que tiene este aspecto: 123456789:AAHf0x.... Cópialo.

Añade el bot al chat

  • Un grupo: añade el bot como miembro.
  • Un canal: añade el bot como administrador con permiso para publicar mensajes.
  • Tu chat personal: abre el bot y pulsa Start («Iniciar»). Un bot no puede escribir a quien no lo ha iniciado.

Después envía cualquier mensaje en ese chat, para que Telegram tenga algo que mostrar en el siguiente paso.

Averigua el ID del chat

  1. Abre esta dirección en el navegador, con tu token en lugar de YOUR_TOKEN:

    https://api.telegram.org/botYOUR_TOKEN/getUpdates

  2. Busca "chat":{"id": en la respuesta y copia el número que sigue. El ID de un grupo o de un canal empieza por un signo menos, por ejemplo -1001234567890: conserva el menos.

Si la respuesta está vacía ("result":[]), envía otro mensaje en el chat y vuelve a cargar la página: Telegram guarda estos datos solo 24 horas.

Envía alertas a Telegram

  1. Pon el token y el ID del chat en esta dirección:

    https://api.telegram.org/botYOUR_TOKEN/sendMessage?chat_id=YOUR_CHAT_ID

  2. Ve a Alertas y haz clic en Nueva alerta, o en el icono del lápiz (Editar) de una regla existente.

  3. Define el nombre, el alcance, la ventana de tiempo y la condición de la regla, como se describe en Alertas.

  4. En Notificar mediante, selecciona Telegram y pega la dirección en URL de webhook de Telegram.

  5. Haz clic en Crear alerta, o en Guardar cambios para una regla existente.

La dirección solo publica en el chat que indica. Para recibir las mismas alertas también en otro chat, forma una dirección para ese chat y añádela a la regla con Añadir chat de Telegram. Varias reglas pueden usar la misma dirección.

Qué dice el mensaje

Cada vez que la regla se dispara, el chat recibe un mensaje de texto breve en inglés con el nombre de la regla, el dominio, cuántas respuestas de la ventana de tiempo cumplieron la condición y por qué se disparó. Las respuestas no aparecen en él: abre el disparo en Alertas para verlas.

Una regla se dispara como mucho una vez cada 30 minutos, o con menos frecuencia si le pones una pausa. Las alertas de un espacio publican como máximo 200 mensajes al día entre Telegram y Slack. Pasado ese límite, la regla sigue disparándose y el disparo aparece en Alertas, pero no se publica nada.

Si los mensajes no llegan

  • Si la alerta no se guarda, comprueba que la dirección empieza por https://api.telegram.org/. Voxtrics solo acepta la dirección de la Bot API de Telegram, no un enlace t.me a un chat o a un bot.
  • Comprueba que la regla está activada y se ha disparado: todos los disparos aparecen en Alertas.
  • Si la regla se disparó pero no llegó nada a Telegram, comprueba que el bot sigue en el chat (y es administrador en un canal), que el ID del chat conserva el menos y que el token no se ha revocado. Cuando Telegram convierte un grupo en supergrupo, su ID cambia: vuelve a averiguarlo y actualiza la dirección.