Collega Telegram a Elido

Elido invia le notifiche Telegram tramite un bot che crei tu. Il bot invia i messaggi a una chat specifica: un messaggio privato con te stesso oppure un gruppo. Il token del bot è tuo; Elido lo memorizza solo in forma cifrata.

Passaggio 1 - Crea un bot con BotFather

1. Apri Telegram e cerca @BotFather, oppure apri https://t.me/BotFather.
2. Invia /newbot.
3. Segui le istruzioni: scegli un nome visualizzato, poi un nome utente (deve terminare con bot, ad esempio AcmeElidoBot).
4. BotFather risponde con il tuo token API. Ha un aspetto simile a 123456789:AABBccDD.... Copialo subito: puoi recuperarlo in seguito da /mybots, ma è più rapido copiarlo subito.

Passaggio 2 - Trova il tuo chat ID

Ti serve il chat ID numerico del posto in cui vuoi ricevere i messaggi.

Per i messaggi privati (solo tu):

1. Invia un messaggio qualsiasi al tuo nuovo bot.

2. Apri questo URL in un browser, sostituendo TOKEN con il tuo token:

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

3. Trova "chat":{"id":...} nella risposta. Quel numero è il tuo chat ID. Di solito è un intero positivo di 9 cifre per le chat personali.

Per un gruppo:

1. Aggiungi il bot al gruppo.
2. Invia nel gruppo un messaggio che menzioni il bot con @ (ad esempio @AcmeElidoBot hello).
3. Apri lo stesso URL getUpdates indicato sopra. I chat ID dei gruppi sono numeri negativi (ad esempio -1001234567890).

Passaggio 3 - Configura Elido

1. Vai su Settings → Notifications → Telegram → Add channel.
2. Incolla il token del bot e il chat ID.
3. Fai clic su Save. Elido invia un messaggio di prova. Aspettati di vederlo su Telegram entro 2 secondi.

Scegliere gli eventi

Una volta collegato, fai clic su Configure events per selezionare quali eventi attivano un messaggio:

• link.broken - punto di partenza consigliato: il monitor dei link non funzionanti ha trovato una destinazione che non risponde più.
• usage.threshold_80 e usage.threshold_100 - il workspace ha usato l'80% o il 100% della quota del piano.
• link.expired e link.cap_reached - un link è scaduto o ha raggiunto il limite di clic.
• link.created - utile per i workspace condivisi in cui vuoi avere visibilità sui nuovi link.
• domain.verified e domain.ssl_failed - stato del dominio personalizzato.

L'elenco completo dei tipi di evento è nella guida ai webhook.

Rimuovere l'integrazione

Vai su Settings → Notifications → Telegram → Remove. Questo elimina il token del bot dal database di Elido. Facoltativamente, revoca il bot stesso in BotFather con /revoke.

Risoluzione dei problemi

"Unauthorized" nel log di consegna - Il token è errato. Verifica incollando questo indirizzo in un browser:

https://api.telegram.org/botTOKEN/getMe

Se restituisce {"ok":false,...}, il token non è valido.

"Chat not found" - Il chat ID è errato, oppure il bot non è mai stato aggiunto al gruppo. Per i gruppi, conferma che il bot sia un membro e invia un messaggio che lo menzioni prima di chiamare getUpdates.

Nessun messaggio dopo aver fatto clic su Test - Controlla getUpdates per verificare che il bot abbia ricevuto qualche interazione. Se la risposta è vuota, Telegram non ha ancora registrato alcun contatto tra l'utente/gruppo e il bot.

I messaggi nel gruppo non sono visibili - Alcuni gruppi Telegram hanno la "modalità lenta" o consentono di scrivere solo agli amministratori. Rendi il bot amministratore con il permesso "Post messages".