Configurar Telegram
Aquesta guia acompanya la pàgina de configuració de Telegram (Configuració → Integracions → Telegram → Configurar). És el canal d'avisos més ràpid d'activar: no necessita verificació d'empresa ni plantilles, i en uns minuts tens el bot. Els passos van numerats igual que les ajudes sota cada camp.
1. Què demana la pàgina
A “Configuració Bàsica”, un “Nom de la Integració” i l'“Entorn”. A “Credencials”: el “Token del bot” (pas 1), l'“Usuari del bot”, que acaba en “bot” i es fa servir a l'enllaç “Connecta Telegram”, i el “Secret del webhook”, que t'inventes tu (passos 2 i 5).
Després de “Desar Configuració” apareixen “Provar Connexió” i “Registrar webhook”. Cada empresa fa servir el seu propi bot.
2. Passos 1 a 3: crear el bot
Pas 1. A Telegram obre @BotFather (l'oficial, amb la marca blava), escriu /newbot i respon amb el nom visible del bot i un nom d'usuari que acabi en “bot” (per exemple, previna_notif_bot). BotFather et torna un token amb aquest aspecte: 123456789:AAE…; copia'l a “Token del bot” i el nom d'usuari, sense l'@, a “Usuari del bot”. Qui tingui el token controla el bot: no el comparteixis.
Pas 2. Inventa't una cadena llarga i aleatòria (32 caràcters o més) i escriu-la a “Secret del webhook”.
Pas 3 (opcional). A @BotFather pots posar descripció i foto al bot amb /setdescription i /setuserpic.
3. Pas 4: desar i provar
Prem “Desar Configuració” i després “Provar Connexió”. Si el token és vàlid, la integració passa a activa. Des d'aquell moment goPrevina ja pot enviar avisos a qui tingui el compte de Telegram vinculat.
4. Pas 5: registrar el webhook
Perquè la vinculació de cada usuari funcioni, Telegram ha de reenviar a goPrevina el /start que envia l'usuari. Amb la integració desada, prem “Registrar webhook”: la plataforma el registra amb l'adreça pública de la teva API i el secret del pas 2, i et diu si Telegram l'ha acceptat.
Telegram només accepta adreces HTTPS accessibles des d'internet; en una instal·lació sense aquestes adreces el registre falla. Sense webhook es pot enviar, però el botó “Connecta Telegram” dels usuaris no acaba la vinculació.
5. Pas 6: que cada usuari connecti el seu Telegram
Això ho fa cada persona, no l'administrador. A Preferències de notificació prem “Connecta Telegram”: s'obre el bot amb un enllaç d'un sol ús. Prem “Iniciar” a Telegram i la targeta passa de “No connectat” a “Connectat”. Després marca la columna Telegram als tipus d'avís que vulguis rebre per allà.
Si “Provar Connexió” falla, revisa el token. Si la vinculació no es completa, falta registrar el webhook (pas 5).