Configurar Telegram
Esta guía acompaña la pantalla de configuración de Telegram (Ajustes → Integraciones → Telegram → Configurar). Es el canal de avisos más rápido de activar: no necesita verificación de empresa ni plantillas, y en unos minutos tienes el bot. Los pasos van numerados igual que las ayudas bajo cada campo.
1. Qué pide la pantalla
En “Configuración Básica”, un “Nombre de la Integración” y el “Entorno”. En “Credenciales”: el “Token del bot” (paso 1), el “Usuario del bot”, que acaba en “bot” y se usa en el enlace “Conectar Telegram”, y el “Secreto del webhook”, que inventas tú (pasos 2 y 5).
Tras “Guardar Configuración” aparecen “Probar Conexión” y “Registrar webhook”. Cada empresa usa su propio bot.
2. Pasos 1 a 3: crear el bot
Paso 1. En Telegram abre @BotFather (el oficial, con la marca azul), escribe /newbot y responde con el nombre visible del bot y un nombre de usuario que termine en “bot” (por ejemplo, previna_notif_bot). BotFather te devuelve un token con este aspecto: 123456789:AAE…; cópialo en “Token del bot” y el nombre de usuario, sin la @, en “Usuario del bot”. Quien tenga el token controla el bot: no lo compartas.
Paso 2. Inventa una cadena larga y aleatoria (32 caracteres o más) y escríbela en “Secreto del webhook”.
Paso 3 (opcional). En @BotFather puedes poner descripción y foto al bot con /setdescription y /setuserpic.
3. Paso 4: guardar y probar
Pulsa “Guardar Configuración” y luego “Probar Conexión”. Si el token es válido, la integración pasa a activa. Desde ese momento goPrevina ya puede enviar avisos a quien tenga su cuenta de Telegram vinculada.
4. Paso 5: registrar el webhook
Para que la vinculación de cada usuario funcione, Telegram tiene que reenviar a goPrevina el /start que manda el usuario. Con la integración guardada, pulsa “Registrar webhook”: la plataforma lo registra con la dirección pública de tu API y el secreto del paso 2, y te dice si Telegram lo aceptó.
Telegram solo acepta direcciones HTTPS accesibles desde internet; en una instalación sin ellas el registro falla. Sin webhook se puede enviar, pero el botón “Conectar Telegram” de los usuarios no termina la vinculación.
5. Paso 6: que cada usuario conecte su Telegram
Esto lo hace cada persona, no el administrador. En Preferencias de notificación pulsa “Conectar Telegram”: se abre el bot con un enlace de un solo uso. Pulsa “Iniciar” en Telegram y la tarjeta pasa de “No conectado” a “Conectado”. Después marca la columna Telegram en los tipos de aviso que quieras recibir por ahí.
Si “Probar Conexión” falla, revisa el token. Si la vinculación no se completa, falta registrar el webhook (paso 5).