Connetti Telegram a Elido

Elido invia notifiche Telegram tramite un bot che crei tu. Il bot invia messaggi a una chat specifica — o un DM privato con te stesso o un gruppo. Tu sei proprietario del token del bot; Elido lo conserva solo criptato.

Step 1 — Crea un bot con BotFather#

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

Step 2 — Trova il tuo chat ID#

Hai bisogno dell'ID numerico della chat dove vuoi che vengano inviati i messaggi.

Per DM (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 a 9 cifre per le chat personali.

Per un gruppo:

1. Aggiungi il bot al gruppo.
2. Invia un messaggio nel gruppo che @-menziona il bot (es. @AcmeElidoBot ciao).
3. Apri lo stesso URL getUpdates sopra. Gli ID delle chat di gruppo sono numeri negativi (es. -1001234567890).

Step 3 — Configura Elido#

1. Vai su Impostazioni → Notifiche → Telegram → Aggiungi canale.
2. Incolla il token del bot e il chat ID.
3. Fai clic su Salva. Elido invia un messaggio di test. Aspettalo in Telegram entro 2 secondi.

Scegli gli eventi#

Una volta connesso, fai clic su Configura eventi per selezionare quali eventi attivano un messaggio:

• threshold.exceeded — punto di partenza consigliato.
• scan.failed — immediatamente utile per qualsiasi link di cui non controlli la destinazione.
• link.created — utile per workspace condivisi dove vuoi visibilità sui nuovi link.

Rimuovi l'integrazione#

Vai su Impostazioni → Notifiche → Telegram → Rimuovi. Questo elimina il token del bot dal database di Elido. Opzionalmente, revoca il bot stesso in BotFather con /revoke.

Risoluzione dei problemi#

"Unauthorized" nel log di consegna — Il token è errato. Ricontrolla incollando https://api.telegram.org/botTOKEN/getMe in un browser. Se restituisce {"ok":false,...}, il token non è valido.

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

Nessun messaggio dopo aver fatto clic su Test — Controlla getUpdates per confermare 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 sono invisibili — Alcuni gruppi Telegram hanno la "slow mode" o la pubblicazione solo per amministratori. Rendi il bot un amministratore con il permesso "Post messages".